Changeset 13140 for docs

Timestamp:

06/03/08 22:47:53 (5 years ago)

Author:

tokuhirom

Message:

more translation

Files:

• docs/cat-ja/Catalyst/Manual/ExtendingCatalyst.pod (modified) (23 diffs)

docs/cat-ja/Catalyst/Manual/ExtendingCatalyst.pod

@@ -1 @@
-=head1 NAME
+=head1 名前(NAME)
 
 Catalyst::Manual::ExtendingCatalyst - フレームワークを拡張する
 
-=head1 DESCRIPTION
+=head1 概要(DESCRIPTION)
 
 This document will provide you with access points, techniques and best
@@ -41 +41 @@
 IRC などで話しかけてください。
 
-=head1 BEST PRACTICES
+=head1 ベストプラクティス(BEST PRACTICES)
 
 During Catalyst's early days, it was common to write plugins to
@@ -56 +56 @@
 forward to L</Namespaces>.
 
-=head2 Quick Checklist
+もし君がめっちゃいそいでいるのなら、以下に必須のポイントに関するクイックチェック
+リストを容易したからそれだけでもよんでいきたまえ。もし君がまったりとこの文書を全
+部読むつもりなら L</Namespaces> に進む。
+
+=head2 3分間チェックリスト(Quick Checklist)
 
 =over
 
-=item Use the C<CatalystX::*> namespace if you can!
-
-C<CatalystX::*> というネームスペースをつかいましょう
+=item C<CatalystX::*> というネームスペースをつかいましょう(Use the C<CatalystX::*> namespace if you can!)
 
 If your extension isn't a Model, View, Controller, Plugin, or Engine,
@@ -72 +74 @@
 C<CatalystX::> をかわりにつかってください。
 
-=item Don't make it a plugin unless you have to!
+=item プラグインはつくらない(どうしてもつくらなきゃいけない場合をのぞいて)!(Don't make it a plugin unless you have to!)
 
 A plugin should be careful since it's overriding Catalyst internals.
@@ -81 +83 @@
 が、内部を上書きしたいんでなければ、Controller か Model にしてね!
 
-=item There's a community. Use it!
-
-コミュあるから利用しちゃおう!
+=item コミュニティがあるから利用しちゃおう!(There's a community. Use it!)
 
 There are many experienced developers in the Catalyst community,
@@ -90 +90 @@
 Catalyst には IRC も ML もあるから、どんどん利用しちゃおう!
 
-=item Add tests and documentation!
-
-テストとドキュメンテーションはしっかりね!
+=item テストとドキュメンテーションはしっかりね!(Add tests and documentation!)
 
 This gives a stable basis for contribution, and even more importantly,
@@ -102 +100 @@
 =back
 
-=head2 Namespaces
-
-ネームスペース
+=head2 ネームスペース(Namespaces)
 
 While some core extensions (engines, plugins, etc.) have to be placed
@@ -112 +108 @@
 コアの拡張(engine や plugin とか)は、C<Catalyst::*> におくべきだけど、そういうの
 つくるときは開発者に相談してからにしよう。できることなら C<CatalystX::*> におこう。
+
+(訳注: CPAN にアップロードする場合、相談してからやらないと mst に痛烈に DIS られます)
 
 When you try to put a base class for a C<Model>, C<View> or
@@ -121 +119 @@
 as examples.
 
-=head2 Can it be a simple module?
-
-それをシンプルなモジュールにすることはできませんか?
+=head2 それをシンプルなモジュールにすることはできませんか?(Can it be a simple module?)
 
 Sometimes you want to use functionality in your application that
@@ -270 +266 @@
 L<Catalyst::Component/"ACCEPT_CONTEXT($c, @args)">.
 
-=head1 CONFIGURATION
-
-設定
+=head1 設定(CONFIGURATION)
 
 The application has to interact with the extension with some
 configuration. There is of course again more than one way to do it.
 
-=head2 Attributes
-
-アトリビュート
+=head2 アトリビュート(Attributes)
 
 You can specify any valid Perl attribute on Catalyst actions you like.
@@ -301 +293 @@
 class|/"Component Base Classes">.
 
-=head2 Creating custom accessors
-
-カスタムアクセサをつくる
+=head2 カスタムアクセサをつくる(Creating custom accessors)
 
 L<Catalyst::Component> uses L<Class::Accessor::Fast> for accessor
@@ -312 +302 @@
 います。
 
-=head2 Component configuration
-
-コンポーネントの設定
+=head2 コンポーネントの設定(Component configuration)
 
 At creation time, the class configuration of your component (the one
@@ -339 +327 @@
   my $model_name = $controller->model_name;
 
-=head1 IMPLEMENTATION
-
-実装
+=head1 実装(IMPLEMENTATION)
 
 This part contains the technical details of various implementation
@@ -347 +333 @@
 implementation, if you haven't already.
 
-=head2 Action classes
+=head2 Actionクラス(Action classes)
 
 Usually, your action objects are of the class L<Catalyst::Action>.
@@ -415 +401 @@
 L<Catalyst::Action> and L<Catalyst::Manual::Actions>.
 
-=head2 Component base classes
+=head2 コンポーネントなクラス(Component base classes)
 
 Many L<Catalyst::Plugin> that were written in Catalyst's early days
@@ -421 +407 @@
 class, you could provide functionality scoped to a single controller,
 not polluting the global namespace in the context object.
+
+Catalyst がうまれたての頃に多くの L<Catalyst::Plugin> が書かれました。
 
 You can provide regular Perl methods in a base class as well as
@@ -432 +420 @@
 already provided via the C<+> prefix for action classes. A simple
 
+シンプルな
+
   sub foo : Local ActionClass('+MyApp::Action::Bar') { ... }
 
 will use C<MyApp::Action::Bar> as action class.
+
+は、C<MyApp::Action::Bar> を Action クラスとしてつかいます。
 
   package MyApp::Base::Controller::FullClass; use strict; use base
@@ -457 +449 @@
   1;
 
-=head2 Controllers
+=head2 コントローラ(Controllers)
 
 Many things can happen in controllers, and it often improves
@@ -546 +538 @@
 =back
 
-=head2 Models and Views
+=head2 モデルとビュー(Models and Views)
 
 If the functionality you'd like to add is really a data-set that you
@@ -586 +578 @@
   1;
 
-=head2 Plugins
-
-プラギン
+=head2 プラグイン(Plugins)
 
 The first thing to say about plugins is that if you're not sure if
@@ -641 +631 @@
 implementation (excuse the lame class name, it's just an example):
 
+プラグインの実装は簡単なようにみえます。あなたのプラグインは Catalyst の継承ツリー
+の上にはいります。これによりあなたは、Catalyst のリクエストライフサイクルの挙動を
+変えることができます。あなたが定義したりあなたのパッケージに import したメソッド
+は、すべてアプリケーションとコンテキストオブジェクトにはえます。例としてあなたが
+Catalyst に uri_for の返り値が undef だったとき警告をだすプラグインをつくったとし
+ましょう。(中略)(アホみたいなクラス名ですいません。これは例なので勘弁してね)
+
   package Catalyst::Plugin::UriforUndefWarning;
   use strict;
@@ -658 +655 @@
 value.
 
-=head2 Factory components with COMPONENT()
-
-COMPONENT() をつかってコンポーネントを生成する
+これは Catalyst の C<uri_for> メソッドをうわがきし、undef がかえってきたら警告を
+ログに吐きだします。
+
+=head2 COMPONENT() をつかってコンポーネントを生成する(Factory components with COMPONENT())
 
 Every component inheriting from L<Catalyst::Component> contains a
@@ -720 +718 @@
 
 =cut
-