Мини инструкция из пакета blogdown

Ниже неактуальная инструкция про blogdown :) Возни много с ним, переехали на Jekyll. Но пусть будет здесь для истории.

Где что:

• Исходники хранятся в репозитории kassandra-ru.github.io_sources.
• Опубликованные страницы на kassandra-ru.github.io.

Установка:

1. Ставим пакет R blogdown
2. Ставим hugo, blogdown::install_hugo()

Создание блога на github-pages в первый раз:

1. Создаём два репозитория, в одном будут хранится исходники, в другом — сами опубликованные посты в html.
2. В папке исходников блога выполняем команду blogdown::new_site(), можно через Rstudio Addins кликнуть :)
3. Копируем содержимое папки public в репозиторий постов блога.

Добавления поста в существующий блог:

1. Выполняем команду blogdown::new_post() или через меню Rstudio Addins кликаем.
2. После всех изменений перезапускаем R session.
3. Выполняем команду blogdown::hugo_build().
4. Копируем содержимое папки public из репозитория исходников в репозиторий постов блога.
5. Заливаем на гитхаб изменения в обоих репозиториях.

This is a post written in plain Markdown (*.md) instead of R Markdown (*.Rmd). The major differences are:

1. You cannot run any R code in a plain Markdown document, whereas in an R Markdown document, you can embed R code chunks (```{r});
2. A plain Markdown post is rendered through Blackfriday, and an R Markdown document is compiled by rmarkdown and Pandoc.

There are many differences in syntax between Blackfriday’s Markdown and Pandoc’s Markdown. For example, you can write a task list with Blackfriday but not with Pandoc:

• Write an R package.
• Write a book.
• …
• Profit!

Similarly, Blackfriday does not support LaTeX math and Pandoc does. I have added the MathJax support to this theme (hugo-lithium) but there is a caveat for plain Markdown posts: you have to include math expressions in a pair of backticks (inline: `$ $`; display style: `$$ $$`), e.g., $S_n = \sum_{i=1}^n X_i$.^[This is because we have to protect the math expressions from being interpreted as Markdown. You may not need the backticks if your math expression does not contain any special Markdown syntax such as underscores or asterisks, but it is always a safer choice to use backticks. When you happen to have a pair of literal dollar signs inside the same element, you can escape one dollar sign, e.g., \$50 and $100 renders “$50 and $100”.] For R Markdown posts, you do not need the backticks, because Pandoc can identify and process math expressions.

When creating a new post, you have to decide whether the post format is Markdown or R Markdown, and this can be done via the ext argument of the function blogdown::new_post(), e.g.

blogdown::new_post("Post Title", ext = '.Rmd')