Getting ready

We wish to build a simple website documenting our messaging library. The source tree now looks as follows:

.├── cmake│   ├── FindSphinx.cmake│   └── UseSphinxDoc.cmake├── CMakeLists.txt├── docs│   ├── conf.py.in│   └── index.rst└── src    ├── CMakeLists.txt    ├── hello-world.cpp    ├── Message.cpp    └── Message.hpp

We have some custom modules in the cmake subdirectory, and the docs subdirectory contains the main page for our website in a plain-text reStructuredText format, index.rst, and a Python template file, conf.py.in, with settings for Sphinx. This file can be autogenerated using the sphinx-quickstart utility, which is a part of the Sphinx installation.

Get CMake Cookbook now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.