文本换行¶

未缩进的段落会自动为翻译器重新换行。这可能会在生成的输出中导致一些细微的差异，因为 groff 使用的重新包装规则不是很清楚。例如，有时保留括号后的两个空格。

无论如何，不同之处只在于换行段落中额外空格的位置，我认为这是值得的。

字体规格¶

第一个更改是关于字体更改规范。在 nroff 中，有几种方法可以指定给定的单词应该用小写、粗体还是斜体书写。在要翻译的文本中，只有一种方法，借用 POD (Perl Online Documentation) 格式：

I<text> -- 斜体文本

等效于 \fItext\fP 或 ".I text"

B<text> -- 粗体文本

等效于 \fBtext\fP 或 ".B text"

R<text> -- 罗马文本

等效于 \fRtext\fP

CW<text> -- 等长宽度文本

等效于 \f(CWtext\fP 或 ".CW text"

备注：并非所有 groff 设备都提供 CW 面。不推荐使用。这是为了您的方便而提供的。

字符自动音译¶

Po4a 会自动音译某些字符，以简化翻译或审核翻译。以下是音译的列表：

连字符

手册页中的连字符 (-) 和减号 (\-) 在 PO 文件中都音译为简单的破折号 (-)。然后，在将翻译插入到输出文档中时，所有破折号都音译为 roff 减号 (\-)。

翻译人员可以在翻译中使用 roff 字形 '\[hy]' 强制使用连字符。

不间断空格

翻译人员可以在翻译中使用不间断空格。这些不间断空格 (latin1 中的 0xA0)将音译为 roff 不间断空格('\ ')。

引用音译

`` 和 '' 分别音译为 \*(lq 和 \*(rq.

为了避免这些音译，翻译人员可以插入零宽度 roff 字符(即分别使用 '\&' 或 '\&')。

在翻译中放 '<' 和 '>'¶

由于这些字符用于分隔字体修改后的部分，因此您不能逐字使用它们。改为使用 E<lt> 和 E<gt> (与 POD 中相同)。

不要在 nroff 中编程¶

nroff 是一种完整的编程语言，具有宏定义、条件等功能。因为这个解析器不是一个功能齐全的 nroff 解释器，所以它在使用这些工具的页面上将失败 (我框中大约有200个这样的页面)。

使用普通宏集¶

仍然有一些宏不受 po4a::man 支持。这只是因为我找不到任何关于它们的文档。这是我的计算机上使用的不受支持的宏的列表。请注意，此列表并不详尽，因为程序在第一个遇到的不受支持的宏上失败。如果您有关于这些宏的任何信息，我很乐意添加对它们的支持。由于这些宏，po4a::man 无法访问我框中的大约 250 个页面。

 ..               ."              .AT             .b              .bank
 .BE              ..br            .Bu             .BUGS           .BY
 .ce              .dbmmanage      .do                             .En
 .EP              .EX             .Fi             .hw             .i
 .Id              .l              .LO             .mf
 .N               .na             .NF             .nh             .nl
 .Nm              .ns             .NXR            .OPTIONS        .PB
 .pp              .PR             .PRE            .PU             .REq
 .RH              .rn             .S<             .sh             .SI
 .splitfont       .Sx             .T              .TF             .The
 .TT              .UC             .ul             .Vb             .zZ

从 po4a 隐藏文本¶

有时，作者知道有些部分是不可翻译的，不应该用 po4a 提取。例如，选项可能接受 other 参数，并且 other 也可能显示为列表的最后一项。在第一种情况下，other 应该是不可翻译的。在第二种情况下，应该翻译 other。

在这种情况下，作者可以避免 po4a 提取一些字符串，使用一些特殊的 groff 结构：

 .if !'po4a'hide' .B other

(这将需要 -o groff_code=verbatim 选项)

还可以定义一个新的宏来自动执行：
.de IR_untranslated
. IR \\$@
..

 .IR_untranslated \-q ", " \-\-quiet

(这将需要选项 -o groff_code=verbatim 和 -o untranslated=IR_untranslated；使用此构造，不严格需要 .if !'po4a'hide' 条件，因为 po4a 不会解析宏定义的内部)

或使用别名：
.als IR_untranslated IR

 .IR_untranslated \-q ", " \-\-quiet

这将需要 -o untranslated=als,IR_untranslated 选项。

结论¶

总结这一节，请保持简单，在编写手册页时不要试图变得聪明。很多事情在 nroff 中是可能的，并且不被这个解析器支持。例如，不要试图扰乱 \c 来中断文本处理(就像我框中的 40 页一样)。或者，确保将宏参数与宏本身放在同一行。我知道它在 nroff 中是有效的，但是会使解析器过于复杂而无法处理。

当然，另一种可能是使用另一种更便于翻译的格式(比如使用 po4a::pod 的 POD，或者像 SGML 这样的 XML 家族之一)，但是多亏了 po4a::man，它不再需要了。也就是说，如果您的文档的源格式是 POD 或 XML，那么转换源格式而不是这个生成的格式可能更聪明。在大多数情况下，po4a::man 将检测生成的页面并发出警告。它甚至会拒绝处理 POD 生成的页面，因为这些页面由 po4a::pod 完美地处理，而且它们的 nroff 对应项定义了许多我不想编写支持的新宏。在我的机器上，4323 个页面中的 1432 个是从 POD 生成的，将被 po4a::man 忽略。

在大多数情况下， po4a::man 会发现问题并拒绝处理页面，发出一个适应的消息。在一些罕见的情况下，程序将没有警告完成，但输出将是错误的。这种情况称为 "bugs"；如果遇到这种情况，请务必报告此情况，并在可能时进行修复…