Hosting bookdown in github

Anybody knows how to publish my bookdown into github?


Read all about it in Publishing Bookdown to github by @yihui


Thank you. The link is a little bit confusing for me (a lot of technical terms). Do you have some of video or another simple tutorial @technocrat


and the collection of related videos at

However, there's really no substitute for DIY and sweating the small stuff from a minimal working example, such as the one given in the primary resource and working your way through increasing bells and whistles.

When, back in the second Reagan administration, I was a law student, my classmates spent a ton of money and time looking for the answers in a variety of so-called hornbooks and other study guides when they should have been paying attention to the questions. I was lucky. My contracts prof told us that everything we needed to know was in the table of contents of the casebook, and the rest was merely detail. Needless to say, I didn't believe him at first, and I kept looking for the answers until I was called to jury duty.

I looked around. There was the judge, the bailiff, the court clerk, the stenographer, the plaintiff's attorney and the defendant's attorney. I did the math. As a juror, it would be my job to give an answer guilt/not guilty or liable/not liable. I got paid $10/day plus parking. At that time, the lawyers were probably getting around $250/hour for knowing the right questions to asked. That's what tripped me to the realization that the questions are far more important than the answers. The same question will always have different answers.


Thank you-@technocrat. I will try it.

If your question's been answered (even by you!), would you mind choosing a solution? It helps other people see which questions still need help, or find solutions if they have similar problems. Here’s how to do it:

1 Like

If you mean you would like to use GitHub pages to publish or deploy your bookdown project and:

a) you would like to place the rendered book (i.e., the folder _book is not in your .gitignore file) on GitHub
b) further, you are OK with placing your rendered book in a folder on your "master" GitHub branch
c) even further, you are OK with using a project domain name like http(s)://<username><projectname>

Then you can take advantage of a neat trick with GitHub pages which allows you publish to GH pages from the master branch /docs folder. To do that:

  1. Configure source for GH pages through GitHub website as master branch /docs folder
  2. Go to your _bookdown.yml file and add output_dir: "docs" on a line by itself
  3. Serve/preview your book locally
  4. Push to GitHub, you should see it there.

This topic was automatically closed 21 days after the last reply. New replies are no longer allowed.