mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
92 lines
3.1 KiB
Python
92 lines
3.1 KiB
Python
|
# -*- coding: utf-8 -*-
|
||
|
|
"""
|
||
|
|
test_markup
|
||
|
|
~~~~~~~~~~~
|
||
|
|
|
||
|
|
Test various Sphinx-specific markup extensions.
|
||
|
|
|
||
|
|
:copyright: 2008 by Georg Brandl.
|
||
|
|
:license: BSD.
|
||
|
|
"""
|
||
|
|
|
||
|
|
from util import *
|
||
|
|
|
||
|
|
from docutils import frontend, utils, nodes
|
||
|
|
from docutils.parsers import rst
|
||
|
|
|
||
|
|
from sphinx import addnodes
|
||
|
|
from sphinx.htmlwriter import HTMLWriter, SmartyPantsHTMLTranslator
|
||
|
|
from sphinx.latexwriter import LaTeXWriter, LaTeXTranslator
|
||
|
|
|
||
|
|
app = TestApp()
|
||
|
|
optparser = frontend.OptionParser(components=(rst.Parser, HTMLWriter, LaTeXWriter))
|
||
|
|
settings = optparser.get_default_values()
|
||
|
|
settings.env = app.builder.env
|
||
|
|
parser = rst.Parser()
|
||
|
|
|
||
|
|
# since we're not resolving the markup afterwards, these nodes may remain
|
||
|
|
class ForgivingTranslator:
|
||
|
|
def visit_pending_xref(self, node):
|
||
|
|
pass
|
||
|
|
def depart_pending_xref(self, node):
|
||
|
|
pass
|
||
|
|
|
||
|
|
class ForgivingHTMLTranslator(SmartyPantsHTMLTranslator, ForgivingTranslator):
|
||
|
|
pass
|
||
|
|
|
||
|
|
class ForgivingLaTeXTranslator(LaTeXTranslator, ForgivingTranslator):
|
||
|
|
pass
|
||
|
|
|
||
|
|
|
||
|
|
def verify(rst, html_expected, latex_expected):
|
||
|
|
document = utils.new_document('test data', settings)
|
||
|
|
parser.parse(rst, document)
|
||
|
|
for msg in document.traverse(nodes.system_message):
|
||
|
|
if msg['level'] == 1:
|
||
|
|
msg.replace_self([])
|
||
|
|
|
||
|
|
if html_expected:
|
||
|
|
html_translator = ForgivingHTMLTranslator(app.builder, document)
|
||
|
|
document.walkabout(html_translator)
|
||
|
|
html_translated = ''.join(html_translator.fragment).strip()
|
||
|
|
assert html_translated == html_expected, 'from ' + rst
|
||
|
|
|
||
|
|
if latex_expected:
|
||
|
|
latex_translator = ForgivingLaTeXTranslator(document, app.builder)
|
||
|
|
latex_translator.first_document = -1 # don't write \begin{document}
|
||
|
|
document.walkabout(latex_translator)
|
||
|
|
latex_translated = ''.join(latex_translator.body).strip()
|
||
|
|
assert latex_translated == latex_expected, 'from ' + rst
|
||
|
|
|
||
|
|
|
||
|
|
def test_inline():
|
||
|
|
# correct interpretation of code with whitespace
|
||
|
|
_html = ('<p><tt class="docutils literal"><span class="pre">'
|
||
|
|
'code</span> <span class="pre">sample</span></tt></p>')
|
||
|
|
verify('``code sample``', _html, '\\code{code sample}')
|
||
|
|
verify(':samp:`code sample`', _html, '\\samp{code sample}')
|
||
|
|
|
||
|
|
# interpolation of braces in samp and file roles (HTML only)
|
||
|
|
verify(':samp:`a{b}c`',
|
||
|
|
'<p><tt class="docutils literal"><span class="pre">a</span>'
|
||
|
|
'<em><span class="pre">b</span></em><span class="pre">c</span></tt></p>',
|
||
|
|
'\\samp{abc}')
|
||
|
|
|
||
|
|
# interpolation of arrows in menuselection
|
||
|
|
verify(':menuselection:`a --> b`',
|
||
|
|
u'<p><em>a \N{TRIANGULAR BULLET} b</em></p>',
|
||
|
|
'\\emph{a $\\rightarrow$ b}')
|
||
|
|
|
||
|
|
# non-interpolation of dashes in option role
|
||
|
|
verify(':option:`--with-option`',
|
||
|
|
'<p><em>--with-option</em></p>',
|
||
|
|
r'\emph{\texttt{--with-option}}')
|
||
|
|
|
||
|
|
# verify smarty-pants quotes
|
||
|
|
verify('"John"', '<p>“John”</p>', "``John''")
|
||
|
|
# ... but not in literal text
|
||
|
|
verify('``"John"``',
|
||
|
|
'<p><tt class="docutils literal"><span class="pre">'
|
||
|
|
'"John"</span></tt></p>',
|
||
|
|
'\\code{"John"}')
|