mirror of
https://github.com/apple/swift.git
synced 2025-12-14 20:36:38 +01:00
53 lines
1.6 KiB
Python
Executable File
53 lines
1.6 KiB
Python
Executable File
#!/usr/bin/env python
|
|
import sys, re, subprocess
|
|
|
|
def run():
|
|
if len(sys.argv) > 1:
|
|
print """
|
|
ns-html2rst - Convert Cocoa HTML documentation into ReST
|
|
|
|
usage: nshtml2rst < NSString.html > NSString.rst
|
|
"""
|
|
exit(0)
|
|
|
|
html = sys.stdin.read()
|
|
|
|
# Treat <div class="declaration>...</div> as <pre>...</pre>
|
|
html = re.sub(
|
|
r'<div\s+class="declaration">(.*?)</div>',
|
|
r'<pre>\1</pre>',
|
|
html, flags=re.MULTILINE|re.DOTALL)
|
|
|
|
# Strip all attributes from <pre>...</pre> containing class="..."
|
|
# The resulting classes confound ReST
|
|
html = re.sub(
|
|
r'<pre\s[^>]*class=[^>]*>(.*?)</pre>',
|
|
r'<pre>\1</pre>',
|
|
html, flags=re.MULTILINE|re.DOTALL)
|
|
|
|
# Remove links from <code>...</code>, which doesn't have a rendering in ReST
|
|
html = re.sub(
|
|
r'<code>(.*?)<a[^>]*?>(.*?)</a>(.*?)</code>',
|
|
r'<code>\1\2\3</code>',
|
|
html, flags=re.MULTILINE|re.DOTALL)
|
|
|
|
# Let pandoc do most of the hard work
|
|
p = subprocess.Popen(
|
|
args=['pandoc', '--reference-links', '-f', 'html', '-t', 'rst']
|
|
, stdin=subprocess.PIPE
|
|
, stdout=subprocess.PIPE
|
|
)
|
|
rst,stderr = p.communicate(html)
|
|
|
|
# HACKETY HACK HACK: Our html documents apparently contain some
|
|
# bogus heading level nesting. Just fix up the one we know about
|
|
# so that ReST doesn't complain later.
|
|
rst = re.sub("(^|\n)('+)($|\n)",
|
|
lambda m: m.group(1) + len(m.group(2))*'^' +m.group(3),
|
|
rst, flags=re.MULTILINE)
|
|
|
|
sys.stdout.write(rst)
|
|
|
|
if __name__ == '__main__':
|
|
run()
|