-----------------------------------------------------------------------
はじめに
-----------------------------------------------------------------------

「えあ草紙＋」は、青空文庫のウェブ版縦書きビューワーとして多くの方に
利用していただいている「えあ草紙」をベースに開発した、サーバー設置型
縦書きビューワーです。

図書館や資料館のサイトで文書を公開したり、学校サイトでの課題図書や生徒の
読書感想文の展示、ご自身のサイトでの作品の公開などにご利用ください。


-----------------------------------------------------------------------
必要な環境
-----------------------------------------------------------------------

PHPのバージョン5以降が動作しているウェブサーバー。


-----------------------------------------------------------------------
インストール手順
-----------------------------------------------------------------------

以下、インストール先を https://www.example.com/easoshiplus
ウェブのドキュメントルートを /var/www/html/ と仮定して説明します。

ダウンロードしたファイルを展開すると easoshiplus-x.x.x という
ディレクトリができますので、これを /var/www/html/easoshiplus という名前で
コピー（あるいはFTPでアップロード）してください。

その中の cache と tmplc ディレクトリが、ウェブサーバーから書込み可能な
状態にあるのを確認してください（オーナー、及びパーミッション）。

これで基本的なインストールは完了です。

サンプルページ（この例では https://www.example.com/easoshiplus/sample）
をブラウザーで開いて動作を確認してください。

※ お試し期間は、readerを最初に起動した日から二週間です。


-----------------------------------------------------------------------
利用方法
-----------------------------------------------------------------------

reader の呼び出しは、
https://www.example.com/easoshiplus/reader/?bookpath=...&title=...
のような形式の URL になります。

以下、書籍データのあるディレクトリが /var/www/html/books だと仮定して、
reader を呼び出すときの URL パラメーターを説明します。

bookpath
　書籍データへのパス（/var/www/html/books/book1.txt）
　相対パスの場合は reader/ が起点（../../books/book1.txt）

title（省略可）
　書籍のタイトル（画面の左上に柱として表示）

home（省略可）
　柱をクリックしたときに表示する関連ページの URL

yoko（省略可）
　値を 0 以外にすると横組で開く


実際の使い方は sample/index.html を参考にしてください。


-----------------------------------------------------------------------
テキストデータの形式
-----------------------------------------------------------------------

基本的には、シンプルなテキストファイル（UTF-8、または SHIFT_JIS）です。

青空文庫のテキスト形式に準拠しており、特別な注記を記述することで
色々なレイアウトが可能です（一部未対応）。

注記の形式は、こちらをご覧ください。
https://www.aozora.gr.jp/annotation/

挿絵を含む場合は、青空文庫と同様に、テキストファイルと挿絵ファイルをまとめて
ZIP ファイルにすることもできます。

データ作成中に表示の確認をしたい場合には、えあ草紙デスクトップ版を
ご利用ください（無料版でも対応）。
https://www.satokazzz.com/easoshi-desktop

また、青空文庫形式に対応したエディタもあるようなので、ネットで
検索してみてください。


-----------------------------------------------------------------------
連番画像データの形式
-----------------------------------------------------------------------

テキストファイルを含まず、画像ファイルだけを以下のような連番ファイル名で
ZIP にまとめたデータ形式です（CBZとも言います）。

001.jpg
002.jpg
003.jpg

コミックや雑誌のような書籍、あるいは自炊した本の閲覧に利用できます。


-----------------------------------------------------------------------
その他
-----------------------------------------------------------------------

logo.png を変更することで、0 ページ目に表示されるロゴを、
ご自身のサイトに合わせたものに変えることができます。

include_head.tpl その他は、そのまま html のソースに挿入されますので、
Googleアナリティクスのトラッキングコードを埋め込むなどに利用できます。

ログインが必要なサイトで、書籍データを外部から直接閲覧されたくない場合は、
書籍データをウェブ空間の外に置き、reader 起動時の最初に呼び出される
init.php でログイン状態をチェックしてください。


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

以上、不明な点は satokazzz@gmail.com までメールでお問い合わせください。
