Symbole in umstrukturiertemText

Question

Ich möchte einige Symbole in restructuredText verwenden; wie kann ich das tun? (z.B.. → in Markdown ergibt das "→"-Symbol gemäß der Definition in der Liste der Standard-HTML-Zeicheneinheiten -- siehe auch w3c-Referenz )

Hinweis: Ich möchte die Unterstützung von mathematischen Formeln nicht als Abhängigkeit voraussetzen.

Answer 1

Über den Operator "Substitution" können Sie eine große Anzahl von Symbolen definieren.

Sie müssen die Definitionen über .. include:: <isonum.txt> oder etwas Ähnliches.

Die meisten von ihnen haben die Form |larr| o |rarr| .

Sie sind definiert in der docutils.parsers.rst.include Installationsverzeichnis. Es gibt Dutzende von Dateien, die zahlreiche Unicode-Zeichen definieren.

Answer 2

Ich hatte den Eindruck, dass rst Unicode unterstützt; können Sie einfach das rohe Zeichen eintippen und die docutils Kodierung für HTML behandeln?

Answer 3

Ich glaube, Sie haben das hier gesucht: http://docutils.sourceforge.net/docs/ref/rst/roles.html#raw

Sie können die folgende Rolle definieren:

.. role::  raw-html(raw)
    :format: html

Und dann können Sie schreiben:

This way :raw-html:`→`

Das sieht dann so aus:

Auf diese Weise →

Answer 4

Ich hatte ein ähnliches Problem bei der Erstellung von html aus .rst-Dateien, die das ±-Zeichen in Windows mit Sphinx enthielten. Durch Ändern der Dateikodierung von Windows-1252 auf UTF-8 konnte ich das Problem beheben.

Einfach mit Notepad öffnen, Speichern unter..., und Encoding: auf UTF-8 ändern