mezzanine-mdown

mezipatro-mdown poskytuje widgety a filtry pro mezipatra, které umožňují administrátorům použít Markdown formátování vytvořit jejich obsah webu, nikoli pomocí TinyMCE editoru generovat HTML používaný v bohatých typů obsahu, jako jsou bohaté stránek a blogů.
Instalace
Získat balíček
PIP:
user @ home: ~ $ pip nainstalovat mezaninové-mdown
easy_install:
user @ home: ~ $ easy_install mezipatro-mdown
Připravte statické média
Použití vynikající staticfiles aplikaci, by měly statické soubory mdown své si vyzvednout automaticky.
Pokud staticfiles aplikace není váš styl, budete muset najít umístění instalace pro balíček mdown (obvykle vašeho IRP site-balíčky adresář) a kopírovat / symlink mdown / statický / mdown do vašeho projektu site_media adresáře.
Konfigurace
Za prvé, přidejte mdown do svého seznamu INSTALLED_APPS v modulu nastavení projektu.
Po instalaci aplikace, je třeba, aby se pár možností. Budete muset zadat RICHTEXT_WIDGET_CLASS a RICHTEXT_FILTER hodnoty ve vašem modulu nastavení.
RICHTEXT_WIDGET_CLASS
Tento balíček obsahuje 2 možnosti pro toto nastavení.
mdown.forms.WmdWidget
& Nbsp; Aktivuje zbraní hromadného ničení bohatý textový editor. (Doporučeno)
mdown.forms.PlainWidget
& Nbsp; Použít prostý Textarea (ne bohatý textový editor).
RICHTEXT_FILTER
Opět platí, že tam jsou 2 možnosti pro toto nastavení.
mdown.filters.codehilite
& Nbsp; Vykreslí obsah pomocí Markdown s codehilite příponou povolena.
mdown.filters.plain
& Nbsp; Vykreslí obsah pomocí formátování vanilkový markdown.
další kroky
Pygments Styles
Pomocí příkazu vedení pygments_styles můžete generovat CSS obarvení bloků kódu analyzován codehilite filtrem.
Poznámka: to vyžaduje pygments být nainstalovány (použití PIP nainstalovat pygments nebo easy_install pygments Pro použití této funkce).
Vyvolat příkaz bez args vidět zprávu o používání a seznam dostupných barevných schémat na vašem systému .:
user @ home: ~ / mysite $ ./manage.py pygments_styles
Využití: ./manage.py pygments_styles
K dispozici barevná schémata:
& Nbsp; Borland
& Nbsp; BW
& Nbsp; barevné
& Nbsp; výchozí
& Nbsp; ... [stříhat] ...
Vyvolání se jménem schématu jako argument bude tisknout CSS na standardní výstup, který si můžete přesměrovat do souboru, jako je takto:
user @ home: ~ / mysite $ ./manage.py pygment_styles pestré> site_media / css / pygments.css
V additon tohoto jediného způsobu schématu, příkaz také akceptuje --all vlajku, která bude vytvářet styly pro všechny k dispozici, ale s jedním rozdílem klíče: každé schéma je prefixed s jeho jméno jako css třídy. To je užitečné při vývoji téma, jak můžete rychle přepínat pygments systémy pouhým nastavením třídy na těle značku do vašeho výběru režimu, aniž byste museli obnovit soubory CSS neustále.
Jakmile máte soubor css generovaný, jednoduše přidejte jej do základní šablona vašeho webu, aby si váš kód "pěkně" tištěný.
Aktualizace motivu Šablony
Témata, které byly založeny na výchozí motiv, a byly vytvořeny před mezaninu je 0.11.3 propuštění bude s největší pravděpodobností nebude mít richtext_filter aplikován na bohatý obsah. Pro tento problém odstranit, můžete jednoduše aktualizovat šablony pro tyto typy obsahu tak, aby se používá filtru.
Například ve výchozím motivu, templates / blog / blog_post_detail.html měl řádek, který byl aktualizován z ::
{{Blog_post.content | bezpečný}}
na ::
{{Blog_post.content | richtext_filter | bezpečný}}
. Jenom zajistit, aby bezpečný filtr přichází poté, co richtext_filter

Požadavky na :

• Python,