文字換行¶

未縮排的段落會自動為翻譯器重新換行。這可能會在生成的輸出中導致一些細微的差異，因為 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"；如果遇到這種情況，請務必報告此情況，並在可能時進行修復…