layout: post title: "2018博客更新记录——从 Octopress 迁移到 Jekyll" date: 2019-01-01 15:56 comments: true
刚刚趁着年底把博客更新了一下，主要是从 Octopress 迁移到 Jekyll。
主要原因是 Octopress 已经好久不更新了，很多库都已经不支持了。很多时候，当我更新了系统的配置的 Ruby，那么整个博客就会失效。其实 Octopress 也是基于 Jekyll 的，但是后者的维护做得好很多。 Octopress 已经 3 年不更新维护了，实在是需要更新换代。同时，Octopress 用了大量我用不到的插件，虽然用着不错，但是太臃肿了，不太喜欢。
当然 Jekyll 很多时候也需要自己配置不少，所以我选择了 jekyll-now 这是一个宣传自己可以在几分钟内使用的博客，我自己测试了下确实不错。
用了 6 年的博客，终于第一次大更新。这里记录下过程和注意点。
<!--more-->任何时候，迁移或者升级都是一个选择问题，所以我这里说说自己的选型考虑。
因为我原来的博客是基于 Github 的，所以这次更新也需要基于 Github ，这样可以保证自己的很多链接不失效。
因为我之前是基于 Octopress 写了 6 年，积累了大量的 Markdown 博客文本，所以有一些基础服务我希望能够支持，主要是 Google Analytics 和 Disqus， 一个负责网站的数据统计，一个是评论记录。
我也看了不少技术方案，感觉还是 jekyll-now 设计的最为简单也最方便使用。同时希望代码结构不要太过于复杂，毕竟只是一个博客，不需要一个完整的网站架构。
其实按照 jekyll-now 的博客非常简单地就可以安装使用。这里不再缀叙。
说两个需要自己调节的。
因为我的 Octopress 使用的日期+标题的方式命名，所以我们需要修改下内部的博客链接。
修改 _config.yml 文件中的 permalink 选项如下格式，这个需要根据原来的博文源文件命名方式修改。
permalink: /blog/:year/:month/:day/:title/
因为写的博文经常会用到 LaTeX， 所以需要修改下原始文件的配置，使之支持 LaTeX.
这里我选择了使用 MathJax 来支持公式。MathJax 是一个支持在网页中渲染 LaTeX 公式的 JS 框架。
使用也非常简单，修改 _layout/post.html 文件，post.html是一个生成博客帖子的模板文件，这里只需要在模板文件中包含 MathJax。 修改了后的文件如下，...是省略的模板代码。
---
layout: default
---
<script src='https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js?config=TeX-MML-AM_CHTML' async></script>
<article class="post">
...
</article>
使用的方式就是连用两个$符即可。我发现和 MathJax 官网的使用有些不同，我猜测是单$被博客引擎占用了，不过不影响使用，所有地方都是用双$符号即可。行内公式和行间公式都可以。
比如 Schrödinger equation
$$ \hat H \Psi=i \hbar \frac{\partial}{\partial t}\Psi $$
Dirac 方程
$$ i \hbar \gamma^\mu \partial_\mu \psi - m c \psi = 0 $$
效果还不错。
当然也可以使用行内公式，比如
When $$a \ne 0$$, there are two solutions to $$ ax^2 + bx + c = 0 $$ and they are $$x = {-b \pm \sqrt{b^2-4ac} \over 2a}.$$。