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