NAME / 名称

Lingua::EO::Orthography::JA - エスペラント文字の正字法と代用表記の変換器

バージョン

この文書はLingua::EO::Orthographyのバージョン0.04について記述しています。

翻訳

en: 英語: Lingua::EO::Orthography
eo: エスペラント: Lingua::EO::Orthography::EO
ja: 日本語: Lingua::EO::Orthography::JA (この文書)

概要

    use utf8;
    use Lingua::EO::Orthography;

    my ($converter, $original, $converted);

    # 正字法にする
    $converter = Lingua::EO::Orthography->new;
    $original  = q(C^i-momente, la songha h'orajxo ^sprucigas aplauwdon.);
    $converted = $converter->convert($original);

    # 代用表記する (X記法)
    $converter->sources([qw(orthography)]); # (複数の記法を受け容れる)
    $converter->target('postfix_x');
        # これは上記と同じです:
        # $converter = Lingua::EO::Orthography->new(
        #     sources => [qw(orthography)],
        #     target  => 'postfix_x',
        # );
    $original  = q(Ĉi-momente, la sonĝa ĥoraĵo ŝprucigas aplaŭdon);
    $converted = $converter->convert($original);

解説

エスペラントのアルファベットのうち字上符付きの6文字はASCIIに存在しません。歴史的に、つまり活版印刷やタイプライターの時代から、それらの文字はしばしば代用表記(eo: surogata skribosistemo)されて来ました。現在ではユニコード(en: Unicode, eo: Unikodo)の普及によって正字法(正書法, en: orthography, eo: ortografio)で表記することも珍しくありません。しかし、キーボードからの入力が難しい環境もまだ多いでしょうし、代用表記で記述された昔の文書を取り扱うこともあるでしょう。

このオブジェクト指向モジュールは、それらの記法を変換する機能を提供します。

警告

このモジュールはベータ版リリースの段階にあり、APIは将来的に変更され得ます。あなたのフィードバックを歓迎します。

記法の一覧

以下の記法名はnew()やadd_sources()などで使えます。

これら以外の記法を動的に追加出来るよう、将来的にAPIを拡張する予定です。

orthography

    Ĉ ĉ Ĝ ĝ Ĥ ĥ Ĵ ĵ Ŝ ŝ Ŭ ŭ

    (\x{108} \x{109} \x{11C} \x{11D} \x{124} \x{125}
     \x{134} \x{135} \x{15C} \x{15D} \x{16C} \x{16D})

エスペラントアルファベットの正字法(正書法)です。ユニコードに存在する字上符付き文字をそのまま取り扱います。文字コードはUTF-8です。

ユニコードは十分に普及しているので、特段の理由がない限りは、今日では正字法を使うことが適当でしょう。 Perl 5.8.1以降でもこれを正しく取り扱えます。

utf8プラグマを有効にした状態でlength()などを正しく働かせるためにも、あなたのプログラム内では一貫してUTF-8文字列を取り扱い、外部からの入力時や外部への出力時にのみ(必要に応じて)変換を掛けるという設計を推奨します。これはEncodeモジュールやPerl IOレイヤーの定石と同じです。

zamenhof

    Ch ch Gh gh Hh hh Jh jh Sh sh U  u

アルファベットにhを後置する代用表記法です。ただし、uは代用表記しません。

エスペラントの創始者であるザメンホフ博士が『エスペラントの基礎』(Fundamento de Esperanto)で提案した代用表記であり、ザメンホフ方式(en: Zamenhof system, eo: Zamenhofa sistemo)と呼ばれています。このため第二の正字法とも称されていますが、今日ではあまり使われていません。

この方式には、'flughaveno'(ja: '空港')などの単語で、語根('flug/haven/o')を跨ぐ文字の並びが代用表記されているように見えるという問題があります。このモジュールでも現時点ではこの問題を回避していません。

capital_zamenhof

    CH ch GH gh HH hh JH jh SH sh U  u

大文字のアルファベットには大文字でHを後置するzamenhof方式です。

postfix_h

    Ch ch Gh gh Hh hh Jh jh Sh sh Uw uw

zamenhof方式を拡張したもので、uにはwを後置させるものです。

H方式(en: H-system, eo: H-sistemo)と呼ばれています。

postfix_capital_h

    CH ch GH gh HH hh JH jh SH sh UW uw

大文字のアルファベットには大文字でHやWを後置するpostfix_h方式です。

postfix_x

    Cx cx Gx gx Hx hx Jx jx Sx sx Ux ux

アルファベットにxを後置する代用表記法です。

X方式(en: X-system, eo: X-sistemo, iksa sistemo)と呼ばれています。

xがエスペラントのアルファベットに存在せず、エスペラント以外の単語を原語表記する場合を除いて使われる機会がないことから、代用表記の一つとして広く使われています。

postfix_capital_x

    CX cx GX gx HX hx JX jx SX sx UX ux

大文字のアルファベットには大文字でXを後置するpostfix_x方式です。

postfix_caret

    C^ c^ G^ g^ H^ h^ J^ j^ S^ s^ U^ u^

アルファベットにキャレット^を後置する代用表記法です。

キャレット方式(caret system, ĉapelita sistemo)と呼ばれています。

キャレット(en: caret)がサーカムフレックス(en: circumflex)と同じ形であることから、代用表記の一つとして使われることがあります。

このモジュールではu^をu~として表記する方法には現時点では対応していません。

postfix_apostrophe

    C' c' G' g' H' h' J' j' S' s' U' u'

アルファベットにアポストロフィー'を後置する代用表記法です。

prefix_caret

    ^C ^c ^G ^g ^H ^h ^J ^j ^S ^s ^U ^u

アルファベットにキャレット^を前置する代用表記法です。

Lingua::EO::Supersignojとの比較

このモジュールと同等の機能を提供するモジュールとして、Lingua::EO::SupersignojがCPANにあります。以下の表でそれらを比較します:

 観点                       ::Supersignoj   ::Orthography               備考
 -------------------------- --------------- --------------------------- ----
 バージョン                 0.02            0.04
 @linesを変換出来る         はい            いいえ                      *1
 アクセッサーがある         はい            はい(有用なメソッド付き)    *2
 記法をカスタマイズ出来る   'u'のみ可能     いいえ(検討中)              *3
 'flughaveno'を取り扱える   いいえ          いいえ(検討中)              *4
 APIの言語                  eo:エスペラント en:英語
 多対1の変換が出来る        いいえ          はい                        *5
 速度                       満足な速さ      約4倍速い                   *6
 直接の依存                 1 (コアは0)     6 (コアは2)                 *7
 全体の依存                 1 (コアは0)     15 (コアは8)                *7
 テストケース数             3               93                          *8
 使用許諾条件(ライセンス)   不明            Perl(ArtisticかGNU GPL)
 最終更新                   2003年3月       2010年3月

Lingua::EO::Orthographyで@linesを変換するには:

    @converted_lines = map { $converter->convert($_) } @original_lines;

Lingua::EO::Orthographyにはall_sources(), add_sources(), remove_sources()のユーティリティーメソッドがあります。

開発者はこの機能のAPIを以下のように設計しようと予定しています:

    $converter = Lingua::EO::Orthography->new(
        notations => {
            postfix_asterisk => [qw(C* c* G* g* H* h* J* j* S* s* U* u*)],
        },
    );

    $notations_ref = $converter->notations;

    @notations = $converter->all_notations;

    @notations = $converter->notations({
        postfix_underscore => [qw(C_ c_ G_ g_ H_ h_ J_ j_ S_ s_ U_ u_)],
    });

    $converter->add_notations(
        postfix_diacritics => [qw(C^ c^ G^ g^ H^ h^ J^ j^ S^ s^ U~ u~)],
    );

開発者はこの機能のAPIを以下のように設計しようと予定しています:

    $converter = Lingua::EO::Orthography->new(
        ignore_words => [qw(
            bushaltejo flughaveno Kinghaio ...
        )],
    );

    $ignore_words_ref = $converter->ignore_words;

    @ignore_words = $converter->all_ignore_words;

    @ignore_words = $converter->ignore_words([qw(kuracherbo)]);

    $converter->add_ignore_words([qw(
        kuracherbo longhara navighalto ...
    )]);

あなたが複数の記法を受け容れられるように実際のアプリケーションを設計するであろうことを、開発者は自らの経験によって想定しています。

このディストリビューションに実例を同梱しています。 Lingua::EO::Orthographyの場合はexamples/converter.plのように一回のconvert()で正字法に変換出来ます。これに相当するLingua::EO::Supersignojの処理はexamples/correspondent.plであり、変換元の記法を差し替えながら変換する必要があります。
Lingua::EO::OrthographyはLingua::EO::Supersignojより約4倍速く文字列を変換出来ます。

これは文字列置換に使う正規表現パターンと文字変換テーブルをMemoizeモジュールによりキャッシュしているためです。さらに、Lingua::EO::Orthographyは複数の記法が混じった文字列を一度に変換することが出来ます。

examples/benchmark.plとしてこのディストリビューションにベンチマークスクリプトを同梱しています。
依存モジュールの情報源はhttp://deps.cpantesters.org/です。

上記の数はビルド用およびテスト用のモジュールを除いたものです。

Lingua::EO::Orthographyのどの依存モジュールも一定の評価を得ています。開発者もそれらの推薦にとても同意しています。

しかし、開発者は依存モジュールを減らすことを検討しています。既にnamespace::clean, namespace::autocleanなどへの依存は断念しています。
上記の数は開発者テスト(en: author's test)を除いたものです。

メソッド

コンストラクター

`new`

    $converter = Lingua::EO::Orthography->new(%init_arg);

コンバーターであるLingua::EO::Orthographyオブジェクトを返します。

変換対称軸としてハッシュを受け容れます。ハッシュのキーにはsourcesとtargetのいずれか、ないしは両方を指定出来ます。

sources => \@source_notations

変換元の記法群を配列リファレンスまたは:allで指定します。

:allはzamenhof, capital_zamenhof, postfix_h, postfix_capital_h, postfix_x, postfix_capital_x, postfix_caret, postfix_apostrophe, prefix_caret全ての指定と等価です。

省略時には:allを指定したものとみなします。

:allまたは配列リファレンス以外の値を指定した場合や、配列要素数が0である場合や、配列要素に未知の記法やundefが含まれる場合には、例外を送出します。

target => $target_notation

変換先の記法を文字列で指定します。

省略時にはorthographyを指定したものとみなします。

未知の記法や、undefを指定した場合には、例外を送出します。

アクセッサー

`sources`

    $source_notations_ref = $converter->sources;

変換元の記法群を配列リファレンスで返します。リストで得たい場合、all_sources()を使ってください。

    $source_notations_ref = $converter->sources(\@notations);

変換元の記法群を配列リファレンスで与えます。使用出来る記法はコンストラクターnew()と同じです。

戻り値は引数を与えない場合と同じです。

`target`

    $target_notation = $converter->target;

変換先の記法を文字列で返します。

    $target_notation = $converter->target($notation);

変換先の記法を文字列で与えます。使用出来る記法はコンストラクターnew()と同じです。

戻り値は引数を与えない場合と同じです。

コンバーター

`convert`

    $converted_string = $converter->convert($original_string);

与えた文字列を変換し、変換後の文字列を返します。引数は汚しません(つまり、副作用として引数の文字列が変更されることはありません)。文字列の変換はコンストラクターnew()やアクセッサーsources(), target()で指定した記法に基づいて実行されます。

文字列の大文字・小文字は区別されます。つまり、'postfix_x'記法であってもcXは代用表記と見なさず、変換しません。

引数の文字列はUTF8フラグがオンになっている必要があります。戻り値の文字列もUTF8フラグがオンになります。

URLやメールアドレスなどには、代用表記と見分けの付かない文字列が含まれることがあります。それらが変換されないようにしたい場合には、文を一旦単語列にsplit()した上で、それぞれの単語についてconvert()を実行してください。これにより、://や@という文字列を含む単語を変換対象から外すことが出来ます。URIはRFC 2396, 3986を、メールアドレスはRFC 5321, 5322を、それぞれ参照してください。また、このディストリビューションに同梱されているexamples/ignore_addresses.plに具体例を記述しています。

ユーティリティー

`all_sources`

    @all_source_notations = $converter->all_sources;

変換元の記法群をリストで返します。配列リファレンスで得たい場合、sources()を使ってください。

`add_sources`

    $source_notations_ref = $converter->add_sources(@adding_notations);

変換元の記法群をリストで指定して加えます。使用出来る記法はコンストラクターnew()と同じです。

追加後の記法群を配列リファレンスで返します。

`remove_sources`

    $source_notations_ref = $converter->remove_sources(@removing_notations);

変換元の記法群をリストで指定して除きます。使用出来る記法はコンストラクターnew()と同じです。

削除後の記法群を配列リファレンスで返します。

削除後の記法は最低でも1つ存在していなければなりません。全ての記法が削除された場合、例外を送出します。

非互換性

互換性のない変更点はありません。

バグと制約事項

バグは報告されていません。

提案やバグ報告の方法

何かバグを発見されたら、機能のご要望がありましたら、または改善のためのご意見がありましたら、メール(<bug-lingua-eo-orthography at rt dot cpan dot org>宛)で報告してください。または、Webインターフェース(http://rt.cpan.org/Public/Bug/Report.html?Queue=Lingua-EO-Orthography)を使って報告してください。これによって、その報告内容が開発者へ通知されます。さらに、バグや要望の対応状況について、報告者が通知を自動的に受けることも出来ます。

バグを報告いただく際には、もし可能であれば、バグを再現するための出来るだけ少量のサンプルコードを添えてください。提案やパッチは勿論歓迎します。

サポート

このモジュールの文書はperldocコマンドで閲覧出来ます。

    % perldoc Lingua::EO::Orthography

エスペラント版の文書もあります。

    % perldoc Lingua::EO::Orthography::EO

日本語版はPod::PerldocJpを使ったperldocjpコマンドで閲覧出来ます。

    % perldocjp Lingua::EO::Orthography::JA

また、以下の場所も参照してください:

RT: CPAN's request tracker: http://rt.cpan.org/Public/Dist/Display.html?Name=Lingua-EO-Orthography
AnnoCPAN: Annotated CPAN documentation: http://annocpan.org/dist/Lingua-EO-Orthography
Search CPAN: http://search.cpan.org/dist/Lingua-EO-Orthography
CPAN Ratings: http://cpanratings.perl.org/dist/Lingua-EO-Orthography

バージョン管理

このモジュールはgitを使って保守されています。

最新版はgit://github.com/gardejo/p5-lingua-eo-orthography.gitにあります。

コード網羅率

テストのコード網羅率(コードカバレッジ)を検査するために、Devel::Coverを使っています。このディストリビューションのテストスートに関するDevel::Coverによる調査結果の概要を以下に示します。

 ---------------------------- ------ ------ ------ ------ ------ ------ ------
 File                           stmt   bran   cond    sub    pod   time  total
 ---------------------------- ------ ------ ------ ------ ------ ------ ------
 .../Lingua/EO/Orthography.pm  100.0  100.0  100.0  100.0  100.0  100.0  100.0
 Total                         100.0  100.0  100.0  100.0  100.0  100.0  100.0
 ---------------------------- ------ ------ ------ ------ ------ ------ ------

今後の予定

テストの拡充
依存モジュールの削減
ユーザー記法を追加するAPIの提供
ユーザー辞書によってflug/haven/oなどの単語を'postfix_h'記法で正確に取り扱うこと
ユーザー辞書によってankaŭなどの単語を'zamenhof'記法で正確に取り扱うこと
MooseやMouseに親和するクラスのリリース(Lingua::EO::Orthography::Moosifiedなど)

著者

守屋雅樹 (Gardejo) (en: MORIYA Masaki, alias Gardejo): <moriya at cpan dot org>, http://gardejo.org/

訳註: 訳者

守屋雅樹 (Gardejo) (en: MORIYA Masaki, alias Gardejo): <moriya at cpan dot org>, http://gardejo.org/

謝辞

Juerd Waalboerはこのモジュールが参考にしているLingua::EO::Supersignojを著しました。

著作権と使用許諾条件

このモジュールはフリーソフトウェアです。あなたはこれをPerlと同じように自由に再配布・改変することが出来ます。詳しくはperlgplおよびperlartisticを参照してください。

使用許諾条件の全文はこのディストリビューションに同梱されているLICENSEファイルにあります。

訳註: 著作権と使用許諾条件の原文

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlgpl and perlartistic.

The full text of the license can be found in the LICENSE file included with this distribution.

To install Lingua::EO::Orthography, copy and paste the appropriate command in to your terminal.

cpanm

cpanm Lingua::EO::Orthography

CPAN shell

perl -MCPAN -e shell
install Lingua::EO::Orthography

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)