.\" Automatically generated by Pod::Man 4.14 (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
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    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 "PO4A-TRANSLATE 1p"
.TH PO4A-TRANSLATE 1p "2023-01-03" "Po4a 工具" "Po4a 工具"
.\" 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 "名稱"
po4a\-translate \- 將 \s-1PO\s0 檔案轉換回文件格式
.SH "簡介"
.IX Header "簡介"
\&\fBpo4a\-translate\fR \fB\-f\fR \fIfmt\fR \fB\-m\fR \fImaster.doc\fR \fB\-p\fR \fI\s-1XX\s0.po\fR \fB\-l\fR \fI\s-1XX\s0.doc\fR
.PP
（\fI\s-1XX\s0.doc\fR 是輸出，所有其他都是輸入）
.SH "描述"
.IX Header "描述"
Po4a (\s-1PO\s0 For Anything) 專案的目標是在文件等不需要翻譯的領域使用 gettext 工具簡化翻譯(更有趣的是，簡化翻譯的維護)。
.PP
\&\fBpo4a\-translate\fR 負責將翻譯（在 \s-1PO\s0 檔案中完成）轉換回文件格式。提供的 \s-1PO\s0 文件應該是由 \fBpo4a\-gettextize\fR\|(1) 生成產生的 \s-1POT\s0 檔案的翻譯。
.SH "選項"
.IX Header "選項"
.IP "\fB\-f\fR, \fB\-\-format\fR" 4
.IX Item "-f, --format"
要處理的文件的格式。使用 \fB\-\-help\-format\fR 幫助格式選項檢視可用格式的列表。
.IP "\fB\-a\fR, \fB\-\-addendum\fR" 4
.IX Item "-a, --addendum"
將檔案新增到生成的檔案中（例如，將翻譯的名稱或\*(L"關於此翻譯\*(R"部分）。要插入的檔案的第一行應該是 \s-1PO4A\s0 標頭，指示應新增它的位置（請參閱 \fBpo4a\fR\|(7) 中的第 \fB\s-1HOWTO\s0 add extra text to translations\fR 部分）。
.IP "\fB\-A\fR, \fB\-\-addendum\-charset\fR" 4
.IX Item "-A, --addendum-charset"
附錄的字符集。請注意，所有附錄應使用相同的字符集。
.IP "\fB\-m\fR, \fB\-\-master\fR" 4
.IX Item "-m, --master"
包含要翻譯的主文件的檔案。
.IP "\fB\-M\fR, \fB\-\-master\-charset\fR" 4
.IX Item "-M, --master-charset"
包含要翻譯的文件的檔案的字符集。
.IP "\fB\-l\fR, \fB\-\-localized\fR" 4
.IX Item "-l, --localized"
應寫入本地化（已翻譯）文件的檔案。
.IP "\fB\-L\fR, \fB\-\-localized\-charset\fR" 4
.IX Item "-L, --localized-charset"
包含本地化文件的檔案的字符集。
.IP "\fB\-p\fR, \fB\-\-po\fR" 4
.IX Item "-p, --po"
應從中讀取訊息目錄的檔案。
.IP "\fB\-o\fR, \fB\-\-option\fR" 4
.IX Item "-o, --option"
要傳遞給格式外掛的額外選項。有關有效選項及其含義的更多資訊，請參閱每個外掛的文件。例如，您可以將 '\-o tablecells' 傳遞給 AsciiDoc 解析器，而文字解析器將接受 '\-o tabs=split'。
.IP "\fB\-k\fR, \fB\-\-keep\fR" 4
.IX Item "-k, --keep"
要保留（即寫入）生成的檔案（預設值：80）的最小閾值。即預設情況下，檔案必須至少翻譯 80% 才能寫入。
.IP "\fB\-w\fR, \fB\-\-width\fR" 4
.IX Item "-w, --width"
列，我們應該在該列換行生成的檔案。
.IP "\fB\-h\fR, \fB\-\-help\fR" 4
.IX Item "-h, --help"
顯示簡短的幫助訊息。
.IP "\fB\-\-help\-format\fR" 4
.IX Item "--help-format"
列出 po4a 理解的文件格式。
.IP "\fB\-V\fR, \fB\-\-version\fR" 4
.IX Item "-V, --version"
顯示指令碼的版本並退出。
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
.IX Item "-v, --verbose"
增加程式的冗長程度。
.IP "\fB\-d\fR, \fB\-\-debug\fR" 4
.IX Item "-d, --debug"
輸出一些除錯資訊。
.IP "\fB\-\-porefs\fR \fItype\fR[,\fBwrap\fR|\fBnowrap\fR]" 4
.IX Item "--porefs type[,wrap|nowrap]"
指定引用格式。引數 \fItype\fR 可以是以下值之一：\fBnever\fR 不生成任何引用；\fBfile\fR 只指定不帶行號的檔案；\fBcounter\fR 用遞增的計數器替換行號；\fBfull\fR 包含完整引用（預設值：full）。
.Sp
引數後跟逗號和 \fBwrap\fR \fBnowrap\fR 關鍵字。 預設情況下，引用在一行上寫入。 \fBwrap\fR 將引用封裝在多行上，以模擬 \fBgettext\fR工具（\fBxgettext\fR \fBmsgmerge\fR）。 此選項將成為將來版本中的預設值，因為它更明智。 \fBnowrap\fR 選項可用，以便想要保留舊行為的使用者可以這樣做。
.IP "\fB\-\-wrap\-po\fR \fBno\fR|\fBnewlines\fR|\fInumber\fR (default: 76)" 4
.IX Item "--wrap-po no|newlines|number (default: 76)"
指定應如何封裝 po 檔案。這使我們可以選擇封裝良好但可能導致 git 衝突的檔案，或者更容易自動處理但對人類來說更難讀取的檔案。
.Sp
從歷史上看， gettext 套件重新格式化了化妝品第 77 列的 po 檔案。此選項指定 po4a 的行為。如果設定為數值，po4a 將在此列之後和內容中的換行符之後換行 po 文件。如果設定為 B <newlines>，po4a 將僅在內容中的符線後拆分 msgid 和 msgstr。如果設定為 \fBno\fR，po4a 將不會封裝 po 檔案。 引用註釋的封裝由 \fB\-\-porefs\fR 選項控制。
.Sp
請注意，此選項對 msgid 和 msgstr 的封裝方式（即，將換行符新增到這些字串的內容中）沒有影響。
.SH "向生成的檔案新增內容（翻譯旁邊）"
.IX Header "向生成的檔案新增內容（翻譯旁邊）"
若要在翻譯的內容旁邊向生成的文件新增一些額外內容（如翻譯人員的姓名或\*(L"關於此翻譯\*(R"部分），應使用 \fB\-\-addendum\fR 選項。
.PP
增編的第一行必須是指示在文件中的放放位置的標頭（它可以在文件的給定部分之前或之後）。 檔案的其餘部分將逐字新增到生成的檔案中，而無需進一步處理。
.PP
請注意，如果 po4a 翻譯無法新增給定檔案之一，它將丟棄整個翻譯（因為丟失的檔案可能是指示作者的檔案，因此會阻止使用者聯絡他報告翻譯中的 Bug）。
.PP
標頭具有相當嚴格的語法。有關如何使用此功能及其工作原理的詳細資訊，請參閱 \fBpo4a\fR\|(7) man 頁面。
.SH "參見"
.IX Header "參見"
\&\fBpo4a\-gettextize\fR\|(1), \fBpo4a\-normalize\fR\|(1), \fBpo4a\-updatepo\fR\|(1), \fBpo4a\fR\|(7)
.SH "作者"
.IX Header "作者"
.Vb 3
\& Denis Barbier <barbier@linuxfr.org>
\& Nicolas François <nicolas.francois@centraliens.net>
\& Martin Quinson (mquinson#debian.org)
.Ve
.SH "版權和許可"
.IX Header "版權和許可"
版權所有 2002\-2020，SPI，Inc.
.PP
此程式是自由軟體；您可以根據 \s-1GPL\s0 條款重新分發和/或修改它(請參閱複製檔案)。