R blogdown 简介和安装

R blogdown 是什么

• R语言的一个扩展包，用来制作网站的工具。
• 可以用非常简洁的方式快速搭建静态网页构成的网站。
• 虽然名字里有“博客”（blog）字样，但并不仅限于博客。非常适合搭建一个科研小组的展示窗口。
• 基于 markdown 扩展语法，可以在网页中方便地插入图表、脚注、数学公式、R 代码等元素。
• 非常容易将 bookdown 生成的论文转化成网页展示。
• 非常易于维护，迁移，备份。

本书的官方网站就是用 R blogdown 搭建的。网站里给大家提供的 R 示例代码、试读章节、勘误表等，都是直接从书稿中拷贝粘贴到文本文件里，然后运行一下 blogdown 的指令，网站就自动更新了。

安装

blogdown 的背景平台是 R 语言，用户界面首选 RStudio ，产生的网站框架是 Hugo ，掰手指头数一数，要安装4样东西，略显繁琐，但并不难，一劳永逸。安装方式如下：

• R。去R的服务器CRAN，点击Download R for Windows（其他操作系统的用户请自便），在打开的新网页最上方点击base，就找到下载链接了。下载完毕后安装，一路“下一步”的傻瓜式安装即可。
• RStudio。去官网下载安装文件运行即可。
• blogdown。运行RStudio，在左上面板的代码窗口输入并运行以下代码：

if(!require(devtools)) install.packages('devtools')
devtools::install_github('rstudio/blogdown')

解释一下：由于 blogdown 目前只发布到了 GitHub 服务器上，尚未发布到CRAN，所以上面第一条代码先安装开发工具 devtools 包，第二行用这个包的install_github() 函数从 GitHub 安装。

• Hugo 框架。在 RStudio 左上面板的代码窗口输入并运行以下代码：

blogdown::install_hugo()

安装完毕。

用 R blogdown 搭建个人博客

<p>
  <strong>创建示例网站</strong>
</p>

<p>
  我在自己博客建立了个子站，作为 R blogdown <a href="http://pzhao.org/blogdown_demo_default/">个人博客的示例</a>。下面我们看看这个博客是如何创建的。
</p>

<p>
  首先，在你的电脑里新建一个文件夹，准备存放网站文件，假定是<code>c:\blogdown_default</code>，那么创建网站只需在RStudio里运行两行代码：
</p>

<pre class="r"><code>setwd('c:\\blogdown_default')

blogdown::new_site()

<p>
  示例网站搭建完毕。对，就这么简单！
</p>

<p>
  去<code>c:\blogdown_default</code>看看吧，出现了好多新文件夹。别的不用管也不用动，只注意两个<code>content\</code> 和<code>public\</code> 就行了。打开 <code>public\</code>，打开里面的index.html，这就是网站的主页。随便点开上面的几个链接试试看。
</p>

<p>
  <strong>发布到网上</strong>
</p>

<p>
  上面搭建的网站，目前只存在于本地电脑里，下面我们发布到网上。
</p>

<p>
  如果你像我一样，已经有了自己租用的服务器，上面有了WordPress博客，那最简单，在服务器的<code>public_html\</code>文件夹下面创建一个新文件夹，例如叫做<code>test</code>，那么只需将刚刚在本地新建的博客或科研网站的 <code>public</code>文件夹里所有文件上传到服务器的<code>test</code> 文件夹即可。访问<code>你的域名/test</code>，就可以看到新网站了！
</p>

<p>
  如果你没有自己的服务器，那么最简单的是在 <a href="https://www.netlify.com/">netlify</a> 免费注册个账号，然后按提示将你本地的 <code>public\</code> 文件夹拖进去，会自动布署，等几分钟，就可以访问了。你可以免费申请个子域名，也可以买个自己的域名绑定上去。我已经申请了一个，打算作为<a href="http://zhao.netlify.com/">自己的科研主页</a>。这是从blogdown 创建的科研网站示例（创建方法见下文）修改而来的，而且还没改完，里面的英文内容都是示例里别人的工作。
</p>

<p>
  那么，如何将自动生成的网站更新成自己的，并添加新内容呢？
</p>

<p>
  <strong>网站更新</strong>
</p>

<p>
  前文提醒你注意，新建的网站文件夹里有个<code>content\</code>文件夹。这里就是更新网站内容的地方。你只需用记事本或RStudio，打开其中的<code>.md</code>或 <code>.Rmd</code> 文件，修改成自己的内容后保存，然后运行建站函数：
</p>

<pre class="r"><code>blogdown::build_site()</code></pre>

<p>
  这样，<code>public\</code> 就自动更新了，再发布到网上即可。
</p>

<p>
  <code>.md</code>或 <code>.Rmd</code> 文件使用 markdown语法，见我以前写的帖子：
</p>

<ul>
  <li>
    <a href="http://pzhao.org/archives/17033">九分钟学会 Markdown</a>
  </li>
  <li>
    <a href="http://pzhao.org/archives/17712">精品网络应用：Markdown篇</a>
  </li>
  <li>
    <a href="http://pzhao.org/archives/19141">R bookdown 快速入门和语法速查</a>
  </li>
</ul>

<p>
  如果要发表新帖子，那么有两种方式最简单： 1. 方法一：将原有的<code>.md</code>或 <code>.Rmd</code>拷贝粘贴，改一下标题和内容即可； 2. 方法二：在RSudio代码窗口点击 Addins- New Post， 按提示填写即可。
</p>

<p>
  写完保存，运行建站函数，上传。好了。
</p>

<p>
  <strong>自动同步</strong>
</p>

<p>
  也许你嫌每次更新上传太麻烦。我们当然可以选择自动同步。
</p>

<p>
  如果网站搭建在Netlify，那么只需做三件事：
</p>

<ol style="list-style-type: decimal">
  <li>
    下载并安装 GitHub 客户端，申请个免费账号，并创建一个项目，例如叫做myweb，将前面我们举例的<code>c:\blogdown_default</code> 文件夹设为项目的文件夹，并同步到云端。
  </li>
  <li>
    在你的Netlify设置里，设为自动跟你的GitHub里的myweb项目同步，同步内容是 <code>public</code>文件夹。
  </li>
  <li>
    以后每次更新并运行完建站函数后，在GitHub客户端同步一下即可。
  </li>
</ol>

用 R blogdown 搭建科研网站

<p>
  上文说到，我申请了一个Netlify免费账号，并且创建了<a href="http://zhao.netlify.com/">自己的科研主页</a>，是从blogdown 创建的科研网站示例修改而来的。这个示例的本来面貌可以来我博客上看：<a href="http://pzhao.org/blogdown_demo_academic/">科研网站的示例</a>。这个科研网站的构架比个人博客复杂，有简介、新闻、发表论文、科研项目等基本模块，还可以根据需要新增，非常适合作为科研小组的展示窗口。
</p>

<p>
  这个网站的搭建也很简单，跟个人博客类似。在你的电脑里新建文件夹，比如 <code>c:\blogdown_academic</code>，在RStudio里运行两行代码：
</p>

<pre class="r"><code>setwd('c:\\blogdown_default')

blogdown::new_site(theme=‘gcushen/hugo-academic’)

<p>
  去<code>c:\blogdown_academic</code> 看看吧，科研网站搭建完毕！
</p>

<p>
  但是，如果你这时双击打开<code>c:\blogdown_academic\public\index.html</code> 的话，会发现界面并不好看（css未载入），并且点击页面的那些链接也无效。别急，我们再做个小改动就行了。
</p>

<p>
  用记事本将<code>c:\blogdown_academic\config.toml</code> 打开，删掉第一行，然后添加下面两行并保存文件。
</p>

<pre><code>baseurl = "/"

relativeurls = true

<p>
  然后在RStudio运行建站函数<code>build_site()</code>：
</p>

<pre class="r"><code>blogdown::build_site()</code></pre>

<p>
  好了，现在可以打开<code>c:\blogdown_academic\public\index.html</code> 正常浏览了！
</p>

<p>
  解释一下：config.toml 文件里的默认设置不支持本地浏览，而且发布到网上时需要重新布署（见下一步）。这里改成相对路径<code>relativeurls = true</code>，就可以直接在本地打开 index.html 浏览了。
</p>

<p>
  其他的发布、更新、同步，跟前文讲述的一致，这里不重复了。需要特别指出的是，<strong>科研网站</strong>示例的首页，个人信息需要在前面提到的<code>config.toml</code>里的<code>[params]</code> 修改。其他的功能我也在慢慢摸索中，欢迎一起探讨。
</p>