■ TypingClub の例文追加作業

□ 手順

/NF/WWW/http/typing/ が Typing Club ディレクトリ。

./ksu/textlist がファイルリスト
./text/ 以下にデータ

ファイルリストに一行追加し、そこで示されたテキストファイルに
タイプ例文を入れるような形になる。

textlist の行

京都産業大学学歌,中級用,ksuSong.TXT,KSU1,HIRA,COMMON

追加した例文ファイル ./text/ksuSong.TXT の内容

========

#!
<OPTION SPACE=false>
<OPTION RETURN=false>
<MESG>
【京都産業大学　学歌】
</MESG>
<TYPE>
あめつちの　ひらけしときゆ　かみがみの　しずまりませる

こうやまの　そのもとやまに　むすびわざ　まなびいそはく

たくましき　たくましき　われら　わこうど

つぎのよの　わがひのもとを　ああ　にないて　にないてたたむ
</TYPE>

=======

（ここでは RETURN=false にしているせいか、空行はタイプ練習窓では
  表示されない。）

□ 注意点

書式は明確だが、挙動不審な点が多く、注意を要する。（プログラムに処理
不十分な点があると考えるべき。）

まず、

・textlist ファイルは Shift-JIS で記述する。改行コードは LF のみ。

・例文ファイルも同様に Shift-JIS と LF で書く。

細かなことを先に出しておく。

・<MESG></MESG> は長さ制限があり、せいぜい 50 バイト程度。表示は
  それこそ一秒以下程度で、ほとんど実用にならない。まさにひとこと
  程度。

・空行があると挙動がおかしくなる。最後の <TYPE></TYPE> 行のあとにも
  つけるべきではない。

基本的には <TYPE></TYPE> 中のテキストデータを画面に表示し、タイプさせる
だけだが、例文本文の作成には以下の点を把握しておくべき。

・画面中には四行しか表示されない。四行で一旦終了して、次の単元へと
  進むようにできている。（一旦終了してスピード、ミスタッチ率などが
  表示され、再び練習開始ボタンをクリックして再開する。）

・一行は実験値だが 50 バイトが上限の模様。英文は word wrap されるため
  それより前の位置になる。

・50 バイトを越えた場合はタイプ練習ソフトの表示行で次の行に折り返して
  表示される。それは問題ではないが、そのまま四行を越えた場合、次の単元は
  折り返した位置からではなく次の行の先頭からはじまる。

つまり、<TYPE></TYPE>のなかに無造作に英文を入れると、奇妙なことがおきる。

<TYPE>
Alice was beginning to get very tired of sitting by her sister on the
bank, and of having nothing to do:  once or twice she had peeped into
the book her sister was reading, but it had no pictures or conversations
in it, 'and what is the use of a book,' thought Alice 'without pictures
or conversation?'
</TYPE>

のようにすると、Typing Club 上では恐らく

Alice was beginning to get very tired of sitting
by her sister on the bank, and of having nothing
to do:  once or twice she had peeped into the
book her sister was reading, but it had no

でひとつの練習単元が終り、次に再開したときには

in it, 'and what is the use of a book,' thought 
Alice 'without pictures or conversation?'

のようになる。（pictures or conversations が無視され、次の行である
in it からはじまる。）

単に文字を打つだけなら良いが、文章を意識しながらタイプするにはあまりに
やりづらい。これを避けるためには手作業で以下のように整形して登録
するほかない。

<TYPE>
Alice was beginning to get very tired of sitting
by her sister on the bank, and of having nothing
to do:  once or twice she had peeped into the
book her sister was reading, but it had no
pictures or conversations in it, 'and what is the
use of a book,' thought Alice 'without pictures
or conversation?'
</TYPE>
<TYPE>
So she was considering in her own mind (as well
as she could, for the hot day made her feel very
...

最初のパラグラフについては最初の四行の次は、続く三行で切りが良いため
ここで </TYPE> を入れて区切るようにすると良い。
（ <TYPE></TYPE> はいくつあってもよい。）

□ 記録

2003年4月に、CIEC TypingClub開発 PJ チーム とメイルを何度か交換し、
板倉氏、甲斐氏から以下の例文フォーマットに関する情報をもらった。

この情報は /NF/WWW/http/typing/TEXTLIST.euc にあった。逆にこれ以上は
なにもないということか。

=======

>・サンプルテキストの追加方法について書かれたマニュアルはあるのでしょうか？
>　（情報センターによるとそれも無いというような話なので、、、）
>
>・あれば良いのですが、ないのであれば、今回のテキストを登録するために
>　少々お力を貸して頂けないでしょうか？

textlistの書式については，
サーバの設定ファイルに「TEXTLIST.euc」に記載されています．
念のため，その内容を本文の後ろに追加しておきます．

テキスト本文の中身について記述方法ついては，
[typing-center 00065]の内容です．
--------------------------------------------------
（１）ファイルの一行目に「#!」があると，タグ入りテキストとして，
    テキストの解釈を行う．
    #!：単なるコメントとして，テキストとしては無視する．
（２）<OPTION>の指定
    <OPTION CASE=true/false>：大文字／小文字を区別するかどうかの指定．
        false：練習時に大文字／小文字を区別せずに，どちらがタイプされても
                正しい文字として判定する．
    <OPTION SPACE=true/false>：テキスト内にスペースの文字があるときにタイプ
                を必要とするかの指定．
        false：テキスト内のスペースの部分はタイプが不要となる．
    <OPTION RETURN=true/false>：改行のタイプを必要とするかの指定．
        false：改行の部分はタイプする必要がなくなる．
    <OPTION 2SPACE=true/false>英文タイプ用のモードにする
        true：文の区切りにスペースを二ついれて，文を接続する．
    <OPTION TOUCHTEXT=true/false>テキストの整形するかどうかの指定．ただし<
TYPE>があるとその指定で表示される．
        false：指定されたテキストをそのままの形で，整形を行わず利用する．

（３）<READ>と</READ>
    囲った範囲の文字をタイプ前に練習者への説明文として表示し，
    「練習開始」ボタンを押すことで，練習を開始する．
（４）<MESG>と</MESG>
    囲った範囲の文字をタイプ前に練習者への説明文として表示する．
    一定時間表示後，練習が始まる．
（５）<TYPE>と</TYPE>
    練習する文字列を囲む．
    ４行以上に渡る場合には，４行毎に区切って表示する．
--------------------------------------------------
TextListの書式

【書式】[1]名前,[2]分類,[3]実ファイル名,[4]スコア用省略名,[5]言語の種類,[6]
テキストのある場所
【記述例】日本国憲法,中級用,theConstitutionOfJapan,CJ,ENG,COMMON

各フィールドの説明
●[1]名前
    「テキストの選択」に表示されるテキストの名前．
●[2]分類
    「テキストの選択」に表示されるテキストの分類．同一のものが続くと一つにま
    とめられる．
    同一のものが複数分かれてあった場合は，同じ分類がその場所に作成される．
●[3]実ファイル名
    テキストの実際のファイル名．テキストファイルの参照場所は「[6]テキストの
    場所」で，指定される．
●[4]スコア用省略名
    スコア用保存用の省略の名称．各テキストごとにユニークな文字列にする必要が
    ある．
    プログラム内で，テキストとスコアの対応をとるために利用している．
●[5]言語の種類
    英語のテキストか日本語のテキストかを指定する．現在，「ENG」と「HIRA」の
    ２種類がある．
    「ENG」：英語，「HIRA」：ひらがな．
●[6]テキストの場所
    テキストファイルの参照場所の指定．現在，「COMMON」と「LOCAL」の２種類が
    ある．
    共通で利用するテキストは「COMMON」で指定し，各接続先固有のテキストは「
    LOCAL」で指定することを想定している．

    「COMMON」：    接続先が「/typing/public_html/example/」の場合には，
            「/typing/public_html/text/」の中にあるテキストを参照する．
    「LOCAL」：     接続先が「/typing/public_html/example/」の場合には，
            「/typing/public_html/example/text/」の中にあるテキストを参照す
             る．
        
※記述の注意点
（１）半角のコンマ（「,」）で各フィールドは区切られています．
（２）半角のコンマ（「,」）は，利用できません．
　　　通常のキーボードから入力可能な文字が利用可能です．
（３）各項目の最大文字数に，プログラム上の制限はありません．
（４）各分類は，同一のものが分かれて存在する場合も，特にまとめる作業は行いま
      せん．
--------------------------------------------------


--------------------------------------------------
Ｑ．各項目の最大文字数はいくつでしょうか？また、使える文字に制限がないでしょ
    うか？
Ａ．プログラム上は最大文字数には制限がありません．ただし，例えばテキストの表
    示名が長すぎると画面上では欠けて表示されたり，ファイル名はOSに依存したり
    します．

Ｑ．(*1)同じカテゴリの間に違うカテゴリをはさんだ場合、別々のカテゴリに分類さ
    れてしまいますが、一般的にはどう配置するのが正しいのでしょうか？
    設定例がありましたら、お願い致します。

    例) 以下のような記述をすると、違う「中級用」のカテゴリに表示されます。

    <textlist>
    日本国憲法(英文),中級用,theConstitutionOfJapan.TXT,CJ,ENG,COMMON
    工業英語-01,初級用,EASYText1.txt,EZ1,ENG,COMMON
    工業英語-01,中級用,CYU1.TXT,CYU1,ENG,COMMON
    <表示>
    【中級用】
    　　日本国憲法(英文)
    【初級用】
    　　工業英語-01
    【中級用】
    　　工業英語-01
Ａ．これは，そのような仕様で作成してあり，特にまとめる作業は行っておりません．
　　ですから，中級用は，事前に中級用としてまとめたり，「【工業英語-中級用】
」
    という形にすることを想定しています．

Ｑ．(*2)テキストデータはdataディレクトリ直下にしか置けないのでしょうか？
  　サブディレクトリには配置できないのでしょうか？
Ａ．COMMONとLOCALの指定を利用することで，サブディレクトリに配置することがで
    きます．

Ｑ．(*3)違うテキスト名で同じスコア名にした場合の不具合・問題点はありませんで
    しょうか？
　  一般的にはどのような設定を行うのが正しいのでしょうか？
Ａ．違うとテキストで，同じスコア名にすることは考えておりませんでした．
　　各テキストは固有のスコア名を持っており，それを利用して，テキストとスコア
    の管理を行っています．異なるテキストで同一のスコア名にしても，プログラム
    内での不具合は生じません．
　　各テキスト毎に一つのスコアということで作成しております．

Ｑ．(*4)文字タイプの種類は、「ENG=英数」「KANA=かな」でよいのでしょうか？
  　他にどんなタイプがあるのでしょうか？
Ａ．現在，ENGとHIRA（＝ひらがな）の２種類があります．

Ｑ．(*5)「COMMON」項目はどんな意味なのでしょう？
Ａ．テキストデータの参照場所を示しており，COMMONとLOCALがあります．

--------------------------------------------------