v1.18.0

New features

• End-user features:
  • (antora-extension) In API docs, automatically append the descriptions with pieces of info gathered from the following JSON Schema keywords, if these pieces of info are specified in the OpenAPI source documents: minItems/maxItems, minLength/maxLength, pattern, multipleOf, minimum/maximum, exclusiveMinimum/exclusiveMaximum, enum, default, example/examples, and const 758fe2e, 3c28559...73b4a16, fd2b182, 166a552
  • (antora-ui) Adapt the print CSS of the API docs so that API docs can exported to PDF in a pretty layout ed64599
  • (antora-ui) Enhance the appearance of the navigation tree by highlighting the parent pages of the active page, instead of just the active page 61daf6f
• Authoring/CI-centric features:
  • (antora-extension) Extensively rewrite the API doc generation scripts in order to better support new and future APIs (including OKS API and non-Outscale APIs) bc23b20, 64df09a...f7822f7, a3b2db6, 14af460...a2331e2, 48b5f6f, 94699b4...aad9557, 0da99ef, be65399, 7f88520, 1775634...37321c7, 88f2ca5, d9e07ca, 2268479...e2d2da5, 369d4c6
  • (antora-sourcer) Add an "antora-sourcer" extension to enable Antora content sources to automatically switch between two possible origins: either a remote repository fetched by Antora during generation, or a local repository cloned by the author beforehand (see antora-sourcer-extension/README.adoc for more info) be6b6eb
  • (antora-extension) Add build_options config option to enable Antora content sources to collect specific Git repos or packages (via Antora Collector) before API docs is generated (see antora-extension/Configuration-Reference.md for more info) be6b6eb, c1474bd, 0da99ef...bd1b443
  • (antora-extension) Support overriding content source branches via a TRIGGER_REF environment variable, to enable CIs of different repos and branches to dynamically modify the playbook 46ec86d...c6cd3c8

Improvements

• (antora-extension / antora-ui) UI improvements:
  • In API docs, move contact info and terms of service info from below the intro text to below the page title 166a552
  • In API docs, rename "Shell" tab to "Curl" 0a82bc0...46ec86d
  • In API docs, add vertical padding at the bottom of the left panel to prevent the last item of the list from being hidden by the browser's URL text pop-up 450944c
  • In the User Guide's search results list, add a small message to inform of the possibility to press Enter to access the standalone search results page 0a82bc0
• (Vale) Update Vale rules, to detect curved quotes, code blocks that should be JSON, and some term exceptions 9973890...5d97239

Bugfixes

• (antora-extension) Fix formatting errors in Curl code examples 88f2ca5...78ee897
• (antora-extension) Fix "Copy code" button in API docs to correctly ignore comments and leading/trailing newlines 14af460
• (antora-extension) Correctly display hard-coded nested (i.e. non-$ref) API schemas fc83d4c
• (antora-tooltipper-extension) Fix incorrectly generated tooltips f3f0627...e6d9c52
• (antora-ui) Fix incorrectly generated links ba10df4...cb3e7a6, 36f9c9c
• (antora-ui) Fix minor CSS/visual issues f3f0627, 64df09a, 3c28559, 92095a3, 17d257b, 1775634, 88c6966, 2268479