Update global options documentation in book

[apreshill]

Hi @yihui,

I hope it is OK for me to place there here- I would like to update this section after our workshop next week to reflect additional global options listed here: https://github.com/rstudio/blogdown/edit/master/docs/01-introduction.Rmd.

Also, I would like to reference the usethis::edit_r_profile() function here- it alerts users to the empty line rule at the end of the file in a user-friendly way.

Again, I'm assigning this issue to myself (if that is OK with you!).

Alison

[yihui]

I hope it is OK for me to place there here- I would like to update this section after our workshop next week to reflect additional global options listed here: https://github.com/rstudio/blogdown/edit/master/docs/01-introduction.Rmd.

Sorry, but I didn't get it: which additional options do you want to update in Section 1.4? Note that there are more options documented in the appendix: https://bookdown.org/yihui/blogdown/more-global-options.html

Also, I would like to reference the usethis::edit_r_profile() function here- it alerts users to the empty line rule at the end of the file in a user-friendly way.

Sounds good.

Again, I'm assigning this issue to myself (if that is OK with you!).

Sure!

[apreshill]

Specifically, I don't see blogdown.title_case as a global option, which I like (for the appendix).

For the main overview, I think the blogdown.new_bundle = TRUE needs to at least be mentioned- many current Hugo themes are using page bundles "out of the box" (like the Academic theme's most recent versions). New users are going to be confused by this. I realize this probably means some updates to the "Content" section as well, but I was making my notes for updates sequentially :)

[yihui]

WAT. I forgot to document my proudest blogdown.title_case?! Oh please feel free to add this one and other ones I forgot. You need to be terse when explaining the options in the table so the table won't be too wide in PDF.

Please feel free to improve the documentation of page bundles, too. Thanks!

BTW, we should also mention that the data/ directory is NOT for R: #356

[apreshill]

Good points- I'll go through a do more thorough edit/update. Also I want to add info regarding .netlify.toml files.

[yihui]

Yes, netlify.toml. Absolutely.

[maelle]

Ah, I was wondering where the exhaustive list of options lived! I am thrilled to learn about blogdown.title_case!

[yihui]

@maelle Sorry, I didn't mean to keep this option to myself: https://github.com/rbind/yihui/blob/0d4dd3a/.Rprofile#L6-L9 It is documented on the help page ?blogdown::new_post, but it certainly deserves a paragraph or two in the blogdown book.