mezzanine-mdown

Mezzanine-mdown bietet Widgets und Filter für Zwischengeschoss, die Administratoren ermöglichen, Markdown Formatierung nutzen, um ihre Inhalte zu erstellen, anstatt den TinyMCE Editor html in Rich Content-Typen wie reiche Seiten und Blog-Posts verwendet generieren.
Installation
Holen Sie sich das Paket
pip:
user @ home: ~ $ pip installieren Mezzanine-mdown
easy_install:
user @ home: ~ $ easy_install Mezzanine-mdown
Prep die statischen Medien
Unter Verwendung der ausgezeichneten staticfiles app, sollten statische Dateien mdown die automatisch abgeholt.
Wenn die staticfiles app ist nicht Ihr Stil, müssen Sie den Installationsort für die mdown Paket (in der Regel site-packages-Verzeichnis Ihrer Python-Interpreter) zu lokalisieren und kopieren / Symlink mdown / static / mdown in Ihr Projekt site_media Verzeichnis.
Konfiguration
First off, fügen mdown zur Liste ihrer INSTALLED_APPS in den Projekteinstellungen-Modul.
Mit installiert die App, müssen Sie ein paar Entscheidungen zu treffen. Sie müssen die RICHTEXT_WIDGET_CLASS und RICHTEXT_FILTER Werte in Ihre Einstellungen Modul angeben.
RICHTEXT_WIDGET_CLASS
Dieses Paket enthält 2 Optionen für diese Einstellung.
mdown.forms.WmdWidget
& Nbsp; Aktiviert die WMD Rich Text Editor. (Empfohlen)
mdown.forms.PlainWidget
& Nbsp; Verwenden Sie einen Klartextarea (kein Rich Text Editor).
RICHTEXT_FILTER
Auch hier gibt es 2 Optionen für diese Einstellung.
mdown.filters.codehilite
& Nbsp; Renders den Inhalt mit Markdown mit dem codehilite Erweiterung aktiviert.
mdown.filters.plain
& Nbsp; Renders den Inhalt mit Vanille Abschlag Formatierung.
Zusätzliche Schritte
Pygments Styles
Mit den Verwaltungsbefehl pygments_styles Sie css zu erzeugen, um Codeblöcke durch den Filter analysiert codehilite kolorieren.
Hinweis: Dies erfordert pygments installiert werden (Verwendung pip pygments oder easy_install pygments installieren, um diese Funktion zu nutzen).
Rufen Sie den Befehl ohne Argumente, um einen Bedienungshinweis und Liste der verfügbaren Farbschemata auf Ihrem System finden .:
user @ home: ~ / mysite $ ./manage.py pygments_styles
Verbrauch: ./manage.py pygments_styles
Verfügbare Farben:
& Nbsp; borland
& Nbsp; bw
& Nbsp; bunt
& Nbsp; Standard
& Nbsp; ... [Ausschnitt] ...
Unter Berufung auf mit dem Namen der Regelung als Argument wird die CSS auf die Standardausgabe, die Sie in eine Datei umleiten, so wie zu drucken:
user @ home: ~ / mysite $ ./manage.py bunten pygment_styles> site_media / css / pygments.css
In additon zu dieser Regelung einzelnen Verfahren, übernimmt der Befehl auch die --all Flagge, die Stile für alle verfügbaren erzeugen wird, aber mit einem wesentlichen Unterschied: Jede Regelung ist mit seinem Namen als CSS-Klassennamen vorangestellt. Dies ist während der Themenentwicklung praktisch, da man schnell wechseln pygments Systeme nur durch Einstellen der Klasse auf dem Body-Tag, um die Auswahl der Regelung ohne CSS-Dateien ständig zu regenerieren.
Sobald Sie eine CSS-Datei erzeugt haben, es ist einfach zu Basisvorlage Ihrer Website hinzufügen, um Ihren Code zu bekommen "pretty" gedruckt.
Aktualisieren Theme Templates
Themen, die auf dem Standard-Theme basiert wurden und wurden vor der Mezzanine ist 0.11.3 Release erstellt wird höchstwahrscheinlich nicht die richtext_filter um reichhaltige Inhalte angewendet. Um dies zu korrigieren, müssen Sie einfach die Vorlagen für diese Inhaltstypen zu aktualisieren, so dass der Filter verwendet wird.
Zum Beispiel im Standard-Theme, die templates / Blog / blog_post_detail.html hatte eine Linie, die aus wurde aktualisiert ::
{{Blog_post.content | Safe}}
zu ::
{{Blog_post.content | richtext_filter | Safe}}
. Einfach sicher, dass der Safe-Filter kommt nach der richtext_filter

Anforderungen :

• Python