How to get started with the bookdown package

For more, see the full blog post at rfortherestofus.com/2022/04/b...
If you want to receive emails to help you on your R journey, sign up for the R for the Rest of Us newsletter: rfortherestofus.com/newsletter

[@giacomobovo5729]

Best tutorial i've seen to get started with this package, tank you very much!

[@123XDmisterin]

Thank you very much! It's a nice and clear tutorial with all the necessary features :)

[@nand1sh]

Thank you so much for this.

[@akepilinggiehili5320]

Thank you was searching for like this basic one

[@kevalan1042]

Nice! Would love a follow up, on 1) how to deal with references/bibliography, 2) how to export to ebook formats like epub/mobi, 3) how to best handle math symbols and equations

[@davidgkeyes]

I haven't done 1 and 3 so I don't have anything to offer there. On 2, it creates that every time you build your book.

[@kevalan1042]

@@davidgkeyes Having played around with it for a week: For #1 RStudio is nicely integrated with the Zotero open source tool. #3 works well out of the box for HTML and PDF outputs, however it's less nice with EPUB/MOBI (math typesetting is a bit ugly).

[@felipeperilla]

Thanks a lot, David!

[@rfortherestofus]

You are welcome!

[@oblatiosui]

Thanks for this! Great video tutorial, I wonder though if there's a way rendered pages can be hidden based on RBAC? I mean not all pages/sections to be seen but some are kind of restrcted. TIA!

[@rfortherestofus]

There isn't a way built into bookdown. This is something I and many people have wondered about, though. See twitter.com/dgkeyes/status/1387876087334543360

[@oblatiosui]

@@rfortherestofus Thanks for the tip, I think we are using the ShinyApp so need to probably push in that direction and just separate the docs into different audiences.

[@evaldosilva786]

Great video, David. Could you prepare a video explaining how to prepare a book in PDF format using bookdown?

[@rfortherestofus]

When you build the whole book, it also creates a PDF file automatically. See bookdown.org/yihui/bookdown/build-the-book.html

[@fyzen568]

How to chosse? bookdown or quarto book?

[@ShadArfMohammed]

Thanks for sharing this, is it possible to show the rendered version directly on github ? or it should be on Netlify ?

[@rfortherestofus]

You could use GitHub Pages to show the rendered version, but not GitHub itself (that's just for showing the source code). Hope that helps!

[@ShadArfMohammed]

@@rfortherestofus thanks a lot for the reply. I will try to do so.

[@larem8435]

What if I have already knit my markdown files to html and I want to put several html files in a book without having to run/use the rmd files, how would one do this?

[@davidgkeyes]

I'm not sure I understand your question. Do you mind elaborating?

[@larem8435]

@@davidgkeyes yea no problem, I have RMD files that ive already knitted to html and theyre perfect, they have dark theme and table of contents on the side that let you click to a section in the project just the way i want, and I want to put these all together into one book only using the html files because I dont want to rerun the models used in the RMD files they will take too long and things might not work the same anymore

[@rfortherestofus]

​@@larem8435 I believe you could just add them to a new project and follow the instructions in my video, creating a _bookdown.yml file that lists them all. This will have them be part of your book.

[@dskevinperezgarcia]

what about files to be ignored by git?

[@rfortherestofus]

You can edit your .gitignore file just like any other project. Is that what you're asking about?

[@dskevinperezgarcia]

@@rfortherestofus When creating a bookdown, what files should it ignore other than the ones that are usually ignored by an R project? It seems to me that some extra files are created like when one works with LaTeX.

[@rfortherestofus]

@@dskevinperezgarcia It's a good question, but it's not something I've had to deal with. I just left the default .gitignore and it works fine.

[@dskevinperezgarcia]

@@rfortherestofus gracias por tu respuesta.

[@rfortherestofus]

@@dskevinperezgarcia Con mucho gusto!