Scroll to navigation

LOCALE::PO4A::SIMPLEPOD.3PM(1) User Contributed Perl Documentation LOCALE::PO4A::SIMPLEPOD.3PM(1)

1;

__END__

名前

Locale::Po4a::SimplePod - PO ファイルと POD データの変換、ただしPod::Simpleを使って

書式

  [po4a_paths] potへのパス $lang:poへのパス
  [type:SimplePod] source.podへのパス $lang:localized.podへのパス

もしくは

  [po4a_paths] potへのパス $lang:poへのパス
  [po4a_alias:pod] SimplePod
  [type:pod] source.podへのパス $lang:localized.podへのパス

説明

これは、POD形式(Perlのコードを文書化するときに好まれる言語)の文書を他の自然言語へ翻訳することを補助するモジュールです。

現在のPod形式とSimplePodの形式の主な違いは以下の通りです。

  • SimplePod形式では、翻訳される伝文に余分な改行が含まれません。しかし、現在のPod形式には余剰の改行が含まれることがあります。特に書いた通りの(verbatimな)伝文の項目がそうです。
  • 段落は行が折り返されて呈示されることがあります。Pod::Parser モジュールでは行の折り返しで特別な扱いが適用されることがあり、 Pod::Simple ではそれを際限することが難しくなっています。しかし、 Pod::Simple の方がより自然な出力を生成できるようです。
  • SimplePodでは、 "=for" の伝文(例えば "=for comment テキスト" など)には形式名(例えば "comment" など)が含まれません。そのため、伝文はテキストのみからなります。一方、現在のPod形式では形式名が残るため、結果として伝文が "comment テキスト" のようになります。前者の挙動が翻訳者にとってより都合がよいと考えられます。
  • 以下のような項目のような、 "=end comment" が示されているものは、現在のPodモジュールには見られましたが、もう存在しなくなります。これらは翻訳できない伝文なので、なくなるのは1つの改善です。

      #. type: =end
      #: sample.pod:10
      msgid "comment"
      msgstr ""
        
  • POD形式としての妥当性が不確かなテキストブロックは "no-wrap" として扱われるようになりました。これは例えば、 "=begin html" ブロック内の内容です。Podモジュールでは、これらは "no-wrap" として扱われていませんでした。これにより、結果として行の折り返しが発生することがありました。
  • "=begin" の引数付きの節は翻訳の対象でなくなりました。現在のPodモジュールでは含まれています。翻訳に含めたい需要がありましたらご報告ください。

このモジュールの状態

このモジュールはまだ新しく開発されたばかりなので、 Locale::Po4a::Pod より安定性に欠けます。開発が進行中であり、まだまだ調整の余地があります。利用者の翻訳の体験を最適化するため、挙動が今後変わったり、オプションが追加されたりする可能性があります。実際の現場のアプリケーションからのフィードバックと用途のご報告は、このモジュールの今後の開発で鍵を握ります。

このコードはテストスートで完全に押さえられており、既存の不具合は何ら認識していません。しかし、2025年の段階で、既存のプロジェクトによる実際の現場の翻訳工程でバトルテストされたことがありません。つまり、このモジュールがより広く適用されていくにつれ、いくつかの不具合が発見されることは避けられないでしょうが、それでもなおこのモジュールは実運用の準備はできていると信じています。

このモジュールは現在の Locale::Po4a::Pod モジュールを置き換えることを意図しています。その理由は、現在の Locale::Po4a::Pod で使われている Pod::Parser は今や非推奨となっており、代わりに Pod::Simple を使うことが推奨されているためです。 GitHub issue #256 "Consider migrating away from deprecated "Pod::Parser"" <https://github.com/mquinson/po4a/issues/256> もご参照ください。

関連項目

Pod::Simple, Locale::Po4a::Pod, Locale::Po4a::TransTractor, po4a(7), Locale::Po4a::SimplePod::Parser.

著者

  gemmaro <gemmaro.dev@gmail.com>

訳者

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

著作権とライセンス

  Copyright (C) 2025 gemmaro <gemmaro.dev@gmail.com>.

本プログラムは自由ソフトウェアです。GPL v2.0以降の条項に基づき再頒布と変更を行えます(COPYINGファイルを参照)。

2025-09-14 perl v5.40.1