mezzanine-mdown

mezzanine-mdown biedt widgets en filters voor mezzanine die beheerders in staat stellen om markdown opmaak gebruiken om hun inhoud van de site te maken, in plaats van de TinyMCE editor om html gebruikt in rijke types inhoud, zoals rijke pagina's en blogberichten genereren.
installatie
Krijg het pakket
pip:
gebruiker @ home: ~ $ pip installeren mezzanine-mdown
easy_install:
gebruiker @ home: ~ $ easy_install mezzanine-mdown
Prep de statische media
Met behulp van de uitstekende staticfiles app, moet statische bestanden mdown automatisch opgehaald.
Als de staticfiles app is niet jouw stijl, moet u de installatie locatie te vinden voor de mdown pakket (meestal uw python interpreter de site-packages directory) en kopieer / symlink mdown / static / mdown in uw project site_media directory.
Configuratie
Ten eerste, voeg mdown aan je lijst met INSTALLED_APPS in uw instellingen project module.
Met de app is geïnstalleerd, moet u een paar keuzes te maken. Je moet de RICHTEXT_WIDGET_CLASS en RICHTEXT_FILTER waarden in uw instellingen module opgeven.
RICHTEXT_WIDGET_CLASS
Dit pakket bevat 2 opties voor deze instelling.
mdown.forms.WmdWidget
& Nbsp; activeert de WMD rich text editor. (Aanbevolen)
mdown.forms.PlainWidget
& Nbsp; Met een duidelijke Textarea (geen rich text editor).
RICHTEXT_FILTER
Nogmaals, er zijn 2 opties voor deze instelling.
mdown.filters.codehilite
& Nbsp; Renders de inhoud met behulp van markdown de codehilite extensie ingeschakeld.
mdown.filters.plain
& Nbsp; Renders de inhoud met behulp van vanille markdown opmaak.
Extra stappen
Pygments Stijlen
Met behulp van het beheer commando pygments_styles kunt css genereren om code blokken ontleed door de codehilite filter inkleuren.
Opmerking: Dit vereist pygments worden geïnstalleerd (gebruik pip pygments of easy_install pygments installeren om deze functie te gebruiken).
Roep het commando zonder argumenten om een ​​gewoonte bericht en een lijst van beschikbare kleurenschema's te zien op uw systeem .:
gebruiker @ home: ~ / mijnsite $ ./manage.py pygments_styles
Usage: ./manage.py pygments_styles
Beschikbare kleuren:
& Nbsp; borland
& Nbsp; bw
& Nbsp; kleurrijke
& Nbsp; in gebreke
& Nbsp; ... [knip] ...
Het aanroepen van de naam van de regeling als een argument zal de css naar stdout, die u kunt omleiden naar een bestand als zo af te drukken:
gebruiker @ home: ~ / mijnsite $ ./manage.py pygment_styles kleurrijke> site_media / css / pygments.css
In aanvulling op deze single regeling methode, de opdracht aanvaardt ook de --all vlag, welke stijlen zal genereren voor alle beschikbare, maar met één belangrijk verschil: elke regeling wordt voorafgegaan door haar naam als een CSS-klasse naam. Dit is handig tijdens het thema ontwikkeling als je snel kunt schakelen pygments regelingen alleen door het instellen van de klasse op het lichaam tag om uw keuze van de regeling zonder CSS-bestanden voortdurend regenereren.
Zodra u een css-bestand gegenereerd hebt, voegt het gewoon naar de basis sjabloon van uw site om uw code te krijgen 'mooie' afgedrukt.
Thema Templates updaten
Thema's die waren gebaseerd op de standaard thema en werden voorafgaand gecreëerd om Mezzanine's 0.11.3 release zal waarschijnlijk niet de richtext_filter hebben toegepast om rijke inhoud. Om dit te corrigeren, moet je gewoon de sjablonen voor deze soorten inhoud bij te werken, zodat het filter wordt gebruikt.
Bijvoorbeeld, in de standaard thema, de templates / blog / blog_post_detail.html had een lijn die is bijgewerkt van ::
{{Blog_post.content | veilig}}
naar ::
{{Blog_post.content | richtext_filter | veilig}}
. Gewoon zorgen dat de veilige filter komt na de richtext_filter

Eisen

• Python