How to properly use UTF-8 in Perl http://bit.ly/igbaDG (http://bit.ly/lgZsPp) - L<link|http://twitter.com/zagru/statuses/75829223486533632>


How to properly use UTF-8 in Perl http://bit.ly/igbaDG (http://bit.ly/lgZsPp)


TITLE

DESCRIPTION

comment

=begin comment :src
{
  "date": "2011-06-01T07:41:10Z",
  "id": "e/000317f999bc718519e0eb616b2bb6c0",
  "rawBody": "How to properly use UTF-8 in Perl http://bit.ly/igbaDG (http://bit.ly/lgZsPp)",
  "url": "http://friendfeed.com/zag/000317f9/how-to-properly-use-utf-8-in-perl",
  "body": "How to properly use UTF-8 in Perl <a rel=\"nofollow\" href=\"http://bit.ly/igbaDG\" title=\"http://stackoverflow.com/questions/6162484/why-does-modern-perl-avoid-utf-8-by-default/#6163129\">http://stackoverflow.com/questio...</a> (<a rel=\"nofollow\" href=\"http://bit.ly/lgZsPp\" title=\"http://news.ycombinator.com/item?id=2602737\">http://news.ycombinator.com/item...</a>)",
  "rawLink": "http://twitter.com/zagru/statuses/75829223486533632",
  "via": {
    "url": "http://twitter.com/zagru/statuses/75829223486533632",
    "name": "Twitter"
  },
  "from": {
    "name": "углы «Исимуры»",
    "type": "user",
    "id": "zag"
  }
}
=end comment


root

Разновидностью кода замещения C<P<>> является код форматирования C<A<>>. Он замещается содержимым именованного псевдонима или объекта, указанных внутри ограничителей.


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


Разновидностью кода замещения C<P<>> является код форматирования C<A<>>. Он замещается содержимым именованного псевдонима или объекта, указанных внутри ограничителей.
Например:


code

=begin code
    =alias PROGNAME    Earl Irradiatem Eventually
    =alias VENDOR      4D Kingdoms
    =alias TERMS_URL   L<http://www.4dk.com/eie>

    The use of A<PROGNAME> is subject to the terms and conditions
    laid out by A<VENDOR>, as specified at A<TERMS_URL>.
=end code


Любой из объектов Perl 6, доступный на этапе компиляции и содержащий сигил, автоматически становится доступным для подстановки по его имени. Также все объекты, которые не являются строковыми типами, в режиме подготовки документации преобразуются в строки посредством неявного вызова метода C<.perl>.


Так, например, документ может ссылаться на имя своего файла - C<A<$?FILE>>, на подпрограмму, внутри которой размещен блок Pod - C<A<$?ROUTINE>> или на текущий класс C<A<$?CLASS>> N<твигил C<?> указывает на значение переменной на этапе компиляции.>. 


Аналогично, значение любой программной константы определенной с сигилом может быть легко вставлено в документацию:


=begin code
    # Actual code...
    constant $GROWTH_RATE of Num where 0..* = 1.6;
    =pod
    =head4 Standard Growth Rate
    The standard growth rate is assumed to be A<$GROWTH_RATE>.
=end code


Для подобных объектов возможны вызовы константных (non-mutating) методов.
Так например, в документации можно вставить сигнатуру подпрограммы (C<A<$?ROUTINE.signature>>) или тип константы (C<A<$GROWTH_RATE.WHAT>>). 


На странице конвертера "L<Perl 6 Pod to HTML|<http://zag.ru/perl6-pod/>" доступен L<пример кода форматирования A |http://zag.ru/perl6-pod/#PWJlZ2luIHBvZAo9YWxpYXMgU0lURSBMPGh0dHA6Ly9leGFtcGxlLmNvbS8+Cj1wYXJhCk9mZmljaWFsIHNpdGUgb2YgdGhlIHByb2plY3QgaXMgbG9jYXRlZCBhdCBBPFNJVEU+IAo9ZW5kIHBvZAo=>.


Chapter 14. Python Packaging http://www.aosabook.org/en/packaging.html - L<link|http://twitter.com/zagru/statuses/75814067096403968>


Chapter 14. Python Packaging http://www.aosabook.org/en/packaging.html


=begin comment :src
{
  "rawLink": "http://twitter.com/zagru/statuses/75814067096403968",
  "likes": [
    {
      "from": {
        "name": "Николай",
        "type": "user",
        "id": "mishin"
      },
      "date": "2011-06-01T07:25:39Z"
    }
  ],
  "body": "Chapter 14. Python Packaging <a rel=\"nofollow\" href=\"http://www.aosabook.org/en/packaging.html\" title=\"http://www.aosabook.org/en/packaging.html\">http://www.aosabook.org/en...</a>",
  "id": "e/df084ac8167a95b2d4140f74bd1a82b0",
  "date": "2011-06-01T06:40:56Z",
  "rawBody": "Chapter 14. Python Packaging http://www.aosabook.org/en/packaging.html",
  "url": "http://friendfeed.com/zag/df084ac8/chapter-14-python-packaging",
  "from": {
    "name": "углы «Исимуры»",
    "type": "user",
    "id": "zag"
  },
  "via": {
    "name": "Twitter",
    "url": "http://twitter.com/zagru/statuses/75814067096403968"
  }
}
=end comment
