RT @davewiner: "REST is a nice dream. But I'm not personally a fan." http://r2.ly/8gza - L<link|http://twitter.com/zagru/statuses/49704142796619776>


RT @davewiner: "REST is a nice dream. But I'm not personally a fan." http://r2.ly/8gza


TITLE

DESCRIPTION

comment

=begin comment :src
{
  "id": "e/1cccf3df6d397464ff5e4b9fe848bedc",
  "rawBody": "RT @davewiner: \"REST is a nice dream. But I'm not personally a fan.\" http://r2.ly/8gza",
  "date": "2011-03-21T05:29:25Z",
  "url": "http://friendfeed.com/zag/1cccf3df/rt-davewiner-rest-is-nice-dream-but-i-m-not",
  "body": "RT @<a rel=\"nofollow\" href=\"http://twitter.com/davewiner\">davewiner</a>: &quot;REST is a nice dream. But I'm not personally a fan.&quot; <a rel=\"nofollow\" href=\"http://r2.ly/8gza\" title=\"http://blog.movieos.org/post/3979010061\">http://blog.movieos.org/post...</a>",
  "rawLink": "http://twitter.com/zagru/statuses/49704142796619776",
  "from": {
    "id": "zag",
    "type": "user",
    "name": "углы «Исимуры»"
  },
  "via": {
    "url": "http://twitter.com/zagru/statuses/49704142796619776",
    "name": "Twitter"
  }
}
=end comment


root

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


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


Perl 6 Pod: Списки


Комкон 2011 Вам случалось любоваться Игрой? Ее гениальностью... Сотни людей живут полноценной жизнью... в игре - L<link|http://www.comcon.su/>


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


item

Комкон 2011 Вам случалось любоваться Игрой? Ее гениальностью... Сотни людей живут полноценной жизнью... в игре


=begin comment :src
{
  "body": "Комкон 2011 Вам случалось любоваться Игрой? Ее гениальностью... Сотни людей живут полноценной жизнью... в игре - <a rel=\"nofollow\" href=\"http://www.comcon.su/\">http://www.comcon.su/</a>",
  "rawLink": "http://www.comcon.su/",
  "thumbnails": [
    {
      "height": 175,
      "link": "http://www.comcon.su/",
      "width": 277,
      "url": "http://m.friendfeed-media.com/bfa78e06c3ebe68b35f3e22af820ee12cbe21b34"
    },
    {
      "url": "http://m.friendfeed-media.com/8daf09a855e92e3e4e4bd37d859d22421fbd55f8",
      "width": 45,
      "height": 175,
      "link": "http://www.comcon.su/"
    }
  ],
  "id": "e/d9a7083ae29747a5a42081409c5e8a45",
  "date": "2011-03-19T06:55:41Z",
  "rawBody": "Комкон 2011 Вам случалось любоваться Игрой? Ее гениальностью... Сотни людей живут полноценной жизнью... в игре",
  "url": "http://friendfeed.com/zag/d9a7083a/2011",
  "comments": [
    {
      "from": {
        "type": "user",
        "id": "zag",
        "name": "углы «Исимуры»"
      },
      "id": "e/d9a7083ae29747a5a42081409c5e8a45/c/de5323b7df7d4aabba9845e2b04b39d0",
      "date": "2011-03-19T06:55:41Z",
      "rawBody": "Воссозданы лучшие условия обсуждений даже для искушенных теоретиков, сыгровки и презентации для практиков, обучающие семинары, маленькие игры и мастер-классы для тех, кто еще хочет что-то узнать.",
      "via": {
        "url": "http://friendfeed.com/share/bookmarklet",
        "name": "Bookmarklet"
      },
      "body": "Воссозданы лучшие условия обсуждений даже для искушенных теоретиков, сыгровки и презентации для практиков, обучающие семинары, маленькие игры и мастер-классы для тех, кто еще хочет что-то узнать."
    }
  ],
  "via": {
    "name": "Bookmarklet",
    "url": "http://friendfeed.com/share/bookmarklet"
  },
  "from": {
    "name": "углы «Исимуры»",
    "id": "zag",
    "type": "user"
  }
}
=end comment
