2016-01-01 2 views
2

Я использую Pelican для статического блога и пытаюсь установить расширение figure-ref. Поскольку я использую Markdown, плагин полагается на стороннее расширение Markdown figureAltCaption. Однако я понятия не имею, как установить его.Установите стороннее расширение Markdown в Pelican

Pelican имеет MD_EXTENSIONSconfiguration option, но я пробовал несколько очевидных вариантов, не повезло. Похоже, это мертво-простое представление, но не ясно, как действовать дальше. Понравились бы некоторые предложения.

ответ

5

К сожалению, автор рисункаAltCaption, похоже, не предоставил сценарий установки. Мое предложение состояло в том, чтобы создать его и внести в него как тянущий запрос. Это tutorial о создании расширений для Python-Markdown охватывает создание сценария установки.

Однако в качестве ярлыка вы должны просто скопировать файл figureAltCaption.py в соответствующий каталог. Обычно вам нужен каталог сайтов-пакетов. Как this answer шоу, просто сделайте следующее из Python:

>>> import site; site.getsitepackages() 

Затем скопируйте файл figureAltCaption.py в первый каталог вернулся.

Теперь, когда расширение находится на вашем PYTHONPATH, оно должно быть импортируемым. В командной строке Python, попробуйте:

import figureAltCaption 

Если вы не получите никаких ошибок, то он работал, и вы просто должны сказать Пеликан об этом.

MD_EXTENSIONS = ['figureAltCaption'] 
+0

Работал как шарм, спасибо большое. Я полагал, что это было просто. Я пробовал следовать указаниям в учебнике по расширению Python-Markdown, но продолжал работать в причудливых ошибках, связанных с различными полями, которые я должен был определить в 'setup.py.' Спасибо! – Magsol

+0

Это решение также работает для MKDocs. Большое спасибо за ваш вклад. –

+1

Начиная с [** 3.7.0 **] (http://docs.getpelican.com/en/stable/changelog.html?highlight=MD_EXTENSIONS#id2) Пеликанской версии, нам нужно использовать [** MARKDOWN setting * *] (http://docs.getpelican.com/en/stable/settings.html?highlight=MARKDOWN#basic-settings) вместо 'MD_EXTENSIONS'. Благодарю. –