Acronym Extension
The acronym extension provides a convenient way to defined acronyms that may be used throughout all documentation pages. On each page the full text and acronym definition will be displayed the first time is used, as shown in Example 1.
When viewing on the website a tooltip is created for the acronyms, the full name will appear when the mouse is placed over the acronym.
Acronym List
A list of acronyms can be created by using the !acronym list
command. Table 1 show the available options for this command.
Table 1: Available configuration options for the !acronym list
command.
Key | Default | Description |
---|---|---|
style | None | The style settings that are passed to rendered HTML tag. |
class | None | The class settings to be passed to rendered HTML tag. |
id | None | The class settings to be passed to the rendered tag. |
complete | False | Show the complete list of acronyms regardless of use on current page. |
location | None | The markdown content directory to build the list from. |
heading | True | Display the headings row of the acronym table. |
prefix | Table | Prefix to use when a caption and id are provided. |
caption | None | The caption to use for the acronym table. |
Configuration
The available configuration options for the acronym extension are provided in Table 2.
Table 2: Available configuration options for the AcronymExtension object.
Key | Default | Description |
---|---|---|
active | True | Toggle for disabling the extension. This only changes the initial active state, use setActive to control at runtime. |
acronyms | {} | Complete dict (or dict of dict) of acronyms. |
The acronyms are defined in the configuration (e.g., config.yml
) as a dictionary of items under the "acronyms" configuration item.
Additionally, multiple dictionaries may be used to allow items to be pulled from multiple sources. For example, to use the acronyms defined within the framework as well as define additional items, the following may be done.