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.