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.