mezzanine-mdown

antresola-mdown zapewnia widżety i filtry do antresoli, które umożliwiają administratorom użyć formatowania markdown stworzyć ich zawartość witryny, a nie za pomocą edytora TinyMCE do generowania html używany w bogatych typów treści, takich jak bogate stronach i blogach.
instalacji
Pobierz pakiet
pip:
użytkownik @ home: ~ $ pip install antresoli-mdown
easy_install:
użytkownik @ home: ~ $ easy_install antresola-mdown
Prep media statyczne
Korzystanie z aplikacji doskonałe staticfiles, statyczne pliki mdown powinien dostać zabierani automatycznie.
Jeśli aplikacja staticfiles nie jest Twój styl, musisz zlokalizować położenie instalacji dla pakietu mdown (zwykle katalogu site-packages tłumacza Pythona) i skopiować / dowiązania symbolicznego mdown / statyczne / mdown do katalogu site_media projektu.
Konfiguracja
Po pierwsze, dodać mdown do listy INSTALLED_APPS w module ustawień projektu.
Po zainstalowaniu aplikacji, trzeba zrobić kilka wyborów. Musisz określić RICHTEXT_WIDGET_CLASS i wartości RICHTEXT_FILTER w module ustawień.
RICHTEXT_WIDGET_CLASS
Pakiet ten zawiera dwie opcje dla tego ustawienia.
mdown.forms.WmdWidget
& Nbsp; Aktywuje WMD edytor tekstu sformatowanego. (Zalecane)
mdown.forms.PlainWidget
& Nbsp; Użyj zwykłego Textarea (bez edytor tekstu).
RICHTEXT_FILTER
Ponownie, są 2 opcje dla tego ustawienia.
mdown.filters.codehilite
& Nbsp; Renders zawartość za pomocą przecen z rozszerzeniem codehilite włączone.
mdown.filters.plain
& Nbsp; Renders zawartość za pomocą formatowania wanilii markdown.
Dodatkowe kroki
Pygments Style
Korzystanie z pygments_styles poleceń zarządzania można wygenerować css do kolorowania bloki kodu przeanalizowane przez filtr codehilite.
Uwaga: to wymaga pygments być zainstalowane (wykorzystanie pip install pygments lub easy_install pygments korzystać z tej funkcji).
Wywołuje polecenie bez args zobaczyć użytkowaniu i listy dostępnych schematów kolorów w systemie .:
użytkownik @ home: ~ / mojawitryna $ ./manage.py pygments_styles
Zastosowanie: ./manage.py pygments_styles
Dostępne w kolorystyce:
& Nbsp; borland
& Nbsp; bw
& Nbsp; kolorowe
& Nbsp; domyślnie
& Nbsp; ... [ciach] ...
Wywoływanie z nazwą stosowania programu jako argument wydrukuje CSS standardowe wyjście, które można przekierować do pliku w postaci:
użytkownik @ home: ~ / mojawitryna $ ./manage.py pygment_styles kolorowe> site_media / css / pygments.css
W additon tylko do tego metodą systemu, polecenie akceptuje również --Wszystkie flagę, która będzie generować stylów dla wszystkich dostępne, ale z jedną istotną różnicą: każdy system jest poprzedzona jego nazwie, jak nazwa klasy css. Jest to przydatne w czasie rozwój temat, jak można szybko przełączać programy pygments tylko poprzez ustawienie klasy na znacznika body do wyboru programu, bez konieczności regeneracji plików css stale.
Gdy masz wygenerowany plik css, po prostu dodaj go do szablonu bazowego witryny, aby uzyskać kod "dość" wydrukowane.
Aktualizacja Szablony tematyczne
Tematy, które zostały oparte na domyślny motyw i zostały utworzone przed antresoli znajduje 0.11.3 wydania najprawdopodobniej nie mają richtext_filter stosowane do bogatej zawartości. Aby rozwiązać ten problem, po prostu musisz zaktualizować szablony dla tych typów zawartości, tak że jest używany filtr.
Na przykład, w domyślnym temacie, szablony / blog / blog_post_detail.html miał linię, która została zaktualizowana od ::
{{Blog_post.content | bezpieczne}}
do ::
{{Blog_post.content | richtext_filter | bezpieczne}}
. Wystarczy upewnić się, że filtr pochodzi z sejfu po richtext_filter

Wymagania :

• Python