46 lines
1.2 KiB
Python
46 lines
1.2 KiB
Python
|
# encoding: utf-8
|
||
|
|
|
||
|
|
#
|
||
|
|
# Copyright (c) 2013 Dariusz Dwornikowski. All rights reserved.
|
||
|
|
#
|
||
|
|
# Adapted from https://github.com/tdi/sphinxcontrib-manpage
|
||
|
|
# License: Apache 2
|
||
|
|
#
|
||
|
|
|
||
|
|
|
||
|
|
import re
|
||
|
|
|
||
|
|
from docutils import nodes, utils
|
||
|
|
from docutils.parsers.rst.roles import set_classes
|
||
|
|
from string import Template
|
||
|
|
|
||
|
|
|
||
|
|
def make_link_node(rawtext, app, name, manpage_num, options):
|
||
|
|
ref = app.config.man_url_regex
|
||
|
|
if not ref:
|
||
|
|
ref = "https://man7.org/linux/man-pages/man%s/%s.%s.html" %(manpage_num, name, manpage_num)
|
||
|
|
else:
|
||
|
|
s = Template(ref)
|
||
|
|
ref = s.substitute(num=manpage_num, topic=name)
|
||
|
|
set_classes(options)
|
||
|
|
node = nodes.reference(rawtext, "%s(%s)" % (name, manpage_num), refuri=ref, **options)
|
||
|
|
return node
|
||
|
|
|
||
|
|
|
||
|
|
def man_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
|
||
|
|
app = inliner.document.settings.env.app
|
||
|
|
p = re.compile("([a-zA-Z0-9_\.-_]+)\((\d)\)")
|
||
|
|
m = p.match(text)
|
||
|
|
|
||
|
|
manpage_num = m.group(2)
|
||
|
|
name = m.group(1)
|
||
|
|
node = make_link_node(rawtext, app, name, manpage_num, options)
|
||
|
|
return [node], []
|
||
|
|
|
||
|
|
|
||
|
|
def setup(app):
|
||
|
|
app.add_role('man', man_role)
|
||
|
|
app.add_config_value('man_url_regex', None, 'env')
|
||
|
|
return
|
||
|
|
|