воскресенье, 4 октября 2015 г.

Настройка внешнего вида документов RMarkdown

Опробовал в действии пакет tufterhandout для создания документов RMarkdown, из которых получаются HTML-файлы в специфическом стиле. Мой пример созданного таким образом документа залит на Гитхаб. Поискал, как можно настраивать под себя формат вывода RMarkdown - оказалось, ничего сложного в этом нет.
Способ, описанный в блоге, не сработал. Понимание пришло в процессе чтения официальной документации.

При создании в RStudio нового документа RMarkdown можно использовать шаблоны, которые и обеспечивают возможность изменения всех аспектов внешнего вида итогового HTML-файла. Сами шаблоны лежат в папке "R-3.2.2\library\rmarkdown\rmarkdown\templates", там же можно создать свой шаблон.
Минимальный шаблон состоит из папки (например, "report") со следующими файлами:
template.yaml 
skeleton/skeleton.Rmd 
skeleton/styles.css 
Содержимое "template.yaml":
name: Report
description: New template
create_dir: false
Содержимое "skeleton.Rmd":
 ---
title: "Report"
output:
  html_document:
    toc: true
    css: styles.css
---
Главное - указать файл с таблицей стилей "styles.css". Вообще тут может быть любой документ RMarkdown, демонстрирующий возможности шаблона.

"styles.css" отвечает за всю разметку. Вносим свои правки - видим результат, например, можно добиться вывода рамок в таблицах, поменять размеры заголовков и пр. Например:
table {
   max-width: 95%;
   border: 1px solid #ccc;
}

th {
  background-color: #000000;
  color: #ffffff;
}

td {
  background-color: #dcdcdc;
}



Комментариев нет:

Отправить комментарий