
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 名称

Locale::Po4a::Pod - 将 POD 数据从/转换为 PO 文件

=head1 简介

    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new (sentence => 0, width => 78);

    # 从标准输入读取 POD 并写入标准输出。
    $parser->parse_from_filehandle;

    # 从 file.pod 读取 POD 并写入 file.txt。
    $parser->parse_from_file ('file.pod', 'file.txt');

=head1 描述

Locale::Po4a::Pod 是一个模块，用于帮助将 POD 格式(编写 Perl 文档的首选语言)的文档翻译成其他 [人类] 语言。

=head1 此模块的状态

我认为这个模块非常稳定，F</usr/lib/perl5/tk/MainWindow.pod> (以及其他一些页面，见下文)中只有一个已知的 bug：

  C<" #n">

运气不佳，在 po4a 版本中，这是通过封装在空间上分开的。因此，在原始版本中，手册页包含

 " #n"

而我的则包含

 "" #n""

这是因为 CE<lt>foobarE<gt> 被重写为 "foobar" 的逻辑。

我的框中有此问题的页面的完整列表(来自 564 页；请注意，这取决于所选的换行列)：/usr/lib/perl5/Tk/MainWindow.pod /usr/share/perl/5.8.0/overload.pod /usr/share/perl/5.8.0/pod/perlapi.pod /usr/share/perl/5.8.0/pod/perldelta.pod /usr/share/perl/5.8.0/pod/perlfaq5.pod /usr/share/perl/5.8.0/pod/perlpod.pod /usr/share/perl/5.8.0/pod/perlre.pod /usr/share/perl/5.8.0/pod/perlretut.pod





=head1 内件

作为 Pod::Parser 的派生类，Locale::Po4a::Pod 支持相同的方法和接口。有关所有细节，请参见 L<Pod::Parser>；简而言之，使用 C<< Locale::Po4a::Pod->new() >> 创建一个新的解析器，然后调用 parse_from_filehandle() 或 parse_from_file()。

new() 可以采用键/值对形式的选项来控制解析器的行为。所有 Pod::Parser 子级通用的可识别选项为：

=over 4

=item B<alt>

如果设置为 true 值，则选择使用不同标题样式的备用输出格式，并在左边距中用冒号标记 B<=Item> 条目。默认值为 false。

=item B<code>

如果设置为 true 值，则输入文件的非 POD 部分将包括在输出中。用于查看使用 POD 块记录的代码，并呈现 POD 并保持代码不变。

=item B<indent>

用于缩进常规文本的空格数，以及 B<=over> 块的默认缩进。默认为 4。

=item B<loose>

如果设置为 true 值，则在 B<=head1> 标题后打印一个空行。如果设置为 false (默认值)，则在 B<=head1> 之后不打印空行，但在 B<=head2> 之后仍打印一个空行。这是默认设置，因为这是手册页的预期格式；如果您正在格式化任意文本文档，则将其设置为 true 可能会产生更令人满意的输出。

=item B<quotes>

设置用于将 CE<lt>> 文本括起来的引号。如果值是单字符，则同时用作左引号和右引号；如果是两个字符，则第一个字符用作左引号，第二个字符用作右引号；如果是四个字符，则前两个字符用作左引号，后两个字符用作右引号。

也可以将其设置为特殊值 B<none>，在这种情况下，CE<lt>> 文本两边不会添加引号。

=item B<sentence>

如果设置为真值，Locale::Po4a::Pod 将假定每个句子以两个空格结束，并将尝试保留该空格。如果设置为 false，则非逐字段落中的所有连续空格都将压缩为一个空格。默认值为 true。

=item B<width>

要在其右侧换行文本的列。默认为 76。

=back

=head1 参见

L<Pod::Parser>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|po4a.7>

=head1 作者

 Denis Barbier <barbier@linuxfr.org>
 Martin Quinson (mquinson#debian.org)

=head1 版权和许可

版权所有 © 2002 SPI, Inc.

此程序是自由软件；您可以根据 GPL 条款重新分发和/或修改它(请参阅复制文件)。

