Image

Не хватает Свидетеля на вершине холма


item

TITLE

DESCRIPTION

comment

=begin comment :src
{
  "from": {
    "id": "zag",
    "type": "user",
    "name": "углы «Исимуры»"
  },
  "comments": [
    {
      "id": "e/060315323b9647659ea7b5ba42a1f861/c/045fce2946b747e38cbc5471c0f3d670",
      "rawBody": "Не хватает Свидетеля на вершине холма",
      "date": "2011-04-30T18:46:22Z",
      "from": {
        "type": "user",
        "id": "meatreach",
        "name": "Based on real people"
      },
      "body": "Не хватает Свидетеля на вершине холма"
    }
  ],
  "date": "2011-04-30T18:13:02Z",
  "id": "e/060315323b9647659ea7b5ba42a1f861",
  "rawBody": "wallpaper",
  "thumbnails": [
    {
      "height": 175,
      "link": "http://m.friendfeed-media.com/0de7753f02909b47a99e4ef52a945b67cdecfd6b",
      "url": "http://m.friendfeed-media.com/d8ec65349620aa2db0cd52fcab383ec50b671b75",
      "width": 233
    }
  ],
  "url": "http://friendfeed.com/zag/06031532/wallpaper",
  "likes": [
    {
      "date": "2011-05-01T10:04:20Z",
      "from": {
        "type": "user",
        "id": "philsmirnov",
        "name": "Phil Smirnov"
      }
    },
    {
      "date": "2011-05-01T08:18:19Z",
      "from": {
        "id": "seliv",
        "type": "user",
        "name": "sёliv"
      }
    },
    {
      "date": "2011-05-01T03:21:13Z",
      "from": {
        "name": "Белопони",
        "type": "user",
        "id": "jo10"
      }
    },
    {
      "from": {
        "name": "prool",
        "id": "prool",
        "type": "user"
      },
      "date": "2011-04-30T21:20:55Z"
    },
    {
      "date": "2011-04-30T20:18:00Z",
      "from": {
        "type": "user",
        "id": "jinger",
        "name": "Нет, ты"
      }
    },
    {
      "date": "2011-04-30T19:02:08Z",
      "from": {
        "id": "prdx",
        "type": "user",
        "name": "Покак Пузантес"
      }
    },
    {
      "date": "2011-04-30T19:01:16Z",
      "from": {
        "name": "Sergey Zhuzhgov",
        "private": true,
        "id": "sergeyzhuzhgov",
        "type": "user"
      }
    },
    {
      "date": "2011-04-30T18:48:51Z",
      "from": {
        "private": true,
        "type": "user",
        "id": "hostya",
        "name": "Лучшая девушка в СССР"
      }
    },
    {
      "date": "2011-04-30T18:39:51Z",
      "from": {
        "name": "cat",
        "id": "kikelia",
        "type": "user",
        "private": true
      }
    },
    {
      "date": "2011-04-30T18:37:30Z",
      "from": {
        "id": "artreal",
        "type": "user",
        "name": "50 оттенков кошкости"
      }
    },
    {
      "date": "2011-04-30T18:37:25Z",
      "from": {
        "name": "alex@kapranoff.ru",
        "type": "user",
        "id": "kkapp"
      }
    }
  ],
  "rawLink": "http://friendfeed.com/e/06031532-3b96-4765-9ea7-b5ba42a1f861",
  "body": "wallpaper"
}
=end comment


root

wallpaper


RT @google: Google's Prediction API v1.2 helps developers build smarter apps using machine learning, new features: http://goo.gl/1AZhC - L<link|http://twitter.com/zagru/statuses/64911510144692224>


RT @google: Google's Prediction API v1.2 helps developers build smarter apps using machine learning, new features: http://goo.gl/1AZhC


=begin comment :src
{
  "from": {
    "name": "углы «Исимуры»",
    "id": "zag",
    "type": "user"
  },
  "via": {
    "url": "http://twitter.com/zagru/statuses/64911510144692224",
    "name": "Twitter"
  },
  "rawLink": "http://twitter.com/zagru/statuses/64911510144692224",
  "body": "RT @<a rel=\"nofollow\" href=\"http://twitter.com/google\">google</a>: Google's Prediction API v1.2 helps developers build smarter apps using machine learning, new features: <a rel=\"nofollow\" href=\"http://goo.gl/1AZhC\" title=\"http://googlecode.blogspot.com/2011/04/prediction-api-every-app-smart-app.html\">http://googlecode.blogspot.com/2011...</a>",
  "id": "e/b55ede9f31f9bfd5bf06e40be3aa4c47",
  "date": "2011-05-02T04:38:04Z",
  "rawBody": "RT @google: Google's Prediction API v1.2 helps developers build smarter apps using machine learning, new features: http://goo.gl/1AZhC",
  "url": "http://friendfeed.com/zag/b55ede9f/rt-google-prediction-api-v1-2-helps-developers"
}
=end comment


Perl 6 Pod представляет собой гибкий и расширяемый язык разметки. В первую очередь 
он полезен для ведения документации: как технической (описание API, технические 
задания ), так и пользовательской: например, руководства и даже книги.


Perl 6 Pod на ближайших конференциях


Perl 6 Pod представляет собой гибкий и расширяемый язык разметки. В первую очередь 
он полезен для ведения документации: как технической (описание API, технические 
задания ), так и пользовательской: например, руководства и даже книги. 


Мои первые руководства я создавал для пользователей компьютерной лаборатории. 
В те времена I<(в середине 90x)> для этих целей применялся Microsoft Word. 
Позднее я использовал для создания документов HTML, Tex и docbook. В дальнейшем основным 
форматом, который я стал использовать повсеместно, был Perl 5 POD 
N< Plain Old Documentation. L<http://perldoc.perl.org/perlpod.html>>. Возможно, 
причиной тому стала его интеграция с языком Perl. Это позволило создавать 
качественную документацию непосредственно во время разработки, а так же поддерживать 
ее в актуальном состоянии. Конечно же, эта документация была по программному коду. 


Тем не менее, Perl 5 POD был удовлетворительным форматом и для создания руководств. 
Для полного счастья не хватало поддержки изображений, таблиц. Эти неудобства 
устранялись созданием специализированного парсера, который особым образом обрабатывал POD.
Таким образом создавался некий подсинтаксис POD и, как следствие, подобная документация 
могла быть обработана только этим особым парсером. 


В новом Perl 6 Pod  N<Спецификация формата Pod (Synopsis 26).L<https://github.com/zag/specs/raw/master/S26-documentation.pod>>,
все описанные ограничения были устранены. Данный формат стал лаконичнее, 
появились таблицы и самое главное - B<расширяемость>. Благодаря последней 
особенности в документах Pod можно реализовать любые собственные сущности:  
например, изображения. Хорошим примером может служить исходный код этой 
статьи N<Исходный код статьи в формате Perl 6 Pod. L<http://zag.ru/2011/119/a1/Perl-6-Pod-na-blizhajshikh-konferencijakh.pod>>.


Рассказать о данном формате я планирую на следующих ближайших мероприятиях:


Помимо описания основных деталей формата Perl 6 Pod, также расскажу для решения каких задач
я его использую.
