Documentation | Fix glossary format (!188)
Sebastian Huber (@sebhub)
gitlab at rtems.org
Mon Aug 25 08:51:38 UTC 2025
Sebastian Huber created a merge request: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/188
Project:Branches: sebhub/rtems-docs:fix-glossary-format to rtems/docs/rtems-docs:main
Author: Sebastian Huber
Assignee: Sebastian Huber
## Summary
Fix glossary format
According to the
[MyST documentation](https://mystmd.org/guide/glossaries-and-terms#glossaries)
glossaries should have this format:
```
:::{glossary}
term
: Definition line 0
Definition line 1
:::
```
However, this does not produce the expected output by Sphinx.
The `: Definition line 0` is added to the glossary term.
The `Definition line 1` is the definition.
What works is the formation mentioned in the compatibility note:
````markdown
```{glossary}
term
Definition line 0
Definition line 1
```
````
<!-- Default settings, if it is a dropdown it will set after submission -->
--
View it on GitLab: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/188
You're receiving this email because of your account on gitlab.rtems.org.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/bugs/attachments/20250825/23f3f858/attachment.htm>
More information about the bugs
mailing list