名前
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が生成されるためです.
連続する直述段落は空行を挟んで１つに連結されます.
例
(with ja.utf8)
=head1 NAME
Example - Example document
J<< ja;Example - サンプル >>
=head1 SEE ALSO
L<example/somewhere>
J<<< ja;
L<< example/somewhere J<ja;どこか> >>
>>>
=cutsample 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また, 以下の場所でも見ることが出来ます:
AnnoCPAN: Annotated CPAN documentation
CPAN Ratings
RT: CPAN's request tracker
Search CPAN
関連項目
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.