Сундучок мыслей - Моя крайняя книга доступна в печатном виде - L<link|http://users.livejournal.com/_darkus_/565893.html#>


"Наконец-то заключил договор с издательством «Вебов и Книгин», так что книгу можно распечатывать по технологии print-on-demand."


item

ранее по этой теме:http://friendfeed.com/zag/dcc3dd05/c


Сундучок мыслей - Моя крайняя книга доступна в печатном виде


TITLE

DESCRIPTION

comment

=begin comment :src
{
  "via": {
    "name": "Bookmarklet",
    "url": "http://friendfeed.com/share/bookmarklet"
  },
  "from": {
    "id": "zag",
    "type": "user",
    "name": "углы «Исимуры»"
  },
  "comments": [
    {
      "via": {
        "name": "Bookmarklet",
        "url": "http://friendfeed.com/share/bookmarklet"
      },
      "date": "2011-03-22T05:42:27Z",
      "id": "e/770bb463c26647d7a1600d2d7bd32993/c/4c4d6978f2e143f2897402788244667b",
      "rawBody": "\"Наконец-то заключил договор с издательством «Вебов и Книгин», так что книгу можно распечатывать по технологии print-on-demand.\"",
      "from": {
        "name": "углы «Исимуры»",
        "type": "user",
        "id": "zag"
      },
      "body": "&quot;Наконец-то заключил договор с издательством «Вебов и Книгин», так что книгу можно распечатывать по технологии print-on-demand.&quot;"
    },
    {
      "rawBody": "ранее по этой теме:http://friendfeed.com/zag/dcc3dd05/c",
      "date": "2011-03-22T05:43:18Z",
      "id": "e/770bb463c26647d7a1600d2d7bd32993/c/2c7dbfdead734918b262910d4396c34f",
      "from": {
        "name": "углы «Исимуры»",
        "type": "user",
        "id": "zag"
      },
      "body": "ранее по этой теме:<a href=\"http://friendfeed.com/zag/dcc3dd05/c\" title=\"http://friendfeed.com/zag/dcc3dd05/c\">http://friendfeed.com/zag...</a>"
    }
  ],
  "id": "e/770bb463c26647d7a1600d2d7bd32993",
  "date": "2011-03-22T05:42:27Z",
  "rawBody": "Сундучок мыслей - Моя крайняя книга доступна в печатном виде",
  "url": "http://friendfeed.com/zag/770bb463",
  "body": "Сундучок мыслей - Моя крайняя книга доступна в печатном виде - <a rel=\"nofollow\" href=\"http://users.livejournal.com/_darkus_/565893.html#\" title=\"http://users.livejournal.com/_darkus_/565893.html#\">http://users.livejournal.com/_darkus...</a>",
  "rawLink": "http://users.livejournal.com/_darkus_/565893.html#"
}
=end comment


root

Rakudo * now in OpenBSD ports. #perl6 http://openports.se/lang/rakudo - L<link|http://twitter.com/zagru/statuses/50140487037890561>


Rakudo * now in OpenBSD ports. #perl6 http://openports.se/lang/rakudo


=begin comment :src
{
  "from": {
    "name": "углы «Исимуры»",
    "type": "user",
    "id": "zag"
  },
  "via": {
    "url": "http://twitter.com/zagru/statuses/50140487037890561",
    "name": "Twitter"
  },
  "date": "2011-03-22T10:23:18Z",
  "id": "e/d1f95e9a23a80378c17dd4ae24ef12c4",
  "rawBody": "Rakudo * now in OpenBSD ports. #perl6 http://openports.se/lang/rakudo",
  "url": "http://friendfeed.com/zag/d1f95e9a/rakudo-now-in-openbsd-ports-perl6",
  "rawLink": "http://twitter.com/zagru/statuses/50140487037890561",
  "body": "Rakudo * now in OpenBSD ports. <a rel=\"nofollow\" href=\"http://search.twitter.com/search?q=%23perl6\">#perl6</a> <a rel=\"nofollow\" href=\"http://openports.se/lang/rakudo\" title=\"http://openports.se/lang/rakudo\">http://openports.se/lang...</a>"
}
=end comment


Image

Списки в Pod представлены в виде групп, следующих друг за другом блоков C<=item>. Каких либо специальных директив-"контейнеров" или разделителей для определения границ списков нет.


Списки в Pod представлены в виде групп, следующих друг за другом блоков C<=item>. Каких либо специальных директив-"контейнеров" или разделителей для определения границ списков нет. Например:


code

=begin code 
     The seven suspects are:

     =item  Happy
     =item  Dopey
     =item  Sleepy
     =item  Bashful
     =item  Sneezy
     =item  Grumpy
     =item  Keyser Soze
=end code


Элементы списка имеют неявный уровень вложенности:


nested

Списки могут быть многоуровневыми. Каждый уровень указывается с помощью блоков C<=item1>, C<=item2>, C<=item3> и т.д. В этом смысле блок C<=item> является синонимом C<=item1>. Например:


=begin code
     =item1  Animal
     =item2     Vertebrate
     =item2     Invertebrate

     =item1  Phase
     =item2     Solid
     =item2     Liquid
     =item2     Gas
     =item2     Chocolate
=end code


para

Обработчики Pod должны выдавать предупреждающее сообщение в случаях, когда разность между уровнями вложенности соседствующих блоков больше 1. Например, если за блоком C<=item1> следует блок C<=item3>.


Блоки C<=item> не могут содержать вложенные списки. Это значит, что даже элементы с более низким уровнем вложенности I<не> могут присутствовать внутри C<=item> более высокого уровня.


=begin code
    =comment НЕВЕРНО...
    =begin item1          --------------
    The choices are:                    |
    =item2 Liberty        ==< Level 2   |==<  Level 1
    =item2 Death          ==< Level 2   |
    =item2 Beer           ==< Level 2   |
    =end item1            --------------
=end code


=begin code
    =comment ПРАВИЛЬНО...
    =begin item1          ---------------
    The choices are:                     |==< Level 1
    =end item1            ---------------
    =item2 Liberty        ==================< Level 2
    =item2 Death          ==================< Level 2
    =item2 Beer           ==================< Level 2
=end code


head

Нумерованный список состоит из элементов, имеющих конфигурационный параметр C<:numbered>.


=begin code
     =for item1 :numbered
     Visito

     =for item2 :numbered
     Veni

     =for item2 :numbered
     Vidi

     =for item2 :numbered
     Vici
=end code


Приведенный код преобразуется в следующего вида текст:


Схема нумерации целиком определяется средствами подготовки того или иного формата вывода. Поэтому возможен следующий вид нумерации:


Эквивалентным свойству C<:numbered> в свойствах элемента, является указание C<#> первым символом
в тексте элемента списка.


=begin code
     =item1  # Visito
     =item2     # Veni
     =item2     # Vidi
     =item2     # Vici
=end code


В случаях, когда требуется использовать символ C<#> первым без интерпретации его как признака нумерованного списка, используется код форматирования C<V<>>:


=begin code :allow<B>
    =item B<V<#>> introduces a comment
=end code


или явное отрицание нумерации: 


=begin code :allow<B>
    =for item B<:!numbered>
    # introduces a comment
=end code


Следующие друг за другом элементы первого уровня C<=item1> нумеруются последовательно. Их нумерация начинается заново, если их последовательность прерывается каким либо блоком Pod. В следующем примере, список прерывается параграфом:


=begin code
    The options are:

    =item1 # Liberty
    =item1 # Death
    =item1 # Beer

    The tools are:

    =item1 # Revolution
    =item1 # Deep-fried peanut butter sandwich
    =item1 # Keg
=end code


Результат будет следующим:


Нумерация вложенных элементов ( C<=item2>, C<=item3>, C<=item4> ) сбрасывается каждый раз, когда встречается элемент более высокого уровня вложенности.


Чтобы продолжить нумерацию C<=item1>, после разрыва списка блоком Pod, достаточно указать свойство C<:continued>:


=begin code :allow<B>
     =for item1
     # Retreat to remote Himalayan monastery

     =for item1
     # Learn the hidden mysteries of space and time

     I<????>

     =for item1 B<:continued>
     # Prophet!
=end code


Указанный код будет преобразован в следующий текст:


Список элементов без указанного свойства C<:numbered> интерпретируется как маркированный I<(unordered)> список. Элементы таких списков отмечаются маркерами, так называемыми буллитами I<(bullit)>N<Маркер списка (буллит) - типографский знак, используемый для выделения элементов списка. L<Маркер списка|http://ru.wikipedia.org/wiki/%D0%9C%D0%B0%D1%80%D0%BA%D0%B5%D1%80_%D1%81%D0%BF%D0%B8%D1%81%D0%BA%D0%B0> >.


=begin code
    =item1 Reading
    =item2 Writing
    =item3 'Rithmetic
=end code


может выглядеть следующим образом:
