Mercurial

comparison third_party/libuv/docs/src/sphinx-plugins/manpage.py @ 160:948de3f54cea

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[ThirdParty] Added libuv
author June Park <parkjune1995@gmail.com>
date Wed, 14 Jan 2026 19:39:52 -0800
parents
children
comparison
equal deleted inserted replaced
159:05cf9467a1c3 160:948de3f54cea
1 # encoding: utf-8
2
3 #
4 # Copyright (c) 2013 Dariusz Dwornikowski. All rights reserved.
5 #
6 # Adapted from https://github.com/tdi/sphinxcontrib-manpage
7 # License: Apache 2
8 #
9
10
11 import re
12
13 from docutils import nodes, utils
14 from docutils.parsers.rst.roles import set_classes
15 from string import Template
16
17
18 def make_link_node(rawtext, app, name, manpage_num, options):
19 ref = app.config.man_url_regex
20 if not ref:
21 ref = "https://man7.org/linux/man-pages/man%s/%s.%s.html" %(manpage_num, name, manpage_num)
22 else:
23 s = Template(ref)
24 ref = s.substitute(num=manpage_num, topic=name)
25 set_classes(options)
26 node = nodes.reference(rawtext, "%s(%s)" % (name, manpage_num), refuri=ref, **options)
27 return node
28
29
30 def man_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
31 app = inliner.document.settings.env.app
32 p = re.compile("([a-zA-Z0-9_\.-_]+)\((\d)\)")
33 m = p.match(text)
34
35 manpage_num = m.group(2)
36 name = m.group(1)
37 node = make_link_node(rawtext, app, name, manpage_num, options)
38 return [node], []
39
40
41 def setup(app):
42 app.add_role('man', man_role)
43 app.add_config_value('man_url_regex', None, 'env')
44 return
45