Используя Сфинкса для записи личных веб-сайтов и блогов
http://www.regular-expressions.info/javascript.html по сравнению с http://www.regular-expressions.info/python.html
5 ответов
Я сделал это на http://reinout.vanrees.org/weblog . Ключевой трюк - добавить шаг препроцессора. У меня есть записи в блоге в структуре папок weblog / yyyy / mm / dd / .
Сценарий проходит через эту структуру папок, создавая файлы index.txt в каждом каталог, в котором перечислены подпункты. Затем нормальный процесс Sphinx отображает эти файлы index.txt .
Я добавил специальный процессор Sphinx для тегов. Итак, ".. tags :: python, buildout" где-то в верхней части моей записи в блоге генерирует теги. И препроцессор снова собирает эти записи и записывает файл weblog / tags / TAGNAME.txt , который Sphinx снова обрабатывает нормально.
Препроцессор также создает корневой weblog / index.txt ] с последними 10 записями. И weblog / atom.xml в (жестко закодированном) каталоге вывода для RSS-канала.
Итак: вам нужны некоторые нестандартные вещи, но это в значительной степени простой текст, поэтому для меня это был хорошее упражнение. И вы можете написать несколько вспомогательных сценариев, чтобы облегчить жизнь, например, тот, который копирует текстовый файл откуда-то в каталог сегодняшнего блога (включая создание недостающих каталогов и «svn add»).
Дуг Хеллманн, автор «Python Module of the Week» делает свой сайт с помощью Sphinx.
http://www.doughellmann.com/PyMOTW/
У него есть несколько сообщения, охватывающие темы сфинксов, которые, вероятно, могут помочь вам на вашем пути:
Не Sphinx, а несколько сайтов по адресу http://codespeak.net/ выполняются с помощью скриптов, которые принимают текст ReST, генерируют HTML и загружают их на сайт. Я не писал эти сценарии, но использовал их.
Это разумный способ создания сайтов, если сайты все равно должны содержать много файлов ReST, например, при создании документации для модулей Python, что, конечно, эти сайты все о. Также хорошо, если вам нужен контроль версий сайта, потому что вы можете сохранить исходный код в svn или hg, или что-то в этом роде.
Но если вы начнете писать много автоматических меню и других расширений, в итоге вы получите систему управления контентом. И таких уже много, так что вы можете сначала взглянуть на них.
Другой пример - новый packages.python.org. Там вы можете сгенерировать свою документацию любым удобным для вас способом, а затем через PyPI загрузить zip-файл с документами. Distribute сделал это с помощью Sphinx: http://packages.python.org/distribute . Но здесь не нужен специальный скрипт, он просто генерирует HTML из документации Sphinx.
Однако ...
Я должен сказать, что я считаю идею написания программного обеспечения для ведения блогов в виде расширения Sphinx немного забавным, тем более что есть так много отличного программного обеспечения для ведения блогов. И в любом случае ничто не сравнится с Wordpress, а wordpress.com стал для меня отличным опытом ведения блога. Но как упражнение в том, насколько можно злоупотреблять Сфинксом, почему бы и нет! : -)
Я переделал свой личный сайт ( http://homepage.mac.com/s_lott/steve/ ) в Sphinx. Это прекрасно работает. К сожалению, разметка SO искажает _ в моем URL.
Я также полностью переписал Введение в программирование для непрограммистов ( http: // homepage.mac.com/s_lott/books/nonprog/html/index.html) книгу в Sphinx. Я сейчас переписываю Введение в Python на Sphinx.
Я не использую Sphinx для блогов - это не совсем удобно, но сработает. Я использую blogspot для ведения блога с низким содержанием графики / текста и относительно высокой скоростью. Я использую iWeb ( http://web.me.com/s_lott/Travel/Welcome.html ) для ведения блога с высокой графикой и относительно низкой скоростью.
Стоит знать, что в расширениях sphinx-contrib есть расширение RSS для sphinx, которое называется sphinxcontrib.feed
Это и многие другие забавные штуки Сфинкса живут по адресу http://bitbucket.org/birkenfeld/sphinx-contrib/
(Отказ от ответственности: я написал расширение канала.)