mezzanine-mdown

mezzanin-mdown giver widgets og filtre til mezzanin, der gør admins at bruge markdown formatering til at oprette deres indhold på webstedet, snarere end at bruge TinyMCE editor til at generere html anvendt i rige indholdstyper, såsom rige sider og blogindlæg.
Installation
Få pakken
pip:
bruger @ home: ~ $ pip installere mezzanin-mdown
easy_install:
bruger @ home: ~ $ easy_install mezzanin-mdown
Prep de statiske medier
Brug af fremragende staticfiles app, bør mdown er statiske filer blive afhentet automatisk.
Hvis staticfiles app er ikke din stil, skal du finde installere placering til mdown pakken (normalt din python tolkens site-pakker mappe) og kopiere / symlink mdown / statisk / mdown i projektet site_media mappe.
Konfiguration
First off, tilføje mdown til din liste over INSTALLED_APPS i dit projektindstillinger modul.
Med app'en installeret, er du nødt til at foretage et par valg. Du bliver nødt til at specificere RICHTEXT_WIDGET_CLASS og RICHTEXT_FILTER værdier i din indstillinger modul.
RICHTEXT_WIDGET_CLASS
Denne pakke indeholder 2 muligheder for denne indstilling.
mdown.forms.WmdWidget
& Nbsp; Aktiverer masseødelæggelsesvåben rich text editor. (Anbefales)
mdown.forms.PlainWidget
& Nbsp; Brug en almindelig Textarea (ingen rige tekst editor).
RICHTEXT_FILTER
Igen er der 2 muligheder for denne indstilling.
mdown.filters.codehilite
& Nbsp; Renders indholdet ved hjælp markdown med codehilite forlængelse aktiveret.
mdown.filters.plain
& Nbsp; Renders indholdet ved hjælp af vanille markdown formatering.
Ekstra Steps
Pygments Styles
Brug af kommandoen management pygments_styles du kan generere css til farvelægger kodeblokke parsede af codehilite filteret.
Bemærk: det kræver pygments der skal installeres (brug pip installere pygments eller easy_install pygments at bruge denne funktion).
Påberåbe sig kommandoen uden args at se et forbrug budskab og liste over tilgængelige farveskemaer på systemet .:
bruger @ home: ~ / MySite $ ./manage.py pygments_styles
Anvendelse: ./manage.py pygments_styles
Tilgængelige farveskemaer:
& Nbsp; Borland
& Nbsp; bw
& Nbsp; farverigt
& Nbsp; standard
& Nbsp; ... [snip] ...
Påberåber med ordningens navn som argument vil udskrive css til stdout, som du kan omdirigere til en fil som så:
bruger @ home: ~ / MySite $ ./manage.py pygment_styles farverigt> site_media / css / pygments.css
I additon til denne fælles ordning metode, accepterer kommandoen også --all flag, hvilket vil generere stilarter for alle tilgængelige, men med én afgørende forskel: hver ordning er foranstillet med navn som en css klasse navn. Dette er praktisk under temaet udvikling som du hurtigt kan skifte pygments ordninger blot ved at sætte klassen på kroppen tag til dit valg af ordningen uden at regenerere css filer konstant.
Når du har fået en css fil genereret, skal du blot føje det til dit websted base skabelon for at få din kode "pretty" trykt.
Opdatering Tema skabeloner
Temaer, der var baseret på standard tema og blev skabt før Mezzanine s 0.11.3 udgivelse vil højst sandsynligt ikke have den richtext_filter anvendt på rige indhold. For at rette dette, du simpelthen nødt til at opdatere skabeloner for disse indholdstyper, så filteret bliver brugt.
For eksempel i standard tema, den templates / blog / blog_post_detail.html havde en linje, der blev opdateret fra ::
{{Blog_post.content | safe}}
til ::
{{Blog_post.content | richtext_filter | safe}}
. Bare sørge for, at en sikker filter kommer efter richtext_filter

Krav :

• Python