<?xml version="1.0" encoding="Shift_JIS" ?>
<doc>
<title>起動の仕方</title>

<para>
<ptitle>吉里吉里の起動について</ptitle>
　吉里吉里を起動し、スクリプトを指定するためには通常、<kw>プロジェクトフォルダ</kw> を決定する必要があります ( <link href="StorageSystem"/> 参照 )。<r/>
　プロジェクトフォルダを決定する方法はいくつかありますが、下記に挙げた順に優先されます ( 上のほうに書いたものが適用できれば適用される )。<r/>
　起動時に吉里吉里に渡すオプションについては <link href="CommandLine"/> を参照してください。<r/>
</para>

<para>
<ptitle>プロジェクトフォルダの決定順序</ptitle>
<dl>
<dt>コマンドラインに指定されたフォルダやアーカイブ</dt>
<dd>
　コマンドラインの引数としてフォルダが指定された場合、それをプロジェクトフォルダと見なし、実行します。<r/>
　コマンドラインの引数として XP3 アーカイブが指定された場合、その中にプロジェクトフォルダが入っていると見なし、実行します。<r/>
　コマンドラインの引数として ファイルやフォルダを指定するのはコマンドプロンプトからもできますが、一番簡単なのは、エクスプローラや「開く」で、吉里吉里の実行可能ファイルのアイコンの上にプロジェクトフォルダやファイルをドロップすることです。<r/>
　また、吉里吉里の実行可能ファイルへの引数として特定のプロジェクトフォルダを書いたショートカットをデスクトップなどにおいておくと便利でしょう。
</dd>

<dt>実行可能ファイルと同じ場所の content-data フォルダ</dt>
<dd>
　実行可能ファイルと同じ場所に "content-data" という名のフォルダがある場合はそれをプロジェクトフォルダと見なし、実行します。
</dd>

<dt>実行可能ファイルと同じ場所の "data.xp3" ファイル</dt>
<dd>
　実行可能ファイルと同じ場所に data.xp3 という名のアーカイブファイルがある場合は、それを XP3 アーカイブ形式としてその中にプロジェクトフォルダが入っていると見なし、実行します。
</dd>

<dt>実行可能ファイルと同じ場所の "data.exe" ファイル</dt>
<dd>
　実行可能ファイルと同じ場所に data.exe という名のファイルがある場合は、それを XP3 アーカイブ形式としてその中にプロジェクトフォルダが入っていると見なし、実行します。<r/>
( XP3 アーカイブは実行可能ファイルと結合できるためこのようなプロジェクトフォルダの決定方法があります )
</dd>

<dt>自分自身に XP3 アーカイブが結合されているとき</dt>
<dd>
　XP3 形式アーカイブは実行可能ファイルと結合することができますが、自分自身が XP3 アーカイブと結合されていた場合、自分自身にプロジェクトフォルダが入っていると見なし、実行します。
</dd>

<dt>実行可能ファイルと同じ場所の data フォルダ</dt>
<dd>
　実行可能ファイルと同じ場所に "data" という名のフォルダがある場合はそれをプロジェクトフォルダと見なし、実行します。
</dd>
</dl>
<r/>
　いずれの方法でも決定できなかった場合は、フォルダ/アーカイブ選択の画面が出ます。<r/>
　ただし、リリースオプションで 「XP3アーカイブのみから実行」が指定されていた場合は、data.xp3ファイル、data.exeファイル、「自分自身に XP3 アーカイブが結合されているとき」の場合の動作しかしません ( <link href="Configure"/> 参照 )。<r/>
</para>

<para>
<ptitle>フォルダ/アーカイブ選択</ptitle>
　フォルダ/アーカイブ選択の画面は以下のようになります。<r/>
<img src="FolderSelector.png"/><r/><r/>
　現在フォルダを選択しているのか、ファイルを選択しているのかは下側の選択中のファイル名の右に <b>(フォルダ)</b> や <b>(ファイル)</b> として出ています。<r/>
<r/>
<dl>
<dt>「選択しない」ボタン</dt>
<dd>
　このボタンをクリックすると、プロジェクトフォルダを選択しません。<link href="Controller"/> が開きます。プロジェクトフォルダが指定されていない状態ですが、コンソールやスクリプトエディタを使って簡単なスクリプトのテストなどをすることができます。
</dd>

<dt>「OK」ボタン</dt>
<dd>
　現在選択中のフォルダやファイルの実行を開始します。
</dd>

<dt>「キャンセル」ボタン</dt>
<dd>
　何もせずに吉里吉里を終了します。
</dd>
</dl>
</para>

<para>
<ptitle>最初に実行されるファイル</ptitle>
　プロジェクトフォルダ決定後、最初に実行されるのは、プロジェクトフォルダ内の startup.tjs です。これがない場合はエラーになります。<r/>
</para>

<para>
<ptitle>メッセージマップファイル</ptitle>
　吉里吉里は、起動直後に吉里吉里と同じフォルダに msgmap.tjs があるかどうかを調べ、それが存在すれば実行します。ただしリリースオプションでこれを読み込まないように指定されていた場合を除きます ( <link href="Configure"/> 参照 )。msgmap.tjs では <at href="f_System_assignMessage.html">System.assignMessage</at> を使用してメッセージの割り当てを変更することができます。msgmap.tjs は <link href="Controller" /> でも作成することができます。<r/>
</para>

<para>
<ptitle>設定ファイル</ptitle>
　吉里吉里は、<link href="Configure"/> で作成した設定ファイル (.cf ファイルや .cfu ファイル) を読み込み、そこに記述してある設定にしたがって動作します。<r/>
　ファイル名やファイルの作成される場所については <link href="Configure"/> を参照してください。<r/>
</para>

</doc>

