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