diff options
-rw-r--r-- | .readthedocs.yaml | 21 | ||||
-rw-r--r-- | README-maintainer | 15 | ||||
-rw-r--r-- | TODO | 6 | ||||
-rw-r--r-- | manual/release-notes.rst | 3 |
4 files changed, 42 insertions, 3 deletions
diff --git a/.readthedocs.yaml b/.readthedocs.yaml new file mode 100644 index 00000000..d5c54677 --- /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 47d64b2d..8306d9af 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. @@ -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 31c78628..e5d73c90 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 + <https://qpdf.readthedocs.io>`__. + - Library Enhancements - Since qpdf version 8, using object accessor methods on an |