6.1 RStudio Connect
理论上,你可以自己编译书籍然后将其发布到你想要的任何地方。例如,你可以在自己的 Web 服务器上托管书籍的 HTML 版本。不过我们在 bookdown 中提供了一个函数 publish_book()
,它能够让你很轻松地将书籍上传至 https://bookdown.org。这是一个由 RStudio 提供的网站,用于免费托管你的书籍。这个网站建立在 “RStudio Connect” 之上,它是 RStudio 提供的产品之一,能够让你将各种与 R 相关的应用部署到服务器上,包括 R Markdown 文档、Shiny 应用、R plots 等。
你不必了解太多 RStudio Connect 就能够将你的书籍发布到 bookdown.org。你需要在 https://bookdown.org/connect/ 注册,之后当你第一次尝试运行 bookdown::publish_book()
时,系统将要求你授权 bookdown 发布到你的 bookdown.org 账户。以后使用时,只需要再次调用 publish_book()
即可,bookdown 将不会要求你进行任何其他的操作。
你需要接触的 publish_book()
的唯一参数是 render
。它决定了在发布之前是否编译书籍。如果你之前已经运行过 render_book()
,就不需要改变这个参数,否则你可能需要将其设置为 'local'
:
如果你已经配置好了自己的 RStudio Connect 服务器,那么当然可以将书籍发布到你自己的服务器,而不必上传至 bookdown.org。