[x] Remove all old pdf generating supporting scripts in bin/linter, instructions_makepdf.md, makepdf, manual_config_pdf
[x] Removing the docs-pdf step from the pipeline
[x] Commenting the uploading pdf step in .drone.star
[x] Harmonize directory names for each extension (antora, asciidoc) + setting it correctly in site.yml
[x] Fix asciidoctor-kroki extension registration in site.yml
[x] Force cheerio to use the htmlparser2 engine - 6x more performant
This will take much less time in CI to finish the job freeing ressources - for EACH docs build
[x] Upgrade the pipeline to Node 18 as Node 16 is already EOL
Other repo dependent important notes/steps:
[x] All failing xrefs need to be resolved first - done with
1235 and
1238
[x] Check for the existence of attachmentsdir as with Antora 3 we can consistently use the family coordinate attachment$.
[x] For the docs-server repo, we need to switch in the development manual for all versions where applicapable from ifeval::["{format}" == "html"] to ifndef::format[] because we have no longer the attribute defined in the build process (package.json). This attribute needs to be set to format=pdf to the antora build step when creating pdf's in future.
Backport to 10.13 and 10.12 - Important reminder: fix the version key in antora.yml !!
References: https://github.com/owncloud/docs-client-branding/pull/90 (Antora 3.1 upgrade)
This upgrades Antora to version 3 (3.1.7 atm).
Tasks:
package.json
so it has the latest Antora (3.1.7 atm)package.json
to use the correct options for the Antora buildsBUILD_SEARCH_INDEX
triggered the indexing preperation stepxref-validator
js code as this is now fully covered in the Antora build process, see https://gitlab.com/antora/xref-validatorxref-validator
step from the pipelinegenerator
directory as it is empty nowEdit-this-page
js code from the generation code as this is now handled by Antora, see https://docs.antora.org/antora/latest/playbook/content-edit-url/#source-viewbin/
linter
,instructions_makepdf.md
,makepdf
,manual_config_pdf
docs-pdf
step from the pipeline.drone.star
site.yml
asciidoctor-kroki
extension registration insite.yml
cheerio
to use thehtmlparser2
engine - 6x more performant This will take much less time in CI to finish the job freeing ressources - for EACH docs buildOther repo dependent important notes/steps:
1235 and
1238
attachment$
.docs-server
repo, we need to switch in the development manual for all versions where applicapable fromifeval::["{format}" == "html"]
toifndef::format[]
because we have no longer the attribute defined in the build process (package.json). This attribute needs to be set toformat=pdf
to the antora build step when creating pdf's in future.Backport to 10.13 and 10.12 - Important reminder: fix the version key in
antora.yml
!!