···

       
1
       
1
       
 
       
--[[

     

       
2
       
2
       
-
       
Turns a manpage reference into a link, when a mapping is defined

     

       
3
       
3
       
-
       
in the unix-man-urls.lua file.

     

       
2
       
2
       
+
       
Turns a manpage reference into a link, when a mapping is defined below.

     

       
4
       
3
       
 
       
]]

     

       
5
       
4
       
 
       


     

       
6
       
5
       
 
       
local man_urls = {

     

···

       
55
       
55
       
 
       
- []{#ssec-contributing-markup-inline-roles}

     

       
56
       
56
       
 
       
  If you want to link to a man page, you can use `` {manpage}`nix.conf(5)` ``, which will turn into {manpage}`nix.conf(5)`.

     

       
57
       
57
       
 
       


     

       
58
       
58
       
-
       
  The references will turn into links when a mapping exists in {file}`doc/build-aux/pandoc-filters/unix-man-urls.lua`.

     

       
58
       
58
       
+
       
  The references will turn into links when a mapping exists in {file}`doc/build-aux/pandoc-filters/link-unix-man-references.lua`.

     

       
59
       
59
       
 
       


     

       
60
       
60
       
 
       
  This syntax is taken from [MyST](https://myst-parser.readthedocs.io/en/latest/syntax/syntax.html#roles-an-in-line-extension-point). Though, the feature originates from [reStructuredText](https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#role-manpage) with slightly different syntax.

     

       
61
       
61