вводить
рbookdownПакет расширений является еще одним расширением формата markdown после пакетов расширений Knitr и rmarkdown, так что формат Rmd может поддерживать формулы, теоремы, автоматическую нумерацию и цитирование диаграмм, ссылок, библиографических цитирований и ссылок и другие функции, подходящие для написания книг.
Под управлением bookdown: содержимое книги может быть разложено на несколько файлов Rmd, которые могут содержать исполняемый код R, а текстовые результаты, таблицы и графика, сгенерированные кодом R, могут быть автоматически вставлены в сгенерированное содержимое. и графика Может быть плавающей версткой. Выходной формат в основном поддерживает веб-книги в формате gitbook.Этот тип книг отображает каталог слева и содержание справа, и может автоматически ссылаться на предыдущую главу и следующую главу; для подробного ознакомления, пожалуйста, обратитесь к:Учебник по языку R - Глава 23.
Поддерживает конвертацию книг в PDF-файл через отдельно устанавливаемый компилятор LaTeX, поддерживает китайский язык, умеет генерировать электронные книги в ePub и других форматах. Помимо написания книг с несколькими главами, bookdown также можно использовать для создания отчетов об исследованиях в одном файле. Конечно, я также использую его для интересных вещей: гиперссылок.
Для создания книг рекомендуется использовать RStudio.В этом программном обеспечении встроена функция компиляции всей книги одним щелчком мыши.
Простой учебник
Вот несколько простых шагов, которые помогут вам начать писать книги с помощью Bookdown. Полную документацию по bookdown см.книга down.org/awhile/book's…
Установить
В любом случае подойдет:
# you can either use the CRAN version
install.packages('bookdown')
# or the development version on Github
remotes::install_github('rstudio/bookdown')
Создайте
Щелкните Файл-Новый проект-Новый каталог, затем щелкните следующие значки:
Задайте имя файла и путь и нажмите «Создать».
В это время появится следующий интерфейс. В правом нижнем углу находятся некоторые файлы, которые идут с ним. Внутри маленькой коробки находится rmd каждой главы. Вы можете видеть, что bookdown — это книга, которая объединяет множество файлов rmd. Конечно, он также включает файлы yml, формат bib для документов, файлы css для создания тем и т. д.
компилировать
Находим файл index.rmd, открываем его и нажимаем вязать для компиляции, и в правом нижнем углу можем получить скомпилированный результат:
Конечно, вы также можете предварительно просмотреть его на веб-странице, нажав «Показать в новых окнах» справа от метлы в правом нижнем углу.
Примечание. Кнопка «Связать» отображает только ту главу, которую вы редактируете (например, index.rmd, 01-intro.Rmd и т. д.), и использует выходной формат книги по умолчанию.
Чтобы построить все главы и все форматы книги, вы можете использовать кнопку сборки книги на панели сборки RStudio (правый верхний угол всего интерфейса).
Теперь вы сделали книги в разных форматах! Вы можете найти соответствующий файл в соответствующей папке проекта.
Этот шаблон не поддерживает рендеринг pdf с китайскими шрифтами, но поддерживает html с китайскими шрифтами.
Изготовление китайских книг
Если вам нужно сделать книги с китайскими иероглифами (конечно, нужно!), вы можете применить их напрямую.Ли ДунфэнУчитель подготовил для нас шаблон.
Ссылка для скачивания:bookdown-template-v0-5.zip, так же можно вывести в командном окне официальной учетной записи [bookdown]получить.
папка содержит
Подкаталог CBook содержит необходимые шаблоны китайских книг, подкаталог CArticle содержит шаблоны бумажного формата, а в других подкаталогах есть некоторые другие шаблоны (все они могут быть изучены и использованы, спасибо г-н Ли! У меня есть возможность опубликовать еще один учебник !)
Существует также каталог MathJax для нативной поддержки отображения математических формул на веб-страницах, см. в нем файл readme.txt.
Используйте учебник
Создайте новый проект (File-New Project), затем скопируйте и вставьте все файлы из папки CBook в папку проекта, например:
Вот некоторые из этих файлов:
- index.rmd
В книжной книге обычно должен быть одинindex.Rmdфайл, который является исходным файлом домашней страницы окончательно сгенерированного веб-сайта. Вы можете написать некоторые описания книг в этом файле и установить соответствующие настройки в разделе метаданных YAML в начале, такие как название, автор, дата и т. д. Подобно файлу yaml в Rmarkdown, вы можете изменить его здесь.Мистер Ли также указывает внутренние параметры шаблона.объяснить подробно. Эта статья предназначена для начинающих, поэтому я не буду слишком много объяснять, просто сначала используйте ее.
- xxx.Rmd
За исключением index.rmd, каждый файл .Rmd в проекте служит главой. Первая строка каждого файла .Rmd должна быть заголовком первого уровня, начинающимся со знака решетки и пробела, за которым следует пробел, а затем метка главы, начинающаяся со знака решетки в фигурных скобках, например
# 随机数 {#rng}
0101-usage.rmd в шаблоне даетБазовое использование шаблона китайской книги Bookdown, включая: настройки установки, структуру документа, автоматическую нумерацию формул графической таблицы, формирование PDF, выгрузку на сайт и т.д.
Этот файл rmd содержит много сухих товаров, не пропустите его!
1001-chapter01.rmd содержит внутреннее содержание главы, которое можно использовать в качестве справочного материала. Вы можете заменить содержимое своим собственным, и вы можете создать больше похожих файлов rmd.Имена лучше всего располагать в похожем порядковом номере, потому что по умолчанию компилируется последовательно по порядковому номеру. Например, мой журнал настроен на:
После того, как вы написали свой собственный контент, вы можете скомпилировать его в соответствии с предыдущим базовым руководством (два способа). Или вы можете использовать то, что рекомендовал г-н Ли: используйте следующую команду для компиляции в командном окне:
bookdown::render_book("index.Rmd",
output_format="bookdown::gitbook", encoding="UTF-8")
Для вывода pdf у вас должна быть среда tex! Рекомендуется установить Xie Yihui'sTinyTeX.
Затем найдите соответствующий pdf-файл в папке проекта, откройте его, и это книга, которую вы сделали сами! Вот скриншот моего дневника:
мне есть что сказать
-
Если вы впервые видите мои материалы о передаче документов и хотите следовать этому руководству, чтобы создать книгу, я предлагаю вам прочитать базовое руководство по RMarkdown, которое я написал, потому что книга по построению содержит все виды синтаксиса Rmarkdown, если вы этого не сделаете. Использование может вызвать головную боль.
-
Редактор может только ввести вас в дверь (как создавать, использовать, компилировать). В процессе фактического использования вы можете столкнуться с различными практическими проблемами.Рекомендуется использовать большеbing(google) Английский поиск, чтобы найти ответ, который вы хотите.
-
Вот некоторые справочные материалы, связанные с Bookdown.