outliner の概要

outliner は、アウトラインプロセッサではなく、エディタなどで作成されたアウトライン文書 ( 階層付きテキスト文書 ) を HTML 文書に整形するソフトです。
普通のテキスト文書に、ほとんど手を加えずに手間をかけずに、見栄えの良く機能的な HTML 文書に変換する事を目的としています。

階層付きテキストをサポートしているアウトラインプロセッサ
AUTLA, FitzNote, Nami2000, IdeaTree, kie, StoryEditor, TreeProoF
などで編集したファイルを見栄えの良い、機能的な HTML に変換できます。
さらに Windows HTML Help Workshop 形式にも出力できます。( 例えばフリーソフト作者の方であれば、アウトラインプロセッサやエディタなどで取扱説明書を書けば、それだけで HTML 文書に変換してホームページにアップしたり、HTMLヘルプを作成してソフトに添付したりできます。)

変換元のアウトライン文書はどのようなソフトで作成されても構いません。
outliner が対象としているアウトライン文書は普通のテキストファイルですので特定のソフトで作成されたものである必要はありません。
基本的に outliner は文書コンバータであってオーサリング機能はありません。変換元文書の編集などはエディタやアウトラインプロセッサを使います。

通常階層付きテキストは文頭に "." ピリオドを付けて階層化を行いますが、outliner では任意の文字列で階層を表現する事も可能です。

outliner の一番身近な変換例は、この Chapter-01.html 自体です。この HTML 文書は普通のテキストエディタで作成したテキスト文書を outliner で変換したものです。

変換元文章 readme.txt ←これを変換すると、今ご覧になっているこの HTML 文書になります。
※この文章を Wz Editor のアウトラインで開くと文書作成中でもツリー構造のアウトライン表示が出来ます。

てっとり早く動作させたい人は簡単な使い方をまずご覧になってください。まず文書を変換して見る事が一番理解が早いと思います。

outliner は、ある簡単な書式で書かれたテキストファイルを HTML 文書に変換します。ただ単に変換するだけでなく、簡単なテキスト書式で記述された章見出しヘッダを判別しメニューを作り HTML 文書に変換します。

よく階層構造になっている文書では、章見出しに「1-1」とか「2-3」・「3-1-2」などの番号が付けられ文書構造のレベル付けが行われています。

outliner では章見出しに番号を付けるのではなく、行頭に「. ( ピリオド ) 」や「■」・「▲」を入れておくと、それが章見出しヘッダになります。
この章見出しヘッダを解析して自動でレベル付けを行い、HTML 文書に変換します。

この章見出しヘッダと章見出しに続く文章で一つのパラグラフ ( 段落 ) を構成します。

これは WZ Editor でアウトライン ( 標準設定 ) で作成した時の文書構造です

これはサクラエディタでアウトライン解析を行った時の文書構造の例です

このように文の先頭に章見出しヘッダを入れる事で、階層構造のアウトライン文書を作成します。このアウトライン文書を HTML 文書に変換するのが outliner です。

章見出しのレベルは 1～6 までを作成できます。( HTML の見出しを表す H ( Head ) タグが H1～H6 までだからです。)

さらに以下の機能があります。

Windows HTML Help 形式出力

Windows HTML Workshop で読み込めるプロジェクトファイル、目次ファイル、索引ファイルを出力する事が出来ます。
このプロジェクトファイルを HTML Workshop で読み込むと変換元ファイルを Windows HTML Help に変換することができます。

ソフトなどの取扱説明書は、エディタなどで作成し outliner で変換しておけば、その取扱説明書がそのままヘルプファイルになります。
Windows HTML Help の目次ファイルは作成に非常に手間が掛かりますが、outliner なら取扱説明書がそのまま HTML Help に早変わりしてしまいます。もちろん Windows HTML Help 用のスタイルシートも用意してありますので、HTML Help にふさわしいスタイルで表示させる事が出来ます。

他のソフトとの連携

outliner は他のアウトラインプロセッサなどと連携する事で、威力を発揮します。

以下のアウトラインプロセッサは階層付きテキストファイルの読み書きをすることができます。このソフトから出力された階層付きテキストファイルは outliner で正常に変換を行うことができました。

ソフト名	備考
AUTLA	階層付きテキストのエクスポートが可能。コマンドライン版は AUTLA のプラグインとして動作します。
FitzNote	階層付きテキスト・IdeaTree 形式のインポート・エクスポートが可能
Nami2000	階層付きテキストのインポート・エクスポートが可能 <note@履歴> などの文字列を HTML タグとして認識してしまう
kie	階層付きテキストのインポート・エクスポートが可能
StoryEditor	階層付きテキストのインポート・エクスポートが可能
IdeaTree	階層付きテキストのインポート・エクスポートが可能
TreeProoF	階層付きテキストのインポート・エクスポートが可能

構造化エディタは階層付きテキストのインポート・エクスポートが出来ませんが、データ形式がシンプルなのでコンバータを作ることは簡単そうです。

※総てのソフトを使い込んだ訳ではないので、誤りや、このソフトでも動いた、コンバータあるよ、などの情報がありましたら教えて下さい。

動作環境

ToDo

・&&M- を指定した下のレベルのパラグラフもメニューに表示しないようにする
・章番号は現在 1-2-3 という半角英数字だけだが、I-II-III や i-ii-iii などの形式も用意する
・メニューをコンテンツと一緒にする変換モードも作成
・数字や・を OL UL タグを利用してリストにする
・インデックスリンクは同じパラグラフへのリンクは行わないようにする
・現在は文字コード変換に jcode.pl を使用しているが、Jcode.pm か Encode モジュールを使用する予定
・アウトラインプロセッサの独自形式 ( テキスト ) から変換できるようにしたい
・形態素解析を使用した名詞 -> サーチエンジンリンク
・i18n 対応

既知のバグ

・変換時開放されないメモリがある。GUI 版では1回変換を行なう度に 4K～8KB 程のメモリを使用してしまいます。早急に修正する予定です。繰り返し何回も変換を行わせる場合は、時々 outliner の再起動を行って下さい。outliner を終了させると全てのメモリは開放されます。
・文字参照で < は HTML タグとの関連で変換できていません。
・章見出しヘッダに半角カナがある場合文字化けします。
・HTML ヘッダ・フッタ設定でファイルをオープン等をしたときにプロジェクトステータスが (変更) にならない。( 文字入力をした場合はなる。)
・CTRL キーや F5 を押しただけでロジェクトステータスが (変更) になってしまう。

履歴

1.0-3 : 2003-03-03

・リンクのアンカーの出力形式がいままでアンカー文字列だけだったのを、章見出しも選択できるように追加。
・置換文字列で &&CHAPTER_PARENT_?????&& と &&CHAPTER_TOP_?????&& &&FILE_?????&& を追加。
・メニューのメニュー章見出しと章番号にに id タグをつけるようにした。
・Windows HTML Help 出力がアンカータイプ HEADER に対応していなかったのを修正。
・Windows HTML Help でプロジェクトオプションを自由に指定できるようにした ( 指定はプロジェクトファイルを直接編集 )
・Windows HTML Help で目次用アイコンを指定できるようにした ( 指定はプロジェクトファイルを直接編集 )
・出力先フォルダをシェルで開けるようにした。
・&&TABLE&& 内の項目で "," が含まれている場合、" でクォーテーションするようにした。