これは RuntimeRevolution 1.1.1 のヘルプにある文書を邦訳したものです。この文書の文責はUDIにあり、またUDIはこの文書についての一切の債務を負いません。 間違いがありましたら eudio@chabashira.co.jp までお知らせ下さい。この文書は必要と思われる時に適宜アップデートされます。

Help -> Revolution Documantation -> Development Guide -> Developing with Revolution -> About... the Revolution documentation


About the Revolution documentation
Revolution ドキュメンテーションについて
==============

参照:
--------------
Help menu > Revolution Documentation, Shortcut to look up Transcript term, Shortcut to open Revolution documentation


 Revolution の完全なドキュメンテーションは Revolution に同梱されており、それらは Revolution の開発環境で作られている。

 ドキュメンテーションを参照するには、Help メニューから 'Revolution Documentation' を選択する。


Contents:
The Documentation Window
The Section Windows
Documentation Shortcuts
Additional Resources
Legal Gibberish & Fine Print
Credits & Acknowledgements


The Documentation Window
ドキュメンテーションウィンドウ
 ドキュメンテーションウィンドウには、Revolution ドキュメンテーションの roadmap (地図)が含まれている。リストにあるセクション名をクリックすればそのトピックを見ることが出来る。セクション間を移動するにはウィンドウ右下の矢印ボタンをクリックする。 'Roadmap' ボタンをクリックすればリストに戻ることが出来る。

 ティプス: ドキュメンテーションの中には、例えば Transcript Dictionary のように、頻繁に利用されるセクションがある。ウィンドウ下部の 'Show this page when documentation opens' にチェックを入れれば、ドキュメンテーションウィンドウを開いたときに、すぐにそのセクションが現れるようになる。次回ドキュメンテーションウィンドウを開いた時には、リストセクションをスキップして、ダイレクトにそのページに移動する。


The Section Windows
セクションウィンドウ
 Revolution のドキュメンテーションには、これらのセクションが含まれている:

Encyclopedia: 詳細な予備情報
Transcript Dictionary: Transcript 言語の完全なリファレンス
How To: 一般的な操作方法
Troubleshooting: トラブルの解決法
Tutorials: Revolution による開発とスクリプティングについての紹介
Using the Starter Kit: Starter Kit の制限内で作業するためのティップス
Shortcuts Reference: 便利なキーボードショートカットリファレンス
Menu Reference: 開発環境のメニュー項目リファレンス
Glossary: ドキュメンテーション内の技術用語の定義
Tips: 便利なテクニックとポイント

 これらの各セクションは別々のウィンドウに表示され、セクション間を自由に行き来することが出来る。

 各ドキュメンテーションウィンドウ(このウィンドウも含む)の上部にはグレイのコントロールバーがある。このコントロールバーを利用して、現在のセクションのトピックを検索したり、直前のトピックに戻ったり、関連するトピックを見ることが出来る。

 ティップス: ドキュメンテーションの全セクションのトピックウィンドウ上部には、See Also (「参照」)メニューがある。 See Also は、調べたい事柄をどうやって探せばいいのか分からないが、それに関連したトピックなら分かっている、と言う時に役に立つ。例えば Transcript の find コマンドと同じ働きをするメニュー項目を調べるには、Menu Reference の項を開いて、その See Also リストをチェックする。

Looking up terms in the documentation
ドキュメンテーションで用語を探す
 Transcript 言語の用語は、どのドキュメンテーションセクションでも強調文字で表されている。強調文字をクリックすれば、Transcript Dictionary の、その用語の項を見ることが出来る。

 glossary に解説のある単語の上にマウスポインタが乗ると、その単語がハイライトして、マウスポインタも手の形に変わる。そのままこの単語をクリックすれば glossary を見ることが出来る。(閉じるには表示されている glossary を再度クリックする)

 ドキュメンテーションには、インターネットへのリンクや、ウェブ上の情報が含まれている。これらのドキュメントの URL はアンダーライン付きの青文字で表示されている。このドキュメントをクリックすれば、その URL がブラウザで開かれる。

 ティップス: ドキュメンテーションのテキストをコピーするには、コピーしたいテキストを Option キー( Mac OS と OS X 上)か Alt キー( Unix と Windows 上)を押しながらドラッグして選択する。マウスボタンを離すと、そのテキストは自動的にクリップボードに入る。

 各ドキュメンテーションウィンドウのグレイのコントロールバーには、検索ボックスがある。 Find ボックスに単語を入れて Return キーを押せば、セクション内のトピックタイトルを検索することが出来る。また Option キー( Mac OS と OS X 上)か Alt キー( Unix と Windows 上)を押しながら Return キー押せば、全文検索することが出来る。

Notes and tips
注意とティップス
 ドキュメンテーションの中には、特別な情報について書かれた部分がある。この情報には以下のような種類がある:

Note: (訳文上では「注意:」) 便利な追加情報やキーポイント。

Tip: (訳文上では「ティップス:」) その他の手段や近道。

Important! (訳文上では「重要!」) 知っておかないと混乱する可能性のある Revolution の性質や、予想外の動作を回避する方法。

Caution! (訳文上では「警告!」) スクリプトエラーやデータ損失を起こす可能性のある問題についての警告。

Transcript Dictionary special features
Transcript Dictionary の特別な機能
 Transcript Dictionary にはいくつかの特別な機能がある:

* ウィンドウ上部にあるアイコンは、その Transcript 用語が、Mac OS、OS X、Unix、Windows のどのプラットホームでサポートされているかを示している。

* 言語で使われる(キーワード以外の)用語は、タイプライター風強調文字で示されている。構文説明はこれら標準の慣例に従う:

 [] 角ブラケット記号で囲われた部分はオプション。
 {} 巻括弧で囲われた部分は選択肢の列挙。
 |  垂直線は選択肢を区切る記号。

 イタリックで書かれた単語は、そのまま使うのではなく、他のものに置き換えることを表している。

* 右上のアイコンを使って、簡略表示と全体表示を切り替えることが出来る。簡略表示ではその用語の構文と簡単な説明を小さなパレットで見ることが出来る。この表示を使えばスクリーンを効率よく使える。

 再度スイッチボックスをクリックして全体表示に戻せば、サンプルや、プラットホームのサポート状態、プロパティと返値についての情報などを見ることが出来る。

 ティップス: スクリプトエディタから Transcript Dictionary を開いた場合は、自動的に簡略表示になる。


Documentation Shortcuts
 ドキュメンテーション上のショートカット

ドキュメンテーションを開く
  Command-? ( Mac OS と OS X )
  Control-? ( Unix と Windows )
  F1 キー
  Help キー

セクション内のトピックを移動する
  左右矢印キー

スクロールアップ、ダウン(スクロールバーがある場合):
  上下矢印キー

選択したテキストのコピー
  テキストを Option - ドラッグ( Mac OS と OS X )
  テキストを Alt - ドラッグ( Windows )
  テキストを Meta - ドラッグ( Unix )

セクション内のトピック検索
  ウィンドウ上部の Find ボックスに単語や文を入れて、Return か Enter を押す。
  キーを続けて押せば、タイトルにその単語を含むトピックを、更に検索出来る。

以前のトピックに戻る
  ウィンドウ上部にある Go Back メニューから選択する。

関連したトピックを見る
  ウィンドウ上部にある See Also メニューから選択する。

スクリプトエディタ内の単語を調べる
  調べたい単語を Command - クリック( Mac OS と OS X )
  調べたい単語を Control - クリック( Unix と Windows )


Additional Resources
更なる情報源
 もしこれらのドキュメンテーション内に、あなたの疑問に対する答えが見つからなかった場合は、アプリケーション開発を続けるために、これらの情報源にあたってみなさい。また経験豊かな Revolution 開発者たちのコミュニティに入れば、専門知識を持った人々があなたの疑問に答えてくれるかも知れない。 

 まず最初に http://www.runrev.com にある Revolution のウェブサイトからスタートしなさい。ここではサンプルコードや、バージョンアップ情報や、最新のアップデート情報を得ることが出来る。

Developer Community
開発者のコミュニティ
 他の開発者からの助言を得るためのメーリングリストが用意されている。機能追加や次期バージョンに対するリクエスト、また Runtime Revolution からのアナウンスを受け取ることも出来る。 Revolution メーリングリストには、ここから入ることが出来る http://www.runrev.com/revolution/developers/mailinglists/

Keeping Current
最新情報を得る
 ドキュメンテーションを最新のものに保つために、Help メニューの 'Check for Updates Online' を利用することが出来る。もし新しいバージョンの Revolution やドキュメンテーションが利用可能になっていれば、そのダウンロード方法が Revolution に表示される。

Technical Support
テクニカルサポート
 Runtime Revolution は、Professional 版のユーザーに全面的なテクニカルサポートを提供し、その他のライセンスのユーザーに対しては限定的なサポートを提供する。バグレポートやサポート依頼をするには、Help メニューの 'Revolution Support' を選択してフォームを全て埋めるか、support@runrev.com にメールを送る。 


Legal Gibberish & Fine Print
著作権等の表示
Version 1.1.1
Documentation ゥ 2000-2002 Runtime Revolution Ltd. All rights reserved.

This documentation may be altered or reproduced only for the personal use of the license holder, and may not be redistributed in any form without the explicit written permission of the copyright holder.
 このドキュメンテーションは、ライセンス保持者が個人で使用する範囲内で、変更を加えたり、複製することが出来る。フォーマットを変更したものを著作者に無断で再配布してはならない。(訳注:この訳文の公開については、Runtime Revolution の了解を得ています。 A showing of this documents gets the consent from Runtime Revolution )

Apple, HyperCard, Macintosh, QuickTime, Mac OS, OS X, and the Mac OS and OS X logos are trademarks of Apple Computer, Inc. PostScript is a trademark of Adobe Systems Incorporated. Motif and UNIX are registered trademarks of The Open Group. Windows and the Windows logo are trademarks of Microsoft Corporation. All other trademarks are the property of their respective owners.


Credits & Acknowledgements
Documentation by Jeanne A. E. DeVoto jeanne@runrev.com
Tutorials by Richard Gaskin
Using the Starter Kit by Raymond Griffith
About Connecting to and Using SQL Databases by Tuviah Snyder

Thanks to...
Scott Raney, Kevin Miller, Dave Cragg, Andu Novac, Tuviah Snyder, and Geoff Canyon for expert technical assistance

Heather Williams and Steve Wagenseller for technical review of the Tutorials

Rob Cozens for technical review of the Transcript Dictionary

The Revolution List for extensive commentary and testing

The MetaCard List for tips and information

邦訳/文責:UDI
2003.01.07
2003.04.08

inserted by FC2 system