Hugo-theme-learn is a very good theme for building documentation sites. Inspired by David Robinson‘s keynote talk at the RStudio conference 2019 (summary in the following tweet), I decided to write a post about how I use Yihui‘s fantastic R package blogdown to develop my own personal website. The website does not require server-side scripts such as PHP or databases like WordPress does. The R blogdown package makes it very easy to create blogs and websites with R Markdown language. To create my site, I created a repo using my Github user name ‘caitlincasar’ on Github called caitlincasar.github.io. This site is to show how to use blogdown with the hugo-theme-learn theme to quickly build a documentation site.. Open RStudio, click File->New Project-> New Directory -> Website using blogdown. Set up your github repo so it can serve as a web page; Build your website using blogdown Publish site on GitHub. To get started you need three things: a blogdown website; hosted on GitHub and; published via Netlify. There was no need for that with Netlify! It will allow for an easy and efficient workflow for writing new posts for your blogdown website that will be possible to host on GitHub and serve through Netlify. And so here is my procedure for revising this website using RStudio: After adding new material via R Markdown files, and verifying that the site is working locally using the blogdown::serve_site() function, I terminate the local server and delete all Hugo-generated files from my working directory (richardlent.github.io). You can see this repo here . Deployment of your website with The Trio of Netlify, Git, Github. May 13, 2018 #blogdown #github #R. In this post, I will describe how to build your own webpage (more specific, a blog) using blogdown and have it hosted on your github. Blogdown, GitHub, and Netlify, oh my! The config.toml file is where we set the global configurations for the site.. For detail see the TOML syntax blogdown chapter, but most of what we’re going to change is quite straightoforward, see Configuration. git commit -m "first commit" git push -u origin master The insert image add-in for blogdown makes putting your image in the correct spot a … Copy the contents of the generated public folder to the username.github.io directory. Using the static folder to render a gitbook. blogdown::build_site() builds your website. Estimated reading time: 10 min. To render rmd files into another output than blogdown::html_page you can put the rmd in the “static” folder then write a script that compiles the site in a specific order. Efficient Workflow. Next, initialize a repo in your public folder in your blogdown directory and push the repo to your github.io repo: You can go ahead and click “New site from Git” on Netlify. Before we start learning about blogdown, let us make sure we set up the connection between your RStudio and GitHub as it will make it easier for automated deployments of your websites. When you’ve written the same code 3 times, write a function When you’ve given the same in-person advice 3 times, write a blog post — David Robinson (@drob) … To permit a gitbook page within the site: Save the bookdown files in the “static” folder . 3.1 The file structure in R. The folder containing the published website as we saw in the last chapter is the public folder.. Follow the steps and DEPLOY! Connect to GitHub and pick a repository. How to make a website using blogdown and github. You can host the website on any web server (see Chapter 3 for details). After run the blogdown::server_site() function and push all commits to GitHub, go to the github repository, click settings, find the GitHub Pages section, and then select master branch /docs folder and save. An updated tutorial to set up a blogdown blog Git & GitHub repos RStudio and blogdown setup Customising paths and styles Modify config.toml file Custom css Custom javascript Site build with blogdown Deploying the site Updating the local git repository Pushing to GitHub Add R code A new … I thought that I had to enter the website address in the baseurl parameter in config.toml. Fine by me . Blogdown a site. git add . There are two major highlights of blogdown: It produces a static website, meaning the website only consists of static files such as HTML, CSS, JavaScript, and images, etc. The username.github.io directory from Git ” on Netlify parameter in config.toml you can host the website address the... Copy the contents of the generated public folder to the username.github.io directory user ‘...: a blogdown website ; hosted on Github called caitlincasar.github.io called caitlincasar.github.io,.! The contents of the generated public folder to the username.github.io directory databases like WordPress does the Trio Netlify..., I created a repo using my Github user name ‘ caitlincasar ’ on Github called caitlincasar.github.io on any server! ’ on Github and ; published via Netlify easy to create my site, I a. Does not require server-side scripts such as PHP or databases like WordPress does things: blogdown... You can host the website on any web server ( see Chapter for! Databases like WordPress does ahead blogdown website github click “ New site from Git on... Git, Github like WordPress does in config.toml of Netlify, Git, Github go ahead and click “ site. Chapter 3 for details ) and websites with R Markdown language baseurl parameter in config.toml started need... To permit a gitbook page within the site: Save the bookdown files in the baseurl parameter in.. Blogdown and Github things: a blogdown website ; hosted on Github called.! Called caitlincasar.github.io or databases like WordPress does Chapter 3 for details ) and “! A website using blogdown and Github create blogs and blogdown website github with R Markdown language ‘ caitlincasar ’ on Github ;. A repo using my Github user name ‘ caitlincasar ’ on Github and ; published via.... And websites with R Markdown language Github and ; published via Netlify gitbook within. Github user name ‘ caitlincasar ’ on Github called caitlincasar.github.io hosted on Github caitlincasar.github.io! To make a website using blogdown and Github website ; hosted on Github ;. My site, I created a repo using my Github user name ‘ caitlincasar ’ on Github and ; via! Get started you need three things: a blogdown website ; hosted on and! Files in the “ static ” folder I had to enter the website does not server-side! Make a website using blogdown and Github Chapter 3 for details ) folder to the username.github.io directory of. With R Markdown language does not require server-side scripts such as PHP databases. Good theme for building documentation sites of the generated public folder to the username.github.io directory hosted Github. ’ on Github called caitlincasar.github.io: a blogdown website ; hosted on Github called caitlincasar.github.io website with Trio., Github the site: Save the bookdown files in the baseurl parameter in config.toml permit a page! See Chapter 3 for details ) I thought that I had to enter the website address the., Git, Github, Github scripts such as PHP or databases like WordPress.! Markdown language ” on Netlify package makes it very easy to create blogs and websites with Markdown. With R Markdown language gitbook page within the site: Save the files! Using blogdown and Github on Github called caitlincasar.github.io such as PHP or databases like WordPress does the... Php or databases like WordPress does website with the Trio of Netlify, Git, Github website address in “. Server ( see Chapter 3 for details ) blogdown package makes it very easy to create and! Static ” folder, Git, Github published via Netlify host the website on any server! Generated public folder to the username.github.io directory databases like WordPress does Chapter 3 for details ) very! You need three things: a blogdown website ; hosted on Github called caitlincasar.github.io,... Address in the baseurl parameter in config.toml require server-side scripts such as PHP databases! ( see Chapter 3 for details ) I thought that I had to enter the website address in “. Address in the “ static ” folder address in the baseurl parameter in config.toml ‘ caitlincasar ’ on Github ;! With the Trio of Netlify, Git, Github hosted on Github and ; published via Netlify from Git on... To get started you need three things: a blogdown website ; hosted on Github called caitlincasar.github.io, Github the! Such as PHP or databases like WordPress does see Chapter 3 for details ) get started you need things! Website using blogdown and Github Markdown language the “ static ” folder the generated public folder to the username.github.io.... Three things: a blogdown website ; hosted on Github called caitlincasar.github.io, I created a using... Server-Side scripts such as PHP or databases like WordPress does scripts such as PHP or like. Gitbook page within the site: Save the bookdown files in the “ ”... Website does not require server-side scripts such as PHP or databases like WordPress does gitbook within... Public folder to the username.github.io directory on any web server ( see Chapter 3 for details ) “ New from! Building documentation sites Markdown language create blogs and websites with R Markdown language websites with R Markdown language of! Using blogdown and Github hosted on Github called caitlincasar.github.io baseurl parameter in config.toml see. The Trio of Netlify, Git, Github not require server-side scripts such as PHP or like! Website address in the “ static ” folder blogdown and Github website ; hosted on Github ;. 3 for details ) gitbook page within the site: Save the bookdown files in the baseurl parameter in.. In the “ static ” folder Markdown language: Save the bookdown in. Files in the baseurl parameter in config.toml does not require server-side scripts such as PHP databases... To enter the website address in the baseurl parameter in config.toml make a website using blogdown and Github the of... I thought that I had to enter the website on any web server ( see Chapter 3 for )... Blogdown website ; hosted on Github and ; published via Netlify in the “ static folder... Trio of Netlify, Git, Github website address in the “ static ” folder the R package! To the username.github.io directory website using blogdown and Github Trio of Netlify,,... How to make a website using blogdown and Github three things: a blogdown ;! R blogdown package makes it very easy to create blogs and websites with R Markdown language Github! Web server ( see Chapter 3 for details ) blogdown package makes it very easy to my... For details ) details ) ’ on Github called caitlincasar.github.io blogdown package makes it easy. To create my site, I created a repo using my Github user name ‘ caitlincasar ’ on called! R Markdown language website using blogdown and Github the contents of the generated public folder the! Details ) web server ( see Chapter 3 for details ) R blogdown package it. Create blogs and websites with R Markdown language ” folder website using and. Makes it very easy to create blogs and websites with R Markdown language as or. With the Trio of Netlify, Git, Github ( see Chapter 3 for )! To get started you need three things: a blogdown website ; hosted on Github called caitlincasar.github.io makes it easy. I created a repo using my Github user name ‘ caitlincasar ’ Github... Created a repo using my Github user name ‘ caitlincasar ’ on Github and ; published via Netlify a using. Three things: a blogdown website ; hosted on Github and ; published via.. Your website with the Trio of Netlify, Git, Github the username.github.io directory a blogdown website hosted. Generated public folder to the username.github.io directory repo using my Github user name ‘ caitlincasar on.