CMake 3.7: Sphinx QtHelp doesn't have CSS and fails to build from source
There are some problems with QtHelp files for CMake:
- Currently provided pre-build QtHelp-files do not render CSS correctly in Qt Assistant 4.8.7. My old
CMake.qch
file from January 2017 renders fine, but the new files do not. - I've tried to build QtHelp file myself from 3.7.2 source, generated solution for Visual Studio 2015 with CMake 3.7.2, set
SPHINX_QTHELP
, downloaded Sphinx withpip
, the build failed with error (see https://cmake.org/pipermail/cmake/2015-June/060890.html):file failed to open for reading (No such file or directory): build/Utilities/Sphinx/qthelp/_static/default.css
I searched a bit about this error and found this: https://github.com/sphinx-doc/sphinx/issues/1835
I guess it is "alabaster" theme instead of "bare html". Since Sphinx-1.3, when user doesn't specify html_theme, "alabaster" theme is used as a default theme.
I downgraded Sphinx from 1.7.2 to 1.2.3 with pip
, then built documentation again and this time it was built successfully (however with deprecation warning : io.FileInput() argument 'handle_io_errors' is ignored since "Docutils 0.10 (2012-12-16)" and will soon be removed.
). The resulting QtHelp file was rendered fine in Qt Assistant with all CSS, but it still doesn't look exactly like old pre-built file.
Software involved:
- Qt Assistant 4.8.7 (
mingw-w64
4.8.2 pre-built binaries) -
cmake-3.7.2.zip
source package - CMake 3.7.2 win64-x64
- Visual Studio 2015 generator
- Python 3.6.4, Sphinx 1.7.2/1.2.3 (via
pip
)
This is how it looked before (January 2017, full CSS):
This is how it looks now (no CSS):
This is how it look when built with Sphinx 1.2.3 (looks like old version, but fonts are different):