@inditextech/docouture-cli 0.1.0-SNAPSHOT.40.1

package/build/templates/agent-support/AGENTS.md

@@ -0,0 +1,72 @@
+<!-- docouture:start - managed by docouture; edits inside this block are overwritten by `docouture new`/`docouture upgrade` -->
+<!-- prettier-ignore -->
+# __DOCOUTURE_TITLE__ documentation
+
+This repository's `docs/` directory is an Antora documentation site, scaffolded by
+`docouture new` (`@inditextech/docouture-cli`). This file is the baseline for any coding agent
+(OpenCode, Claude Code, Codex, Cursor, …) working on it — house rules, commands and where
+to look for more.
+
+## Layout
+
+```
+docs/
+  antora-playbook.yml          build entry point: site title, content sources, UI bundle
+  antora-playbook.local.yml    used by `docouture dev` and PR verification — builds HEAD only
+  src/
+    antora.yml                 component descriptor: name, title, version, nav
+    modules/
+      ROOT/                    the default module
+        nav.adoc               the navigation tree
+        pages/*.adoc           one page per file — these become site URLs
+```
+
+The nesting (`docs/src/...`) is intentional — see the `docs-internals` skill.
+
+## Commands
+
+Run from the repository root (or pass `--dir <path>` to any of them):
+
+| command                         | does                                                                                         |
+| ------------------------------- | -------------------------------------------------------------------------------------------- |
+| `docouture dev [--port <port>]` | build the site and serve it with live reload, rebuilding on every change                     |
+| `docouture build`               | build the site once (`npm run build` under `docs/`)                                          |
+| `docouture doctor`              | check Node version, the four names that must agree, git history and that antora is installed |
+
+`docs/package.json` also exposes `npm run build`/`npm run dev` directly if you'd rather not
+go through the `docouture` CLI.
+
+## Conventions
+
+- Every page lives at `docs/src/modules/<module>/pages/*.adoc` and must have an `xref:`
+  entry in that module's `nav.adoc`, or it builds but is unreachable from the navigation.
+- A build failure on a warning is expected behaviour here, not a bug — `antora-playbook.yml`
+  sets `runtime.log.failure_level: warn`. A broken `xref:`, a missing include target or an
+  unknown attribute reference fails the build.
+- Run `docouture doctor` after any structural change (renaming the component, moving
+  `antora.yml`, editing `package.json`'s `name`) — it's the fast way to catch the four names
+  drifting out of agreement.
+
+## Skills
+
+- **`documenting-your-repo`** — start here: planning what to document, sourcing content
+  from wherever it actually lives (existing docs, README, or the code itself), and the
+  long-term loop that keeps docs in sync as the repo grows. Hands off to the two skills
+  below for mechanics once a decision is made.
+- **`writing-docs-pages`** — authoring AsciiDoc content: the language itself, `xref:`
+  references, `nav.adoc`, admonitions, code blocks, and this site's own custom blocks
+  (`[tabs]`, `[cards]`, `[accordion]`, …).
+- **`docs-internals`** — the playbook, the component descriptor, the four names that must
+  agree, the home-page vs. content-page patterns, and mono-module vs. multi-module sites.
+- **`docs-versioning`** — only present when this site was scaffolded with
+  `--mode versioned`: cutting releases, `docouture version`, and `docs/.release-version`.
+
+<!-- docouture:end -->
+
+## Documentation state
+
+<!-- maintained by the documenting-your-repo skill — do not hand-edit structure, only content -->
+
+| doc page          | derived from          | status |
+| ----------------- | --------------------- | ------ |
+| index.adoc (home) | manual (hand-written) | —      |

package/build/templates/starter/antora-playbook.local.yml

@@ -0,0 +1,99 @@
+#
+# Antora playbook for local development and PR verification.
+#
+# Reference: https://docs.antora.org/antora/latest/playbook/
+#
+# Build with:  npx antora --fetch antora-playbook.local.yml
+# Output:      build/site
+#
+# Why this exists:
+# Once this site adopts one of the two documented versioning modes (see the
+# docouture docs-site-package skill's reference/versioning-modes.md), the real
+# `antora-playbook.yml` aggregates content from more than just whatever is
+# checked out right now — versioned matches `branches: [main]` +
+# `tags: ['v*']`, standalone matches `branches: [main]` + `tags: ['stable']`.
+# A PR build (or a local build on a feature branch) is on a detached HEAD or
+# a branch that is neither of those, so `main` and the version tag(s) are
+# not resolved in that checkout — the real playbook either fails or silently
+# builds fewer versions than it should.
+#
+# This playbook points content aggregation at HEAD (the current worktree)
+# instead, so `docouture dev` (see src/lib/dev-server.ts) and
+# `docouture-pr-verify.yml` (see .github/workflows/) validate the current docs
+# content without needing `main` or any release ref. It intentionally never
+# changes shape when a site switches versioning mode, or adds a release:
+# there is always exactly one thing to validate, whatever is currently
+# checked out.
+#
+# Publishing (`docouture-publish.yml`) uses the real `antora-playbook.yml`.
+#
+
+site:
+  title: __DOCOUTURE_TITLE__
+  # Set to the dev server's own origin so Antora also generates 404.html
+  # (@antora/page-composer only does this when site.url is set) — docouture dev
+  # (src/lib/dev-server.ts) then has a real 404 page to serve instead of a
+  # plain-text fallback. Harmless here: this playbook is dev/PR-verify only,
+  # never used for a real publish (see the file header above).
+  url: http://localhost:5000
+  start_page: __DOCOUTURE_COMPONENT_NAME__::index.adoc
+  # Same placeholder logo/favicon as the real antora-playbook.yml — see its
+  # own comment. Harmless here too: this playbook is dev/PR-verify only.
+  keys:
+    product_logo: /_/product-logo.png
+    product_logo_dark: /_/product-logo-dark.png
+    favicon: /_/favicon.ico
+
+content:
+  sources:
+    # See antora-playbook.yml's comment on `url`/`start_path` — same reasoning
+    # applies here: this playbook lives at <repo-root>/docs/ too.
+    - url: ..
+      start_path: docs/src
+      branches: HEAD
+
+ui:
+  bundle:
+    # Same docouture UI bundle as the real antora-playbook.yml — see its comment.
+    # Resolved from node_modules too, so `npm install` must have run first.
+    url: ./node_modules/@inditextech/docouture-ui-bundle/build/ui-bundle.zip
+    snapshot: false
+  supplemental_files: ./supplemental-ui
+
+output:
+  dir: build/site
+
+urls:
+  html_extension_style: indexify
+
+runtime:
+  log:
+    failure_level: warn
+    # See antora-playbook.yml's own comment on this key: Antora's own
+    # default is 'warn', which would otherwise silently drop
+    # @inditextech/docouture-antora-extensions' docouture-version-report and
+    # docouture-search-index diagnostics — both logged at 'info'.
+    level: info
+
+asciidoc:
+  attributes:
+    experimental: ''
+    icons: font
+    sectanchors: ''
+    idprefix: ''
+    idseparator: '-'
+    source-highlighter: shiki
+    page-pagination: '@'
+    # Same as the real antora-playbook.yml — see its own comment.
+    kroki-enabled: true
+    kroki-diagram-types: mermaid,plantuml,bpmn,excalidraw
+  extensions:
+    # Same as the real antora-playbook.yml — see its own comment and the
+    # writing-docs-pages skill's reference/docouture-blocks.md.
+    - '@inditextech/docouture-asciidoc-extensions'
+
+antora:
+  extensions:
+    # Same as the real antora-playbook.yml — see its own comment and the
+    # docs-internals skill's reference/antora-extensions.md.
+    - '@inditextech/docouture-antora-extensions'

package/build/templates/starter/antora-playbook.versioned.yml

@@ -0,0 +1,167 @@
+#
+# Antora playbook — the entry point for building this site.
+# Reference: https://docs.antora.org/antora/latest/playbook/
+#
+# Build with:  npx antora --fetch antora-playbook.yml
+# Output:      build/site
+#
+# Versioned (Full History) versioning — see the docouture docs-site-package
+# skill's reference/versioning-modes.md for the full mechanism this playbook
+# and docs/antora.yml together implement.
+#
+
+site:
+  title: __DOCOUTURE_TITLE__
+  # Set this to the public URL of the deployed site. It is required for the
+  # sitemap and for canonical links; leave it out while developing locally.
+  #
+  # Publishing to GitHub Pages as a project page always publishes under
+  # https://<org>.github.io/<repo>/ — the repo name has to be baked into
+  # this as a path segment; Antora uses it to generate correct absolute
+  # asset URLs — e.g.:
+  #
+  # url: https://<org>.github.io/<repo>
+  # url: https://docs.example.com
+  #
+  # A second /<component-name>/ segment only appears below (in
+  # site.start_page) if this site opted into one (`docouture new`'s "extra URL
+  # path segment" question, or `--url-segment`) — off by default, in which
+  # case docs/antora.yml's component name is Antora's reserved `ROOT` and
+  # contributes no segment.
+  start_page: __DOCOUTURE_COMPONENT_NAME__::index.adoc
+  # Side-menu brand mark (nav-brand.hbs) and browser tab icon (head-icons.hbs)
+  # — placeholder artwork under supplemental-ui/, wired via
+  # ui.supplemental_files below. Supplemental files land under the UI's own
+  # output dir (ui.output_dir, default `_`), not the site root, hence the
+  # `/_/` prefix. Swap these two files (and product-logo-dark.png, used
+  # automatically under the dark theme) for real artwork, or remove the keys
+  # entirely to fall back to a text-only brand block and no favicon.
+  keys:
+    product_logo: /_/product-logo.png
+    product_logo_dark: /_/product-logo-dark.png
+    favicon: /_/favicon.ico
+
+content:
+  sources:
+    # Antora resolves a local `url` relative to THIS FILE's own directory, not
+    # the build's cwd — and requires the resolved path to be a git worktree
+    # root itself, not merely nested inside one. This playbook lives at
+    # <repo-root>/docs/antora-playbook.yml, one level below the repository
+    # root `docouture new` scaffolded into, so `url: ..` is what reaches it — see
+    # the standalone playbook's own comment on this, and the
+    # docs-site-package skill.
+    - url: ..
+      # Repository-root relative, hence `docs/src` — see the standalone
+      # playbook's comment: the starter template's own nested `src/` lands
+      # one level below this repository's `docs/`.
+      start_path: docs/src
+      # Versioned (Full History): `main` aggregates as the prerelease
+      # version — docs/antora.yml on this branch says `version: prerelease`,
+      # `prerelease: true`, the same as the standalone mode's shape (this
+      # descriptor is identical for both modes on main — see docs/antora.yml's
+      # own comment). `tags: ['v*']` matches every release tag (v1.2.0,
+      # v2.0.0, ...) docouture-release.yml cuts, each an immutable version with
+      # its own copy of docs/antora.yml — the version dropdown grows by one
+      # every release and nothing here ever needs editing again.
+      branches: [main]
+      tags: ['v*']
+
+ui:
+  bundle:
+    # The docouture UI bundle, installed as a real npm dependency (see
+    # package.json) rather than fetched from a URL at build time — `npm
+    # install` puts it under node_modules, and Antora reads the zip straight
+    # out of there. Pinned to the exact same version as
+    # @inditextech/docouture-cli (both packages release in lockstep, one version
+    # per tag), so whatever generated this site is always what it builds
+    # with.
+    #
+    # `build/ui-bundle.zip` (no version in the name) is a stable alias the
+    # published package always carries alongside the versioned
+    # `build/ui-bundle-<version>.zip` — see ui-bundle's own alias.js — so this
+    # path never needs editing on a version bump.
+    #
+    # Swap in a different bundle instead by pointing `url` at its zip
+    # (a URL or another local path) and dropping the devDependency above.
+    url: ./node_modules/@inditextech/docouture-ui-bundle/build/ui-bundle.zip
+    snapshot: false
+  # Serves the placeholder logo and favicon under site.keys above from a
+  # root-relative URL — see the docs-site-package skill's reference/
+  # playbook.md for how this directory's contents land under the UI's own
+  # output dir at build time.
+  supplemental_files: ./supplemental-ui
+
+output:
+  # `docouture publish <target>` (see .github/workflows/docouture-publish.yml)
+  # publishes whatever is here, defaulting to this same value if the line
+  # is removed. Its own configuration — which target, and that driver's
+  # options — lives in this package's own package.json under a "docouture"
+  # key, not here: this file stays a plain, portable Antora playbook.
+  dir: build/site
+
+urls:
+  # Every page's own URL ends in a trailing slash (.../page/) resolving an
+  # index.html, rather than a bare .../page.html — a matter of taste, not a
+  # requirement; drop this line for Antora's plain default if the deployed
+  # site sits behind something that prefers literal .html routes.
+  html_extension_style: indexify
+
+runtime:
+  # Fail the build on broken xrefs and other content problems rather than
+  # publishing a site with silent gaps.
+  log:
+    failure_level: warn
+    # Antora's own default is 'warn' (@antora/playbook-builder's convict
+    # schema, not @antora/logger's own 'info' default, which never actually
+    # applies here) — below that, @inditextech/docouture-antora-extensions'
+    # diagnostic reports (docouture-version-report: which versions Antora
+    # resolved and which it picked as latest; docouture-search-index: how many
+    # pages/records were indexed) both log at 'info' and would otherwise be
+    # silently dropped, not merely hard to find in the build output.
+    level: info
+
+asciidoc:
+  attributes:
+    # Enable kbd:[], btn:[] and menu:[] macros.
+    experimental: ''
+    # Render admonition icons as font glyphs rather than text labels.
+    icons: font
+    # Add clickable anchors to section titles.
+    sectanchors: ''
+    idprefix: ''
+    idseparator: '-'
+    # Static, build-time syntax highlighting via Shiki instead of Antora's own
+    # default (highlight.js, client-side) — see
+    # @inditextech/docouture-asciidoc-extensions's shiki-syntax-highlighter.js for
+    # the adapter this name resolves to, and
+    # @inditextech/docouture-antora-extensions's shiki-prewarm.js (wired below,
+    # under `antora.extensions`) for the async setup it depends on.
+    source-highlighter: shiki
+    # Turns on the ui-bundle's previous/next footer nav (pagination.hbs) for
+    # every page by default — it is opt-in per page otherwise. `@` makes it a
+    # soft default, so an individual page can still opt out with
+    # `:!page-pagination:` (e.g. a landing-style page).
+    page-pagination: '@'
+    # Same as the real antora-playbook.yml — see its own comment.
+    kroki-enabled: true
+    kroki-diagram-types: mermaid,plantuml,bpmn,excalidraw
+  extensions:
+    # Authoring blocks with no plain AsciiDoc equivalent — [tabs], [cards],
+    # [feature-tabs], [cta], [accordion] grouping, plus the label:[]/mono:[]
+    # inline macros and a few table/video sizing attributes. See the
+    # writing-docs-pages skill's reference/docouture-blocks.md for the full
+    # syntax of each.
+    - '@inditextech/docouture-asciidoc-extensions'
+
+antora:
+  extensions:
+    # Antora pipeline extensions (a different key/kind from asciidoc.extensions
+    # above — see the docs-internals skill's reference/antora-extensions.md):
+    # nav_modules-driven module switcher, an authored site footer, the search
+    # index the UI bundle's search dialog reads, and llms.txt/llms-full.txt
+    # generation for AI ingestion. `duplicateLatestVersion` (GH #137)
+    # additionally publishes whichever release tag Antora computes as
+    # latest a second time under `/latest/…` — a real, independent copy,
+    # not a redirect stub — once a first release tag exists.
+    - require: '@inditextech/docouture-antora-extensions'
+      duplicate_latest_version: true

package/build/templates/starter/antora-playbook.yml

@@ -0,0 +1,189 @@
+#
+# Antora playbook — the entry point for building this site.
+# Reference: https://docs.antora.org/antora/latest/playbook/
+#
+# Build with:  npx antora --fetch antora-playbook.yml
+# Output:      build/site
+#
+# Standalone (default) versioning — see the docouture docs-site-package skill's
+# reference/versioning-modes.md for the full mechanism this playbook and
+# docs/antora.yml together implement.
+#
+
+site:
+  title: __DOCOUTURE_TITLE__
+  # Set this to the public URL of the deployed site. It is required for the
+  # sitemap and for canonical links; leave it out while developing locally.
+  #
+  # Publishing to GitHub Pages as a project page always publishes under
+  # https://<org>.github.io/<repo>/ — the repo name has to be baked into
+  # this as a path segment; Antora uses it to generate correct absolute
+  # asset URLs — e.g.:
+  #
+  # url: https://<org>.github.io/<repo>
+  # url: https://docs.example.com
+  #
+  # A second /<component-name>/ segment only appears below (in
+  # site.start_page) if this site opted into one (`docouture new`'s "extra URL
+  # path segment" question, or `--url-segment`) — off by default, in which
+  # case docs/antora.yml's component name is Antora's reserved `ROOT` and
+  # contributes no segment.
+  start_page: __DOCOUTURE_COMPONENT_NAME__::index.adoc
+  # Side-menu brand mark (nav-brand.hbs) and browser tab icon (head-icons.hbs)
+  # — placeholder artwork under supplemental-ui/, wired via
+  # ui.supplemental_files below. Supplemental files land under the UI's own
+  # output dir (ui.output_dir, default `_`), not the site root, hence the
+  # `/_/` prefix. Swap these two files (and product-logo-dark.png, used
+  # automatically under the dark theme) for real artwork, or remove the keys
+  # entirely to fall back to a text-only brand block and no favicon.
+  keys:
+    product_logo: /_/product-logo.png
+    product_logo_dark: /_/product-logo-dark.png
+    favicon: /_/favicon.ico
+
+content:
+  sources:
+    # Antora resolves a local `url` relative to THIS FILE's own directory, not
+    # the build's cwd — and requires the resolved path to be a git worktree
+    # root itself, not merely nested inside one. This playbook lives at
+    # <repo-root>/docs/antora-playbook.yml, one level below the repository
+    # root `docouture new` scaffolded into, so `url: ..` is what reaches it —
+    # `url: .` would point at this docs/ directory, which is not itself a
+    # git repository, and the build fails with "Local content source must be
+    # a git repository". (Only a playbook living AT the repository root can
+    # use `url: .` — see the docs-site-package skill.)
+    - url: ..
+      # Repository-root relative, hence `docs/src`: the whole starter
+      # template — including its own nested `src/` holding antora.yml — was
+      # copied under this repository's `docs/`, so the descriptor ends up at
+      # `docs/src/antora.yml`.
+      start_path: docs/src
+      # Standalone: `main` aggregates as the prerelease version —
+      # docs/antora.yml on this branch permanently says `version: prerelease`,
+      # `prerelease: true`. `stable` is a rolling tag that docouture-release.yml
+      # force-moves to a fresh one-off commit on every release, not a second
+      # long-lived branch. Until the first release, `stable` does not exist
+      # yet and this site builds with just the one (prerelease) version —
+      # that is expected, not an error.
+      branches: [main]
+      tags: ['stable']
+
+ui:
+  bundle:
+    # The docouture UI bundle, installed as a real npm dependency (see
+    # package.json) rather than fetched from a URL at build time — `npm
+    # install` puts it under node_modules, and Antora reads the zip straight
+    # out of there. Pinned to the exact same version as
+    # @inditextech/docouture-cli (both packages release in lockstep, one version
+    # per tag), so whatever generated this site is always what it builds
+    # with.
+    #
+    # `build/ui-bundle.zip` (no version in the name) is a stable alias the
+    # published package always carries alongside the versioned
+    # `build/ui-bundle-<version>.zip` — see ui-bundle's own alias.js — so this
+    # path never needs editing on a version bump.
+    #
+    # Swap in a different bundle instead by pointing `url` at its zip
+    # (a URL or another local path) and dropping the devDependency above.
+    url: ./node_modules/@inditextech/docouture-ui-bundle/build/ui-bundle.zip
+    snapshot: false
+  # Serves the placeholder logo and favicon under site.keys above from a
+  # root-relative URL — see the docs-site-package skill's reference/
+  # playbook.md for how this directory's contents land under the UI's own
+  # output dir at build time.
+  supplemental_files: ./supplemental-ui
+
+output:
+  # `docouture publish <target>` (see .github/workflows/docouture-publish.yml)
+  # publishes whatever is here, defaulting to this same value if the line
+  # is removed. Its own configuration — which target, and that driver's
+  # options — lives in this package's own package.json under a "docouture"
+  # key, not here: this file stays a plain, portable Antora playbook.
+  dir: build/site
+
+urls:
+  # Every page's own URL ends in a trailing slash (.../page/) resolving an
+  # index.html, rather than a bare .../page.html — a matter of taste, not a
+  # requirement; drop this line for Antora's plain default if the deployed
+  # site sits behind something that prefers literal .html routes.
+  html_extension_style: indexify
+  # NOTE: deliberately no `latest_version_segment` here. Under Antora's own
+  # `latest_version_segment_strategy` (default `replace`), setting it turns
+  # `.../stable/…` into a permanent redirect stub the moment a release
+  # exists — the opposite of what this standalone (stable/prerelease) setup
+  # promises. A `/.../latest/…` alias is provided instead, further down,
+  # by @inditextech/docouture-antora-extensions' `duplicateLatestVersion` (GH
+  # #137) — it publishes `stable`'s content a second time under `/latest/…`
+  # as a genuinely independent copy, so BOTH URLs stay real.
+
+runtime:
+  # Fail the build on broken xrefs and other content problems rather than
+  # publishing a site with silent gaps.
+  log:
+    failure_level: warn
+    # Antora's own default is 'warn' (@antora/playbook-builder's convict
+    # schema, not @antora/logger's own 'info' default, which never actually
+    # applies here) — below that, @inditextech/docouture-antora-extensions'
+    # diagnostic reports (docouture-version-report: which versions Antora
+    # resolved and which it picked as latest; docouture-search-index: how many
+    # pages/records were indexed) both log at 'info' and would otherwise be
+    # silently dropped, not merely hard to find in the build output.
+    level: info
+
+asciidoc:
+  attributes:
+    # Enable kbd:[], btn:[] and menu:[] macros.
+    experimental: ''
+    # Render admonition icons as font glyphs rather than text labels.
+    icons: font
+    # Add clickable anchors to section titles.
+    sectanchors: ''
+    idprefix: ''
+    idseparator: '-'
+    # Static, build-time syntax highlighting via Shiki instead of Antora's own
+    # default (highlight.js, client-side) — see
+    # @inditextech/docouture-asciidoc-extensions's shiki-syntax-highlighter.js for
+    # the adapter this name resolves to, and
+    # @inditextech/docouture-antora-extensions's shiki-prewarm.js (wired below,
+    # under `antora.extensions`) for the async setup it depends on.
+    source-highlighter: shiki
+    # Turns on the ui-bundle's previous/next footer nav (pagination.hbs) for
+    # every page by default — it is opt-in per page otherwise. `@` makes it a
+    # soft default, so an individual page can still opt out with
+    # `:!page-pagination:` (e.g. a landing-style page).
+    page-pagination: '@'
+    # Renders `[mermaid]`/`[plantuml]`/etc. blocks as real diagrams instead of
+    # literal source text, via a self-hosted Kroki service — enabled by
+    # default (comment both lines below out to turn it off). Needs Docker
+    # available; @inditextech/docouture-antora-extensions' kroki-prewarm.js
+    # starts the service itself, automatically, the first time a build needs
+    # it — no manual setup required. Run `docouture eject kroki` to copy the
+    # bundled compose file into docs/kroki-compose.yml if you need to
+    # customize it (a different image version, a companion for another
+    # diagram type, ...); `docouture teardown kroki` stops it manually, since
+    # nothing stops it automatically. `kroki-diagram-types` is a
+    # comma-separated subset of kroki.js's `SUPPORTED_TYPES` (e.g. `mermaid`
+    # or `mermaid,plantuml,bpmn,excalidraw`); omit it to enable every
+    # supported type.
+    kroki-enabled: true
+    kroki-diagram-types: mermaid,plantuml,bpmn,excalidraw
+  extensions:
+    # Authoring blocks with no plain AsciiDoc equivalent — [tabs], [cards],
+    # [feature-tabs], [cta], [accordion] grouping, plus the label:[]/mono:[]
+    # inline macros and a few table/video sizing attributes. See the
+    # writing-docs-pages skill's reference/docouture-blocks.md for the full
+    # syntax of each.
+    - '@inditextech/docouture-asciidoc-extensions'
+
+antora:
+  extensions:
+    # Antora pipeline extensions (a different key/kind from asciidoc.extensions
+    # above — see the docs-internals skill's reference/antora-extensions.md):
+    # nav_modules-driven module switcher, an authored site footer, the search
+    # index the UI bundle's search dialog reads, and llms.txt/llms-full.txt
+    # generation for AI ingestion. `duplicateLatestVersion` additionally
+    # publishes `stable`'s content a second time under `/latest/…` — a real,
+    # independent copy, not a redirect — once a first release exists (see
+    # the `urls` note above).
+    - require: '@inditextech/docouture-antora-extensions'
+      duplicate_latest_version: true

package/build/templates/starter/gitignore

@@ -0,0 +1,3 @@
+node_modules/
+build/
+.DS_Store

package/build/templates/starter/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "__DOCOUTURE_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "description": "__DOCOUTURE_TITLE__ documentation, built with Antora",
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "build": "antora --fetch antora-playbook.yml",
+    "dev": "docouture dev",
+    "clean": "node -e \"require('fs').rmSync('build', { recursive: true, force: true })\"",
+    "check-links": "node scripts/check-links.mjs"
+  },
+  "devDependencies": {
+    "@inditextech/docouture-cli": "__DOCOUTURE_CLI_VERSION__",
+    "@inditextech/docouture-ui-bundle": "__DOCOUTURE_CLI_VERSION__",
+    "@inditextech/docouture-asciidoc-extensions": "__DOCOUTURE_CLI_VERSION__",
+    "@inditextech/docouture-antora-extensions": "__DOCOUTURE_CLI_VERSION__",
+    "@inditextech/docouture-publish-gh-pages": "__DOCOUTURE_CLI_VERSION__",
+    "antora": "3.1.15",
+    "linkinator": "8.0.4"
+  },
+  "docouture": {
+    "publish": {
+      "gh-pages": {}
+    },
+    "checkLinks": {
+      "ignore": [
+        "*/edit/HEAD/*",
+        "https://<org>.github.io/<repo>",
+        "__DOCOUTURE_REPO_IGNORE_GLOB__"
+      ]
+    }
+  }
+}