构建网站
Sphinx 构建网站
地震“学”所有教程网站都使用文档生成工具 Sphinx 构建。读者可以按照如下步骤在自己的计算机上构建网站。
安装 git 和 Python
以下步骤假定用户已安装版本控制工具 git 和 Python。
若未安装 git,可以使用以下命令安装或更新 git:
$ sudo dnf install git$ sudo yum install git$ sudo apt install git$ brew install git打开 https://git-scm.com/downloads,下载并安装 Git for Windows。
安装完成后,还需设置个人信息。打开终端,运行以下命令(将 “seismo-learn” 和 “seismo-learn@gmail.com” 替换成个人对应的信息):
# 设置用户姓名和邮箱 $ git config --global user.name "seismo-learn" $ git config --global user.email "seismo-learn@gmail.com" # 查看 ~/.gitconfig $ cat ~/.gitconfig [user] name = seismo-learn email = seismo-learn@gmail.com若未安装 Python,建议通过 Anaconda 来安装和管理 Python。
备注
以下步骤以地震“学”科研入门教程为例。构建其他文档时只需做简单替换即可:
下载文档源码
# 克隆源码,并进入源码目录 $ git clone --depth=50 https://github.com/seismo-learn/seismology101.git $ cd seismology101
安装 Sphinx 等文档所需依赖
$ pip install -r requirements.txt
编译生成 HTML 格式的文档
$ make html
生成的文档位于
build/html/
目录下,直接用浏览器打开build/html/index.html
即可在本地预览。
Hugo 构建网站
地震学主站和地震“学”链接是由静态网站生成器 Hugo 构建生成的,具体构建方法请参考他们源码网址里的 README.md
文件。此外,地震“学”链接使用的主题是我们基于 Bootstrap 框架和 Font Awesome
精美图标自定义的。