.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "LOCALE::PO4A::RUBYDOC.3PM 1" .TH LOCALE::PO4A::RUBYDOC.3PM 1 2024-06-26 "perl v5.38.2" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH НАЗВАНИЕ .IX Header "НАЗВАНИЕ" Locale::Po4a::RubyDoc: преобразование данных в формате документации Ruby из/в PO\-файлы .SH ОПИСАНИЕ .IX Header "ОПИСАНИЕ" Целью проекта po4a (PO for anything, PO везде и для всего) является облегчение процесса перевода (и что более важно — поддержки перевода), используя инструменты gettext в тех случаях, когда их применение может выглядеть неожиданным, например для документации. .PP Locale::Po4a::RubyDoc — это модуль, предназначенным для помощи в переводе документации в формате Ruby Document (RD, язык разметки документации Ruby) на другие [человеческие] языки. .SH "СОСТОЯНИЕ ЭТОГО МОДУЛЯ" .IX Header "СОСТОЯНИЕ ЭТОГО МОДУЛЯ" Этот модуль был успешно протестирован на простых файлах с документацией Ruby, покрывающих большую часть возможностей синтаксиса этого формата. .PP Известное ограничение заключается в том, что он не может правильно распознать составную структуру входного Ruby\-документа: это означает, что, когда, например, EnumListItem состоит из более чем одного блока, то по факту только первый блок распознаётся как EnumListItem, а последующие — уже как TextBlocks... .SH "ПАРАМЕТРЫ ПРИНИМАЕМЫЕ ЭТИМ МОДУЛЕМ" .IX Header "ПАРАМЕТРЫ ПРИНИМАЕМЫЕ ЭТИМ МОДУЛЕМ" Данный модуль поддерживает следующие параметры: .IP \fBpuredoc\fR 4 .IX Item "puredoc" Обрабатывать файлы, полностью состоящие из текста в формате Ruby Document (без каких\-либо "=begin"). .Sp По умолчанию этот модуль обрабатывает только текст в формате Ruby Document между строками "=begin" и "=end" (т.е. игнорируя, среди прочего, всё, что предшествует первой строке "=begin"). .SH "СМОТРИТЕ ТАКЖЕ" .IX Header "СМОТРИТЕ ТАКЖЕ" \&\fBLocale::Po4a::TransTractor\fR\|(3pm) .SH АВТОРЫ .IX Header "АВТОРЫ" Франческо Поли (Francesco Poli) .SH "АВТОРСКИЕ ПРАВА И ЛИЦЕНЗИИ" .IX Header "АВТОРСКИЕ ПРАВА И ЛИЦЕНЗИИ" .Vb 1 \& Copyright © 2016\-2017 Франческо Поли (Francesco Poli) .Ve .PP Данная программа является свободным программным обеспечением. Вы вправе распространять ее и/или модифицировать в соответствии с условиями версии 2 либо по вашему выбору с условиями более поздней версии Стандартной Общественной Лицензии GNU, опубликованной Free Software Foundation. .PP Мы распространяем данную программу в надежде на то, что она будет вам полезной, однако НЕ ПРЕДОСТАВЛЯЕМ НА НЕЕ НИКАКИХ ГАРАНТИЙ, в том числе ГАРАНТИИ ТОВАРНОГО СОСТОЯНИЯ ПРИ ПРОДАЖЕ и ПРИГОДНОСТИ ДЛЯ ИСПОЛЬЗОВАНИЯ В КОНКРЕТНЫХ ЦЕЛЯХ. Для получения более подробной информации ознакомьтесь со Стандартной Общественной Лицензией GNU. .PP Вместе с данной программой вы должны были получить экземпляр Стандартной Общественной Лицензии GNU. Если вы его не получили, сообщите об этом в Free Software Foundation, Inc., 59 Temple Place \- Suite 330, Boston, MA 02111\-1307, USA. .PP Некоторые части кода (как, например, многие регулярные выражения) были взяты из исходного кода rdtool в соответствии с условиями Стандартной общественной лицензии GNU версии 2 или более поздней. Изначально авторские права на эти части принадлежали: .PP .Vb 2 \& Copyright © 2004 MoonWolf \& Copyright © 2011\-2012 Youhei SASAKI .Ve .PP Код функции \fBinitialize()\fR был взяты из исходного кода Locale::Po4a::Text в соответствии с условиями Стандартной общественной лицензии GNU версии 2 или более поздней. Изначально авторские права на этот код принадлежали: .PP .Vb 1 \& Copyright © 2005\-2008 Николя Франсуа (Nicolas FRANÇOIS) .Ve