15 September 2009 20:58
Я нашел идеальный на сегодня формат для написания статей в этом блоге, ведения документации по разрабатываемому коду, инструмент создания отчетов. Это расширяемый и просто удобный язык разметки - Perldoc Pod.
Perldoc Pod - эволюция POD
Согласно спецификации на новый диалект Pod для perl6, различие между Pod и POD существенное.
Pod - является эволюцией ( не мутацией! ) Perl5 Plain Old Documentation ( POD ). Внешне новый диалект похож на POD, но более компактен. В нем отсутствуют обязательные отступы между директивами, более компактно описываются списки ( нет =over и =back ), а также имеется особый формат для блоков текста - Сокращенные блоки ( Abbreviated blocks ).
Перечисленные достоинства мелочь, в сравнении с самым главным - расширяемостью. Pod позволяет определять собственные директивы и коды форматирования. Поэтому области применения Pod не ограничены только встроенной документацией для Perl кода.
Pod в качестве языка разметки для блога
Это первая статья, написанная на диалекте Perldoc Pod. Oн идеально подошел к задаче основного формата для создания статей на этом сайте, где до настоящего момента использовался Perl5 POD. Приходилось прибегать к некрасивым хакам, например, чтобы сделать возможным поддержку изображений в документах. В новом Pod для решения подобных задач предусмотрено подключение собственных директив и кодов форматирования.
Расширения для Perl6's Pod
О том как создавать расширения для Perdoc Pod, а так же где можно использовать документы Pod, я собираюсь рассказать на втором белорусском воркшопе BY_PERL.
Для получения представления об основных новшествах Perldoc Pod рекомендую:
- посмотреть презентацию к моему докладу на YAPC::Russia 2009 ( PDF)
- почитать спецификацию SYNOPSIS 26
