Building the cookbook is currently a separate CMake project which requires boilerplate configuration (OTB_DIR, etc...). There is no proper CMake dependency between the OTB build and the cookbook, leading to errors when not rebuilding the correct git branch, etc...
In this MR I:
- Add the cookbook to the main
- Port the cookbook build system to Python 3 (and drop Python 2 support)
You can now build the cookbook in your usual OTB build dir simply with:
cmake -DBUILD_DOCUMENTATION . make CookBookHTML firefox Documentation/Cookbook/html/index.html
Easier CookBook build and better dependency management.
BUILD_DOCUMENTATIONCMake variable is useful because the configure step looks for Latex, Sphinx, etc, and we want to be able to completely disable it. But do we want
sphinx_rtd_themea mandatory build dependency (it was optional), so the final result is the same everywhere.
- Should document somewhere the list of build dependencies for the various OTB documentation (Sphinx, latex, etc.)
The copyright owner is CNES and has signed the ORFEO ToolBox Contributor License Agreement.
Check before merging:
- All discussions are resolved
- At least 2
👍votes from core developers, no 👎vote.
- The feature branch is (reasonably) up-to-date with the base branch
- Dashboard is green
- Copyright owner has signed the ORFEO ToolBox Contributor License Agreement