mezzanine-mdown

mezzanino-mdown fornisce widgets e filtri per mezzanino che consentono agli amministratori di utilizzare la formattazione Markdown per creare loro contenuti del sito, piuttosto che utilizzare l'editor TinyMCE per generare codice HTML usato in ricchi tipi di contenuto, come le pagine ricche e post di blog.
Installazione
Prendi il pacchetto
pip:
utente @ home: ~ $ pip install mezzanino mdown
easy_install:
utente @ home: ~ $ easy_install mezzanino mdown
Prep i media statiche
Utilizzando l'eccellente staticfiles applicazione, i file statici di mdown dovrebbero ottenere raccolti automaticamente.
Se il staticfiles applicazione non è il tuo stile, è necessario individuare il percorso di installazione per il pacchetto mdown (solitamente directory site-packages del vostro interprete Python) e copiare / link simbolico mdown / static / mdown nella directory site_media progetto.
Configurazione
Prima di tutto, aggiungi mdown alla tua lista di INSTALLED_APPS nel modulo impostazioni del progetto.
Con l'applicazione installata, è necessario fare un paio di scelte. Dovrete specificare il RICHTEXT_WIDGET_CLASS e valori RICHTEXT_FILTER nel modulo impostazioni.
RICHTEXT_WIDGET_CLASS
Questo pacchetto offre 2 opzioni per questa impostazione.
mdown.forms.WmdWidget
& Nbsp; di attivare la WMD rich text editor. (Consigliato)
mdown.forms.PlainWidget
& Nbsp; Usare un Textarea pianura (senza rich text editor).
RICHTEXT_FILTER
Questo caso, ci sono 2 opzioni per questa impostazione.
mdown.filters.codehilite
& Nbsp; il rendering del contenuto utilizzando markdown con estensione codehilite abilitato.
mdown.filters.plain
& Nbsp; il rendering del contenuto utilizzando la formattazione vaniglia Markdown.
I passaggi aggiuntivi
Pygments Styles
Utilizzando le pygments_styles comando di gestione è possibile generare CSS per colorare blocchi di codice analizzate dal filtro codehilite.
Nota: questo richiede pygments da installare (uso pip installare pygments o easy_install pygments per utilizzare questa funzione).
Richiamare il comando senza argomenti per vedere un messaggio di utilizzo e la lista di combinazioni di colori disponibili nel sistema .:
utente @ home: ~ / miosito $ ./manage.py pygments_styles
Uso: pygments_styles ./manage.py
Combinazioni di colori disponibili:
& Nbsp; borland
& Nbsp; bw
& Nbsp; colorato
& Nbsp; di default
& Nbsp; ... [omissis] ...
Invocare con il nome del programma come argomento stamperà il css per stdout, che è possibile reindirizzare a un file in questo modo:
utente @ home: ~ / miosito $ ./manage.py pygment_styles colorato> site_media / css / pygments.css
In additon a questo metodo unico schema, il comando accetta anche la bandiera --all, che genererà stili per tutti disponibili, ma con una differenza fondamentale: ogni schema è prefissato con il suo nome come un nome di classe CSS. Questo è utile durante lo sviluppo del tema, come si può passare rapidamente schemi Pygments semplicemente impostando la classe sul tag body per la vostra scelta di regime senza dover rigenerare i file css costantemente.
Una volta che hai un file CSS generato, è sufficiente aggiungere al template di base del tuo sito per ottenere il codice "pretty" stampato.
Aggiornamento dei modelli tematici
Temi che sono stati basati sul tema di default e sono stati creati prima 0.11.3 rilascio di Mezzanine molto probabilmente non hanno la richtext_filter applicata a contenuti ricchi. Per correggere questo, dovete semplicemente aggiornare i modelli per questi tipi di contenuto modo da utilizzare il filtro.
Ad esempio, in tema di default, il template / blog / blog_post_detail.html aveva una linea che è stata aggiornata da ::
{{Blog_post.content | cassaforte}}
a ::
{{Blog_post.content | richtext_filter | cassaforte}}
. Basta assicurarsi che il filtro di sicurezza viene dopo il richtext_filter

Requisiti

• Python