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

Question

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

很多参加Coursera 数据课程的人，如果他们不是来自计算机科学，就会遇到问题，包括我自己，所以我想分享一个有效的系统。我相信它可以大大改进。

Answer 1

让我们一步一步来，非常简单：

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

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

快速检查：再次单击设置，然后在 GitHub 页面下检查消息：“您的站点已发布在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。单击确定。现在您可以修改、添加或保留屏幕上弹出的内容以完成演示。请注意，有一些以“{r}”开头的所谓代码块，表示在渲染 html 文档（或 pdf）时将执行以下代码。echo=FALSE意味着只会打印代码的结果（而不是实际的命令）。

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

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

我们现在正朝着相反的方向前进。首先，单击顶部菜单上的 GiT 超酷符号（在“knit HTML”上方，具体取决于您的 RStudio 的配置）。这是一个下拉菜单。选择提交。您可以选择cars.html或所有内容。忽略警告消息，并在“提交消息”下发布超短注释。无论你想写什么（例如“更新”？）。单击“提交”按钮 - 非常重要！现在您已准备好单击“推送” ……您猜对了……这是绿色按钮。系统将提示您输入您的 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图标才能编辑此文件。完成后点击Commit changes。返回浏览器以查看您的网站。刷新，直到它使用您刚刚嵌入的超链接进行更新。单击它...您现在正在在线观看您的 RStudio 工作。魔法！

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

祝你好运！