如何使用 bookdown.org 和 github？

Question

我正在尝试写一本关于 Github 的书，但老实说，我没有时间学习如何编码和深入研究所有新的 terminology/technology 以及学习的来龙去脉Github因为它真的不友好。

所有的教程都过于密集，不适合初学者。我只想为我的书生成内容。我怎样才能做到这一点？我非常擅长使用模板并根据我的需要对其进行调整，但我什至无法使用模板。

• 我已经在 R 中安装了 bookdown 包并在 R 中打开了样本书。如何将这本样本书放到 Github 网站上？我刚刚上传了所有文件，当我访问我的网站时，它只带我到 README.md
• 我正在通过我的浏览器使用 Github，不打算安装现有的任何 Github 软件和所有类似的东西。实在没时间深究怎么用Github。所以任何教程都需要我通过浏览器使用 Github。
• 在为我的书写内容时，有什么方法可以在 Github 上完成，还是在 Rstudio 中完成最简单？
• 我不太想把我的书上传到 bookdown.org。我还能在 github 上建立我的网站吗？
• 我需要将 Rmd 文件转换为 md 文件吗？我该怎么做？

关于 Github 的书籍很多（bookdown.org 案例很多）。我相信您可以查看 files/code 和 Github 上没有的内容，因此只需在那里获取几个必要的文件就可以很容易。我不知道哪些是重要的，即使我知道，我也不知道如何让它与我的 Github.

一起工作

Answer 1

您可以 fork rstudio/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. 通过单击 bookdown-demo.Rproj 打开您在 RStudio 中下载的 bookdown-demo 存储库。
5. 打开 R Markdown 文件 index.Rmd 并单击 RStudio 的“构建”选项卡上的按钮 Build Book。

尝试用一个像 yihui/bookdown-minimal

这样的最小示例