https://github.com/yihui/blogdown-jekyll

Automatically knit R Markdown documents, build them with Jekyll, and serve the website with servr locally
https://github.com/yihui/blogdown-jekyll

css html jekyll knitr

Last synced: 12 days ago
JSON representation

Automatically knit R Markdown documents, build them with Jekyll, and serve the website with servr locally

• Host: GitHub
• URL: https://github.com/yihui/blogdown-jekyll
• Owner: yihui
• License: mit
• Created: 2014-09-28T04:13:55.000Z (about 10 years ago)
• Default Branch: gh-pages
• Last Pushed: 2022-07-15T17:55:40.000Z (over 2 years ago)
• Last Synced: 2024-08-06T03:06:07.406Z (3 months ago)
• Topics: css, html, jekyll, knitr
• Language: SCSS
• Homepage: https://jekyll.yihui.org
• Size: 41 KB
• Stars: 204
• Watchers: 17
• Forks: 165
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
This is a minimal example of a Jekyll-based website using [**knitr**](https://yihui.name/knitr/), [**blogdown**](https://github.com/rstudio/blogdown), and R Markdown, briefly documented at .

You can actually serve the Jekyll website locally with R, and R Markdown posts can be compiled automatically, with the web pages being automatically refreshed in your web browser as well. To build the serve the website locally, you need to install **blogdown** (and Jekyll, of course) and call the `serve_site()` function:

```r

devtools::install_github("rstudio/blogdown")

blogdown::serve_site()

```

After you are satisfied with the local preview, you can either just push the Markdown blog posts to your Github repo (e.g. the `gh-pages` branch), and let Github generate the website for you, or host the HTML files generated under the `_site/` directory on your own server.

The original website was created from `jekyll new .` under the root directory, which was part of the [official Jekyll repo](https://github.com/jekyll/jekyll). The additional code (mainly R code) in this repo is under the MIT License, and the [blog post](https://jekyll.yihui.name/2014/09/jekyll-with-knitr.html) I wrote is under the [CC-BY 4.0](http://creativecommons.org/licenses/by/4.0/) International License.

The support for Jekyll is limitted in **blogdown**, and you may want to switch to Hugo, which is much better supported in **blogdown**.