Customize the Title
title key is used for sorting the versions by name and for display purposes in the reference UI when a component name contains uppercase letters, symbols, or blank spaces.
It doesn’t affect page and resource IDs or the component name segment in the page URL.
title key is optional.
It’s set in a component version’s antora.yml file and used by the reference UI where ever the component’s name is displayed, including the component version page menu, component version selector, and first breadcrumb position on a component version’s pages.
title isn’t set, the reference UI uses the value of name instead.
name, the value of
title can contain empty spaces, uppercase letters, and a broader range of characters (e.g.,
name: colorado title: Colorado ∆ version: '5.6'
This key is useful when a project’s name contains spaces or characters that break Antora’s page and resource IDs, prevent portability between web servers, or aren’t recommended in URLs.
Also, if the name of your project changes, you can change the value of the
title key but not have to update page and resource IDs or redirect URLs.
Assign a title to a component version
Let’s expand on the antora.yml example where you previously learned how to assign a component name and version.
The project’s official name is Silver Leaf, and the team wants this name to be displayed in the UI.
name can’t contain blank spaces, let’s set
title in the component version’s antora.yml file.
Open the component version’s antora.yml file in the text editor or IDE of your choice.Example 2. antora.yml for the component version silver-leaf 7.1
name: silver-leaf version: '7.1'
On a blank line, type
title, directly followed by a colon (
Insert a blank space after the colon, and then type the value you want to assign to
name: silver-leaf title: Silver Leaf version: '7.1'
Save the file.
Now, the UI will display Silver Leaf in the component version page menu, component version selector, and page breadcrumbs.