comparison doc/runrst @ 10974:854ac04d712c

doc: make links for hg role

The system has a bit of smartness:

  :hg:`update`     -> links to hg.1.html#update
  :hg:`help diffs` -> links to hg.1.html#diffs

10973:49a07f441496

from docutils.core import publish_cmdline
from docutils import nodes, utils

def role_hg(name, rawtext, text, lineno, inliner,
            options={}, content=[]):
    node = nodes.literal(rawtext, "hg " + utils.unescape(text, True))
    return [node], []

roles.register_local_role("hg", role_hg)

if __name__ == "__main__":

10974:854ac04d712c

from docutils.core import publish_cmdline
from docutils import nodes, utils

def role_hg(name, rawtext, text, lineno, inliner,
            options={}, content=[]):
    text = "hg " + utils.unescape(text)
    linktext = nodes.literal(rawtext, text)
    parts = text.split()
    cmd, args = parts[1], parts[2:]
    if cmd == 'help' and args:
        cmd = args[0] # link to 'dates' for 'hg help dates'
    node = nodes.reference(rawtext, '', linktext,
                           refuri="hg.1.html#%s" % cmd)
    return [node], []

roles.register_local_role("hg", role_hg)

if __name__ == "__main__":