Image

Любой текст, заключенный в код C<S<>> форматируется как обычно,
сохраняя при этом пробельные символы.


Perl 6 Pod: Код форматирования S - текст с неразрывными пробелами


TITLE

DESCRIPTION

Любой текст, заключенный в код C<S<>> форматируется как обычно,
сохраняя при этом пробельные символы ( в том числе символ новой строки ). Эти символы
интерпретируются как неразрывные пробелы ( кроме новой строки). Например:


The emergency signal is: S<
dot dot dot   dash dash dash   dot dot dot>.


Будет отформатирован следующим образом:


The emergency signal is:E<NEL>
dotE<nbsp>dotE<nbsp>dotE<nbsp>E<nbsp>E<nbsp>dashE<nbsp>dashE<nbsp>dashE<nbsp>E<nbsp>E<nbsp>E<nbsp>dotE<nbsp>dotE<nbsp>dot.


nested

The emergency signal is: dot dot dot dash dash dash dot dot dot.


root

How to Change the Default Firefox 4 Search Engine #firefox4 - L<link|http://www.groovypost.com/howto/how-to/change-firefox-4-address-bar-search-engine-provider/>


item

How to Change the Default Firefox 4 Search Engine #firefox4


comment

=begin comment :src
{
  "body": "How to Change the Default Firefox 4 Search Engine <a href=\"http://friendfeed.com/search?q=%23firefox4\">#firefox4</a> - <a rel=\"nofollow\" href=\"http://www.groovypost.com/howto/how-to/change-firefox-4-address-bar-search-engine-provider/\" title=\"http://www.groovypost.com/howto/how-to/change-firefox-4-address-bar-search-engine-provider/\">http://www.groovypost.com/howto...</a>",
  "likes": [
    {
      "date": "2011-05-25T14:36:32Z",
      "from": {
        "id": "mishin",
        "type": "user",
        "name": "Николай"
      }
    }
  ],
  "rawLink": "http://www.groovypost.com/howto/how-to/change-firefox-4-address-bar-search-engine-provider/",
  "date": "2011-04-21T08:44:30Z",
  "id": "e/1668dca696b04a57ba6622f165ac83e7",
  "rawBody": "How to Change the Default Firefox 4 Search Engine #firefox4",
  "url": "http://friendfeed.com/zag/1668dca6/how-to-change-default-firefox-4-search-engine",
  "thumbnails": [
    {
      "height": 175,
      "link": "http://www.groovypost.com/howto/how-to/change-firefox-4-address-bar-search-engine-provider/",
      "url": "http://m.friendfeed-media.com/8be509c5e099b6a83c29e2afae3a507498de32d9",
      "width": 191
    },
    {
      "link": "http://www.groovypost.com/howto/how-to/change-firefox-4-address-bar-search-engine-provider/",
      "height": 175,
      "url": "http://m.friendfeed-media.com/7bb099f37c2aac44b0d12b1c75118cea2919097e",
      "width": 247
    },
    {
      "width": 375,
      "url": "http://m.friendfeed-media.com/9f5fcbfa750a8d2fda864f21f87a491becc1162b",
      "link": "http://www.groovypost.com/howto/how-to/change-firefox-4-address-bar-search-engine-provider/",
      "height": 163
    }
  ],
  "comments": [
    {
      "body": "about:config",
      "id": "e/1668dca696b04a57ba6622f165ac83e7/c/5da34f64ad964886b7d4ad38b001914e",
      "from": {
        "type": "user",
        "id": "zag",
        "name": "углы «Исимуры»"
      },
      "date": "2011-04-21T08:44:30Z",
      "rawBody": "about:config",
      "via": {
        "name": "Bookmarklet",
        "url": "http://friendfeed.com/share/bookmarklet"
      }
    }
  ],
  "from": {
    "name": "углы «Исимуры»",
    "type": "user",
    "id": "zag"
  },
  "via": {
    "name": "Bookmarklet",
    "url": "http://friendfeed.com/share/bookmarklet"
  }
}
=end comment


Код форматирования 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<>> 
в любом блоке и будет пропущен при обычной обработке. Например:
