UI development

Antora uses UI bundles to define the look and feel of a documentation site. They are developed separately and are built into a ZIP file, to be consumed by Antora’s default site generator pipeline.

docs.dt.in.th, like other Antora-based sites, uses its own UI bundle. The source code is located in the dtinth/docs-ui repository, while the built ZIP file is directly checked in to the dtinth/docs repository.

Why check the UI bundle directly into the docs repo?

Most Antora projects use a URL to point to the Antora UI bundle. But checking in the UI bundle directly into the docs repo allows the UI to be bundled with the dtinth-docs command without requiring a separate release process which introduces unnecessary overhead.

Updating UI bundle

Assuming that the docs repo and docs-ui repos are next to each other:

📒 docs
  📂 .git
  📄 update-ui.sh
  📄 ui-bundle-*.zip
  📄 …
📒 docs-ui
  📂 .git
  📄 …

Within the docs repo, run:

./update-ui.sh

to update the UI bundle.