リファレンス
ブックファイルに記述するタグの解説、および作成時の 注意事項 についてはこのページを参考にしてください。 また、新規にブックファイルを作成するには テンプレート をお読みください。
| xml | ||||
|---|---|---|---|---|
| 属性 | 値 | 初期値 | 必須 | 説明 |
| version | 1.0 | ★ | 準拠するXMLのバージョンを指定します。 | |
| encoding | Shift_JIS/UTF-8 etc... | ★ | ブックファイルがどの文字コードで表現されているかを指定します。 | |
| book (必須) | ||||
|---|---|---|---|---|
| 属性 | 値 | 初期値 | 必須 | 説明 |
| version | 1.0 | ★ | ブックファイルのバージョンを指定します。 | |
| autoplay | yes/no | no | 自動再生するかどうかを指定します。yesにすると起動時に自動再生を開始します。 | |
| interval | 0〜99999 | 10 | 自動再生時の切り替え間隔を指定します。単位は秒です。ここで指定する秒はあくまでも目安であり、再生環境やデータサイズによって間隔は変わります。 | |
| repeat | yes/no | no | 最後のページまで進んだら、最初のページに戻るかどうかを指定します。 | |
| startpage | 1〜page数/#ページタイトル/random | 1 | 起動時に強制的に表示するページの番号、または#ページタイトル (page要素のtitle属性の値に#をつけたもの) を指定します。randomにすると1〜page数の中からランダムに決定されます。 | |
| body | ||||
|---|---|---|---|---|
| 属性 | 値 | 初期値 | 必須 | 説明 |
| background-color | #000000〜#FFFFFF | #FFFFFF | 背景色を指定します。色の名称での指定はできません。 | |
| background-image | 背景イメージへのパス | 背景イメージのパスを指定します。(JPEG形式) | ||
| background-image-alpha | 0〜100 | 100 | 背景イメージの不透明度を指定します。数字が小さくなるほど透明に近づきます。 | |
| navi | ||||
|---|---|---|---|---|
| 属性 | 値 | 初期値 | 必須 | 説明 |
| visible | yes/no | yes | ナビゲーションを表示するかどうかを指定します。 | |
| fore-color | #000000〜#FFFFFF | #FFFFFF | 前面色を指定します。色の名称での指定はできません。 | |
| fore-alpha | 0〜100 | 100 | 前面の不透明度を指定します。数字が小さくなるほど透明に近づきます。 | |
| background-color | #000000〜#FFFFFF | #000000 | 背面色を指定します。色の名称での指定はできません。 | |
| background-alpha | 0〜100 | 75 | 背面の不透明度を指定します。数字が小さくなるほど透明に近づきます。 | |
| pagelist | yes/no | yes | ページのリストを表示するかどうかを指定します。 | |
| tooltip-visible | yes/no | yes | ボタンにマウスカーソルが重なったときに説明を表示するかどうかを指定します。 | |
| key-control | yes/no | yes | キー入力で操作できるようにするかどうかを指定します。 | |
| page (最大999まで) | ||||
|---|---|---|---|---|
| 属性 | 値 | 初期値 | 必須 | 説明 |
| title | ページタイトル | ページのタイトルを記述します。 | ||
| autoplay | yes/no | ページ表示時に自動再生を制御します。yesにすると再生、noにすると一時停止します。この設定はbook要素のautoplay属性がyesになっている場合のみ影響します。 | ||
| interval | 0〜99999 | ページにおける自動再生時の切り替え間隔を指定します。単位は秒です。ここで指定する秒はあくまでも目安であり、再生環境やデータサイズによって間隔は変わります。この設定はbook要素のinterval属性より優先されます。 | ||
| image | ||||
|---|---|---|---|---|
| 属性 | 値 | 初期値 | 必須 | 説明 |
| src | イメージへのパス | ★ | イメージへのパスを指定します。(JPEG形式) ""と指定すると表示中のイメージをフェードアウトします。 | |
| fade | 1〜100 | 10 | フェードインのスピードを指定します。数字が小さくなるほどゆっくりフェードします。 | |
| alpha | 0〜100 | 100 | イメージの不透明度を指定します。数字が小さくなるほど透明に近づきます。 | |
| scale | none/fit/stretch | none |
none イメージを元の大きさのまま表示します。枠より小さい場合は中央に、 枠より大きい場合はイメージをマウスでスクロールします。 fit イメージを枠の大きさにします。 stretch イメージを枠の大きさに合わせて縦横比を保ったまま伸縮します。 | |
| sound | ||||
|---|---|---|---|---|
| 属性 | 値 | 初期値 | 必須 | 説明 |
| src | サウンドへのパス | ★ | サウンドへのパスを指定します。(MP3形式) ""と指定すると再生中のサウンドをフェードアウトします。 | |
| fade | 1〜100 | 10 | フェードインのスピードを指定します。数字が小さくなるほどゆっくりフェードします。 | |
| volume | 0〜100 | 100 | サウンドの音量を指定します。数字が小さくなるほど音は小さくなります。 | |
| loop | 0〜999 | 0 | サウンドの繰り返し再生の回数を指定します。 | |
| text | ||||
|---|---|---|---|---|
| 属性 | 値 | 初期値 | 必須 | 説明 |
| visible | yes/no | no | ページの表示とともにテキストボックスを表示するかどうかを指定します。指定しない場合は、直前の状態を引継ぎます。 | |
| width | 50〜枠の横幅 | 150 | テキストボックスの横幅を指定します。指定しない場合は、直前の状態を引継ぎます。 | |
| height | 50〜枠の縦幅 | 150 | テキストボックスの縦幅を指定します。指定しない場合は、直前の状態を引継ぎます。 | |
| align | left/center/right | left | テキストボックスの水平位置を指定します。指定しない場合は、直前の位置を引継ぎます。 | |
| valign | top/middle/bottom | top | テキストボックスの垂直位置を指定します。指定しない場合は、直前の位置を引継ぎます。 | |
| closable | yes/no | yes | テキストボックスを閉じるボタンを表示するかどうかを指定します。指定しない場合は、直前の状態を引継ぎます。 | |
| draggable | yes/no | yes | テキストボックスをドラッグで移動できるかどうかを指定します。指定しない場合は、直前の状態を引継ぎます。 | |
テンプレート
新規にブックファイルを作成する場合は、付属のテンプレートいずれかを複製し、それを編集することをお奨めします。
- temp.xml : ボタンの色など基本的な設定が初期値で記述されている
- temp_min.xml : 最低限の要素のみ記述されている
- temp_full.xml : すべての設定が初期値で記述されている
文章作成
- 文章では一部のHTMLタグを扱えます。(扱えるHTMLタグについてはMacromediaのサイトを参照)
- 特殊記号 (< > など) を記述する場合は必ず文字実体参照 (< > など) で記述します。
- 長文になるほど表示に時間がかかるので、ページあたり1000文字未満をお奨めします。
フォント
<font size="24" color="#FF0000">三水りんご</font>
sizeは文字のピクセルサイズを指定します。
colorに色名称 (red、blackなど) は指定できません。
リンク
<u><b><font color="#0000FF">
<a href="http://www.higopage.com/">higopage</a>
</font></b></u>
<u>はアンダーライン
<b>は太文字
リンクは<a>のみで可能ですが、色やアンダーラインをつけないと他の文章と見た目が変わらないため、 明確にしたい場合はこのようします。また、指定できるURLは最大127文字です。
ページ移動
<a href="asfunction:gotopage,移動先">三水りんご</a>
移動先の部分に以下のいずれかを指定します。
- ページ番号 (1〜page数)
- #ページタイトル (page要素のtitle属性の値に#をつけたもの)
- next (次のページ)
- prev (前のページ)
- random (1〜page数の中からランダムに選択されたページ)
キー操作
キー操作はスライドショーをクリックし、半角入力にしてから行います。
- [0] アラートを表示
- [↑][↓] ページリストやテキストのスクロール
以下のキーはnavi要素のkey-control属性が yes のときに有効です。
- [1][←] 前のページへ移動
- [2][→] 次のページへ移動
- [3] 自動再生を開始/一時停止
- [4] テキストを表示/非表示
- [5] サウンドをオン/オフ
- [6] ページリストを表示/非表示
注意事項
- イメージファイルはJPEG形式のみ対応しています。ただしプログレッシブJPEGは対応しません。
- サウンドファイルはMP3形式のみ対応しています。ただしファイルによってはうまく再生されない場合があります。公開前に正しく再生されるか確認してください。
- データサイズの大きなものはそれだけ読み込みが遅くなりますので、むやみに大きなファイルを使用するのは避けましょう。
- 関連するファイル名、フォルダ名は半角英数のみを使用してください。
- <book version="...">, </book>は必ず記述してください。
- 属性値に不正な値を入力した場合の動作はサポートしません。
- <page>...</page>は合計999まで追加できます。それ以上追加されたものは無視されます。
- <image />のsrc属性にはSWFファイルを指定することができますが、その際に起こる問題についてはサポートしません。
- ブックの表示領域を小さくしすぎると、ナビゲーションやテキストボックスが隠れて見づらくなります。縦、横ともに150ピクセル以上にすることをお奨めします。
- ブックの表示領域を大きくしすぎると、再生環境によっては表示が遅くなります。縦、横を600ピクセル以下にすることをお奨めします。
- テキストボックスをドラッグする際、文章が見えなくなりますが、これは動作を軽快にするための仕様です。
- 自動再生中にページ移動が行われたときは一時停止となります。 (文章内からのページ移動も同様) 一時停止を避けたいときは navi要素のvisible属性を no にしてナビゲーションを隠し、key-control属性を no にしてキー入力による操作をできないようにします。
- スライドショーをクリックし、半角入力にしてから[0]キーを押すと、StoryBookReader のバージョンが確認できます。表示されたアラートもう一度[0]キーを押せば隠れます。
- FTPソフトなどでファイルをアップロードする際、StoryBookReader やイメージファイル、サウンドファイルはバイナリ形式で転送してください。
- 閲覧者のコンピューターにFlash Playerがインストールされていない場合がありますので、Flash Playerのダウンロードサイトへのリンクをページ内に記述することをお奨めします。
