Skip to content

SpaDES.docs 0.4.0

Choose a tag to compare

@achubaty achubaty released this 21 Sep 18:13
· 14 commits to main since this release
fcad569

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 uses numeric_version(), so v1.0.10 sorts above v1.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 DESCRIPTION rather 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.