[cmake-developers] PATCH: fix sphinx-documentation theme

[Stuermer, Michael SP/HZA-ZSEP]

> -----Original Message-----
> From: cmake-developers [mailto:cmake-developers-bounces at cmake.org]
> On Behalf Of Brad King
> Sent: Monday, November 16, 2015 4:57 PM
> To: cmake-developers at cmake.org
> Subject: Re: [cmake-developers] PATCH: fix sphinx-documentation theme
> 
> On 11/16/2015 10:45 AM, Stuermer, Michael SP/HZA-ZSEP wrote:
> > Sphinx does not seem to provide any "default" theme anymore, it's
> > called "classic" now.
> 
> Thanks.  This was previously discussed here:
> 
>  https://cmake.org/pipermail/cmake/2015-July/061096.html
> 
> Upstream Sphinx has decided to drop the warning:
> 
>  https://github.com/sphinx-
> doc/sphinx/commit/034c4e942451fad40350ae3bb3beda6c63a49064
> 
> > It might even be better to make the html_theme value a cmake variable
> > in the build process.
> 
> Perhaps, but that will require more extensive changes to configure all the
> different places in the source that refer to the theme.
> If the `static/cmake.css` file needs to be configured then we might also have
> to configure/copy everything else in the entire `static` directory since IIRC
> sphinx only has one value for that and not a search path.
> 
> For now it is simplest to ignore the warning from Sphinx or upgrade to a
> version of Sphinx that drops the warning.
> 

The warning itself is not the problem, sphinx (at least my current version) simply does not have any "default" theme so the design is completely broken in html view. If newer sphinx versions introduce a fallback to "classic" theme if "default" is configure, it's ok.
 

> -Brad
> 
> --
> 
> Powered by www.kitware.com
> 
> Please keep messages on-topic and check the CMake FAQ at:
> http://www.cmake.org/Wiki/CMake_FAQ
> 
> Kitware offers various services to support the CMake community. For more
> information on each offering, please visit:
> 
> CMake Support: http://cmake.org/cmake/help/support.html
> CMake Consulting: http://cmake.org/cmake/help/consulting.html
> CMake Training Courses: http://cmake.org/cmake/help/training.html
> 
> Visit other Kitware open-source projects at
> http://www.kitware.com/opensource/opensource.html
> 
> Follow this link to subscribe/unsubscribe:
> http://public.kitware.com/mailman/listinfo/cmake-developers