[fc] Repository: plone.restapi

Branch: refs/heads/main
Date: 2024-09-20T16:28:37-07:00
Author: Steve Piercy (stevepiercy) <web@stevepiercy.com>
Commit: plone/plone.restapi@dcf7966

Switch to Plone Sphinx Theme for documentation, include changes to http-examples to build docs preview (#1815)

* Include changes to http-examples to build docs preview

* Remove obsolete styles and template

* Update requirements-docs.txt and conf.py to align with minimal Plone Sphinx Theme

* Update requirements-docs.txt and conf.py to align with minimal Plone Sphinx Theme

* Only install docs requirements when building docs

* Add setuptools to requirements-docs.txt because sphinxcontrib.httpexample requires its pkg_resources

* improve comment for future developers

* news

* Remove commented code

* Move legacy commented setting descriptions above their settings

* Move python-clean into a separate make target, so docs-clean does not obliterate the virtual environment. Most of the time, I just want to purge the built docs, not the virtual environment.

Files changed:
A news/1815.documentation
M .github/workflows/tests.yml
M .readthedocs.yaml
M Makefile
M docs/source/conf.py
M requirements-docs.txt
D docs/source/_static/custom.css
D docs/source/_static/print.css
D docs/source/_templates/page.html