构建网站

Sphinx 构建网站

地震“学”所有教程网站都使用文档生成工具 Sphinx 构建。读者可以按照如下步骤在自己的计算机上构建网站。

备注

以下步骤以地震“学”科研入门教程为例。构建其他文档时只需做简单替换即可:

  1. 下载文档源码

    # 克隆源码,并进入源码目录
    $ git clone --depth=50 https://github.com/seismo-learn/seismology101.git
    $ cd seismology101
    
  2. 安装 Sphinx 等文档所需依赖

    $ pip install -r requirements.txt
    
  3. 编译生成 HTML 格式的文档

    $ make html
    
  4. 生成的文档位于 build/html/ 目录下,直接用浏览器打开 build/html/index.html 即可在本地预览。

Hugo 构建网站

地震学主站地震“学”链接是由静态网站生成器 Hugo 构建生成的,具体构建方法请参考他们源码网址里的 README.md 文件。此外,地震“学”链接使用的主题是我们基于 Bootstrap 框架和 Font Awesome 精美图标自定义的。