テキストのかきかた

　「タイピングの練習(れんしゅう)」のテキストは、かんたんな命令(めいれい)をふくんだテキストファイルで構成(こうせい)されています。

　テキストのファイルのなかでは、つぎの表(ひょう)のような命令(めいれい)をつかうことができます。

練習(れんしゅう)問題(もんだい)を構成(こうせい)する命令(めいれい)

　練習(れんしゅう)問題(もんだい)をつくる命令(めいれい)です。命令(めいれい)をよびだす順番(じゅんばん)は任意(にんい)です。

命令(めいれい)	説明(せつめい)
:hint	つぎの行(ぎょう)から、画面(がめん)ひだりがわに表示(ひょうじ)するヒントをかきます。
:ime_mode [モード]	練習(れんしゅう)で使用(しよう)する「ひらがなIME」の入力(にゅうりょく)モードを指定(してい)します。英数(えいすう)モードにするときは「A」を、かなモードにするときは「あ」を指定(してい)します。
:keyboard	練習(れんしゅう)画面(がめん)にキーボードを表示(ひょうじ)するようにします。
:text	つぎの行(ぎょう)から、メニューのテキストや練習(れんしゅう)するテキストをかきます。
:title [タイトル]	テキストのタイトルを指定(してい)します。
:zenkaku	半角(はんかく)で入力(にゅうりょく)した文字(もじ)（アラビア数字(すうじ)など）も全角(ぜんかく)とみなして評価(ひょうか)するようにします。

　ヒントや練習(れんしゅう)するテキストにはルビをふっておくことができます。ルビは、ユニコードのルビ用(よう)のコードポイントU+FFF9からU+FFFBに対応(たいおう)しています。「ふりがなパッド」をつかうと、ルビのついたテキストをかんたんにかくことができます。

　ヒントやメニューのテキストのなかでは、「Pangoマークアップ言語(げんご)」をつかうことができます。くわえて、テキストでは、キーボードのキーをあらわすための<kbd>タグをつかうことができます。

　練習(れんしゅう)問題(もんだい)の構成(こうせい)ができたら、つぎの命令(めいれい)のいずれかひとつをよびだします。

命令(めいれい)	説明(せつめい)
:menu [ファイル名(めい)]...	練習(れんしゅう)メニューを表示(ひょうじ)して、ユーザーの選択(せんたく)をまちます。[ファイル名(めい)]...には、メニュー画面(がめん)からジャンプするテキストのファイル名(めい)を順番(じゅんばん)に指定(してい)していきます。
:random [練習(れんしゅう)数(すう)]	テキストから練習(れんしゅう)数(すう)ぶんの行(ぎょう)をランダムにぬきだして、練習(れんしゅう)画面(がめん)を開始(かいし)します。テキストの部分(ぶぶん)に単語(たんご)を１行(ぎょう)ずつかいておけば、ランダムに単語(たんご)の練習(れんしゅう)をすることができます。
:start	テキストをつかって、タイピングの練習(れんしゅう)を開始(かいし)します。

:nextと:upは、どちらかひとつを指定(してい)します。

命令(めいれい)	説明(せつめい)
:show_score	練習(れんしゅう)結果(けっか)を画面(がめん)に表示(ひょうじ)します。
:next	:menu命令(めいれい)で指定(してい)したファイルリスト中(ちゅう)のつぎのファイルにジャンプします。
:up	ひとつうえのメニュー画面(がめん)にもどります。

　コマンドライン引数(ひきすう)にテキストのファイル名(めい)を指定(してい)して起動(きどう)すると、じぶんで用意(ようい)したテキストで練習(れんしゅう)できます。

$ esrille-typing-practice [ファイル名]