The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

ИМЯ

POD2::RU - Perl Документация по-русски

СИНТАКСИС

  $ perldoc POD2::RU::<название_pod>

  $ perl -MPOD2::RU -e print_pods
  $ perl -MPOD2::RU -e print_pod <название_pod1> [<название_pod2> ...]

  use POD2::RU;
  print_pods();
  print_pod('pod_foo', 'pod_baz');

  use POD2::RU;
  my $pod2 = POD2::RU->new();
  $pod2->print_pods();
  $pod2->print_pod('perlfunc');
                                                                                          

ОПИСАНИЕ

Этот модуль содержит перевод Perl-документации на русский. Домашняя страница проекта ─ https://github.com/mishin/perldoc-ru.

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

  $ perldoc POD2::RU::<название_pod>

Начиная с Pod::Perldoc версии 3.14 можно использовать следующий синтаксис:

  $ perldoc -L RU <название_pod>
  $ perldoc -L RU -f <функция>
  $ perldoc -L RU -q <регулярное выражение для FAQ>

Модификатор -L определяет код языка перевода. Если пакет POD2::<код_языка> не существует, то модификатор игнорируется.

Для ленивых можно добавить псевдоним (alias):

  perldoc-ru="perldoc -L RU"

для того, чтобы не писать модификатор -L каждый раз:

  $ perldoc-ru perlre
  $ perldoc-ru -f map

Начиная с Pod::Perldoc версии 3.15 вы можете использовать переменную среды PERLDOC_POD2. Если эта переменная установлена в '1', то perldoc осуществляет поиск pod документации на языке, указанном в переменной LC_ALL, LANG или LC_LANG. Или же вы можете установить значение "ru", означающее вывод документации на русском языке. Например,

       export PERLDOC_POD2="ru"
       perldoc perl

API

Пакет экспортирует следующие функции:

  • new

    Была добавлена для совместимости с perldoc Perl 5.10.1. Pod::Perldoc использует ее для возврата имени пакета перевода.

  • pod_dirs

    Была добавлена для совместимости с perldoc Perl 5.10.1. Pod::Perldoc использует ее для определения, где искать переведенные файлы.

  • print_pods

    Выводит все переведенные части и оригинальную версию Perl.

  • print_pod

    Выводит на экран оригинальнуя версию Perl для всех частей, переданых в качестве аргументов.

  • search_perlfunc_re

    perldoc -f function использует возвращаемое значение этой функции (как regexp), чтобы пропустить введение и найти список функций.

АВТОРЫ

  • Анатолий Шарифулин (Tech Lead), sharifulin + sharifulin at gmail.com

  • Николай Мишин (Language Lead), mishin + pod2ru at gmail.com, mi at ya.ru

  • Антон Николаев (Language), me at lelf.lu

  • Алексей Суриков (Language), KSURi

  • Михаил Любимов (Language), mikhail.lyubimov

  • Дмитрий Константинов (Language), Dim_K

  • Евгений Баранов (Language), Baranov

  • Динар Жамалиев (Language), zhdinar

ПРОЕКТ

Домашняя страница https://github.com/mishin/perldoc-ru.

СМОТРИТЕ ТАКЖЕ

POD2::ES, POD2::PT_BR, POD2::IT, POD2::FR, POD2::LT.

ПОЖЕРТВОВАНИЕ

Проект перевода документации Perl требует постоянных усилий, что доступно только для сильных духов и альтруистов. Авторы не просят, но ни не отвергают помощь в виде денег, книг, сыра и продуктов из свинины (можно хамон;) ), или даже поездки в Полинезию для снижения утомления и сохранения боевого духа команды. Мы приглашаем всех.

ОШИБКИ

Информацию об ошибках и пожелания можно оставить на странице http://rt.cpan.org/NoAuth/ReportBug.html?Queue=POD2-RU или отправить на e-mail bug-pod2-ru at rt.cpan.org, mi at ya.ru.

ПОДДЕРЖКА

Для просмотра документации в этом модуле, используйте команду perldoc.

    perldoc POD2::RU

Вы также можете найти информацию о:

БЛАГОДАРНОСТЬ

Авторы хотели бы выразить свою благодарность команде разработчиков OmegaT, инструмента, который используется для перевода.

Проект OmegaT: http://omegat.org/

ЛИЦЕНЗИИ И АВТОРСКИЕ ПРАВА

Copyright (C) 2011-2013 Команда Perl по-русски, Moscow-pm.

Данная программа является свободным программным обеспечением, вы можете распространять и изменять его в соответствии с условиями общественной лицензии GNU GPL, опубликованной Фондом свободного программного обеспечения, или Artistic License.

См. http://dev.perl.org/licenses для более подробной информации.