File: article_info.md

package info (click to toggle)
rocm-docs-core 1.23.0-5
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 2,632 kB
  • sloc: python: 1,960; sh: 160; javascript: 152; cpp: 29; makefile: 27
file content (41 lines) | stat: -rw-r--r-- 1,470 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
---
myst:
    html_meta:
        "description": "Setting article info in ROCm documentation"
        "keywords": "Documentation settings, Display document information, Display article metadata, Display document metadata"
---

# Article Info

Article info is disabled by default and must be enabled in `conf.py`.

## Settings

*Legend: `setting name (setting data type):` explanation*

- `setting_all_article_info (bool)`: Setting this value to true will enable article info for all pages and use default values. See possible settings for default values.

- `all_article_info_os (list[str])`: Determines which supported OS appear in the article info. Possible strings are `"linux"` and `"windows"`. Default value is `["linux"]`.

- `all_article_info_author (str)`: Determines the author. Default is empty string.

- `all_article_info_date (str)`: Determines date of publication. Default is the date the file was last modified in git.

- `all_article_info_read_time (str)`: Determines the read time. Default is calculated based on the number of words in the file.

- `article_pages (list[dict])`: Used for specific settings for a page. These override any of the general settings above (eg: `all_article_info_<field>`).

Example:

```python
article_pages = [
    {
        "file":"index",
        "os":["linux", "windows"],
        "author":"Author: AMD",
        "date":"2023-05-01",
        "read-time":"2 min read"
    },
    {"file":"developer_guide/commitizen"}
]
```