Wie kann ich in reStructuredText einen geschützten Bereich erstellen?

Question

Wie kann ich einen geschützten Bereich in reStructuredText erstellen?

Eine offensichtliche, aber problematische Lösung ist:

`word A` 

Aber es könnte anders durch verschiedene Implementierungen, wie rst2latex oder rst2pdf behandelt werden. Plus es ist kursiv wiedergegeben.

Answer 1

Ich sehe das Problem hier nicht, mit Docutils v0.9. Mindestens rst2latex und rst2html verhalten sich in Bezug auf nicht-brechende Leerzeichen korrekt. Latex erzeugt ~ und HTML erzeugt & nbsp; Wenn Sie ein nicht brechendes Zeichen eingeben (\ xa0, \ 0240).

Vielleicht haben Sie ein Editor Problem? Wenn Sie es schaffen, den Charakter einzugeben, wird Docutils die Aufgabe übernehmen.

Answer 2

Ich habe es nicht getestet, aber vielleicht können Sie http://docutils.sourceforge.net/docs/ref/rst/directives.html#unicode-character-codes und die Unicode „kein Bruch space“ Zeichen verwenden: http://www.fileformat.info/info/unicode/char/a0/index.htm

Answer 3

Sie müssen die Unicode-Richtlinie, aber es kann nur in Substitutionen verwendet werden. Sie müssen also eine Substitution wie folgt definieren:

.. |nbsp| unicode:: 0xA0 
    :trim: 

und es dann wie folgt verwenden:

xx |nbsp| xx 

:trim: ist diese Räume rund um die Substitution loszuwerden.

Answer 4

Ich endete mit einem Workaround für Sphinx. Ich überschreibe die HTML- und LaTeX-Writer, um das Zeichen ~ in ein nicht-brechendes Leerzeichen zu konvertieren. Hier ist der HTML ein:

import sphinx.writers.html 
BaseTranslator = sphinx.writers.html.SmartyPantsHTMLTranslator 

class CustomHTMLTranslator(BaseTranslator): 

    def bulk_text_processor(self, text): 
     if '~' in text: 
      text = text.replace('~', ' ') 
     return text 

sphinx.writers.html.SmartyPantsHTMLTranslator = CustomHTMLTranslator 

und der Latex ein:

import sphinx.writers.latex 
BaseTranslator = sphinx.writers.latex.LaTeXTranslator 

class DocTranslator(BaseTranslator): 

    def visit_Text(self, node): 
     if self.verbatim is not None: 
      self.verbatim += node.astext() 
     else: 
      text = self.encode(node.astext()) 
      if '\\textasciitilde{}' in text: 
       text = text.replace('\\textasciitilde{}', '~') 
      if not self.no_contractions: 
       text = educate_quotes_latex(text) 
      self.body.append(text) 

sphinx.writers.latex.LaTeXTranslator = DocTranslator 

Es ist nicht so schön, und es ist nicht einmal lassen Sie entkommen den ~ Charakter, aber es funktioniert für meine Zwecke.

Answer 5

Sie können auch |_| anstelle von |nbsp| verwenden, was weniger visuell aufdringlich ist, da reStructuredText das Ziel hat, als reiner Text lesbar zu sein.