[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~ (not applicapable)
[x] ~Commenting the uploading pdf step in .drone.star~ (not applicapable)
[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 - none as we do not have any modules/components here and all other repos have been prepared already.
[x] For the docs repo, we can remove BUILD_SEARCH_INDEX from .drone.star as it is no longer used.
"BUILD_SEARCH_INDEX": ctx.build.branch == deployment_branch, --> remove.
[x] Need a docs repo upgrade for Node 18 and a comment that one needs to upgrade his local installation!
References: https://github.com/owncloud/docs-client-branding/pull/90 (Antora 3.1 upgrade) Fixes: https://github.com/owncloud/docs/issues/4853 (Upgrade the documentation framework) Fixes: https://github.com/owncloud/docs/issues/4545 (Antora release upgrade from 2.3.4 to 3.0.x)
This upgrades Antora to version 3 (3.1.7 atm).
Tasks:
package.jsonso it has the latest Antora (3.1.7 atm)package.jsonto use the correct options for the Antora buildsBUILD_SEARCH_INDEXtriggered the indexing preperation stepxref-validatorjs code as this is now fully covered in the Antora build process, see https://gitlab.com/antora/xref-validatorxref-validatorstep from the pipelinegeneratordirectory as it is empty nowEdit-this-pagejs 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_pdfdocs-pdfstep from the pipeline~ (not applicapable).drone.star~ (not applicapable)site.ymlasciidoctor-krokiextension registration insite.ymlcheerioto use thehtmlparser2engine - 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:
docsrepo, we can removeBUILD_SEARCH_INDEXfrom.drone.staras it is no longer used."BUILD_SEARCH_INDEX": ctx.build.branch == deployment_branch,--> remove.docsrepo upgrade for Node 18 and a comment that one needs to upgrade his local installation!Upgrade sort order: