Python 利用 sphinx 构建个人博客
一、基础概念
利用sphinx+pandoc+github+readthedocs构建个人博客
Sphinx: 是一个基于ReStructuredText的文档生成工具,可以令人轻松的撰写出清晰且优美的文档, 由Georg Brandl在BSD许可证下开发。新版的Python文档就是由Sphinx生成的,并且它已成为Python项目首选的文档工具,同时它对C/C++项目也有很好的支持;并计划对其它开发语言添加特殊支持。
Read the Docs是一个在线文档托管服务,可以从各种版本控制系统中导入文档。支持webhooks,当你提交代码时,文档将被自动构建。
Pandoc:pandoc是一款开源转换工具,可以实现常见的格式转换。支持全平台操作,以命令行的方式进行转换。
二、流程
Sphinx + GitHub + ReadtheDocs 作为一个文档写作工具,利用pandoc文本转换, 用Sphinx生成文档,GitHub托管文档,再导入到 ReadtheDocs。我们可以使用这个工具写文档、记笔记等。
三、实施部署
3.1 安装环境
此处利用的centos7.4 系统默认python版本2.7
3.2 pip 安装sphinx环境
3.3 初始化项目
3.4 目录结构
3.5 修改配置文件
由于修改模板较麻烦可以直接git clone我的模板进行简单修改即可
3.6 安装第三方模块
如果报错可能由于下载超时,重新执行即可。
3.7 利用pandoc安装
3.8 利用pandoc转换文件
利用pandoc将之前的markdown格式的博客源文件转换成rst格式
编辑index.rst,进行引用文件
3.9 编译生成html文件
3.10 将页面项目托管至github
如果不会github可以参考git笔记
3.11 关联github和read the docs
如果没有readthedocs账号可以通过github账号登陆
管理github
导入代码库
项目编译
可以通过连接地址查看博客
四、查看
链接地址:
版权声明: 本文为 InfoQ 作者【雪雷】的原创文章。
原文链接:【http://xie.infoq.cn/article/ddfccb1a56736ac744fe5512d】。文章转载请联系作者。
评论