The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

名前

Pod::MultiLang_ja - 多言語対訳Pod

バージョン

Version 0.14

概要

  use Pod::MultiLang::Html;
  my $parser = Pod::MultiLang::Html->new(langs=>[qw(ja en)]);
  $parser->parse_from_file($infile,$outfile);

説明

pod の装飾符号として, pod 内に複数言語での対訳を記述するために J<> を拡張定義します. 訳文は J<> という整形符号で囲みます. 見出しによく使われる単語は自動で訳がつきます. これは公式な装飾符号ではなく独自に拡張しているものです.

L<|/> には,

 J<<< ja;
 L<< text | page /"heading J<ja; japanese heading >" >>
 >>>

という風に記述します. 見出し部分にはデフォルトの言語からリンクidが生成されるためです.

連続する直述段落は空行を挟んで1つに連結されます.

(with ja.utf8)

  =head1 NAME
  
  Example - Example document
  J<< ja;Example - サンプル >>

  =head1 SEE ALSO
  
  L<example/somewhere>
  J<<< ja;
  L<< example/somewhere J<ja;どこか> >>
  >>>
  
  =cut

sample output.

 en:NAME
 ja:名前
 en:  Example - Example document
 ja:  例 - サンプル
 en:SEE ALSO
 ja:関連項目
 en:  "somewhere" in example (linkto:example/somewhere)
 ja:  example 内 "どこか" (linkto:example/somewhere)

今後の予定

verbatim 段落の多言語化はまだ仕様化されていません.

ユーティリティメソッド.

makelinktext

 $label = $parser->makelinktext($lang,$text,$name,$sec);

$text が指定されていればそれを, なければ $name と $sec から $lang 用に 作って返す.

parseLang

 ($lang,$text) = $parser->parseLang($data);
 
  $parser->parseLang("ja; text"); ==> ('ja', 'text')

メソッド

new

create new instance.

OVERRIDES

This module implements Pod::Parser.

begin_pod
end_pod
command
textblock
verbatim

著者

山科 氷魚 (YAMASHINA Hio), <hio at cpan.org>

バグ

バグや要望は bug-pod-multilangt.cpan.org 宛に 報告してください. 若しくは http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Pod-MultiLang. にある web インターフェースからでもかまいません. そこから私に通知され, そして私が変更を行うことで報告頂いたバグの進捗を 自動的にあなたに伝えるでしょう.

サポート

このモジュールのドキュメントは perldoc コマンドで見ることが出来ます.

    perldoc Pod::MultiLang

また, 以下の場所でも見ることが出来ます:

関連項目

Pod::Parser, Pod::MultiLang::Html

著作権及びライセンス

Copyright 2006 YAMASHINA Hio, all rights reserved.

このプログラムはフリーソフトウェアです. あなたは Perl と同じライセンスの 元で再配布及び変更を行うことが出来ます. 原文: This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.