mezzanine-mdown

mezzanine-mdown gir widgets og filtre for mezzanine som gjør at administratorer å bruke markdown-formatering for å skape sitt innhold, snarere enn å bruke TinyMCE editor for å generere html brukt i rike innholdstyper, for eksempel rike sider og blogginnlegg.
Installasjon
Få pakken
pip:
user @ home: ~ $ pip installere mezzanine-mdown
easy_install:
user @ home: ~ $ easy_install mezzanine-mdown
Prep de statiske media
Bruke gode staticfiles app, bør mdown statiske filer blir plukket opp automatisk.
Hvis staticfiles app ikke er din stil, må du finne installere plassering for mdown pakken (vanligvis python tolkens site-pakker katalog) og kopiere / symlink mdown / statisk / mdown inn i prosjektet site_media katalogen.
Konfigurasjon
First off, legge mdown til i listen over INSTALLED_APPS i prosjektmodulen i innstillingene.
Med appen installert, må du gjøre et par valg. Du må angi RICHTEXT_WIDGET_CLASS og RICHTEXT_FILTER verdier i modulen i innstillingene.
RICHTEXT_WIDGET_CLASS
Denne pakken inneholder to alternativer for denne innstillingen.
mdown.forms.WmdWidget
& Nbsp; Aktiverer WMD rik tekst editor. (Anbefales)
mdown.forms.PlainWidget
& Nbsp; Bruk en ren Textarea (ingen rik tekst editor).
RICHTEXT_FILTER
Igjen, det er to alternativer for denne innstillingen.
mdown.filters.codehilite
& Nbsp; Gjengir innhold med Markdown med codehilite forlengelse aktivert.
mdown.filters.plain
& Nbsp; Gjengir innhold ved hjelp av vanilje Markdown formatering.
Ekstra trinn
Pygments Styles
Bruke ledelse kommando pygments_styles kan du generere css å fargelegge kodeblokker analyseres av codehilite filter.
Merk: dette krever pygments som skal installeres (bruk PiP installere pygments eller easy_install pygments å bruke denne funksjonen).
Påberope kommandoen uten args å se en bruk meldingen og listen over tilgjengelige fargevalg på systemet .:
user @ home: ~ / mysite $ ./manage.py pygments_styles
Bruk: ./manage.py pygments_styles
Tilgjengelige farger:
& Nbsp; Borland
& Nbsp; bw
& Nbsp; fargerik
& Nbsp; standard
& Nbsp; ... [snip] ...
Starte med ordningens navn som argument vil skrive ut css til stdout, som du kan omdirigere til en fil som så:
user @ home: ~ / mysite $ ./manage.py pygment_styles fargerik> site_media / css / pygments.css
I additon til denne ene ordningen metoden, godtar kommandoen også --Alle flagg, som vil generere stiler for alle tilgjengelige, men med en viktig forskjell: hver ordning er prefiks med sitt navn som en css klassenavnet. Dette er nyttig under tema utvikling som du raskt kan bytte pygments ordninger bare ved å sette klassen på kroppen tag til ditt valg av ordningen uten å regenerere css filer hele tiden.
Når du har fått en css-fil generert, bare legge det til nettstedets smal for å få koden "pen" ut.
Oppdatering Tema Maler
Temaer som var basert på standardtemaet, og ble opprettet før Mezzanine er 0.11.3 utgivelsen vil mest sannsynlig ikke har den richtext_filter påført rikt innhold. For å rette opp dette, du bare nødt til å oppdatere maler for disse innholdstyper slik at filteret er brukt.
For eksempel i standardtemaet, den maler / blogg / blog_post_detail.html hadde en linje som ble oppdatert fra ::
{{Blog_post.content | trygt}}
til ::
{{Blog_post.content | richtext_filter | trygt}}
. Bare sørge for at den trygt filter kommer etter richtext_filter

Krav

• Python