Miki Review 説明書

Miki Reviewをダウンロードしていただきありがとうございます。 Miki Reviewは、本やCDのレビューが間単に書けて WEB公開用のHTMLが作成できる様にと思って作ったソフトウェアです。 Miki Reviewを使ってあなたのレビューページを是非作ってみてください。

１ 準備
２ 実行方法
３ メニュー
４ 使い方
５ 設定の仕方
６ スタイルシートの作成について

ファイルはZIP形式で圧縮されています。ツール等を使って解凍して中に入っているファイルを確認して下さい。以下のファイルが入っていればOKです。

mikireview20.jar      -----  実行ファイル
mikireview-manual.html  ---  説明書（このファイル）
fig0.gif              -----  説明書用イメージファイル
fig1.gif              -----  説明書用イメージファイル
fig2.gif              -----  説明書用イメージファイル
fig3.gif              -----  説明書用イメージファイル
fig4.gif              -----  説明書用イメージファイル
style01.xsl           -----  スタイルシートサンプル１
style02.xsl           -----  スタイルシートサンプル２
review.dtd            -----  レビュー用DTD
reviewlist.dtd        -----  インデックス用DTD
change.log            -----  バージョン1.0からの変更点
sample.ser            -----  サンプルです。実際にMiki Reviewで作成して公開しているレビューの
                             ファイルを付けています
tdback.gif            -----  スタイルシートサンプル１で使用するイメージファイル
logo02.gif            -----  スタイルシートサンプル２で使用するイメージファイル
cs01.css              -----  スタイルシートサンプル１で使用するカスケードスタイルシート
cs02.css              -----  スタイルシートサンプル２で使用するカスケードスタイルシート
gpl.txt               -----  GNU 一般公衆利用許諾契約書
get_java_blue-button.gif --  Javaのロゴイメージファイル
sample.xsl            -----  RSSをHTMLに変換するスタイルシート
xml.gif               -----  RSS用イメージファイル
src                   -----  Miki ReviewのJavaのソース。拡張子が.java

良く分らない方はベクターの質問ページを御覧下さい。

Miki ReviewはJavaの実行環境が必要となります。実行するパソコンにJavaが入っていない方はSUNのページよりダウンロードしてください。

Windowsのユーザの場合、Explore上でmikireview20.jarをクリックすれば実行できます。マニュアルで実行する場合は、下記のコマンドを実行してください。

java -jar mikireview20.jar

プログラムを起動すると、最初に下記の画面が表示されます。

とりあえずすぐに書き方を知りたいという方のためにサンプルファイルをつけています。『ファイル』メニューの『ファイルを開く』を選択して、 sample.serファイルを開き、右側のレビューのリストをマウスでクリックしてみてください。

メニューの構成は以下になっています。

ファイル ------- 新規作成 ==> 現在開いているレビューファイルを捨てて新しいレビューを開始します
            |
            +--- ファイルを開く ==> 保存したレビューファイルを開きます
            |
            +--- ファイルに保存 ==> レビューファイルを開いている場合、上書き保存します
            |
            +--- 名前をつけて保存=> 書いたレビューをファイルに保存
            |
            +--- 終了           ==> 終了します
編集     ------- 検索           ==> 与えられた文字列をレビュー内から検索します
            |
            +--- HTMLに出力     ==> レビューをHTMLファイルに出力
            |
            +--- RSSを出力      ==> 最新レビューのRSSファイルを作成
            |
            +--- XMLに出力      ==> レビューをXMLファイルに出力
            |
            +--- XMLに出力      ==> レビューをXMLファイル（XSLT指定）に出力
            |    （スタイルシート付き）
            +--- 設定           ==> 各種設定
表示     ------- 文字の大きさ   ==> 未完成です。次バージョンまで待って下さい
            |
            +--- LOOK & FEEL    ==> 表示をWindows風やLinux風に変更します
ツール   ------- ホームにアップ ==> 未完成です。次バージョンまで待って下さい
            |
            +--- 出力プレビュー ==> 未完成です。次バージョンまで待って下さい

右上の『新しいレビュー』のボタンを押すか、既にあるレビューを開いてタイトルを変えて『登録』ボタンを押して下さい。

タイトル: 本やCDのタイトルです。
名前: 本の著者やCDのアーティスト名です。
イメージ: 本の表紙やCDのジャケットのイメージが有る場合にファイル名又はURL名を書いて下さい。ファイル名をdefault にした場合にはレビューのファイル名と同じで拡張子が.jpgとなります。
AffiliateのURL: Amazonのアソシエイト等に参加している場合にはURLを書いて下さい。
本文: レビューの本文です。段落を変える場合には１行空けて下さい。 HTMLでは自動的に<p>タグで囲まれまて出力されます。
更新日: レビューを書いた日が自動的に表示されています。変更する場合には YYYY-MM-DD形式で変更してください。例）２００３年９月２６日の場合は2003-09-26, ２００３年１月９日では2003-01-09と書いて下さい
関連キーワード: 今書いているレビューに関連すると思うレビューがある場合には、右側の一覧から選択して、ドラッグアンドドロップして下さい。レビューのタイトル名が表示されます。

登録したレビューは右側のタイトル一覧に表示されます。既に書いたレビューを修正する場合にはタイトル一覧上のタイトルをクリックして下さい。左側に内容が表示されますので、修正して登録を押して下さい。なお、タイトルを変更すると別レビューとして登録されますので注意して下さい。

『ファイル』メニューの『名前をつけて保存』を選択して下さい。ファイルを指定する画面が表示されますので、適当な名前をつけて保存して下さい。

『編集』メニューの『HTMLに出力』を選択して下さい。インデックスファイルとレビューがHTMLファイルとして出力されます。

『編集』メニューの『検索』を選択して下さい。検索文字列を指定する画面が表示されます。文字列を指定すると文字列が含まれるレビューのタイトルが下に表示されます。タイトルをクリックして該当のレビューを呼出すことができます。見つかった文字列は強調表示されます。文字列はタイトル、名前、更新日、本文の順に検索します。見付かった時点でそのレビューはリストアップされます。１レビューに複数の文字列が有る場合、後ろの部分は表示されません。

画面の見た目を変えることができます。下記の４種類を用意しています。

Windows風
Linux風 Linuxで良く使われるGTKに似た画面です
Java風 SUNが作ったJavaオリジナルです
Unix風 Unixで良く使われるMotifに似た画面です

設定メニューを選びますと下記画面が表示されます。

スタイルシート名: XMLをHTMLへ整形するXSLTファイルを指定します。ダウンロードしたZIPファイルにはstyle01.xslとstyle02.xslの２つのファイルがサンプルとして含まれています
ファイル接頭語: レビューのファイル名はファイル接頭語＋登録した順番に４桁の番号が自動で振られて出力されます。例）ファイル接頭語がRの場合、ファイル名はR0001.html、XMLの場合にはR0001.xmlとなります。
保存ファイル名: レビューファイルを保存するファイル名です。 HTMLは１レビュー１HTMLで出力されますが、保存ファイルは全てのレビューが１つのファイルになります。
出力ディレクトリ: HTMLやXMLを出力するディレクトリを指定します。
ホームURL: あなたのホームページのURLです。RSSで使用します
ホーム名称: あなたのホームページのタイトル名です。RSSで使用します
インストールURL: レビューをインストールするURLです。RSSで使用します。例）レビューのHTMLがR0001.html、レビューファイルをインストールするURLがhttp://aaa/bb/cc/の場合に、RSSにはhttp://aaa/bb/cc/R0001.htmlと記述されます。
RSS名: RSSのファイル名です。拡張子はxml又はrdfにするのが普通です。
インデックス名: インデックスファイルの名前です。例）インデックスファイル名が indexの場合ファイル名はindex.html、XMLの場合にはindex.xmlとなります。; インデックス用スタイルシート

XSLTを使って自分用のスタイルシートを作成する場合、簡単な確認方法としては『XMLに出力（スタイルシート付き）』にてスタイルシート名が組込まれたXMLファイルを出力して、MSIEやMozilla等 XSLTをサポートしたブラウザで読み込ませて表示／確認する方法があります。

■ Miki Review 2.0 説明書

§はじめに

●目次

§ 準備

●ダウンロードしたファイルの確認

●Java実行環境のダウンロード

§ 実行方法

§ メニュー

●立ち上がりの画面

●メニューの構成

§ 使い方

●新しいレビューの書き方

●書く項目について

●書いたレビューの修正

●書いたレビューの保存

●HTMLの出力

●検索

●LOOK & FEEL

§ 設定の仕方

●動作設定の項目

§ スタイルシートの作成について

●確認方法