2014-10-30 Issue with some Sphinx themes and Internet Explorer
The theme Bootstrap does not work well on Internet Explorer. In that case, the file [python_path]/Lib/site-packages/sphinx/themes/basic/layout.html must be modified to include the following line:
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
2014-02-01 Sphinx themes and presentation
A year ago, I was looking for tools to generate automated help for a Python module. However, I was looking a tool able to use the javadoc style because most of my old code uses it. Doxygen is nice but the unavoidable tool is now Sphinx (+ autodoc). I will not explain what I did because I did it quick (and wrong). The right way to do it is to use the following Sphinx extension: Breathe. Anyway, I do not remember all the issues I had when trying Sphinx but I found the documentation more usable. So I played a little with some theme I was able to find:
- basicstrap (example)
- solar theme (example)
- Sphinx-hachibee-theme (example)
- sphinxjp (example)
- wild_sphinx_theme (example)
- sphinx_readable_theme (example)
- sphinx_rtd_theme (example)
- Cloud Sphinx Theme (example)
Another thing I did wrong is the way I made the design of this blog. I implemented many thing (keywords generation, month aggregation...). But today, I would try first to look at Pelican or even directly use Sphinx which already does many things about indexes. If you look on the internet about sphinx blog theme, you would find some examples like the following one: Tinkerer. You can even find theme to do presentation (instead of PowerPoint I suppose):
more...
|
Xavier Dupré
|
