Man page - po4a(7)

Packages contains this manual

Package:  po4a
apt-get install po4a

Manuals in package:
• po4a-translate(1)
• po4a-display-pod(1)
• po4a-updatepo(1)
• po4a-gettextize(1)
• po4a-display-man(1)
• po4a(7)
• po4a-normalize(1)
• po4a(1)
• msguntypot(1)
Documentations in package:
• po4a

Available languages:

en fr pt_BR es it nl ja uk ru sr sr_Cyrl de

Manual

PO4A.7

名 前
概 要
な ぜ po4aな の か ？
サ ポ ー ト す る フ ォ ー マ ッ ト
po4aを 使 う
po4aで の 作 業 工 程 の 詳 細 な 図 解
新 規 に 翻 訳 の プ ロ ジ ェ ク ト を 始 め る に は
翻 訳 と 文 書 を 更 新 す る
補 遺 を 使 っ て 翻 訳 に 追 加 の テ キ ス ト を 入 れ る
ど の よ う に 動 作 し ま す か ?
TransTractorと プ ロ ジ ェ ク ト の ア ー キ テ ク チ ャ
形 式 に 固 有 の 構 文 解 析 器
Poオ ブ ジ ェ ク ト
po4aに 貢 献 す る
po4aを 使 っ て い る オ ー プ ン ソ ー ス プ ロ ジ ェ ク ト
FAQ
po4aは ど う 発 音 す る の で す か ？
な ぜ 個 別 の ス ク リ プ ト が 非 推 奨 と な っ た の か
gettext を 使 っ た ド キ ュ メ ン ト 翻 訳 ツ ー ル は 他 に 何 が あ り ま す か ?
gettext ベ ー ス ア プ ロ ー チ の 利 点 ま と め
関 連 項 目
著 者
訳 者
POD ERRORS

---

名 前

po4a - ド キ ュ メ ン ト や そ の 他 の 素 材 の 翻 訳 フ レ ー ム ワ ー ク

概 要

po4a (PO for anything) は 、 従 来 の gettext ツ ー ル を 使 っ た 文 書 翻 訳 の 保 守 を 容 易 に す る も の で す 。 po4aの 主 な 特 徴 は 、 内 容 の 翻 訳 を 文 書 構 造 か ら 切 り 離 す こ と で す 。

こ の ド キ ュ メ ン ト で は po4aプ ロ ジ ェ ク ト の 紹 介 を 行 い こ の ツ ー ル を 使 う か ど う か を 検 討 し て い る 潜 在 的 な 利 用 者 と 、 こ の ツ ー ル の 仕 組 み の な り た ち を 理 解 し た い と い う 興 味 の あ る 読 者 に 焦 点 を 当 て ま す 。

な ぜ po4aな の か ？

自 由 ソ フ ト ウ ェ ア の 理 念 は 、 技 術 を 真 に 誰 も が 利 用 で き る よ う に す る こ と で す 。 し か し 、 ラ イ セ ン ス だ け が 考 慮 す べ き こ と で は あ り ま せ ん 。 翻 訳 さ れ て い な い 自 由 ソ フ ト ウ ェ ア は 、 英 語 を 母 国 語 と し な い 人 々 に と っ て は 無 用 の 長 物 な の で す 。 で す か ら 、 ソ フ ト ウ ェ ア を 誰 も が 利 用 で き る よ う に す る た め に や る べ き こ と は ま だ あ り ま す 。

こ の よ う な 状 況 は ほ と ん ど の プ ロ ジ ェ ク ト で 知 ら れ て お り 、 誰 も が あ ら ゆ る も の を 翻 訳 す る 必 要 性 を 確 信 し て い ま す 。 し か し 、 実 際 の 翻 訳 は 、 多 く の 人 の 膨 大 な 努 力 の 結 晶 で あ り 、 ち ょ っ と し た 技 術 的 な 問 題 で 不 自 由 な こ と に な っ て い る の が 現 状 で す 。

あ り が た い こ と に 、 オ ー プ ン ソ ー ス ソ フ ト ウ ェ ア は 、 gettext tool suite を 使 っ て 実 際 に 非 常 に よ く 翻 訳 さ れ て い ま す 。 こ れ ら の ツ ー ル は 、 プ ロ グ ラ ム か ら 翻 訳 す る 文 字 列 を 抽 出 し 、 標 準 化 さ れ た 形 式 （ POフ ァ イ ル 、 ま た は 翻 訳 カ タ ロ グ と 呼 ば れ ま す ） で 翻 訳 す る 文 字 列 を 提 示 す る た め に 使 用 さ れ ま す 。 翻 訳 者 が 実 際 に こ の POフ ァ イ ル を 翻 訳 す る の を 助 け る た め に 、 こ の ツ ー ル の エ コ シ ス テ ム 全 体 が 成 立 し ま し た 。 そ し て そ の 結 果 を 実 行 時 に gettextが 使 用 し 、 エ ン ド ユ ー ザ ー に 翻 訳 さ れ た 文 言 を 表 示 す る の で す 。

し か し 、 ド キ ュ メ ン テ ー シ ョ ン に 関 し て は 、 ま だ 少 し 残 念 な 状 況 で す 。 最 初 の 時 点 は 文 書 の 元 の フ ァ イ ル を 複 製 し て 翻 訳 を 始 め る だ け な の で 、 プ ロ グ ラ ム の 翻 訳 よ り も 簡 単 そ う に 見 え る か も し れ ま せ ん 。 し か し 、 元 の 文 書 が 変 更 さ れ た 場 合 、 そ の 変 更 点 を 把 握 し て お く こ と は 、 す ぐ さ ま 翻 訳 者 に と っ て 悪 夢 と な り ま す 。 手 作 業 で 行 う 場 合 、 こ の 作 業 は 不 快 で あ り 、 誤 り の 温 床 と な る の で す 。

古 い 翻 訳 は 、 全 く 翻 訳 が な い こ と よ り も 悪 い こ と が よ く あ り ま す 。 エ ン ド ユ ー ザ は 、 プ ロ グ ラ ム の 古 い 動 作 を 説 明 し た 文 書 に 騙 さ れ る 可 能 性 が あ り ま す 。 さ ら に 、 彼 ら は 英 語 を 話 せ な い の で 、 保 守 者 と 直 接 対 話 す る こ と が で き ま せ ん 。 加 え て 、 保 守 者 は 文 書 が 翻 訳 さ れ て い る す べ て の 言 語 は 知 ら な い の で 、 問 題 を 修 正 す る こ と が で き ま せ ん 。 こ の よ う な 困 難 は し ば し ば 貧 弱 な ツ ー ル に よ っ て 引 き 起 こ さ れ る も の で 、 ボ ラ ン テ ィ ア の 翻 訳 者 の モ チ ベ ー シ ョ ン を 蝕 み 、 問 題 を さ ら に 悪 化 さ せ る 可 能 性 が あ り ま す 。

po4aプ ロ ジ ェ ク ト の 目 標 は 、 文 書 を 翻 訳 す る 人 の 仕 事 を 楽 に す る こ と で す 。 特 に 、 文 書 の 翻 訳 を 保 守 可 能 な も の に す る こ と で す 。

ア イ デ ィ ア と し て は gettextの 手 法 を 再 利 用 し 、 こ の 分 野 に 適 応 さ せ よ う と い う も の で す 。 gettextと 同 様 、 テ キ ス ト は 元 の 場 所 か ら 抽 出 さ れ 、 POの 翻 訳 カ タ ロ グ と し て 翻 訳 者 に 提 示 さ れ ま す 。 翻 訳 者 は gettextの 古 典 的 な ツ ー ル を 活 用 し て 、 取 り 組 ん で い る 作 業 を 監 査 し 、 チ ー ム と し て 協 力 ・ 組 織 化 す る こ と が で き ま す 。 そ れ か ら po4aは 翻 訳 を 文 書 構 造 に 直 接 注 入 し て 、 英 語 フ ァ イ ル と 同 様 に 処 理 ・ 配 布 で き る 翻 訳 済 み ソ ー ス フ ァ イ ル を 生 成 し ま す 。 翻 訳 さ れ な か っ た 段 落 は 、 翻 訳 後 の 文 書 に 英 語 の ま ま 残 さ れ 、 エ ン ド ユ ー ザ ー が 文 書 内 の 古 い 翻 訳 を 目 に す る こ と が な い よ う に し ま す 。

こ れ に よ り 、 翻 訳 の 保 守 に お け る ほ と ん ど の 荷 の 重 い 作 業 が 自 動 化 さ れ ま す 。 更 新 が 必 要 な 段 落 を 発 見 す る の は 非 常 に 簡 単 で あ り 、 要 素 の 順 番 が 変 わ っ た だ け で そ れ 以 外 の 変 更 が な け れ ば 工 程 は 完 全 に 自 動 化 さ れ ま す 。 ま た 何 ら か の 検 証 を 行 う こ と で 、 文 書 が 壊 れ て し ま う よ う な 形 式 エ ラ ー の 可 能 性 を 減 ら す こ と が で き ま す 。

こ の ア プ ロ ー チ の 利 点 と 欠 点 の よ り 詳 し い 一 覧 は 、 こ の ド キ ュ メ ン ト の 後 ろ の FAQ を 参 照 し て く だ さ い 。

サ ポ ー ト す る フ ォ ー マ ッ ト

現 在 、 こ の ア プ ロ ー チ で 実 装 に 成 功 し て い る の は 、 以 下 の テ キ ス ト 整 形 フ ォ ー マ ッ ト で す :
man（ 成 熟 し た 構 文 解 析 器 ）

た く さ ん の プ ロ グ ラ ム で 使 わ れ て い る 、 古 き 良 き マ ニ ュ ア ル ペ ー ジ の 形 式 で す 。 こ の 形 式 は い く ら か 難 し く 、 初 心 者 に は 本 当 に 易 し く あ り ま せ ん 。

Locale::Po4a::Man (3pm) モ ジ ュ ー ル は 、 BSD の man ペ ー ジ で 使 わ れ て い る mdoc 形 式 に も 対 応 し て い ま す （ Linux で も か な り 一 般 的 に な っ て い ま す ） 。

AsciiDoc（ 成 熟 し た 構 文 解 析 器 ）

こ の 形 式 は 、 文 書 の 執 筆 を 容 易 に す る こ と を 目 的 と し た 軽 量 の マ ー ク ア ッ プ 形 式 で す 。 例 え ば 、 git シ ス テ ム の ド キ ュ メ ン ト に 使 用 さ れ て い ま す 。 こ れ ら の manペ ー ジ は po4a を 使 っ て 翻 訳 さ れ て い ま す 。

詳 し く は Locale::Po4a::AsciiDocを ご 覧 く だ さ い 。

pod（ 成 熟 し た 構 文 解 析 器 ）

Perl の オ ン ラ イ ン ド キ ュ メ ン ト フ ォ ー マ ッ ト で す 。 既 存 の ほ と ん ど の Perl ス ク リ プ ト に 加 え 、 言 語 や 拡 張 機 能 自 体 が こ の 形 式 を 使 っ て 記 述 さ れ て い ま す 。 ド キ ュ メ ン ト と 実 際 の コ ー ド の 両 方 を 同 じ フ ァ イ ル に 組 み 込 ん で お く こ と で 両 者 の 内 容 を 近 し い も の に 保 ち や す く な っ て い ま す 。 プ ロ グ ラ マ ー の 体 験 が 良 く な り ま す が 、 残 念 な が ら 翻 訳 者 の 生 活 は 楽 に は な り ま せ ん 。 po4aを 使 う ま で は ね 。

詳 細 は Locale::Po4a::Podを 見 て く だ さ い 。

sgml（ 成 熟 し た 構 文 解 析 器 ）

現 在 で は XMLに 取 っ て 代 わ ら れ た と は い え 、 数 画 面 以 上 の 文 書 に は こ の 形 式 が 使 わ れ ま す 。 本 全 体 に 使 わ れ る こ と も あ り ま す 。 こ れ だ け の 長 さ の 文 書 は 、 更 新 す る の が 非 常 に 困 難 で す 。 diff は 、 更 新 後 に 元 の テ キ ス ト の 字 下 げ が 改 め ら れ た 場 合 、 明 ら か に 役 に 立 た な い と わ か る こ と が よ く あ り ま す 。 幸 い な こ と に 、 po4aは そ の よ う な 変 更 処 理 の 後 で も 助 け に な り ま す 。

現 在 、 DebianDoc と DocBook DTD の み に 対 応 し て い ま す が 、 新 し く 対 応 す る も の を 追 加 す る の は 、 本 当 に 簡 単 で す 。 ま た 、 コ マ ン ド ラ イ ン に 必 要 な 情 報 を 与 え 、 コ ー ド を 変 更 せ ず に 未 知 の SGML DTD を po4a で 使 用 す る こ と も で き ま す 。 詳 細 は Locale::Po4a::Sgml (3pm) を 参 照 し て く だ さ い 。

TeX / LaTeX （ 成 熟 し た 構 文 解 析 器 ）

LaTeX形 式 は 自 由 ソ フ ト ウ ェ ア 界 や 出 版 界 で 使 わ れ て い る 主 要 な 文 書 形 式 で す 。

Locale::Po4a::LaTeX (3pm) モ ジ ュ ー ル は Python の ド キ ュ メ ン ト や 書 籍 、 プ レ ゼ ン の ス ラ イ ド で の 実 績 が あ り ま す 。

text（ 成 熟 し た 構 文 解 析 器 ）

テ キ ス ト 形 式 は 、 Markdown、 fortunes、 YAMLフ ロ ン ト マ タ ー 節 、 debian/changelog、 debian/control な ど 、 長 い テ キ ス ト ブ ロ ッ ク を 含 む 多 く の 形 式 の 基 本 形 式 と な り ま す 。

こ れ は 、 静 的 サ イ ト ジ ェ ネ レ ー タ 、 README、 そ の 他 の ド キ ュ メ ン ト シ ス テ ム で 使 用 さ れ る 一 般 的 な 形 式 に 対 応 し て い ま す 。 詳 し く は Locale::Po4a::Text (3pm) を ご 覧 く だ さ い 。

xmlと XHTML（ 恐 ら く 成 熟 し た 構 文 解 析 器 ）

XML フ ォ ー マ ッ ト は 多 く の ド キ ュ メ ン ト フ ォ ー マ ッ ト の 基 礎 に な っ て い ま す 。

現 在 、 DocBook の DTD （ 詳 細 は Locale::Po4a::Docbook (3pm) を 参 照 ） と XHTMLが po4aで は 対 応 さ れ て い ま す 。

BibTeX（ 恐 ら く 成 熟 し た 構 文 解 析 器 ）

BibTeXは 、 LaTeXと 共 に 出 典 リ ス ト （ 参 考 文 献 一 覧 ） を 整 え る た め に 使 用 さ れ て い ま す 。

詳 し く は Locale::Po4a::BibTexを ご 覧 く だ さ い 。

DocBook（ 恐 ら く 成 熟 し た 構 文 解 析 器 ）

XMLを 基 に し た マ ー ク ア ッ プ 言 語 で 、 文 書 を 記 述 す る の に 意 味 的 な タ グ を 用 い ま す 。

詳 し く は Locale::Po4a:Docbookを ご 覧 く だ さ い 。

Guide XML（ 恐 ら く 成 熟 し た 構 文 解 析 器 ）

XMLの 文 書 形 式 の 1つ 。 こ の モ ジ ュ ー ル は 、 少 な く と も 2016年 3月 （ Wayback Machineに 基 づ く ） ま で は 、 Gentoo Linuxド キ ュ メ ン ト の 翻 訳 の サ ポ ー ト と 保 守 を 支 援 す る た め に 特 別 に 開 発 さ れ ま し た 。 Gentooは そ の 後 、 DevBook XML形 式 に 移 行 し ま し た 。

詳 し く は Locale::Po4a:Guideを ご 覧 く だ さ い 。

Wml（ 恐 ら く 成 熟 し た 構 文 解 析 器 ）

Web Markup Languageの 略 で あ っ て 、 携 帯 電 話 で 使 わ れ て い る WAPと し て の WMLを 混 同 し な い よ う に し て く だ さ い 。 こ の モ ジ ュ ー ル は XHTMLモ ジ ュ ー ル に 依 存 し て お り 、 XHTMLモ ジ ュ ー ル 自 体 も XMLモ ジ ュ ー ル に 依 存 し て い ま す 。

よ り 詳 し く は Locale::Po4a::Wmlを 見 て く だ さ い 。

Yaml（ 恐 ら く 成 熟 し た 構 文 解 析 器 ）

JSONの 厳 密 な ス ー パ ー セ ッ ト で す 。 YAMLは シ ス テ ム や プ ロ ジ ェ ク ト の 設 定 と し て よ く 使 わ れ ま す 。 YAMLは Red Hatの Ansibleの 中 核 を 成 し て い ま す 。

よ り 詳 し く は Locale::Po4a::Yaml を 見 て く だ さ い 。

RubyDoc（ 恐 ら く 成 熟 し た 構 文 解 析 器 ）

Ruby Document (RD) 形 式 は 、 2002年 に RDocに 変 換 さ れ る ま で は 、 Rubyお よ び Rubyプ ロ ジ ェ ク ト の 既 定 の 文 書 形 式 で し た 。 た だ し 、 日 本 語 版 の Rubyリ フ ァ レ ン ス マ ニ ュ ア ル は 今 で も RDを 使 用 し て い る よ う で す 。

よ り 詳 し く は Locale::Po4a::RubyDocを 見 て く だ さ い 。

Halibut（ 恐 ら く 実 験 的 な 構 文 解 析 器 ）

PuTTYの 開 発 者 で あ る Simon Tathamが 開 発 し た 、 TeX、 debiandoc-sgml、 TeXinfoな ど に 似 た 要 素 を 持 つ 文 書 作 成 シ ス テ ム で す 。

詳 し く は Locale::Po4a:Halibutを ご 覧 く だ さ い 。

Ini（ 恐 ら く 実 験 的 な 構 文 解 析 器 ）

MS-DOS に よ っ て 普 及 し た 設 定 フ ァ イ ル 形 式 。

詳 し く は Locale::Po4a::Iniを ご 覧 く だ さ い 。

texinfo（ 極 め て 実 験 的 な 構 文 解 析 器 ）

GNU の ド キ ュ メ ン ト は す べ て こ の 形 式 で 書 か れ て い ま す （ 公 式 GNU プ ロ ジ ェ ク ト に な る 必 要 条 件 の 一 つ で さ え あ り ま す ） 。 po4a の Locale::Po4a::Texinfo (3pm) 対 応 は 始 ま っ た ば か り で す 。 バ グ 報 告 や 機 能 の 要 望 を お 願 い し ま す 。

gemtext（ 極 め て 実 験 的 な 構 文 解 析 器 ）

Geminiプ ロ ト コ ル 固 有 の 素 の テ キ ス ト 形 式 で す 。 拡 張 子 「 .gmi」 が 一 般 に 使 わ れ ま す 。 po4aに お け る こ の モ ジ ュ ー ル の 対 応 は ま だ 始 ま っ た ば か り で す 。 何 か 気 付 い た こ と が あ れ ば 不 具 合 を 報 告 し た り 機 能 の 提 案 を お 願 い し ま す 。

他 に 対 応 し て い る 形 式

po4a は 、 2.4以 上 の Linuxカ ー ネ ル の コ ン パ イ ル オ プ シ ョ ン の ド キ ュ メ ン ト (Locale::Po4a::KernelHelp) や 、 dia ツ ー ル で 使 用 す る 図 (Locale::Po4a::Dia) と い っ た 、 も っ と 稀 だ っ た り 特 殊 な 形 式 も サ ポ ー ト し て い ま す 。 新 し い 形 式 を 追 加 す る の は 非 常 に 簡 単 で 、 目 標 の 形 式 の 構 文 解 析 器 を 追 加 す る の が 主 な 作 業 内 容 と な っ て い ま す 。 こ の 詳 細 情 報 は Locale::Po4a::TransTractor (3pm) を 参 照 し て く だ さ い 。

サ ポ ー ト 外 の フ ォ ー マ ッ ト

残 念 な が ら 、 po4aは ま だ い く つ か の 文 書 形 式 に 対 応 し て い ま せ ん 。 そ れ ら の 多 く は po4a で 簡 単 に 対 応 で き る は ず で す 。 例 え ば 、 パ ッ ケ ー ジ の 説 明 （ debや rpm） 、 パ ッ ケ ー ジ の イ ン ス ト ー ル ス ク リ プ ト の 質 問 、 パ ッ ケ ー ジ の 変 更 履 歴 、 ゲ ー ム シ ナ リ オ や wineの リ ソ ー ス フ ァ イ ル の よ う な プ ロ グ ラ ム で 使 用 さ れ る す べ て の 特 殊 な フ ァ イ ル 形 式 な ど 、 文 書 に 使 用 さ れ な い 形 式 が 含 ま れ ま す 。

po4aを 使 う

プ ロ ジ ェ ク ト で こ の ツ ー ル を 使 う 一 番 簡 単 な 方 法 は 、 po4a プ ロ グ ラ ム 用 の 構 成 フ ァ イ ル を 書 き 、 こ の プ ロ グ ラ ム だ け を 使 っ て 作 業 す る こ と で す 。 po4a (1)の ド キ ュ メ ン ト を 参 照 し て く だ さ い 。 こ の 節 の 残 り で は 理 解 を 深 め た い 中 級 以 上 の po4aの 利 用 者 向 け に 詳 細 情 報 を 提 供 し ま す 。

po4aで の 作 業 工 程 の 詳 細 な 図 解

本 節 の 余 り に も 詳 細 な 節 を 読 む 前 に 、 po4a (1)を 読 ん で po4aで の 作 業 工 程 の 単 純 化 さ れ た 全 体 像 を 掴 ん で く だ さ い 。 ほ ぼ 全 て の 詳 細 が 載 っ て い る 、 お ど ろ お ど ろ し い 全 貌 を 掴 み た く な っ た ら こ ち ら に 戻 っ て き て く だ さ い 。

以 下 の 図 解 で は 、 master.doc は 翻 訳 さ れ る 文 書 の 名 前 の 例 で す 。 XX.doc は 言 語 XXで 翻 訳 さ れ た 同 じ 文 書 で あ り 、 doc.XX.po は XX言 語 の 文 書 用 の 翻 訳 カ タ ロ グ で す 。 文 書 の 著 者 は 主 に master.doc （ manペ ー ジ 、 XML文 書 、 AsciiDocフ ァ イ ル な ど ） に 注 力 し 、 翻 訳 者 は 主 に POフ ァ イ ル に 注 力 し ま す 。 一 般 の 利 用 者 は XX.doc フ ァ イ ル だ け を 目 に し ま す 。

"[po4aが poを 更 新 ]"と い っ た 角 括 弧 の 遷 移 は po4aツ ー ル の 実 行 を 表 し て お り 、 "{master.docの 更 新 }"の よ う な 中 括 弧 の 遷 移 は プ ロ ジ ェ ク ト の フ ァ イ ル の 手 作 業 で の 変 更 を 表 し ま す 。

master.doc
|
V
+<-----<----+<-----<-----<--------+------->-------->-------+
: | | :
{翻 訳 } | {master.docの 更 新 } :
: | | :
XX.doc | V V
（ 省 略 可 能 ） | master.doc ->-------->------>+
: | （ 新 ） |
V V | |
[po4a-gettextize] doc.XX.po -->+ | |
| （ 旧 ） | | |
| ˆ V V |
| | [po4aが poを 更 新 ] |
V | | V
translation.pot ˆ V |
| | doc.XX.po |
| | （ フ ァ ジ ー ） |
{翻 訳 } | | |
| ˆ V V
| | {手 作 業 の 編 集 } |
| | | |
V | V V
doc.XX.po --->---->+<---<-- doc.XX.po addendum master.doc
（ 初 期 状 態 ） （ 最 新 ） （ 省 略 可 能 ） （ 最 新 ）
: | | |
: V | |
+----->----->----->------> + | |
| | |
V V V
+------>-----+------<------+
|
V
[po4aが 翻 訳 を 更 新 ]
|
V
XX.doc
（ 最 新 ）

繰 り 返 し ま す が 、 こ の 図 解 は 余 り に も 複 雑 で す 。 単 純 化 さ れ た 全 体 像 に つ い て は po4a (1)を ご 確 認 く だ さ い 。

左 の 部 分 は 、 po4a-gettextize (1)を 使 っ て 、 既 存 の 翻 訳 プ ロ ジ ェ ク ト を po4aの イ ン フ ラ へ と 変 換 す る 方 法 を 示 し て い ま す 。 こ の ス ク リ プ ト は 、 元 の 文 書 と 翻 訳 さ れ た 対 応 す る 文 書 を 受 け 取 り 、 対 応 す る POフ ァ イ ル を 構 築 し よ う と し ま す 。 こ の よ う な 手 動 変 換 は か な り 面 倒 で す が （ 詳 し く は po4a-gettextize (1) の ド キ ュ メ ン ト を 参 照 し て く だ さ い ） 、 既 存 の 翻 訳 を 変 換 す る た め に 一 度 だ け 必 要 に な り ま す 。 も し 変 換 す る 翻 訳 が な け れ ば こ の こ と は 忘 れ て よ く 、 ス キ ー マ の 右 の 部 分 に 集 中 す る こ と が で き ま す 。

右 上 に は 原 著 作 者 が 文 書 を 更 新 す る 動 作 が 図 示 さ れ て い ま す 。 右 中 段 で は 翻 訳 フ ァ イ ル の 自 動 的 な 動 作 が 図 示 さ れ て い ま す 。 新 し い 資 料 か ら 抽 出 さ れ 、 既 存 の 翻 訳 と 比 較 さ れ ま す 。 変 更 さ れ て い な い 部 分 に は 以 前 の 翻 訳 が 使 用 さ れ 、 部 分 的 に 変 更 さ れ た 部 分 に は 、 翻 訳 を 更 新 す る 必 要 が あ る こ と を 示 す "fuzzy" の 印 が 以 前 の 翻 訳 に 付 け ら れ ま す 。 新 し い 部 分 や 大 き く 変 更 さ れ た 箇 所 は 翻 訳 さ れ な い ま ま 残 さ れ ま す 。

次 に 、 手 動 編 集 の 箇 所 で は 、 翻 訳 者 が POフ ァ イ ル を 修 正 し て 、 す べ て の 元 の 文 字 列 と 段 落 に 翻 訳 を 提 供 す る 動 作 が 表 さ れ て い る こ と が わ か り ま す 。 こ れ は 、 GNOME Translation Editor や KDE の Lokalize や poedit な ど の 特 定 の エ デ ィ タ 、 あ る い は weblate や pootle な ど の オ ン ラ イ ン 現 地 語 化 プ ラ ッ ト フ ォ ー ム を 使 用 し て 行 う こ と が で き ま す 。 翻 訳 結 果 は 、 1言 語 に つ き 1つ の POフ ァ イ ル の 集 ま り で す 。 詳 細 は gettext の ド キ ュ メ ン ト を 参 照 し て く だ さ い 。

図 の 下 部 は 、 po4a (1)が 元 の 文 書 で あ る master.doc と 翻 訳 者 に よ っ て 更 新 さ れ た 翻 訳 カ タ ロ グ で あ る doc.XX.po か ら 翻 訳 さ れ た 文 書 の ソ ー ス を 作 成 す る 様 子 を 示 し て い ま す 。 文 書 の 構 造 は 再 利 用 さ れ 、 元 の 内 容 は 翻 訳 さ れ た 対 応 部 分 に 置 き 換 え ら れ ま す 。 も し 補 遺 が あ れ ば 、 そ れ を 使 っ て 翻 訳 に 追 加 の テ キ ス ト を 差 し 込 め ま す 。 こ れ は 、 最 終 的 な 文 書 に 翻 訳 者 の 名 前 を 追 加 す る た め に よ く 使 用 さ れ ま す 。 詳 し く は 以 下 を ご 覧 く だ さ い 。

コ マ ン ド で 呼 び 出 す と 、 po4a は 翻 訳 フ ァ イ ル と 翻 訳 さ れ た 文 書 フ ァ イ ル の 両 方 を 自 動 的 に 更 新 し ま す 。

新 規 に 翻 訳 の プ ロ ジ ェ ク ト を 始 め る に は

一 か ら 始 め る 場 合 、 po4aの 構 成 フ ァ イ ル を 書 き さ え す れ ば 準 備 が 整 い ま す 。 欠 け て い る フ ァ イ ル に つ い て は 関 係 す る 雛 形 が 作 成 さ れ 、 貢 献 者 が 母 語 で プ ロ ジ ェ ク ト の 翻 訳 を で き る よ う に し ま す 。 速 習 の た め の 入 門 や 全 て の 詳 細 に つ い て は po4a (1)を あ た っ て く だ さ い 。

既 存 の 翻 訳 が あ る 場 合 、 例 え ば 手 作 業 で 翻 訳 さ れ た 文 書 フ ァ イ ル が あ る 場 合 、 po4a-gettextize を 使 っ て po4aの 作 業 工 程 に 内 容 を 組 み 入 れ る こ と が で き ま す 。 こ の 作 業 は （ こ の ツ ー ル の manペ ー ジ に 記 述 さ れ て い る よ う に ） 少 し 面 倒 で す が 、 プ ロ ジ ェ ク ト を po4aの 作 業 工 程 に 変 換 し て し ま え ば 、 全 て が 自 動 的 に 更 新 さ れ る よ う に な り ま す 。

翻 訳 と 文 書 を 更 新 す る

準 備 が 整 っ た ら 、 po4a を 呼 び 出 す だ け で 翻 訳 の POフ ァ イ ル と 翻 訳 文 書 の 両 方 が 更 新 さ れ ま す 。 po4a に "--no-translations"を 渡 し て 翻 訳 を 更 新 し な い （ し た が っ て POフ ァ イ ル の み が 更 新 さ れ る ） よ う に し た り 、 "--no-update"を 渡 し て POフ ァ イ ル を 更 新 し な い （ し た が っ て 翻 訳 の み が 更 新 さ れ る ） よ う に し た り で き ま す 。 こ れ は ざ っ く り 言 う と そ れ ぞ れ po4a-updatepo と po4a-translate ス ク リ プ ト に 対 応 し て お り 、 こ れ ら は 現 在 非 推 奨 で す （ 後 述 の FAQの 「 な ぜ 個 々 の ス ク リ プ ト が 非 推 奨 な の か 」 を 参 照 ） 。

補 遺 を 使 っ て 翻 訳 に 追 加 の テ キ ス ト を 入 れ る

フ ァ イ ル を 手 動 で 翻 訳 す る 管 理 を し て い れ ば 、 翻 訳 文 に 新 し い テ キ ス ト を 追 加 す る こ と は 、 長 い 目 で 見 れ ば 恐 ら く ど ん な 管 理 方 法 よ り も 簡 単 で し ょ う :)。 こ う し た こ と は 翻 訳 さ れ た 文 書 に 、 元 の 文 書 の ど の 内 容 に も 対 応 し な い 追 加 部 分 を 入 れ た い 場 合 に 起 こ り ま す 。 古 典 的 な 使 用 例 と し て は 、 翻 訳 チ ー ム に 謝 辞 を 述 べ た り 、 翻 訳 特 有 の 問 題 を 報 告 す る 方 法 を 示 し た り す る こ と が あ り ま す 。

po4a で は addendum フ ァ イ ル を 指 定 し な け れ ば な り ま せ ん が 、 こ れ は 概 念 的 に 処 理 後 に 現 地 化 さ れ た 文 書 に 適 用 さ れ る パ ッ チ と 見 な す こ と が で き ま す 。 各 補 遺 は 別 々 の フ ァ イ ル と し て 与 え ら れ て い な け れ ば な り ま せ ん が 、 そ の 形 式 は 従 来 の パ ッ チ と は 全 く 異 な っ て い ま す 。 最 初 の 行 は header line で 、 補 遺 の 挿 入 位 置 を 定 義 し （ 残 念 な が ら 不 可 解 な 構 文 で ……。 後 述 ） 、 フ ァ イ ル の 残 り の 部 分 は 決 め ら れ た 位 置 に そ の ま ま 追 加 さ れ ま す 。

ヘ ッ ダ 行 は 、 文 字 列 PO4A-HEADER: で 始 ま り 、 key = value フ ィ ー ル ド の リ ス ト を セ ミ コ ロ ン で 区 切 っ た も の が 続 く 必 要 が あ り ま す 。

例 え ば 以 下 の ヘ ッ ダ は 翻 訳 の 一 番 最 後 に 置 か な け れ ば な ら な い 補 遺 を 宣 言 し て い ま す 。

PO4A-HEADER: mode=eof

文 書 の 途 中 に 追 加 の 内 容 を 入 れ た い 場 合 、 話 は よ り 複 雑 に な り ま す 。 以 下 の ヘ ッ ダ は 補 遺 を "About this document"と い う 文 字 列 を 含 む XMLの sectionの 後 に 置 か な け れ ば な ら な い と 宣 言 し て い ま す 。

PO4A-HEADER: position=About this document; mode=after; endboundary=</section>

実 際 に は 、 補 遺 を 適 用 し よ う と す る と き 、 po4aは "position"引 数 （ こ れ は 正 規 表 現 で も 構 い ま せ ん ） に 照 合 す る 最 初 の 行 を 探 し ま す 。 po4aは こ こ で 翻 訳 さ れ た の 文 書 を 考 慮 す る こ と を 忘 れ な い で く だ さ い 。 こ の 文 書 は 英 語 で す が 、 補 遺 が フ ラ ン ス 語 に 翻 訳 さ れ た 文 書 に 適 用 さ れ る こ と を 意 図 し て い る な ら 、 行 は お そ ら く 次 の よ う な も の に す る べ き で し ょ う 。

PO4A-HEADER: position=À propos de ce document; mode=after; endboundary=</section>

"position"が 対 象 の 文 書 で 見 つ か る と 、 po4aは "position"以 降 で 与 え ら れ た "endboundary"に 照 合 す る 行 を 探 し ま す 。 そ の 行 の す ぐ 後 ろ に 補 遺 が 追 加 さ れ ま す （ な ぜ な ら 現 在 の 節 が 終 わ る 境 界 で あ る endboundary を 与 え た た め で す ） 。

ち ょ う ど 同 じ 効 果 が 以 下 の ヘ ッ ダ で も 付 与 で き 、 等 価 で す 。

PO4A-HEADER: position=About this document; mode=after; beginboundary=<section>

こ こ で は 、 po4a は 翻 訳 の 中 の "About this document" に 照 合 す る 行 の 後 に あ る "<section>" に 照 合 す る 最 初 の 行 を 探 し 、 beginboundary 、 つ ま り 次 の 節 の 始 ま り を 示 す 境 界 を 与 え た の で 、 そ の 行 の 前 に 補 遺 を 追 加 す る の で す 。 で す か ら 、 こ の ヘ ッ ダ 行 は 、 "About this document"を 含 む 節 の 後 に 補 遺 を 置 き 、 "<section>"タ グ を 含 む 行 か ら 節 が 始 ま る と po4aに 指 示 す る 必 要 が あ る と し て い ま す 。 こ れ は 前 の 例 と 同 じ で す 。 な ぜ な ら こ こ で 本 当 に し た い こ と は 、 こ の 補 遺 を "</section> > の 後 か "<section> > の 前 に 追 加 す る こ と だ か ら で す 。 ""

挿 入 l<mode>を 値 "before"に 設 定 す る こ と も で き 、 こ れ は 似 た 意 味 を 持 ち ま す 。 "mode=before"と "endboundary"を 組 み 合 わ せ る と 、 照 合 し た 境 界 の ち ょ う ど 後 ろ に 補 遺 を 置 き 、 最 後 の 潜 在 的 な 境 界 線 が "position"の 前 に 来 ま す 。 "mode=before"と "beginboundary"を 組 み 合 わ せ る と 照 合 し た 境 界 の ち ょ う ど 前 に 補 遺 が 置 か れ 、 最 後 の 潜 在 的 な 境 界 線 が "position"の 前 に 来 ま す 。

Mode | Boundary kind | Used boundary | Insertion point compared to the boundary
========|===============|========================|=========================================
'before'| 'endboundary' | last before 'position' | Right after the selected boundary
'before'|'beginboundary'| last before 'position' | Right before the selected boundary
'after' | 'endboundary' | first after 'position' | Right after the selected boundary
'after' |'beginboundary'| first after 'position' | Right before the selected boundary
'eof' | (none) | n/a | End of file

補 遺 に つ い て の ヒ ン ト と コ ツ

	•		こ れ ら が 正 規 表 現 で あ る こ と を 覚 え て お い て く だ さ い 。 例 え ば ".fi"で 終 わ る nroffの 節 の 終 端 に 照 合 さ せ た い と き は 、 endboundary と し て ".fi" を 使 用 し な い で く だ さ い 。 明 ら か に 想 定 し て い な い "the[ fi]le" に も 照 合 し て し ま い ま す 。 こ の 場 合 の 正 し い endboundary は "ˆ\.fi$" で す 。
	•		"position"と 境 界 の 内 容 の 中 で は ま さ に 空 白 が 要 で す 。 で す か ら 、 次 の 2つ の 行 は 異 な り ま す 。 2番 目 の 行 は 、 翻 訳 さ れ た 文 書 に 充 分 な 後 続 の 空 白 が あ る 場 合 に の み 検 出 さ れ ま す 。

PO4A-HEADER: position=About this document; mode=after; beginboundary=<section>
PO4A-HEADER: position=About this document ; mode=after; beginboundary=<section>

	•		こ の 文 脈 検 索 は 、 翻 訳 文 書 の 各 行 に 対 し て 大 ま か に 操 作 し て い る よ う に 思 わ れ ま す が 、 実 際 に は 翻 訳 文 書 の 内 部 デ ー タ 文 字 列 に 対 し て 操 作 し て い ま す 。 こ の 内 部 デ ー タ 文 字 列 は 、 複 数 行 を 含 む 段 落 に ま た が る テ キ ス ト で や XMLタ グ そ の も の に な り え ま す 。 補 遺 の 正 確 な 挿 入 点 は 、 内 部 デ ー タ 文 字 列 の 前 か 後 で な け れ ば な ら ず 、 内 部 デ ー タ 文 字 列 の 中 に あ る こ と は で き ま せ ん 。
	•		po4a に "-vv" 引 数 を 渡 す と 、 ど の よ う に 補 遺 が 翻 訳 に 追 加 さ れ る か を 理 解 す る こ と が で き ま す 。 ま た 、 補 遺 が 適 用 さ れ な い と き の 実 際 の 内 部 デ ー タ 文 字 列 を 見 る た め に 、 po4a を デ バ ッ グ モ ー ド で 実 行 す る こ と も 役 に 立 つ か も し れ ま せ ん 。

補 遺 の 例

•

以 下 の nroff 節 の 後 に 何 か 追 加 し た い と し ま す :

.SH "AUTHORS"

mode=after を 設 定 し て 2工 程 の 手 法 を 選 択 し ま す 。 そ れ か ら position 引 数 の 正 規 表 現 で AUTHORS の 後 の 行 に 検 索 を 絞 り 込 み ま す 。 次 に 、 beginboundary 引 数 の 正 規 表 現 で 、 次 の 節 の 先 頭 （ つ ま り ˆ\.SH ） に 照 合 さ せ ま す 。 つ ま り 次 の よ う に な り ま す 。

PO4A-HEADER:mode=after;position=AUTHORS;beginboundary=\.SH

•

与 え ら れ た 行 の 直 後 に 何 か を 追 加 し た け れ ば 、 こ の 行 に 照 合 す る position と mode=after を 使 い 、 任 意 の 行 に 照 合 す る beginboundary を 与 え て く だ さ い 。

PO4A-HEADER:mode=after;position=Copyright Big Dude, 2004;beginboundary=ˆ

•

ド キ ュ メ ン ト の 最 後 に 何 か 追 加 し た い 場 合 、 position は ド キ ュ メ ン ト の 任 意 の 行 (し か し 1 行 の み 。 ユ ニ ー ク で な い と po4a は 処 理 し ま せ ん ) に マ ッ チ す る よ う に 与 え 、 endboundary は 何 も マ ッ チ し な い よ う に 与 え ま す 。 "EOF" の よ う な 単 純 な 文 字 列 を 使 用 せ ず 、 ド キ ュ メ ン ト に た ま た ま 含 ま れ て い る も の を 使 用 し て く だ さ い 。

PO4A-HEADER:mode=after;position=About this document;beginboundary=FakePo4aBoundary

も っ と 詳 細 な 例

オ リ ジ ナ ル ド キ ュ メ ン ト (POD フ ォ ー マ ッ ト ):

|=head1 NAME
|
|dummy - a dummy program
|
|=head1 AUTHOR
|
|me

そ し て 、 以 下 の 補 遺 は 確 実 に （ フ ラ ン ス 語 で ） 翻 訳 者 に つ い て の 節 を フ ァ イ ル の 最 後 に 追 加 さ れ ま す （ フ ラ ン ス 語 の "TRADUCTEUR" は "TRANSLATOR"、 "moi" は "me" の 意 味 で す ） 。

|PO4A-HEADER:mode=after;position=AUTEUR;beginboundary=ˆ=head
|
|=head1 TRADUCTEUR
|
|moi
|

AUTHOR の 前 に 追 加 内 容 を 追 加 す る に は 、 以 下 の ヘ ッ ダ を 使 用 し て く だ さ い :

PO4A-HEADER:mode=after;position=NOM;beginboundary=ˆ=head1

こ れ は 、 "NAME" 節 （ フ ラ ン ス 語 で は "NOM"と 翻 訳 さ れ る ） の 後 に あ る beginboundary "/ˆ=head1/" に 照 合 し た 次 の 行 が 作 者 を 宣 言 し て い る か ら う ま く い く の で す 。 そ の た め 、 両 方 の 節 の 間 に 追 加 内 容 が 挿 入 さ れ ま す 。 な お 他 の 節 が NAMEと AUTHORの 節 に 後 で 追 加 さ れ る 場 合 、 po4aは 補 遺 を 新 し い 節 の 前 に 置 く た め 間 違 っ た こ と に な り ま す 。

こ れ を 防 ぐ た め に mode =l<before>を 使 っ て 同 じ こ と を 達 成 で き ま す ：

PO4A-HEADER:mode=before;position=ˆ=head1 AUTEUR

ど の よ う に 動 作 し ま す か ?

こ の 章 で は po4aの 内 部 の 全 体 像 を 手 短 か に 説 明 し ま す 。 こ ち ら を お 読 み い た だ け れ ば 、 po4aを 保 守 し 改 善 し て い く 手 助 け を す る に あ た っ て よ り 自 信 が つ く か も し れ ま せ ん 。 ま た 、 な ぜ 思 っ た よ う に 動 作 し な い か 、 ど の よ う に 問 題 を 解 決 す れ ば い い か を 理 解 す る 助 け に な る か も し れ ま せ ん 。

TransTractorと プ ロ ジ ェ ク ト の ア ー キ テ ク チ ャ

po4aプ ロ ジ ェ ク ト の 核 心 に は Locale::Po4a::TransTractor (3pm)ク ラ ス が あ り 、 全 て の po4a構 文 解 析 器 に 共 通 す る 先 祖 と な っ て い ま す 。 こ の 奇 妙 な 名 前 は 文 書 の 翻 訳 と 文 字 列 の 抽 出 を 同 時 に 行 う と こ ろ か ら 付 け ら れ て い ま す 。

も っ と 形 式 張 っ て い う と 、 入 力 と し て 翻 訳 す る 文 書 と 翻 訳 が 入 っ て い る POフ ァ イ ル を 取 り 、 結 果 を 別 の POフ ァ イ ル （ 入 力 文 書 か ら 翻 訳 可 能 な 文 字 列 を 抽 出 し た 結 果 ） と 翻 訳 済 み 文 書 （ 入 力 し た フ ァ イ ル と 同 じ 構 造 で す が 、 翻 訳 可 能 な 文 字 列 は 入 力 POフ ァ イ ル の 内 容 で 置 換 さ れ て い る フ ァ イ ル ） の 2つ に 分 け て 出 力 し ま す 。 以 下 に 図 示 し ま す 。

入 力 ド キ ュ メ ン ト -\ /---> 出 力 ド キ ュ メ ン ト
\ TransTractor:: / (翻 訳 済 み )
+-->-- parse() --------+
/ \
入 力 PO ---------/ \---> 出 力 PO
(抽 出 済 み )

こ の 小 さ な 骨 子 は 、 po4aア ー キ テ ク チ ャ の 中 核 の 全 て を 表 し て い ま す 。 両 方 の 入 力 を 与 え 、 出 力 の POを 無 視 す る と 、 po4a-translate に な り ま す 。 代 え て 出 力 文 書 を 無 視 す る と po4a-updatepo に な り ま す 。 po4a は 最 初 に TransTractorを 使 っ て 最 新 の 出 力 POTフ ァ イ ル を 得 て 、 msgmerge -U を 呼 び 出 し て デ ィ ス ク 上 の 翻 訳 POフ ァ イ ル を 更 新 し ま す 。 そ れ か ら こ れ ら の 更 新 さ れ た POフ ァ イ ル で 2回 目 の TransTractorを 構 築 し 、 出 力 文 書 を 更 新 し ま す 。 要 は 、 po4a は 必 要 な 更 新 に つ い て 1つ の 構 成 フ ァ イ ル を 使 っ て 一 括 で 行 う 解 決 策 を 提 供 す る わ け で す 。

po4a-gettextize も 2つ の TransTractorを 使 い ま す が 、 違 っ た や り 方 を し ま す 。 1つ 目 の TransTractorを 言 語 毎 に 構 築 し 、 そ れ か ら 元 の 文 書 の msgidは msgidと し て 、 翻 訳 文 書 の msgidは msgstrと し て 使 い 、 新 し い POフ ァ イ ル を 構 築 し ま す 。 po4a-gettextize (1)に 記 載 さ れ て い る よ う に 、 こ の よ う に し て 照 合 さ れ た 文 字 列 が 実 際 に 照 合 で き て い る か に つ い て は 注 意 が 必 要 で す 。

形 式 に 固 有 の 構 文 解 析 器

全 て の po4aの 形 式 の 構 文 解 析 器 は TransTractorを 土 台 に 実 装 さ れ て い ま す 。 Text、 Markdown、 AsciiDocと い っ た と て も 単 純 な も の が あ り ま す 。 こ れ ら は TransTractor::shiftline()を 使 っ て 1行 ず つ 読 み 込 み 、 段 落 の 内 容 か 何 か を 積 み 上 げ て い き ま す 。 文 字 列 が 完 全 に 構 文 解 析 で き た ら 、 構 文 解 析 器 は TransTractor::translate()を 使 っ て （ １ ） こ の 文 字 列 を 出 力 POフ ァ イ ル に 追 加 し （ ２ ） 入 力 POフ ァ イ ル か ら 翻 訳 を 取 得 し ま す 。 そ れ か ら 構 文 解 析 器 は TransTractor::pushline()を 使 っ て 出 力 フ ァ イ ル に 結 果 を 押 し 込 み ま す 。

そ の 他 の 構 文 解 析 器 は も っ と 複 雑 で す が 、 そ れ は 入 力 文 書 を 解 析 す る た め に 外 部 の 構 文 解 析 器 に 依 存 し て い る た め で す 。 Xml、 HTML、 SGML、 Podの 構 文 解 析 器 は SAX構 文 解 析 器 を 土 台 に 構 築 さ れ て い ま す 。 こ れ ら の 解 析 器 は 「 以 下 の 内 容 の 新 規 題 名 を 見 付 け ま し た 」 と い う よ う な イ ベ ン ト の コ ー ル バ ッ ク を 宣 言 し 、 TransTractor::translate()と TransTractor::pushline()を 使 っ て 入 力 の 内 容 に 沿 っ て 出 力 文 書 と 出 力 POTフ ァ イ ル を 更 新 し ま す 。 Yaml構 文 解 析 器 は よ り 単 純 で す が 毛 色 が 違 い ま す 。 YAML::Tiny構 文 解 析 器 に よ り 生 成 さ れ る デ ー タ 構 造 を 直 列 化 す る の で す 。 こ れ が po4aの Yamlモ ジ ュ ー ル で は 参 照 行 の 宣 言 が で き な い こ と の 理 由 で す 。 入 力 フ ァ イ ル の 各 文 字 列 の 位 置 は 構 文 解 析 器 で 保 持 さ れ ず 、 文 字 列 の 場 所 と し て 与 え ら れ る の は 「 $filename:1」 の み な の で す 。 SAXに 基 づ く 構 文 解 析 は 大 域 変 数 と そ の 他 の 仕 掛 け を 使 っ て フ ァ イ ル 名 と 参 照 の た め の 行 番 号 を 保 存 し ま す 。

フ ァ イ ル の 符 号 化 方 式 と BOMの 印 に よ り 引 き 起 こ さ れ る 問 題 が あ り ま す 。 単 純 な 構 文 解 析 器 で は TransTractor::read() （ 入 力 文 書 の 行 を 取 得 す る た め に 内 部 的 に 使 用 さ れ ま す ） で 対 処 さ れ る た め こ の 問 題 を 無 視 で き ま す 。 し か し 外 部 の 構 文 解 析 器 に 依 存 す る モ ジ ュ ー ル で は 全 て の フ ァ イ ル が PerlIOデ コ ー ド 層 で 適 切 に 読 み 込 ま れ る よ う に し な く て は な り ま せ ん 。 最 も 簡 単 な の は 、 外 部 の 構 文 解 析 器 に フ ァ イ ル を 自 分 で 開 い て フ ァ イ ル ハ ン ド ル な い し 完 全 な 文 字 列 を 与 え る こ と で す 。 一 例 に つ い て は Pod::read()と Pod::parse()を 見 て く だ さ い 。 TransTractorに よ り 読 ま れ た 内 容 は 無 視 さ れ ま す が 、 外 部 の 構 文 解 析 器 に 新 し い フ ァ イ ル ハ ン ド ル が 渡 さ れ て い ま す 。 重 要 な 部 分 は "<:encoding($charset)" モ ー ド で 、 こ れ が open() perl関 数 に 渡 さ れ ま す 。

Poオ ブ ジ ェ ク ト

Locale::Po4a::Po (3pm)ク ラ ス は POと POTフ ァ イ ル の 読 み 込 み と 活 用 を 担 い ま す 。 基 本 的 に 、 フ ァ イ ル を 読 み 、 項 目 を 追 加 し 、 gettext() メ ソ ッ ド で 翻 訳 を 取 得 し 、 POを フ ァ イ ル に 書 き 込 め ま す 。 POTフ ァ イ ル に POフ ァ イ ル を 統 合 し た り フ ァ イ ル を 健 勝 し た り す る よ り 発 展 的 な 機 能 に つ い て は そ れ ぞ れ msgmerge と msgfmt に 説 明 を 委 ね ま す 。

po4aに 貢 献 す る

過 去 に 全 く オ ー プ ン ソ ー ス プ ロ ジ ェ ク ト に 貢 献 し た こ と が な く て も 歓 迎 し ま す 。 喜 ん で 手 助 け し た り メ ン タ リ ン グ し ま す 。 po4aは 今 日 も 利 用 者 に よ り 最 高 の 保 守 が な さ れ て い ま す 。 人 手 は 足 り て い ま せ ん が 、 ド キ ュ メ ン ト と 自 動 的 な テ ス ト を 改 善 し て プ ロ ジ ェ ク ト へ の 貢 献 に 自 信 が 持 て る よ う に す る こ と で 、 プ ロ ジ ェ ク ト へ の 貢 献 を 迎 え 入 れ ら れ る よ う に 努 め て い ま す 。 詳 細 に つ い て は CONTRIBUTING.mdフ ァ イ ル を 参 照 し て く だ さ い 。

po4aを 使 っ て い る オ ー プ ン ソ ー ス プ ロ ジ ェ ク ト

以 下 は プ ロ ダ ク シ ョ ン 環 境 で ド キ ュ メ ン ト 用 に po4aを 使 っ て い る プ ロ ジ ェ ク ト の ほ ん の 一 部 の 一 覧 で す 。 も し 一 覧 へ の ご 自 身 の プ ロ ジ ェ ク ト の 追 加 を ご 希 望 で し た ら Eメ ー ル （ ま た は マ ー ジ リ ク エ ス ト ） を お 寄 せ く だ さ い 。

	•		adduser (man): ユ ー ザ ー と グ ル ー プ の 管 理 ツ ー ル 。
	•		apt (man, docbook): Debianの パ ッ ケ ー ジ 管 理 。
	•		aptitude (docbook, svg): Debian用 の 端 末 ベ ー ス の パ ッ ケ ー ジ 管 理
	•		F-Droidの webサ イ ト <https://gitlab.com/fdroid/fdroid-website> (markdown): Androidプ ラ ッ ト フ ォ ー ム 用 の イ ン ス ト ー ル 可 能 な FOSS（ 自 由 で オ ー プ ン ソ ー ス な ソ フ ト ウ ェ ア ） の 目 録 。
	•		git <https://github.com/jnavila/git-manpages-l10n> (asciidoc): ソ ー ス コ ー ド の 変 更 を 追 跡 す る た め の 分 散 バ ー ジ ョ ン 管 理 シ ス テ ム 。
	•		Linux manペ ー ジ <https://salsa.debian.org/manpages-l10n-team/manpages-l10n> (man)

こ の プ ロ ジ ェ ク ト は 多 く の パ ッ ケ ー ジ と 別 の 言 語 に 翻 訳 す る イ ン フ ラ を 提 供 し て お り 、 複 数 の 主 要 な デ ィ ス ト リ ビ ュ ー シ ョ ン （ Arch Linux、 Debianと そ の 派 生 、 Fedora） へ の 統 合 の 準 備 が 整 っ て い ま す 。

	•		Stellarium <https://github.com/Stellarium/stellarium> (HTML): 手 元 の コ ン ピ ュ ー タ 用 の 自 由 で オ ー プ ン ソ ー ス な プ ラ ネ タ リ ウ ム 。 po4aは 空 の 文 化 の 説 明 を 翻 訳 す る た め に 使 わ れ て い ま す 。
	•		Jamulus <https://jamulus.io/> (markdown, yaml, HTML): 実 時 間 で オ ン ラ イ ン の ジ ャ ズ を 演 奏 す る た め の FOSSア プ リ ケ ー シ ョ ン で す 。 webサ イ ト の ド キ ュ メ ン ト は po4aを 使 っ て 複 数 言 語 で 保 守 さ れ て い ま す 。
	•		そ の 他 未 整 理 の 項 目 ： <https://gitlab.com/fdroid/fdroid-website/> <https://github.com/fsfe/reuse-docs/pull/61>

FAQ

po4aは ど う 発 音 す る の で す か ？

個 人 的 に は <pouah|https://en.wiktionary.org/wiki/pouah>と 発 声 し て お り 、 こ れ は yuck の 意 味 の フ ラ ン ス 語 の 擬 音 語 で す :)。 ヘ ン な ユ ー モ ア の セ ン ス か も し れ ま せ ん :)

な ぜ 個 別 の ス ク リ プ ト が 非 推 奨 と な っ た の か

po4a-updatepo と po4a-translate は po4a が 代 わ る こ と に よ り 非 推 奨 と な り ま し た 。 そ の 理 由 は po4a が こ れ ら の ス ク リ プ ト を そ の ま ま 置 き 換 え ら れ る 一 方 、 コ ー ド の 重 複 が か な り あ る た め で す 。 個 別 の ス ク リ プ ト は 150行 の コ ー ド で す が po4a プ ロ グ ラ ム は 1200行 に 及 び ま す 。 故 に こ れ ら の 個 別 の ス ク リ プ ト は 共 通 す る 内 部 の 処 理 に 加 え て 沢 山 の こ と を し て い ま す 。 コ ー ド の 重 複 は 両 方 の バ ー ジ ョ ン に 於 い て 不 具 合 に 繋 が っ て お り 、 2つ と も を 修 正 す る 必 要 が 生 じ ま す 。 そ の よ う な 重 複 の 例 は Debianの #1022216や GitHubの #442で す 。 こ れ は 全 く 同 じ 修 正 で す が 、 か つ は po4a で か つ は po4a-updatepo に あ り ま し た 。

長 い 目 で 見 た と き 、 個 別 の ス ク リ プ ト を 管 理 か ら 外 し 、 こ の 1つ の バ ー ジ ョ ン の み を 保 守 し た い と 考 え て い ま す 。 確 か な こ と は 個 別 の ス ク リ プ ト は 最 早 改 善 が 行 わ れ な い と い う こ と で 、 po4a だ け に 新 機 能 が 加 え ら れ ま す 。 つ ま り 、 取 り 急 ぎ の 非 推 奨 と い う も の は あ り ま せ ん 。 少 な く と も 2030年 ま で は で き る 限 り 個 別 の ス ク リ プ ト を 保 持 し て お く 計 画 で い ま す 。 も し プ ロ ジ ェ ク ト で ま だ po4a-updatepo と po4a-translate を 使 っ て い る の で あ れ ば 、 問 題 が 起 こ る か も し れ ま せ ん 。

コ ー ド の 改 修 に よ り コ ー ド の 重 複 が ゼ ロ に 低 減 さ れ れ ば 、 ど こ か の 時 点 で こ れ ら の ス ク リ プ ト の 非 推 奨 を 取 り 消 す 可 能 性 も あ り ま す 。 も し 思 い 付 い た こ と （ 欲 を 言 え ば パ ッ チ ） が あ れ ば ご 協 力 を 歓 迎 し ま す 。

gettext を 使 っ た ド キ ュ メ ン ト 翻 訳 ツ ー ル は 他 に 何 が あ り ま す か ?

い く つ か あ り ま す 。 以 下 は 恐 ら く 不 完 全 な 一 覧 で 、 も っ と 多 く の ツ ー ル が 現 れ て き て い ま す 。
poxml

KDE の 人 た ち が DocBook XML を 扱 う た め に 開 発 し た ツ ー ル で す 。 知 る 限 り で は 、 ド キ ュ メ ン ト か ら PO フ ァ イ ル へ 翻 訳 す る 文 字 列 を 抽 出 し 、 翻 訳 後 に 注 入 す る 初 め て の プ ロ グ ラ ム で す 。

こ れ は XML の み 、 さ ら に 特 定 の DTD の み を 扱 え ま す 。 リ ス ト が 一 つ の 大 き な msgid に な っ て し ま う た め 、 私 は リ ス ト の 扱 い に か な り 不 満 が あ り ま す 。 リ ス ト が 大 き く な る と 、 ひ と か た ま り の 構 造 を つ か み に く く な り ま す 。

po-debiandoc

Denis Barbier に よ っ て 作 ら れ た こ の プ ロ グ ラ ム は 、 多 少 の 異 論 が あ る と は い え po4a SGML モ ジ ュ ー ル の 先 駆 け と い え ま す 。 名 前 の 通 り 、 少 々 非 推 奨 の DTD で あ る DebianDoc DTD の み を 扱 い ま す 。

xml2po.py

2004年 か ら GIMPド キ ュ メ ン ト チ ー ム に 使 わ れ て い ま す 。 名 前 か ら 推 測 さ れ る よ う に XMLフ ァ イ ル の み 対 応 で あ り 、 特 有 の Makefileの 設 定 が 必 要 で す が 、 か な り 良 く 動 作 し ま す 。

Sphinx

Sphinx文 書 プ ロ ジ ェ ク ト も 翻 訳 を 管 理 す る た め に gettextを ふ ん だ ん に 使 っ て い ま す 。 翻 訳 過 程 の 全 体 を 管 理 す る 恐 ら く 唯 一 の ツ ー ル で は あ り ま す が 、 不 運 に も reSTや Markdownと い っ た い く つ か の テ キ ス ト 形 式 で の み 動 作 し ま す 。

以 上 に 対 す る po4a の 主 な 利 点 は 、 簡 単 に 内 容 を 追 加 で き る こ と (欠 点 か も し れ ま せ ん が ) と 、 gettext 化 が 簡 単 な こ と で す 。

gettext ベ ー ス ア プ ロ ー チ の 利 点 ま と め

	•		翻 訳 は オ リ ジ ナ ル と 一 緒 に 保 存 さ れ ま せ ん 。 そ の 翻 訳 が 古 く な っ た 場 合 、 検 出 す る こ と が 可 能 と な り ま す 。
	•		翻 訳 は 互 い に 別 々 の フ ァ イ ル に 格 納 さ れ 、 異 な る 言 語 の 翻 訳 者 が パ ッ チ の 提 供 や エ ン コ ー ド レ ベ ル の 干 渉 を 、 互 い に 受 け な い よ う に し ま す 。
	•		内 部 的 に は gettext を ベ ー ス に し て い ま す (が 、 po4a は 非 常 に シ ン プ ル な イ ン タ ー フ ェ ー ス を 提 供 す る の で 、 内 部 で 使 用 し て い る こ と を 理 解 す る 必 要 は あ り ま せ ん )。 そ ん な と こ ろ で 車 輪 の 再 発 明 を す る 必 要 は な く 、 こ れ は 広 く 用 い ら れ て い る の で 、 バ グ に 悩 ま さ れ る こ と は な い と 考 え て い い で し ょ う 。
	•		エ ン ド ユ ー ザ に と っ て は 何 も 変 化 あ り ま せ ん (願 わ く ば 翻 訳 が よ り よ く 保 守 さ れ る よ う に な る 、 と い う 事 実 は 置 い て お い て )。 出 来 上 が り の 配 布 さ れ る フ ァ イ ル は ま っ た く 同 じ で す 。
	•		翻 訳 者 は 、 新 し い フ ァ イ ル の 文 法 を 学 習 す る 必 要 は な く 、 好 み の PO フ ァ イ ル エ デ ィ タ (Emacs の PO mode や 、 Lokalize、 Gtranslator な ど ) で う ま く 動 作 し ま す 。
	•		gettext は 、 完 了 し て い る も の (t)、 レ ビ ュ ー や 更 新 が 必 要 な も の (f)、 そ し て ま だ 翻 訳 作 業 が 残 っ て い る も の (u) に つ い て 、 統 計 を 取 得 す る 簡 単 な 方 法 を 提 供 し て い ま す 。 以 下 の ア ド レ ス で い く つ か 例 を 見 つ け る こ と が で き ま す :

- https://docs.kde.org/stable5/en/kdesdk/lokalize/project-view.html
- http://www.debian.org/intl/l10n/

し か し 、 す べ て 問 題 な い わ け で は あ り ま せ ん 。 こ の ア プ ロ ー チ に は 対 処 す る べ き 欠 点 も あ り ま す 。

	•		補 遺 は 一 見 し て ど こ か 奇 妙 で す 。
	•		翻 訳 し た テ キ ス ト を 、 段 落 を こ こ で 分 割 す る 、 二 つ の 段 落 を 片 方 に 結 合 す る と い っ た 、 あ な た の 好 み に 合 わ せ る こ と が で き ま せ ん 。 し か し 、 オ リ ジ ナ ル に 問 題 が あ る の で あ れ ば 、 と り あ え ず バ グ と し て 報 告 す べ き だ 、 と い う 意 見 も あ り ま す 。
	•		簡 単 な イ ン タ ー フ ェ ー ス で す が 、 学 習 が 必 要 な 新 し い ツ ー ル の ま ま で す 。

私 の 夢 の 一 つ は Gtranslator や Lokalize に 何 ら か の 形 で 統 合 す る こ と で す 。 文 書 フ ァ イ ル を 開 く と 文 字 列 を 自 動 的 に 抽 出 し 、 翻 訳 さ れ た フ ァ イ ル と POフ ァ イ ル を デ ィ ス ク に 書 き 込 み ま す 。 MS Word (TM) モ ジ ュ ー ル (少 な く と も RTF) で こ れ が で き れ ば 、 プ ロ の 翻 訳 家 も こ れ を 使 っ て く れ る か も 知 れ ま せ ん 。

関 連 項 目

	•		全 て が 1つ に 集 ま っ て い る 使 う べ き ツ ー ル で あ る po4a (1)の ド キ ュ メ ン ト 。
	•		個 別 の po4aス ク リ プ ト の ド キ ュ メ ン ト は 次 の 通 り ： po4a-gettextize (1)、 po4a-updatepo (1)、 po4a-translate (1)、 po4a-normalize (1)。
	•		追 加 の 補 助 ス ク リ プ ト ： msguntypot (1)、 po4a-display-man (1)、 po4a-display-pod (1)。
	•		そ れ ぞ れ の フ ォ ー マ ッ ト の 構 文 解 析 器 は 次 の 通 り 。 詳 し く は そ れ ぞ れ の 解 析 器 で 受 け 付 け る オ プ シ ョ ン を 見 て く だ さ い ： Locale::Po4a::AsciiDoc (3pm) Locale::Po4a::Dia (3pm), Locale::Po4a::Guide (3pm), Locale::Po4a::Ini (3pm), Locale::Po4a::KernelHelp (3pm), Locale::Po4a::Man (3pm), Locale::Po4a::RubyDoc (3pm), Locale::Po4a::Texinfo (3pm), Locale::Po4a::Text (3pm), Locale::Po4a::Xhtml (3pm), Locale::Po4a::Yaml (3pm), Locale::Po4a::BibTeX (3pm), Locale::Po4a::Docbook (3pm), Locale::Po4a::Halibut (3pm), Locale::Po4a::LaTeX (3pm), Locale::Po4a::Pod (3pm), Locale::Po4a::Sgml (3pm), Locale::Po4a::TeX (3pm), Locale::Po4a::Wml (3pm), Locale::Po4a::Xml (3pm)。
	•		イ ン フ ラ の 中 核 の 実 装 は Locale::Po4a::TransTractor (3pm)（ 中 核 の 組 織 立 て を 理 解 す る の に と り わ け 重 要 ） 、 Locale::Po4a::Chooser (3pm)、 Locale::Po4a::Po (3pm)、 Locale::Po4a::Common (3pm)に あ り ま す 。 ソ ー ス ツ リ ー 中 の CONTRIBUTING.md フ ァ イ ル も ご 確 認 く だ さ い 。

著 者

Denis Barbier <barbier,linuxfr.org>
Martin Quinson (mquinson#debian.org)

訳 者

倉 澤 望 <nabetaro@debian.or.jp>
Debian JP Documentation ML <debian-doc@debian.or.jp>

POD ERRORS

Hey! The above document had some coding errors, which are explained below:
Around line 263:

Unterminated C< C< ... > > sequence

---