diff --git a/.readthedocs.yaml b/.readthedocs.yaml new file mode 100644 index 0000000..d5c5467 --- /dev/null +++ b/.readthedocs.yaml @@ -0,0 +1,21 @@ +# .readthedocs.yaml +# Read the Docs configuration file +# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details + +# Required +version: 2 + +build: + os: ubuntu-20.04 + tools: + python: "3.9" + +sphinx: + configuration: manual/conf.py + +formats: + - pdf + - epub + +sphinx: + fail_on_warning: true diff --git a/README-maintainer b/README-maintainer index 47d64b2..8306d9a 100644 --- a/README-maintainer +++ b/README-maintainer @@ -403,3 +403,18 @@ whichever `./config-*` is appropriate for whichever compiler I need to test with. Start one of the Visual Studio native compiler shells, and from there, run one of the msys shells. The Visual Studio step is not necessary if just building with mingw. + + +DOCS ON readthedocs.org + +* Registered for an account at readthedocs.org with my github account +* Project page: https://readthedocs.org/projects/qpdf/ +* Docs: https://qpdf.readthedocs.io/ +* Admin -> Settings + * Set project home page + * Advanced: Show version warning + * Email Notifications: set email address for build failures + +At this time, there is nothing in .github/workflows to support this. +It's all set up as an integration directly between github and +readthedocs. diff --git a/TODO b/TODO index 4435aa8..d547e79 100644 --- a/TODO +++ b/TODO @@ -1,6 +1,9 @@ Next ==== +* At the time of the release, update the webpage to point to + readthedocs if that's what we decide to do. + * High-level API/doc overhaul: #593 * Refactor test_driver.cc so that runtest is not one huge function. @@ -32,9 +35,6 @@ Documentation * See #530 -- add an appendix explaining PDF encryption in general plus how it's handled by qpdf. Or maybe this should go on the wiki. -* Decide about readthedocs including supporting multiple released - versions of the docs and docs from main. - Document-level work =================== diff --git a/manual/release-notes.rst b/manual/release-notes.rst index 31c7862..e5d73c9 100644 --- a/manual/release-notes.rst +++ b/manual/release-notes.rst @@ -26,6 +26,9 @@ For a detailed list of changes, please see the file A top-to-bottom review of the documentation is planned for an upcoming release. + - Documentation is now available at `https://qpdf.readthedocs.io + `__. + - Library Enhancements - Since qpdf version 8, using object accessor methods on an