https://github.com/rdmueller/antora-sandbox

https://github.com/rdmueller/antora-sandbox

Last synced: 29 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/rdmueller/antora-sandbox
• Owner: rdmueller
• Created: 2024-07-19T13:40:56.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2024-07-20T12:37:58.000Z (4 months ago)
• Last Synced: 2024-07-21T11:01:11.024Z (4 months ago)
• Language: Shell
• Size: 5.02 MB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.adoc

Awesome Lists containing this project

README

        
== Antora Sandbox

This is just a simple sandbox to play around with antora.

Start it with gitpod https://gitpod.io#https://github.com/rdmueller/antora-sandbox and you will get a web based VS Code where antora is already installed and the initial playbook is launched in the browser.

A preview is available here: https://rdmueller.github.io/antora-sandbox/

=== Some thoughts

* used docToolchain to get some local templates setup:

+

[source,bash]

----

./dtcw downloadTemplate

----

* read a bit further to get tabs installed without creating my own theme: https://github.com/asciidoctor/asciidoctor-tabs/blob/main/docs/use-with-antora.adoc#using-the-supplemental-ui[using the supplemental ui]

* top menu navigation has been modified through a partial ui configured in paybook: https://github.com/rdmueller/antora-sandbox/blob/main/antora-playbook.yml#L36

* partial ui could also be configured in a folder: https://github.com/ahus1/antora-extensions-demo/tree/main/playbook/supplemental_ui/partials

Rendered pages at https://rdmueller.github.io/antora-sandbox/arc42-template/latest/index.html