mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-12-26 13:41:07 +00:00
docs: Fix links in markdown content differently
pandoc insists on using the xlink namespace for hrefs, and the namespace setup doesn't carry over xi:includes. My first fix was to tell pandoc to generate standalone docbook documents, which makes it insert the xlink namespace. But it also makes it wrap all sections and chapters in articles, and that messes up our toc structure. So, patch things up differently by stripping the xlink: from hrefs via regex. Yay for XML!
This commit is contained in:
parent
d40b1d31b5
commit
85fb015b45
@ -12,6 +12,13 @@ import subprocess
|
||||
# The following code is taken from gtk-doc
|
||||
|
||||
def ExpandAbbreviations(symbol, text):
|
||||
# Hack!
|
||||
# Strip xlink namespace from hrefs since pandoc insists on
|
||||
# inserting them, and namespace setup doesn't transfer across
|
||||
# xi:include.
|
||||
# Yay for XML!
|
||||
text = re.sub('xlink:href', 'href', text)
|
||||
|
||||
# Convert '@param()'
|
||||
text = re.sub(r'(\A|[^\\])\@(\w+((\.|->)\w+)*)\s*\(\)', r'\1<parameter>\2()</parameter>', text)
|
||||
|
||||
@ -177,7 +184,6 @@ def ConvertToDocbook(infile, outfile):
|
||||
subprocess.check_call(["pandoc", infile, "-o", outfile,
|
||||
"--from=" + input_format,
|
||||
"--to=" + output_format,
|
||||
"--standalone",
|
||||
"--top-level-division=" + division])
|
||||
|
||||
def ExpandGtkDocAbbreviations(infile, outfile):
|
||||
|
Loading…
Reference in New Issue
Block a user