From ed02f2fbc9680d5fba0a2b10f9c64aad5d1ecb47 Mon Sep 17 00:00:00 2001 From: ueyama <> Date: Sun, 3 Jun 2007 16:54:35 +0000 Subject: Tranlates for Japanese by Shinya.K --- .../pages/GettingStarted/ja/AboutPrado.page | 98 +++++++++++++++++++ .../pages/GettingStarted/ja/CommandLine.page | 106 +++++++++++++++++++++ .../pages/GettingStarted/ja/HelloWorld.page | 89 +++++++++++++++++ .../pages/GettingStarted/ja/Installation.page | 33 +++++++ .../pages/GettingStarted/ja/Introduction.page | 64 +++++++++++++ .../pages/GettingStarted/ja/NewFeatures.page | 36 +++++++ .../pages/GettingStarted/ja/Upgrading.page | 64 +++++++++++++ .../pages/GettingStarted/ja/directory.gif | Bin 0 -> 2685 bytes .../protected/pages/GettingStarted/ja/sequence.gif | Bin 0 -> 5793 bytes 9 files changed, 490 insertions(+) create mode 100644 demos/quickstart/protected/pages/GettingStarted/ja/AboutPrado.page create mode 100644 demos/quickstart/protected/pages/GettingStarted/ja/CommandLine.page create mode 100644 demos/quickstart/protected/pages/GettingStarted/ja/HelloWorld.page create mode 100644 demos/quickstart/protected/pages/GettingStarted/ja/Installation.page create mode 100644 demos/quickstart/protected/pages/GettingStarted/ja/Introduction.page create mode 100644 demos/quickstart/protected/pages/GettingStarted/ja/NewFeatures.page create mode 100644 demos/quickstart/protected/pages/GettingStarted/ja/Upgrading.page create mode 100644 demos/quickstart/protected/pages/GettingStarted/ja/directory.gif create mode 100644 demos/quickstart/protected/pages/GettingStarted/ja/sequence.gif (limited to 'demos/quickstart/protected/pages/GettingStarted') diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/AboutPrado.page b/demos/quickstart/protected/pages/GettingStarted/ja/AboutPrado.page new file mode 100644 index 00000000..74ca125d --- /dev/null +++ b/demos/quickstart/protected/pages/GettingStarted/ja/AboutPrado.page @@ -0,0 +1,98 @@ + +

PRADO とは?

+

+PRADO はコンポーネントベースかつイベントドリブンなウェブアプリケーションを開発するためのPHP5フレームワークです。
+「PRADO」の名称は、PHP Rapid Application Development Object-oriented の略です。 +

+

+PRADO の第一の目標は、ウェブプログラミングにおいてコードの再利用を可能にすることです。
+自分自身で開発したコードを再利用するだけではなく、簡単な方法で他人の開発したコードを再利用することを目的としています。
+これは、開発工数を劇的に減らす事ができ、とても重要な項目といえます。
+この目的を実現するためにコンポーネントベースの概念を導入しています。 +

+

+上記の目的を達するために、PRADO ではコンポーネントを作成し、コンポーネントにアプリケーションの動作を定義する方法を採用しています。
+コンポーネントは、継承可能なものになっているので、簡単なコードの書き換えで再利用することが可能となっており、既存コンポーネントを利用して、簡単に新しいコンポーネントを作成する事ができます。 +

+

+コンポーネントをインタラクティブに利用できるように、PRADO ではイベントドリブンプログラミングの枠組みを含んでいます。
+ボタンの押下などのユーザーアクションをメソッドに対応付けておく事で、サーバー側のイベントとして自動的に取得する事ができます。
+POST/GET 変数を取得して処理をする従来のウェブプログラミングと比べて、イベントドリブン型プログラミングは開発者が必要な処理に集中でき、POST/GET の取得などの反復コードも激減する事になります。 +

+

+PRADO でのアプリケーション開発は、ページにコンポーネントを配置し、プロパティの設定やイベントに反応するメソッドをコーディングすることが主な作業となります。
+これはデスクトップ GUI アプリケーションを開発するのに使用する Borland Delphi や Microsoft Visual Basic などの RAD ツールと非常に似た作りとなっています。 +

+ +

なぜ PRADO を使うのですか?

+

+PRADO はユニークなフレームワークとして紹介されています。
+事実、退屈な PHP プログラミングを楽しいものと変えることができるくらいユニークなフレームワークです。
+以下のリストは、PRADO に関する主な機能となっています。 +

+ + +

PRADO での開発はどの場面が適していますか?

+

+PRADO はインタラクティブなウェブアプリケーションを開発するのにとても適しています。
+コンテンツ管理システム(CMS)や、Eコマースなどの複雑なシステムを比較的容易に開発する事ができます。
+PRADO はコンポーネントベースのオブジェクト指向プログラミングですので、企業等でのチーム開発で力を発揮します。 +

+

+PRADO はアプリケーションの高速化とスケーラビリティを実現するためのキャッシュ機構を実装しています。
+利用する環境によりキャッシュモジュールを選択し、PRADO アプリケーションで利用する事ができます。
+出力キャッシュは、レンダリングされたウェブページの一部をキャッシュとして保存しておき、再度レンダリングする際に自動的にキャッシュから取得する機構になっています。 +

+ +

PRADO は他のフレームワークと比較してどのような点が異なっていますか?

+

+PRADO はよくユニークなフレームワークと呼ばれています。
+コンポーネントベースとイベントドリブンな実装が特にユニークであるとされています。
+このプログラミング方法はデスクトップアプリケーション開発においては新しくはなく、いくつかのウェブプログラミング言語でも実装されていますが、PHP のフレームワークとしてはおそらく初めて実装されたフレームワークです。
+

+

+ほとんどの PHP フレームワークでは、画面表示部分とロジック部分を切り離して、MVCデザインパターンをすすめています。
+PRADO では、テンプレートの中に画面表示部分とロジック部分を埋め込んだ事により、自然にMVCと同じ目標を達成する事ができています。
+そして、MVCでは実現できなかったコンポーネントベースのプログラミングスタイル、豊富なウェブコントロール、強力なデータベースサポート、柔軟なエラー処理とロギング機能などの色々な機能を実装することができています。 +

+ +

PRADO は安定していますか?

+

+はい。PRADO は2004年8月に初めてリリースされました。
+品質を確保するために多くのテストプログラムが作成されており、何千人もの開発者が利用しています。
+このテストプログラムによるテストを重ねて、フレームワークは開発されており、バグや機能追加などは TRAC システムにより管理されています。
+そして、すべての開発者の疑問にスピーディーに回答できるようにコミュニティも用意してあります。 +

+ +

PRADO の歴史

+

+PRADO のユニークな発想は Apache Tapestry から生まれました。
+設計と実装には、Borland Delphi と Microsoft ASP.NET から多くのアイディアを借りました。
+PRADO の最初のバージョンは、2004年6月にできて、PHP4で書かれていましたが、Zend PHP5コンテストに応募するためにPHP5のコードに書き直しました。(PHP5から提供されたオブジェクトモデルはとても助けになりました)
+そして PRADO は Zend コンテストで観客・審査員の高い評価を得て特賞を勝ち取りました。
+

+

+2004年8月にオープンソースプロジェクトとして SourceForge にて提供され始め、そのすぐ後にプロジェクトサイト「xisc.com」が公開されました。
+PRADO 開発チームと PRADO ユーザーのサポートにより、PRADO は2005年中頃にバージョン2.0へとバージョンアップしました。
+このバージョンでは Wei Zhuo が I18N/L10N サポートの実装で貢献をしました。 +

+

+2005年5月に、バージョン2.0で見つかった問題点を解決し、さらに Microsoft ASP.NET2.0 で利用可能ないくつかの機能を実装するために PRADO フレームワークを完全に書き直す決定をしました。
+1年近い期間をかけて、新たに50,000行を超える新しいコードを追加し、2006年4月にバージョン3.0をリリースしました。 +

+

+バージョン3.0では、PRADO の品質と安定性を確実にするために多くの時間を当てています。 +そして私たちは、PRADO 2.x/1.x にてコンセプトの試験を重ね、PRADO 3.x を重要なビジネスアプリケーションの開発のフレームワークまで成長させたと確信しています。 +

+
$Id: AboutPrado.page * 2007-06-06 21:53:00Z Shinya.K $
\ No newline at end of file diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/CommandLine.page b/demos/quickstart/protected/pages/GettingStarted/ja/CommandLine.page new file mode 100644 index 00000000..ac15bfbb --- /dev/null +++ b/demos/quickstart/protected/pages/GettingStarted/ja/CommandLine.page @@ -0,0 +1,106 @@ + +

Command Line Tool

+

The optional prado-cli.php PHP script file in the framework +directory provides command line tools to perform various tedious takes in Prado. +The prado-cli.php can be used to create Prado project skeletons, create +initial test fixtures, and access to an interactive PHP shell. +

+

Requirements

+

+To use the command line tool, you need to use your command prompt, command console +or terminal. In addition, PHP must be able to execute PHP scripts from +the command line. +

+ +

Usage

+

+If you type php path/to/framework/prado-cli.php, you should see +the following information. Alternatively, if you are not on Windows, +you may try to change the prado-cli.php into an executable +and execute it as a script

+ +Command line tools for Prado 3.0.5. +usage: php prado-cli.php action [optional] +example: php prado-cli.php -c mysite + +actions: + -c + Creates a Prado project skeleton for the given . + + -t + Create test fixtures in the given . + + shell [directory] + Runs a PHP interactive interpreter. Initializes the Prado + application in the given [directory]. + + +

The <parameter> are required parameters and [optional] +are optional parameters.

+ +

Creating a new Prado project skeleton

+ +

To create a Prado project skeleton, do the following:

+
    +
  1. Change to the directory where you want to create the project skeleton.
  2. +
  3. Type, php ../prado/framework/prado-cli.php -c helloworld, where + helloworld is the directory name that you want to create the project skeleton files.
  4. +
  5. Type, php ../prado/framework/prado-cli.php -t helloworld to create + the test fixtures for the helloworld project.
  6. +
+ +

Interactive Shell

+

+The interactive shell allows you to evaluate PHP statements from the command line. +The prado-cli.php script can be used to start the shell and load an existing +Prado project. For example, let us load the blog demo project. Assume that your +command line is in the prado distribution directory and you type. +

+

+ +$: php framework/prado-cli.php shell demos/blog + +The output should be + +Command line tools for Prado 3.0.5. +** Loaded Prado application in directory "demos\blog\protected". +PHP-Shell - Version 0.3.1 +(c) 2006, Jan Kneschke + +>> use '?' to open the inline help + +>> + +Then we will get an instance of the Prado blog application, and from +that instance we want an instance of the 'data' module. Notice that +a semicolon at the end of the line suppresses the output. + + +>> $app = Prado::getApplication(); + +>> $db = $app->getModule('data'); + +Lastly, we want to use the data module to query for a post with ID=1. Notice that +we leave out the semicolon to show the results. + +>> $db->queryPostByID(1) + +There should not be any errors and you should see the following. + +PostRecord#1 +( + [ID] => 1 + [AuthorID] => 1 + [AuthorName] => 'Prado User' + [CreateTime] => 1148819691 + [ModifyTime] => 0 + [Title] => 'Welcome to Prado Weblog' + [Content] => 'Congratulations! You have successfully installed Prado Blog -- + a PRADO-driven weblog system. A default administrator account has been created. + Please login with admin/prado and update your password as soon as possible.' + [Status] => 0 + [CommentCount] => 0 +) + +

+
$Id: CommandLine.page 1927 2007-05-10 23:00:04Z wei $
diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/HelloWorld.page b/demos/quickstart/protected/pages/GettingStarted/ja/HelloWorld.page new file mode 100644 index 00000000..b3b0f142 --- /dev/null +++ b/demos/quickstart/protected/pages/GettingStarted/ja/HelloWorld.page @@ -0,0 +1,89 @@ + +

初めての PRADO アプリケーション

+
+

+ここでは、初めて PRADO アプリケーションを開発する人のために、定番の "Hello World" アプリケーションを解説します。 +

+

+"Hello World" を作る事は、最もシンプルでインタラクティブな PRADO アプリケーションを作る事かもしれません。
+このアプリケーションは、ページに Click Me と書いてある送信ボタンを配置してあります。
+ユーザーがボタンをクリックすると、ボタン文字が Hello World に変わるというアプリケーションです。 +

+

+このアプリケーションには、複雑なアプリケーションを作る上で重要なアプローチがいくつかあります。
+ひとつは、ページからサーバーに変数を送信して、その変数を利用して新しいページ(新しいボタン)を生成していることです。
+またもう一つは、Javascript の onclick を意識することなく利用し、ボタン文字を変更する事ができるということです。 +

+
+

+PRADO ではコンポーネントベース、そしてイベントドリブンのウェブプログラミングを構築する事ができます。
+ボタンは、TButton オブジェクトを使用します。 +TButton では Text プロパティがボタン文字となり、ユーザーのクリック動作をサーバーサイドの OnClick イベントに対応付けます。
+Text プロパティを変更する内容を定義したメソッドを OnClick に対応付けるだけで、ボタンクリックのアクションを設定することができます。
+以下にアプリケーションのシーケンスを示します。 + +

+

+このアプリケーションは3つのファイル index.php, Home.page, Home.php から構成されています。 + + +各ディレクトリ名は開発者によって変更する事が可能です。例えば protected ディレクトリはウェブサーバーにより公開されたディレクトリ以外の場所へ移動することができます。このチュートリアルを読む事で、その方法を修得する事ができます。 +

+ + +
+Tip:PRADO プロジェクトディレクトリを作成するのに framework/prado-cli.phpコマンドラインスクリプト)を使用することができます。
+例えば、helloworld プロジェクトを作りたいディレクトリへ移動し、php path/to/prado-cli.php -c helloworld とコマンド入力する事で、helloworld プロジェクトディレクトリを作成する事ができます。 +
+ +

+アプリケーションの実行に必要な3つのファイルの内容は以下のとおりです。 +

+ +
+

+アプリケーションファイルの準備ができたら、次のURLからアクセスすることができます。 http://Web-server-address/helloworld/index.php
+この例ではドキュメントルート配下に helloworld というディレクトリを配置しています。Home.page テンプレートファイル内の TButtonTLinkButton へ変更してみてどのようになるかも試してみてください。 +

+

+PRADO リリースアーカイブファイルにこのデモのソースを格納しています。また、オンラインデモにて動作を確認する事ができます。 +

+
+ +
$Id: HelloWorld.page 1650 2007-06-04 00:38:00Z Shinya.K $
\ No newline at end of file diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/Installation.page b/demos/quickstart/protected/pages/GettingStarted/ja/Installation.page new file mode 100644 index 00000000..746b3a8e --- /dev/null +++ b/demos/quickstart/protected/pages/GettingStarted/ja/Installation.page @@ -0,0 +1,33 @@ + +

PRADO のインストール

+
+

+ご自分で管理されているサーバーをお持ちであれば、すぐにインストールすることが可能です。 +

+

+PRADO の最小構成は、サーバーがPHP5をサポートしていることです。
+PRADO は Windows と Linux 両環境の Apache サーバーでテストされています。
+PHP5 がサポートされているのであれば、他の環境でも動作させることができるかもしれません。 +

+
+ +
+

+PRADO のインストールは、PRADO をダウンロードし解凍することが主な作業となります。 +

+
    +
  1. PRADO公式ページからPRADOの最新版をダウンロードします。
  2. +
  3. ウェブアクセス可能なディレクトリに展開します。
  4. +
+
+
+

+上記の作業のみでPRADOのインストールが完了します。
+http://web-server-address/prado/demos/ 以下にPRADOデモアプリケーションが展開されますので、PRADOを利用したアプリケーションの動作を体験する事ができます。
+デモアプリケーションの動作が確認できていれば、DocumentRoot 配下に prado サブディレクトリが展開されたことになりますので、インストールは正常に完了しております。 +

+

+もしデモアプリケーションが動作しない等の問題が発生しましたら、サーバー構成がPRADO必要条件を満たしているかどうかを確認する事ができるスクリプト http://web-server-address/prado/requirements/index.php が用意されていますので、確認してください。 +

+
+
$Id: Installation.page * 2007-06-03 17:01:00Z Shinya.K $
\ No newline at end of file diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/Introduction.page b/demos/quickstart/protected/pages/GettingStarted/ja/Introduction.page new file mode 100644 index 00000000..31a20df1 --- /dev/null +++ b/demos/quickstart/protected/pages/GettingStarted/ja/Introduction.page @@ -0,0 +1,64 @@ + +

ようこそ PRADO クイックスタートチュートリアルへ

+
+

+このチュートリアルはPRADO3.xを使ったアプリケーションをスピーディーに構築するためのものです。 +

+

+既にPRADO3.xを使用しており、新しいバージョンで利用可能な機能を知りたい方には新機能ページを用意してあります。
+PRADOを使用したことのない方にはこのチュートリアルはとても役立つものですので、ぜひご覧下さい。 +

+ + +

+このチュートリアルでは全ての機能は網羅しておりませんが、以下のリンクから開発の助けを得る事ができます。 +

+
+ + +
$Id: Introduction.page * 2007-06-03 16:43:00Z Shinya.K $
+
\ No newline at end of file diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/NewFeatures.page b/demos/quickstart/protected/pages/GettingStarted/ja/NewFeatures.page new file mode 100644 index 00000000..9fe65a4a --- /dev/null +++ b/demos/quickstart/protected/pages/GettingStarted/ja/NewFeatures.page @@ -0,0 +1,36 @@ + + +

新機能

+ +

+このページは、以下バージョンの PRADO に含まれる新機能の概要を紹介するページです。 +

+ +

バージョン 3.1.0

+ + +
$Id: NewFeatures.page * 2007-06-03 18:35:00Z Shinya.K $
+
\ No newline at end of file diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/Upgrading.page b/demos/quickstart/protected/pages/GettingStarted/ja/Upgrading.page new file mode 100644 index 00000000..6a44ce08 --- /dev/null +++ b/demos/quickstart/protected/pages/GettingStarted/ja/Upgrading.page @@ -0,0 +1,64 @@ + + +

Upgrading from v2.x and v1.x

+ +
+

+PRADO v3.0 is NOT backward compatible with earlier versions of PRADO. +

+

+A good news is, properties and events of most controls remain intact, and the syntax of control templates remains largely unchanged. Therefore, developers' knowledge of earlier versions of PRADO are still applicable in v3.0. +

+

+We summarize in the following the most significant changes in v3.0 to help developers upgrade their v2.x and v1.x PRADO applications more easily, if needed. +

+
+ +

Component Definition

+

+Version 3.0 has completely discarded the need of component specification files. It relies more on conventions for defining component properties and events. In particular, a property is defined by the existence of a getter method and/or a setter method, while an event is defined by the existence of an on-method. Property and event names in v3.0 are both case-insensitive. As a consequence, developers are now required to take care of type conversions when a component property is being set. For example, the following code is used to define the setter method for the Enabled property of TControl, which is of boolean type, +

+ +public function setEnabled($value) +{ + $value=TPropertyValue::ensureBoolean($value); + $this->setViewState('Enabled',$value,true); +} + +

+where TPropertyValue::ensureBoolean() is used to ensure that the input value be a boolean. This is because when the property is configured in template, a string value is passed to the setter. In previous versions, PRADO knows the property type based on the component specification files and does the type conversion for you. +

+ +

Application Controller

+

+Application controller now implements a modular architecture. Modules can be plugged in and configured in application specifications. Each module assumes a particular functionality, and they are coordinated together by the application lifecycle. The concept of v2.x modules is replaced in v3.0 by page directories. As a result, the format of v3.0 application specification is also different from earlier versions. +

+ +

Pages

+

+Pages in v3.0 are organized in directories which may be compared to the module concept in v2.x. Pages are requested using the path to them. For example, a URL index.php?page=Controls.Samples.Sample1 would be used to request for a page named Sample1 stored under the [BasePath]/Controls/Samples directory, where [BasePath] refers to the root page path. The file name of a page template must be ended with .page, mainly to differentiate page templates from non-page control templates whose file names must be ended with .tpl. +

+ +

Control Relationship

+

+Version 3.0 redefines the relationships between controls. In particular, the parent-child relationship now refers to the enclosure relationship between controls' presentation. And a new naming-container relationship is introduced to help better manage control IDs. For more details, see the controls section. +

+ +

Template Syntax

+
+

+The syntax of control templates in v3.0 remains similar to those in earlier versions, with many enhancements. A major change is about the databinding expression. In v3.0, this is done by the following, +

+ +<com:MyComponent PropertyName=<%# PHP expression %> .../> + +

+Expression and statement tags are also changed similarly. For more details, see the template definition section. +

+
+

Theme Syntax

+

+Themes in v3.0 are defined like control templates with a few restrictions. +

+ +
$Id: Upgrading.page 1650 2007-01-24 06:55:32Z wei $
\ No newline at end of file diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/directory.gif b/demos/quickstart/protected/pages/GettingStarted/ja/directory.gif new file mode 100644 index 00000000..e6c4f724 Binary files /dev/null and b/demos/quickstart/protected/pages/GettingStarted/ja/directory.gif differ diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/sequence.gif b/demos/quickstart/protected/pages/GettingStarted/ja/sequence.gif new file mode 100644 index 00000000..4207a9bb Binary files /dev/null and b/demos/quickstart/protected/pages/GettingStarted/ja/sequence.gif differ -- cgit v1.2.3