名稱

       po4a-translate - 將 PO 檔案轉換回文件格式

簡介

       po4a-translate -f fmt -m master.doc -p XX.po -l XX.doc

       （XX.doc 是輸出，所有其他都是輸入）

描述

       Po4a (PO For Anything) 專案的目標是在文件等不需要翻譯的領域使用 gettext 工具簡化翻譯(更有
       趣的是，簡化翻譯的維護)。

       po4a-translate 負責將翻譯（在 PO 檔案中完成）轉換回文件格式。提供的 PO 文件應該是由
       po4a-gettextize(1) 生成產生的 POT 檔案的翻譯。

選項

       -f, --format
           要處理的文件的格式。使用 --help-format 幫助格式選項檢視可用格式的列表。

       -a, --addendum
           將檔案新增到生成的檔案中（例如，將翻譯的名稱或"關於此翻譯"部分）。要插入的檔案的第一行
           應該是 PO4A 標頭，指示應新增它的位置（請參閱 po4a(7) 中的第 HOWTO add extra text to
           translations 部分）。

       -A, --addendum-charset
           附錄的字符集。請注意，所有附錄應使用相同的字符集。

       -m, --master
           包含要翻譯的主文件的檔案。

       -M, --master-charset
           包含要翻譯的文件的檔案的字符集。

       -l, --localized
           應寫入本地化（已翻譯）文件的檔案。

       -L, --localized-charset
           包含本地化文件的檔案的字符集。

       -p, --po
           應從中讀取訊息目錄的檔案。

       -o, --option
           要傳遞給格式外掛的額外選項。有關有效選項及其含義的更多資訊，請參閱每個外掛的文件。例
           如，您可以將 '-o tablecells' 傳遞給 AsciiDoc 解析器，而文字解析器將接受 '-o
           tabs=split'。

       -k, --keep
           要保留（即寫入）生成的檔案（預設值：80）的最小閾值。即預設情況下，檔案必須至少翻譯 80%
           才能寫入。

       -w, --width
           列，我們應該在該列換行生成的檔案。

       -h, --help
           顯示簡短的幫助訊息。

       --help-format
           列出 po4a 理解的文件格式。

       -V, --version
           顯示指令碼的版本並退出。

       -v, --verbose
           增加程式的冗長程度。

       -d, --debug
           輸出一些除錯資訊。

       --porefs type[,wrap|nowrap]
           指定引用格式。引數 type 可以是以下值之一：never 不生成任何引用；file 只指定不帶行號的
           檔案；counter 用遞增的計數器替換行號；full 包含完整引用（預設值：full）。

           引數後跟逗號和 wrap nowrap 關鍵字。 預設情況下，引用在一行上寫入。 wrap 將引用封裝在多
           行上，以模擬 gettext工具（xgettext msgmerge）。 此選項將成為將來版本中的預設值，因為它
           更明智。 nowrap 選項可用，以便想要保留舊行為的使用者可以這樣做。

       --wrap-po no|newlines|number (default: 76)
           指定應如何封裝 po 檔案。這使我們可以選擇封裝良好但可能導致 git 衝突的檔案，或者更容易
           自動處理但對人類來說更難讀取的檔案。

           從歷史上看， gettext 套件重新格式化了化妝品第 77 列的 po 檔案。此選項指定 po4a 的行
           為。如果設定為數值，po4a 將在此列之後和內容中的換行符之後換行 po 文件。如果設定為 B
           <newlines>，po4a 將僅在內容中的符線後拆分 msgid 和 msgstr。如果設定為 no，po4a 將不會
           封裝 po 檔案。 引用註釋的封裝由 --porefs 選項控制。

           請注意，此選項對 msgid 和 msgstr 的封裝方式（即，將換行符新增到這些字串的內容中）沒有
           影響。

向生成的檔案新增內容（翻譯旁邊）

       若要在翻譯的內容旁邊向生成的文件新增一些額外內容（如翻譯人員的姓名或"關於此翻譯"部分），應
       使用 --addendum 選項。

       增編的第一行必須是指示在文件中的放放位置的標頭（它可以在文件的給定部分之前或之後）。 檔案
       的其餘部分將逐字新增到生成的檔案中，而無需進一步處理。

       請注意，如果 po4a 翻譯無法新增給定檔案之一，它將丟棄整個翻譯（因為丟失的檔案可能是指示作者
       的檔案，因此會阻止使用者聯絡他報告翻譯中的 Bug）。

       標頭具有相當嚴格的語法。有關如何使用此功能及其工作原理的詳細資訊，請參閱 po4a(7) man 頁
       面。

參見

       po4a-gettextize(1), po4a-normalize(1), po4a-updatepo(1), po4a(7)

作者

        Denis Barbier <barbier@linuxfr.org>
        Nicolas François <nicolas.francois@centraliens.net>
        Martin Quinson (mquinson#debian.org)

版權和許可

       版權所有 2002-2020，SPI，Inc.

       此程式是自由軟體；您可以根據 GPL 條款重新分發和/或修改它(請參閱複製檔案)。