NAME

Pod::MultiLang - multi languages in Pod ja;Pod::MultiLang_ja - 多言語対訳Pod

VERSION

Version 0.14

SYNOPSIS

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

DESCRIPTION

Pod::MultiLang is a pod extension. This module implements J<> interior sequence for write multi languages in single pod. One languages enclosed by J interior sequence in each paragraph. Some heading words are translated automatically. Note that J<> is not official interior sequence, this is custom one. ja; pod の装飾符号として, pod 内に複数言語での対訳を記述するために J<> を拡張定義します. 訳文は J<> という整形符号で囲みます. 見出しによく使われる単語は自動で訳がつきます. これは公式な装飾符号ではなく独自に拡張しているものです.

New format for L<|/> interior sequence is: ja; L<|/> には,

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

At section part, English heading is still required. Because in many hypertext formats, link identifier is restricted into ASCII. ja; という風に記述します. 見出し部分にはデフォルトの言語からリンクidが生成されるためです.

Verbatim paragraphs will be joined with one blank line. ja; 連続する直述段落は空行を挟んで１つに連結されます.

EXAMPLE

(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)

TODO

Multi lingual verbatim paragraph is not supported. ja; verbatim 段落の多言語化はまだ仕様化されていません.

UTILITY METHODS ja; ユーティリティメソッド.

makelinktext

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

if $text is specified, returns $text. if not, returns by $name and $sec with $lang. ja; $text が指定されていればそれを, なければ $name と $sec から $lang 用に 作って返す.

parseLang

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

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

METHODS

new

create new instance.

OVERRIDES

This module implements Pod::Parser.

begin_pod

end_pod

command

textblock

verbatim

AUTHOR

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

BUGS

Please report any bugs or feature requests to bug-pod-multilang at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Pod-MultiLang. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. ja; バグや要望は bug-pod-multilangt.cpan.org 宛に 報告してください. 若しくは http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Pod-MultiLang. にある web インターフェースからでもかまいません. そこから私に通知され, そして私が変更を行うことで報告頂いたバグの進捗を 自動的にあなたに伝えるでしょう.

SUPPORT

You can find documentation for this module with the perldoc command. ja; このモジュールのドキュメントは perldoc コマンドで見ることが出来ます.

perldoc Pod::MultiLang

You can also look for information at: ja; また, 以下の場所でも見ることが出来ます:

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Pod-MultiLang

• CPAN Ratings

  http://cpanratings.perl.org/d/Pod-MultiLang

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Pod-MultiLang

• Search CPAN

  http://search.cpan.org/dist/Pod-MultiLang

SEE ALSO

Pod::Parser, Pod::MultiLang::Html ja; Pod::Parser, Pod::MultiLang::Html

COPYRIGHT & LICENSE ja; 著作権及びライセンス

Copyright 2006 YAMASHINA Hio, all rights reserved.

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

cpanm Pod::MultiLang

perl -MCPAN -e shell
install Pod::MultiLang