
        *****************************************************
        *           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::AsciiDoc - 从/到 PO 文件转换 AsciiDoc 文档

=head1 描述

Po4a (PO For Anything) 项目的目标是在文档等不需要翻译的领域使用 gettext 工具简化翻译(更有趣的是，简化翻译的维护)。

Locale::Po4a::AsciiDoc 是一个帮助翻译 AsciiDoc 格式文档的模块。

=head1 此模块接受的选项

以下是此模块的特定选项：

=over

=item B<definitions>

包含 po4a 定义的文件的名称，如 B<INLINE CUSTOMIZATION> 部分中定义。 如果无法将定义放在要翻译的文档中，可以使用此选项。

在定义文件中，行不能以两个斜杠开始，而直接由 B<po4a:> 开始。

=item B<entry>

要转换的属性条目的空格分隔列表。默认情况下，没有属性条目是可翻译的。

=item B<macro>

空格分隔的宏定义列表。

=item B<style>

以空格分隔的样式定义列表。

=item B<forcewrap>

启用非逐字块中的自动行换行，即使结果可能被 AsciiDoc 格式器误解。

默认情况下，po4a 不会对生成的 AsciiDoc 文件进行封装，因为强制执行手动检查以确保封装不会更改格式。例如，请考虑以下列表项：

 * a long sentence that is ending with a number 1. A second sentence.

如果换行指向以下演示文稿，则该项目将被拆分到一个带编号的子列表中。更糟糕的是，只有使用翻译语言的人才能检查情况。

 * a long sentence that is ending with a number
   1. A second sentence.

请注意，不封装 po4a 生成的文件应该不是问题，因为这些文件是自动处理的。它们无论如何都不应该被视为源文件。

With this option, po4a will produce better-looking AsciiDoc files, but it
may lead to possibly erroneous formatted outputs.

=item B<noimagetargets>

默认情况下，块图像的目标是可翻译的，以提供使内容指向已翻译图像的机会。可以通过设置此选项来停止此操作。

=item B<tablecells>

此选项是启用子表分割为单元格内容的标志。分割仅限于单元格内容，其中没有任何解析。

=item B<compat>

将解析规则切换为与不同工具兼容。可用选项为 "asciidoc" 或 "asciidoctor"。Asciidoctor
有更严格的解析规则，例如打开和关闭块围栏的长度相等。

=item B<nolinting>

禁用发送邮件。当无法修复源代码以使文档结构更清晰时，这些消息将毫无用处。

=item B<cleanspaces>

Remove extra spaces from the source segments in no-wrap mode. This is useful
when the translation tools are sensitive to the number of spaces.

=item B<yfm_keys>

Comma-separated list of keys to process for translation in the YAML Front
Matter section. All other keys are skipped. Keys are matched with a
case-sensitive match. If B<yfm_paths> and B<yfm_keys> are used together,
values are included if they are matched by at least one of the
options. Array values are always translated, unless the B<yfm_skip_array>
option is provided.

=item B<yfm_skip_array>

不要转换 YAML Front Matter 部分中的数组值。

=item B<yfm_paths>

Comma-separated list of hash paths to process for extraction in the YAML
Front Matter section, all other paths are skipped. Paths are matched with a
case-sensitive match. If B<yfm_paths> and B<yfm_keys> are used together,
values are included if they are matched by at least one of the options.
Arrays values are always returned unless the B<yfm_skip_array> option is
provided.

=back

=head1 在线定制

AsciiDoc 模块可自定义由 B<//po4a:>。 这些行被解释为解析器的命令。 识别以下命令：

=over 4

=item B<//po4a: macro >I<name>B<[>I<attribute list>B<]>

这详细描述 B<macro> 的参数；I<name> 必须是有效的宏名称，如果必须翻译目标，则以下划线结束。

I<attribute list> 参数是一个逗号分隔的列表，其中包含有关可翻译参数的信息。此列表包含用于定义位置参数的数字或命名属性。

如果 I<name> 前面加了一个加号 (B<+>)，则宏及其参数将作为一个整体进行转换。这种情况下不需要定义属性列表，但必须有方括号。

=item B<//po4a: style >B<[>I<attribute list>B<]>

这详细描述了必须翻译样式的哪些属性。

I<attribute list>
参数是一个逗号分隔的列表，其中包含有关可翻译参数的信息。此列表包含用于定义位置参数的数字或命名属性。第一个属性是样式名称，它不会被翻译。

如果样式名称前面有加号 (B<+>)，则属性列表将作为整体进行转换。不需要定义可翻译属性。

如果样式名称前面有减号 (B<->)，则不会转换此属性。

If a percent signe (B<%>) is appended to the style name, then the style is
processed as verbatim. The lines in paragraph or block of such style are
preserved in the po files and the corresponding entries are marked as
no-wrap.

=item B<//po4a: entry >I<name>

这将属性条目声明为可翻译。默认情况下，它们不会被翻译。

=back

=head1 此模块的状态

在简单的 AsciiDoc 文件上测试成功。

=head1 作者

 Nicolas François <nicolas.francois@centraliens.net>
 Denis Barbier <barbier@linuxfr.org>


=head1 翻译

taotieren <admin@taotieren.com>

=head1 版权和许可

 Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
 Copyright © 2012 Denis BARBIER <barbier@linuxfr.org>.
 Copyright © 2017 Martin Quinson <mquinson#debian.org>.

This program is free software; you may redistribute it and/or modify it
under the terms of GPL v2.0 or later (see the COPYING file).
