首页 > 解决方案 > 如何在 github 上使用 bookdown.org?

问题描述

我正在尝试在 Github 上创建一本书,老实说,我没有时间学习如何编码和深入研究所有新的术语/技术,也没有时间学习 Github 的来龙去脉,因为它真的不是用户友好的。

所有的教程都太密集了,不适合初学者。我只想为我的书生成内容。我怎样才能做到这一点?我很擅长使用模板并根据我的需要进行调整,但我什至无法让模板工作。

Github 上有很多书籍(bookdown.org 展示了很多案例)。我相信您能够查看文件/代码以及 Github 上没有的内容,因此在那里获取几个必要的文件可能非常容易。我不知道哪些是重要的,即使我知道了,我也不知道如何让它与我的 Github 一起工作。

标签: githubgithub-pagesbookdown

解决方案


您可以 forkrstudio/bookdown-demo并将其设为您自己的 GitHub 存储库。

从那里,遵循yihui/bookdown/get-started.html,至少:

  1. 将 GitHub 存储库https://github.com/rstudio/bookdown-demo下载为 Zip 文件,然后在本地解压缩。
    所以那里不需要“Git/GitHub 软件”。
  2. 安装 RStudio IDE。请注意,您需要高于 1.0.0 的版本。如果您的 RStudio 版本低于 1.0.0,请下载最新版本。
  3. 安装 R 包 bookdown:
     # stable version on CRAN
     install.packages('bookdown')
     # or development version on GitHub
     # devtools::install_github('rstudio/bookdown')
    
  4. 通过单击 打开您在 RStudio 中下载的 bookdown-demo 存储库bookdown-demo.Rproj
  5. 打开 R Markdown 文件index.Rmd并单击Build BookRStudio 的 Build 选项卡上的按钮。

尝试一个最小的例子,比如yihui/bookdown-minimal


推荐阅读