This repository contains the Antora playbook and configuration for the Dev Center documentation site. It aggregates content from multiple sources to build a unified documentation portal.
File |
Description |
|
Production Antora playbook. Uses remote GitHub URLs for all content sources and the published UI bundle. Used by CI/CD. |
|
Local sibling-repo playbook (committed). Expects |
|
Same local content sources, but points |
|
Site overlay on the valentus-theme 2.x UI bundle: custom domain |
|
VS Code folder settings and extension recommendations for this playbook repo. |
|
Defines dependencies and build scripts. |
Dependency |
Notes |
LTS recommended |
|
Package manager for install and build scripts |
Clone the content repos as siblings of this playbook repo (see antora-playbook-local.yml), then:
pnpm buildBuild the local UI bundle in a sibling valentus-theme checkout, then:
pnpm build:testingTo build with remote sources (as CI does):
pnpm run build:onlineThe output will be generated in the build/site directory (or as configured in the playbook).
Command |
Purpose |
|
Install dependencies |
|
Build site with local playbook ( |
|
Build with testing playbook (e.g. local UI bundle) |
|
Build with remote sources (production/CI) |
This project is best managed by opening the repository folder in VS Code:
-
Open this repository folder in VS Code (File → Open Folder).
-
Ensure the recommended extensions are installed (AsciiDoc, YAML, etc.).
-
Use the integrated terminal for running builds.
-
Antora UI branding — teal chrome and logo keys
