On this page, you’ll learn:
How to add a title to the site.
How to configure the site’s base URL.
How to assign a site start page.
How to associate the site with a Google Analytics account.
Use the title key (
title) to add a title to your site.
site: title: Demo Docs Site
The title is displayed wherever the site’s UI calls this key. Antora’s default UI displays the site title in the navigation bar at the top of the site.
The site URL key (
url) is the base URL of the published site.
url value must be a valid URI scheme that is directly followed by a colon and two slashes (
Common URI schemes include
The URI should be absolute, e.g., https://www.project.org/docs or https://docs.product.com. The base URL should not end with a trailing slash.
site: url: https://demo.antora.org
When the site is generated, the component, version, module, and page URL segments are appended to the site URL, e.g., https://demo.antora.org/component/version/page.html.
You can use a page from a documentation component as the index page for your site. When a start page is specified, visitors are redirected from the site’s index page at the base URL to the URL of the start page.
The start page key (
start_page) accepts a page ID as a value.
If you want the site’s start page to be a specific version of the designated page, include the version in the page ID.
site: title: Demo Docs Site url: https://demo.antora.org start_page: 1.0@component-b::index.adoc
In this example, https://demo.antora.org/index.html will redirect to https://demo.antora.org/component-b/1.0/index.html.
If you want the start page to always point to the last version of the page you designate, don’t include a version in the page ID.
site: title: Demo Docs Site url: https://demo.antora.org start_page: component-b::index.adoc
For this example, let’s say that version 2.0 is the latest version of Component B. In this case, https://demo.antora.org/index.html will redirect to https://demo.antora.org/component-b/2.0/index.html.
Account keys for services can be passed to Antora using the
google_analytics key assigns a Google Analytics account to the site.
site: title: Demo Docs Site url: https://demo.antora.org keys: google_analytics: 'XX-123456'
The account key must be enclosed in single quotation marks (