使用reStructuredText Sphinx生成的HTML站点，在首页和每一页的侧边栏都会显示导航目录。问题是，默认的目录形式还不够高效 继续阅读“用sphinxcontrib-fulltoc为reStructuredText Sphinx扩展侧边栏目录”
reStructuredText Sphinx HTML中文搜索解决方案
默认情况下，reStructuredText Sphinx生成的HTML站点对中文搜索支持非常有限，基本上那个搜索框就是个摆设而已。Google一下，发现早就有高手 继续阅读“reStructuredText Sphinx HTML中文搜索解决方案”
利用统计代码对Web用户手册进行数据分析
用户手册要有足够的反馈才能更好地改进，直接去问最终用户的感受当然是最好了，不过这不太现实 继续阅读“利用统计代码对Web用户手册进行数据分析”
Sphinx加载HTML页面过慢元凶之MathJax.js
这几天偶然发现用Sphinx reST生成的HTML页面加载异常缓慢，经排查，原来是我不小心在配置中启用了MathJax，加载了一个外部JS文件所导致。 继续阅读“Sphinx加载HTML页面过慢元凶之MathJax.js”
Sphinx自带主题实现图片自适应设计
最近在折腾Sphinx reStructuredText，发现其自带的多个HTML主题都没有图片自适应的功能，于是决定将其改造一番。 继续阅读“Sphinx自带主题实现图片自适应设计”
Sphinx reStructuredText中文PDF输出解决方案之rst2pdf
以前尝试用rst2pdf将Sphinx reStructuredText文档输出为PDF时总是报错，即便是用不含中文的文档也没成功过。rst2pdf其实是个不太完美的作品，其作者甚至说过他一度想要放弃这个项目了（见这里）。 继续阅读“Sphinx reStructuredText中文PDF输出解决方案之rst2pdf”