30分钟教你快速搭建一个顔值超高的博客

2020-07-08 00:00:00 文件 配置文件 这是 文件夹 都有
作者：王炳明
个人公众号：Python编程时光


10个程序员里，有9个人都有写博客的习惯。

这是非常好的习惯，沉淀知识的同时也能帮助他人，这值得每个程序员，投入时间和精力去坚持做下去。


写博客的平台有很多，CSDN，博客园，51CTO，还有人会使用Hexo+GitHub，WordPress，比较会折腾的人还会自己使用Java，Python搭建，我就干过这样的事，不过每年还要支付域名和服务器，比较麻烦而且浪费钱。


以上博客基本我都有注册使用过，不过终还是放弃。由于博客文章，比较零散，无法形成一个系统性的知识体系，不便索引。


为了使自己的文章能有一个比较完整的体系。经过一番探索之后，能满足我的基本要求的有如下两种：

  • GitHub Wiki：索引方便，但排版一般，不方便查看。
  • GitBook：样式不好看，访问速度慢。


由于以上两种都有各自的不足的地方，所以我后选择了一个完美的解决方案：Markdown+Pandoc+Sphinx+GitHub+ReadtheDocs 来管理我的文章。

  • Markdown：书写文档
  • Pandoc：格式转化
  • Sphinx：生成网页
  • GitHub：托管项目
  • ReadtheDocs：发布网页


成品展示


以我的博客(python-online.cn)为例，先给大家展示一下。

这是首页。显示了你所有的文章索引。


这是我的导航栏。是不是结构很清晰，很方便索引。


点击文章后，还可以很方便查看标题，跳转。


体验下搜索功能，速度很快。


看完这些你是不是也很想拥有这样一个博客呢？

只要你认真往下看，30分钟搭建这样一个博客不在话下。


安装Sphinx


安装之前，请确认下Python版本。我这里使用的是Python 2.7.14，其他版本请自行尝试噢，Python3.6好像有些坑，你需要踩一下。


安装Python工具包

$ pip install sphinx sphinx-autobuild sphinx_rtd_theme

相关文章