RT @ImTracyMorgan: Facebook asks what I’m thinking. Twitter asks what I’m doing. Foursquare asks where I am. The internet has turned into a crazy girlfriend. - L<link|http://twitter.com/zagru/statuses/60564069446459392>


RT @ImTracyMorgan: Facebook asks what I’m thinking. Twitter asks what I’m doing. Foursquare asks where I am. The internet has turned into a crazy girlfriend.


TITLE

DESCRIPTION

comment

=begin comment :src
{
  "rawLink": "http://twitter.com/zagru/statuses/60564069446459392",
  "body": "RT @<a rel=\"nofollow\" href=\"http://twitter.com/ImTracyMorgan\">ImTracyMorgan</a>: Facebook asks what I’m thinking. Twitter asks what I’m doing. Foursquare asks where I am. The internet has turned into a crazy girlfriend.",
  "id": "e/811018a4d7e9ea6cb39b6fd79db4a3de",
  "date": "2011-04-20T04:42:54Z",
  "rawBody": "RT @ImTracyMorgan: Facebook asks what I’m thinking. Twitter asks what I’m doing. Foursquare asks where I am. The internet has turned into a crazy girlfriend.",
  "url": "http://friendfeed.com/zag/811018a4/rt-imtracymorgan-facebook-asks-what-im",
  "via": {
    "url": "http://twitter.com/zagru/statuses/60564069446459392",
    "name": "Twitter"
  },
  "from": {
    "type": "user",
    "id": "zag",
    "name": "углы «Исимуры»"
  }
}
=end comment


root

Image

Код форматирования C<Z<>> означает, что его содержимое является B<комментарием нулевой длины> и U<не> отображается.


Perl 6 Pod: Код форматирования Z - комментарии


Код форматирования C<Z<>> означает, что его содержимое является B<комментарием нулевой длины> и U<не> отображается. Например:


code

=begin code :allow<B>
    The "exeunt" command B<Z<Think about renaming this command?>> is used
    to quit all applications.
=end code


В формате Perl 5 POD код C<Z<>> широко использовался для разбиения последовательности кодов разметки на составные части, чтобы избежать их интерпретации:


=begin code :allow<B>
    In Perl 5 POD, the ZB<Z<>><> code was widely used to break up text
    that would otherwise be considered mark-up.
=end code


Данный прием продолжает работать, однако, достичь результата сейчас легче благодаря "дословному" I<(verbatim)> коду форматирования:


=begin code :allow<B>
    In Perl 5 POD, the B< V<Z<>> > code was widely used to break up text
    that would otherwise be considered mark-up.
=end code


Кроме того C<C<>> также обрабатывает свое содержимое как "дословный" текст,
что позволяет исключить необходимость в коде C<V<>>:


=begin code :allow<B>
    In Perl 5 POD, the B<C<Z<>>> code was widely used to break up text
    that would otherwise be considered mark-up.
=end code


Код форматирования C<Z<>> является эквивалентом блока C<=comment>. 


Комментарии как метки категорий


head

Большинство средств обработки Pod предоставляют механизм, позволяющий 
явно подключать или исключать отдельные блоки документации, если они 
соответствуют определенному критерию. Например, модуль экспорта 
документации I<(renderer)> может быть проинформирован пропускать 
любой блок содержащий шаблон C</CONFIDENTIAL/> I<('КОНФИДЕЦИАЛЬНО')>.
Подобный "невидимый маркер", может быть помещен внутри комментария C<Z<>> 
в любом блоке и будет пропущен при обычной обработке. Например:


Последние три года я слежу за развитием этого формата, а также работаю над его реализацией. За это время спецификация избавилась от статуса черновика и на сегодня находится в стабильном состоянии.


Статус реализации Perl6::Pod


Вместе с Perl 6, на смену используемому в Perl 5 POD, приходит новый формат Pod. Ему посвящен Synopsis 26 N<Спецификация формата Pod (Synopsis 26 ).L<https://github.com/zag/specs/raw/master/S26-documentation.pod> >. 


Что касается достигнутых мной результатов, то на данный момент мне проще перечислить недостающие части. 


item

Вот и все, по большому счету, существенные белые пятна в реализации.
Не исключено, что еще что-то я упустил.


Текущая реализация Perl 6 Pod доступна на CPAN N<Реализация Perl 6 Pod на Perl 5. L<http://search.cpan.org/dist/Perl6-Pod/> >.


Для желающих попробовать создать текст в этом формате существует онлайн конвертер L<"Perl 6 Pod to HTML"|http://zag.ru/perl6-pod/>. Он также позволяет сформировать ссылку на введенный в редакторе Pod с помощью кнопки "Generate URL". Эта функция полезна также, когда необходимо указать на ошибку или поделиться Pod.
