博客搬运说明

新的博客，需要用 markdown 格式进行编写，希望各位去参考 markdown 的编写格式。在搬运博客的过程中，务必把这篇博客当做自己的博客进行搬运，我会在最后做个审查，保证博客搬运的质量。

如果你不熟悉 markdown，请务必学习一下 markdown 的基本格式：认识与入门 Markdown - 少数派

推荐 markdown 的工具：typora；

在博客搬运的过程中有几个点需要注意：

1. 博客的 markdown 文件请命名为像如下格式：

   2012-02-15-Chinagraph’2012征文通知.md

2. 在博客的最上方，包含了这篇博客的基本信息

   ---
   title: "Vol2velle Printable Interactive Volume Visualization 可打印的交互式体可视化"
   tags: ["论文评述", "报告"]
   date: 2016-02-29
   author: 潘嘉铖
   mathjax: true
   ---
   

   注意！！这里一定要写为---，三个短线

   以上内容中的标点符号，应该全是英文的标点符号，切勿用中文的标点符号

   英文的标点后面请加空格；中英文之间加入空格；

   • title是博客的名称，请务必加上引号

   • 在 tag 里面需要包含它的类别（因为有些同学写的博客没有勾选分类目录，可能直接被识别为“其他”，请纠正它，一般组会报告标记成["论文评述", "报告"]）：

     • 业界新闻
     • 主题报告
     • 学术交流
     • 学术会议
     • 报告
     • 新闻
     • 活动
     • 论文评述
     • 通知
     • 随感

     ps: 这个类别可以在标题上面找到：

     

   • date表示这篇博客的发表时间，原始的博客里面应该也有

   • author表示这篇博客是谁写的（最好改成中文），如果这个人是 admin，那就还是 admin 即可

   • 如果这篇博客直接跳转到我（潘嘉铖）的博客上了，请直接找我要 markdown 文件，你再做修改即可；

3. 重要，接下去也是最麻烦的一步，需要你重新去排版整个 markdown 文件（为了保证搬运后渲染出来的质量）

   1. 章节标题：每一个小结都可能有一个小标题，请使用##作为第一级标题，###作为第二级标题以此类推；

   2. 图片：图片可以直接复制，然后到 typora 中黏贴就能生成；如果图片有问题，请自行联系作者；假如作者已经毕业就算了；

   3. 在 markdown 里面，没有（1）（2）这样的序号的，请也不要再使用，Markdown 里面，直接用1.，2.这样的序号来表示就行了，示例如下：

   1. 示例一
   	1. 示例1.1
   	2. 示例1.2
   2. 示例二
   

   非有序的序号请使用：

   - 非有序示例一
   - 非有序示例二
   	- 非有序示例2.1
   	- 非有序示例2.2
   

   4. 有些老博客，可能用的是1)这样的序号来标志顺序，请在 markdown 中改为1.，2.等等； 如果标志了序号，请注意不要在连续两个序号段落中间留空行，像下面这样会出错：

   

   5. 如果博客中有公式，希望能将其转为 mathjax 格式的公式（typora 中，在偏好设置中打开【内联公式】的选项）；推荐一个方便的工具（mathpix），可以直接通过截图来产生 latex 代码；

      行内的公式请使用$xxx$，行间的公式请使用：

      $$
      xxxxxx
      $$
      
      

      比如下面这个公式，可以直接截图生成：：

      $$
      H(Y | X)=\sum_{x \in \mathcal{X}, y \in \mathcal{Y}} p(x, y) \log \left(\frac{p(x)}{p(x, y)}\right)
      $$
      

      效果如下：

   $$ H(Y | X)=\sum_{x \in \mathcal{X}, y \in \mathcal{Y}} p(x, y) \log \left(\frac{p(x)}{p(x, y)}\right) $$

博客配置

我对小涛的 aircloud 主题进行了魔改，所以里面有很多东西都改变了

1. 增加了hexo-generator-author，需要对其 index.js 做一些修改：

   hexo.extend.filter.register("template_locals", function(locals) {
       if (typeof locals.site.authors === "undefined") {
           const posts = locals.site.posts
           locals.site.authors = locals.site.posts
               .map(post => post.author)
               .unique()
               .map(author => ({
                   name: author,
                   posts: posts.find({
                       author
                   })
               }))
       }
   })

2. 修改了渲染器，修改方法如下：

   1. 第一步： 使用Kramed代替 Marked

      hexo 默认的渲染引擎是 marked，但是 marked 不支持 mathjax。 kramed 是在 marked 的基础上进行修改。我们在工程目录下执行以下命令来安装 kramed.

      npm uninstall hexo-renderer-marked --save
      npm install hexo-renderer-kramed --save
      

      然后，更改/node_modules/hexo-renderer-kramed/lib/renderer.js，更改：

      // Change inline math rule
      function formatText(text) {
          // Fit kramed's rule: $$ + \1 + $$
          return text.replace(/`\$(.*?)\$`/g, '$$$$$1$$$$');
      }
      

      为：

      // Change inline math rule
      function formatText(text) {
          return text;
      }
      

   2. 第二步: 停止使用 hexo-math

      首先，如果你已经安装 hexo-math, 请卸载它：

      npm uninstall hexo-math --save
      

      然后安装 hexo-renderer-mathjax 包：

      npm install hexo-renderer-mathjax --save
      

   3. 第三步: 更新 Mathjax 的 CDN 链接

      首先，打开/node_modules/hexo-renderer-mathjax/mathjax.html

      然后，把<script>更改为：

      <script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML"></script>
      

   4. 第四步: 更改默认转义规则

      因为 hexo 默认的转义规则会将一些字符进行转义，比如 _ 转为 <em>, 所以我们需要对默认的规则进行修改. 首先， 打开<path-to-your-project/node_modules/kramed/lib/rules、inline.js,

      然后，把:

      escape: /^\\([\\`*{}\[\]()#$+\-.!_>])/,
      

      更改为:

      escape: /^\\([`*\[\]()# +\-.!_>])/,
      

      把

      em: /^\b_((?:__|[\s\S])+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,
      

      更改为:

      em: /^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,
      

   5. 第五步: 开启mathjax

      在主题 _config.yml 中开启 Mathjax， 找到 mathjax 字段添加如下代码：

      mathjax:
          enable: true
      

      这一步可选，在博客中开启 Mathjax，， 添加以下内容：

      ---
      title: Testing Mathjax with Hexo
      category: Uncategorized
      date: 2017/05/03
      mathjax: true
      ---
      

      通过以上步骤，我们就可以在 hexo 中使用 Mathjax 来书写数学公式。

3. 其他魔改的内容都在theme文件夹下，pull下来应该就包括了，不再多说；