Sphinx extensions¶
- .. currentlanguage::¶
This directive solves a subtle problem when documenting multilingual Lino applications: I want to write tickets in the language of the user who reported it. That language is not necessarily English. I don’t want to translate tickets. But I want to expand ddref roles into the user’s language, not to English.
Commands¶
- .. command::¶
Define a “command”, i.e. a suite of words to be typed at a command line.
- :cmd:¶
Refer to a command defined elsewhere.
Don’t mix this with the built-in command role.
Blogging¶
- .. blogger_year::¶
Inserts a calendar for the given year with the twelve months. The individual days are linked to their respective daily entry.
- .. blogger_index::¶
Inserts a main index page forthis blog, one entry for every year.
Inline markup¶
Example:
The :role:`role` *role* inserts a *reference to* a
role *definition* which is defined somewhere else using a
:dir:`role` *directive*.
Result:
The role:role role inserts a reference to a role definition which is defined somewhere else using a role directive.