SeisMan博客

本项目是 SeisMan博客 v3.0的源码。博客v3.0使用 Hugo 作为网站生成引擎， 主题为 Even。

简介

博客自v2.0版本开始，将网站生成引擎配置、主题和博文独立开来，三者位于独立的仓库中。 主题和博文均作为网站生成引擎（即本项目）的子模块。 本项目会追踪主题的 seisman 分支和博文的 master 分支。

• 引擎：
• 主题：
• 博文：

这样的设计具有如下一些优点：

1. 主题的 master 分支可以与上游 Even 的master保持同步更新，方便 seisman 分支进行rebase
2. 可以随时切换主题，而不用担心旧主题占据大量的项目空间
3. Hexo或者其他绝大多数博客引擎都使用 ![AltText](/images/xxx.png) 这种“伪绝对路径”的 方式引用图片，这样做使得 markdown 文件在 GitHub 上无法正常显示图片，而将博文存放在 单独的仓库中则图片可以正常显示
4. 若未来切换博客引擎，所有博文可在少量修改的前提下迁移到新的博客引擎下，且能够保留 所有修订历史

本地预览

读者可以通过直接访问 SeisMan博客 阅读博客内容，也可以在自己的机器上离线预览博客。 只需执行如下几个步骤，即可实现在Linux、Windows、macOS下实现网站的离线预览。整个 过程不超过5分钟（前提是网速还可以，相关网站没有被墙）。

初次使用

1. 安装 Hugo

   本博客使用 Hugo 作为博客引擎，Hugo具有跨平台、速度快等特性。

   到 releases 页面下载自己平台对应的 文件，解压，并将可执行文件放在PATH所在目录即可。

2. Clone项目源码至本地

   $ git clone --recursive https://github.com/seisman/seisman.info.git
   

3. 预览网站

   $ cd seisman.info
   $ hugo server
   

   浏览器打开 http://localhost:1314/ 以离线查看

更新以追踪博客的更新

通过如下两个命令即可将本地的博客更新至最新版本：

$ git pull
$ git submodule update --remote

优化

安装最新版 pandoc

本项目在生成 PDF 时对 pandoc 版本有要求，如果想要本地生成 PDF 则需要手动安装最新版 pandoc。

1. 下载：到 https://github.com/jgm/pandoc/releases/latest 下载最新版本安装包

2. 安装

   对于Ubuntu用户，下载deb安装包并按照如下命令安装

   $ sudo dpkg -i pandoc-xxx-amd64.deb
   

   对于CentOS用户，下载tar.gz安装包并按照如下命令安装

   $ tar -xvf pandoc-2.0.3-linux.tar.gz
   $ mv pandoc-2.0.3/bin/pandoc pandoc-2.0.3/bin/pandoc-citeproc ~/bin/
   

3. 检查pandoc版本

   $ pandoc -v