超级详细从零搭建在线博客，基于 sphinx + markdown + nginx + docker 架构 ! 附源码

---

一、sphinx安装与构建

1. 安装sphinx

python安装sphinx

pip install sphinx

2. 新建项目

安装完毕后转到任意目录测试，例如这里在D:\Temp\blog目录，输入sphinx-quickstart，则会自动生成一些文件

D:\Temp\blog>sphinx-quickstart

接下来是一些新建项目的选项

• Separate source and build directories (y/n) [n]: - 分离source和build目录，这里为方便管理源文件(markdown)和结果文件(html)，选择y
• Project name - 项目名称，例如 MyBlog
• Author name(s) - 作者， 例如 佚名
• Project release [] - 项目版本， 例如 1.0.0
• Project language [en]: 项目的语言，默认是英文， 例如 zh_CN, 这里可以查看文档的语言缩写

这样就配置好了一个新的项目MyBlog, 我们可以在D:\Temp\blog目录发现文件结构如图所示

D:\TEMP\BLOG\SOURCE
│—build
│—source
├─make.bat
└─Makefile

• build文件夹： 运行make html命令后，生成的文件会在这个目录中
• source目录：放置文档的源文件
• make.bat：可以在该目录下使用make命令，sphinx会自动解析
• makefile

3. 构建项目

构建项目，这里使用make html命令，即’编译’source目录下的文件，在build目录生成html文件

D:\Temp\blog>make html