SpaDES.docs 0.4.0
Support for manuals that publish a PDF of each release.
-
publishManualArchive()copies a manual's archived release PDFs into the rendered book directory and writes an index page listing them, newest first. The index is built from the files actually present rather than a list kept by hand, and ordering usesnumeric_version(), sov1.0.10sorts abovev1.0.2.The archived PDFs belong in version control rather than only on the published branch: that branch is rebuilt by every deploy, and an old PDF cannot be regenerated from current sources. Publishing them from a tracked directory also keeps the deploy an exact image of what was built, which is what stops stale files accumulating there.
-
Building a continuously updated manual gains a Releases, and keeping the old PDFs section: taking the version from
DESCRIPTIONrather than the build script, archiving each release's PDF, publishing the archive with the site, linking it statically from the preface, and committing the new PDF from the workflow so a release does not depend on someone remembering a manual step.