mezzanine-mdown

мезонин-mdown обеспечивает виджеты и фильтры для антресоли, которые позволяют администраторам использовать форматирование уценки создать свой контент сайта, а не с помощью редактора TinyMCE для генерации HTML, используемый в сложных типах контента, таких как богатые страниц и сообщений в блоге.
Установка
Получить пакет
PIP:
пользователь @ Home: ~ $ пункт установить мезонин-mdown
easy_install:
пользователь @ Home: ~ $ easy_install мезонин-mdown
Подготовьте статические СМИ
Используя приложение отличные staticfiles, статические файлы mdown должны получить автоматически взял.
Если приложение staticfiles это не ваш стиль, вы должны будете найти место установки для mdown пакета (обычно каталог сайтов-пакеты вашего Python переводчика) и копировать / символической ссылке mdown / статический / mdown в каталог site_media проекта.
Конфигурация
Во-первых, добавить mdown в свой список INSTALLED_APPS в вашем модуле настройки проекта.
С приложение установлено, необходимо сделать пару выбор. Вы будете иметь, чтобы указать RICHTEXT_WIDGET_CLASS и ценности RICHTEXT_FILTER в вашем модуле настройки.
RICHTEXT_WIDGET_CLASS
Этот пакет предоставляет 2 варианта для этого параметра.
mdown.forms.WmdWidget
& NBSP; Активизирует текстовый редактор ОМУ. (Рекомендуемый)
mdown.forms.PlainWidget
& NBSP; Используйте обычный Textarea (не текстовый редактор).
RICHTEXT_FILTER
Опять же, есть 2 варианта для этого параметра.
mdown.filters.codehilite
& NBSP; Оказывает содержимое с помощью уценки с codehilite расширения включен.
mdown.filters.plain
& NBSP; Оказывает содержимое, используя форматирование ванили уценки.
Дополнительные шаги
Pygments Стили
С помощью команды управления pygments_styles вы можете создать CSS для раскрашивания блоки кода разобранные по codehilite фильтра.
Примечание: это требует pygments быть установлены (использование PIP установить pygments или easy_install pygments чтобы использовать эту функцию).
Вызовите команду без каких-либо аргументов, чтобы увидеть подсказку и список доступных цветовых схем в системе .:
пользователь @ Home: ~ / MySite $ ./manage.py pygments_styles
Использование: ./manage.py pygments_styles
Доступные цветовые схемы:
& NBSP; Borland
& NBSP; м.т.
& NBSP; красочный
& NBSP; по умолчанию
& NBSP; ... [СНиП] ...
Вызов с именем схемы ее в качестве аргумента выведет на стандартный вывод CSS, который вы можете перенаправить в файл вот так:
пользователь @ Home: ~ / MySite $ ./manage.py pygment_styles красочные> site_media / CSS / pygments.css
Вдобавок к этому один метод схеме, команда также принимает --all флаг, который будет генерировать стили для всех доступны, но с одним ключевым отличием: каждая схема имеет префикс ее имени в качестве имени класса CSS. Это удобно при разработке темы, как вы можете быстро переключаться pygments схемы, просто установив класс по тегу тела вашему выбору схемы без регенерации CSS файлы постоянно.
После того как вы получили файл CSS сгенерированный, просто добавьте его в шаблон базового вашего сайта, чтобы получить код "довольно" печатается.
Обновление шаблонов тем
Темы, которые были основаны на тему по умолчанию, и были созданы до 0.11.3 выпуска Мезонин будет, скорее всего, не имеют richtext_filter применяется к богатое содержание. Чтобы исправить это, вы просто должны обновить шаблоны для этих типов контента, так что используется фильтр.
Например, в теме по умолчанию, шаблоны / дневник / blog_post_detail.html была линия, которая была обновлена ​​от ::
{{Blog_post.content | безопасна}}
чтобы ::
{{Blog_post.content | richtext_filter | безопасна}}
. Просто убедитесь, что безопасное фильтр поставляется после richtext_filter

Требования

• Python