GitHub 网站发布“Knit”-RStudio 中生成的 HTML 文件

Question

我想分享一个关于如何使用 GitHub 页面在 RStudio 上在线发布您的作品的分步说明。

很多使用Coursera courses on data 的人如果不是来自计算机科学，包括我自己在内，都会遇到问题，所以我想分享一个有效的系统。我相信它可以得到很大的改进。

Answer 1

让我们一步一步来，真的很简单：

1. 从Github开始，而不是从RStudio开始。

没有帐户，注册一个 - 它是免费的，而且非常有价值。现在转到 Repositories（顶部菜单栏），然后按右上角的绿色按钮 New -手角。为存储库命名（为我们的目的命名为“test”）。如果您急于向自己证明它有效，您可以跳过描述（对于在 README 下编写一些备忘录样式的单行符的提示也是如此）。所以去吧...点击创建存储库（绿色按钮）。现在不要惊慌...直接进入设置（右侧垂直菜单中的齿轮符号）。完美的！再点击一下，我们就到了……启动自动页面生成器。现在我们进入引导部分。暂时保留所有这些内容......我们可以稍后对其进行修改，或者当我们知道故事的结尾时我们可以回去重新做一遍（我们确实打算发布一个真实的存储库。点击Continue to layouts。点击任何设计（我选择“建筑师”）...然后发布页面（右上角的绿色按钮）。漂亮！

快速检查：再次点击设置，然后在 GitHub Pages 下检查消息：“您的网站发布在 http://...github.io/test . 在我的情况下，地址是 http://rinterested.github.io/test/ （是...我在完成这篇文章后删除了它）因为我的 Github 帐户是 RInterested。非常关键：注意结构： github.io 没有这个就没有网站。现在你可以去你的浏览器，输入地址并看到一个新的网站已经诞生了（注意：有时这需要几分钟才能实现）。

2。现在是时候使用 RStudio了。如果您参加 Coursera 课程，这是您的舒适区。如果不是，我会假设您一直在使用 [R]，并且简单下载 RStudio（免费在线）将使您的生活变得更好。

所以我们启动 RStudio 并转到右上角，那里有一个包含 R 和单词 Project 的立方体。看见？太好了，因为我们要从下拉菜单中启动一个新项目。弹出...选择哪一个？ 版本控制就是答案。更多弹出窗口...不要惊慌...单击灰色/红色/绿色侧面的 GIT 符号（“Git Clone a project from a Git repository”）。我们有，记得吗？我们称之为“测试”。我们正面临一个需要填写三个字段的最终屏幕。在 Repository URL 下，我们需要输入需要快速返回 Github 的信息...

你在吗？好的...您是否看到 HTTPS 克隆 URL 在右侧带有剪贴板符号，位于测试存储库的一半？单击剪贴板符号...已复制！伟大的！现在我们回到 RStudio 上的问题屏幕，我们被重新路由，然后右键单击并粘贴，填写调查表的 Repository URL 字段。其余的并不重要。按创建项目...就是这样！

3.该开始工作了。 现在让我们通过单击左上角下拉菜单中的相应选项（一张纸上的绿色加号）来创建一个新的 R Markdown 文档图标）。给它一个名字。你是作者。选择 HTML。单击确定。现在您可以修改、添加或仅保留屏幕上弹出的内容以完成演示。请注意，有所谓的 chunks 代码以 ``{r} 开头，这表明以下代码将在呈现 html 文档（或 pdf）时执行。 echo=FALSE 表示只打印代码的结果（不是实际的命令）。

好的。按下顶部菜单，您会看到一个编织针 (Knit HTML)...为其命名并保存文档...非常重要...无论您给它起什么名字，它都必须结束在.Rmd（区分大小写）。那么“cars.Rmd”呢？足够原始...保存并观看 RStudio 发挥它的魔力...希望您现在正在欣赏一个带有图表和数字的漂亮网页...只有一个问题...它不在线。

4.将我们的工作推送到 GitHub：

我们现在正朝着相反的方向前进。首先，单击顶部菜单上的 GiT 超酷符号（在“编织 HTML”上方，具体取决于您的 RStudio 的配置）。这是一个下拉菜单。选择提交。您可以选择 cars.html 或所有内容。忽略警告消息，并在“提交消息”下发布超短注释。无论你想写什么（例如“更新”？）。点击提交按钮 - 非常重要！现在您可以点击Push...您猜对了...这是绿色按钮。系统将提示您输入您的 Github 帐户用户名和密码。这样做。

5.返回 GitHub：

刷新显示我们的“测试”存储库的页面。您现在应该会看到其他文档，包括 cars.html

快速检查：转到您的浏览器并在 URL 栏中输入对我来说是 rinterested.github.io/test/cars.html（请记住，您可以通过如上所述进入设置），然后只需标记我们使用 RStudio 处理的文档的名称。

6.超链接页面：

作为测试，点击“test”存储库下的“index.html”并在其中某处，在正文中嵌入以下内容：

Click <a href="cars.html">here</a> to go to cars.

您必须单击pencil 图标才能编辑此文件。完成后点击提交更改。返回浏览器以查看您的网站。刷新，直到它被您刚刚嵌入的超链接更新。单击它...您现在正在在线观看您的 RStudio 功能齐全。魔法！

现在只需使用一些可在线快速访问的 html 代码进行更改，更改 index.html（主页）上的措辞，或者从头开始构建一个具有内部凝聚力的漂亮网站。

祝你好运！

Answer 2

另一种（更手动的）方法 - 跳过初始答案中涵盖的任何内容。

1.在 GitHub 中创建存储库

我们将其称为 Course_project，无需 README - 我们只需要它的 URL。

2。打开 Windows PowerShell（或 Git Bash）

打开 Git Bash 很简单，只需在 Windows 资源管理器中右键单击我们要选择的目录，然后单击 Git Bash here。我将使用 PowerShell。您可以通过键入pwd 来获取您所在的目录。从那里我们可以键入ls 来列出子文件夹，一直在更改目录以到达我们想要的位置 - 例如cd R 以获取R 作为工作目录。

通过键入https://github.com/RInterested/Course_project.git 克隆项目（我很感兴趣，因此请将该部分更改为您的 GitHub 用户名；还要记住“Course_project”是该项目的名称）。通过键入cd Course_project 将目录更改为Course_project。我们现在创建一个没有父分支的分支：git checkout --orphan gh-pages。通过键入以下内容确保克隆的 Course_project 为空：git rm -rf . 我们将很快使用真正的 RStudio 降价，但为了测试我们到目前为止所做的工作，我们可以在空的工作目录中键入网页名称：echo "Test Page" > index.html。现在是时候添加/提交/推送：git add index.html，然后是 git git commit -a -m "first commit" 和 git push origin gh-pages。此页面现在可见于：http://RInterested.github.io/Course_project/index.html。

3.使用 RStudio 创建内容

我们有一个目录 (Course_project) 和一个玩具 index.html 在里面......我们需要真实的内容。所以我们去 RStudio。创建一个R Markdown 文件并将其命名（我称它为mtcars）。检查 HTML 作为输出。更改文档（上面的答案中有关它的一些信息）。最后，重要的一步：将其保存为Index.Rmd（确保R工作目录与PowerShell中相同）。点击knit HTML创建html文件，渲染R Markdown中嵌入的R代码。

4.使用 PowerShell 向上游推送

现在我们在目录 Course_project 中有资料，但它不在线 - 它仍然是本地的（您可以使用 Windows 资源管理器转到它并查看“索引”下的 html 文件）。键入git status 以查看所做的更改，然后再次按照常规添加/提交/推送：git add .，然后是git commit -a -m "commit"，和git push origin gh-pages。

一段时间后，该页面将在http://RInterested.github.io/Course_project/index.html中生效

5.添加第二个页面

我们现在可以在 RStudio 上创建第二个 R Markdown 文件（我将其标记为 Second_page 并将其保存为 Second_page.Rmd。写完我们想要的内容后编织 HTML，我们可以看到这两个新文件出现在 Course_project 本地文件夹中。我们只需像以前一样在 PowerShell 中添加/提交/推送。新页面将在 @ 987654323@。现在很容易在第一个 (index.Rmd) 上键入一个超链接到第二个 (Second_page.html)，编织 index.Rmd，然后将其推送到网络上。