トップ > ソフトウェア > doctools

[前ページ] [次ページ]


ドキュメント作成関連ツールおよびデータ形式

Author: Takeshi Fujiyoshi
Last update: 2010/08/22

この資料では主に、筆者がウェブページ構築に使用している自作ソフトウェアと、 その中で使用しているデータ形式について説明する。

目次

動作環境

Ruby 1.8.7 がインストールされた UNIX 系の OS ならたぶん動く。 Ruby 1.9.1 でも一応動くことは確認している。 筆者が確認した OS は NetBSD 5.99.24 と Debian 5.0 のみ。

今のところ Windows 上で動かすことは全く考えていないし、 実際に動くかどうか確認する気もない。

配布物

いずれも小物ツールであるため1つのパッケージにまとめた。 このパッケージの呼称には悩むが、とりあえず ncl-doctools とする。

ファイル 内容
ncl-doctools-20100822.gem RubyGemsパッケージ形式
LICENSE.txt ライセンス

ncl-doctools は以下の個別のソフトウェアを含んでいる。 詳細はそれぞれのドキュメントを参照。

tunahtml 1.0
HTMLリンカ。 ページ間の階層構造などを定義したコンフィグファイルに従い 複数のHTMLファイルをリンクする。
fokan2html 1.0
FokanデータからHTMLファイルを生成する。 Fokanとは写真データを管理するためのデータ形式。
twsk2html 1.1
追跡データからHTMLファイルを生成する。 追跡データとは旅行中に訪れた場所などを記録するためのデータ形式。

インストール方法

本ソフトウェアは Ruby で書かれている。 Ruby と RubyGems があらかじめインストールされている必要がある。

上記のファイルをダウンロードし、以下のコマンドを実行する。:

$ gem install ncl-doctools-20100822.gem

一般ユーザで gem install を実行すると、 デフォルトで ~/.gem 以下にインストールされるようである。 Ruby 1.8.7 なら ~/.gem/ruby/1.8/bin に実行ファイル(のラッパー)が 置かれるようなので、その場合はパスを通しておくこと。

古いバージョンの RubyGems では、そのままでは一般ユーザではインストール できないかも知れない。その場合は、root 権限でインストールするなり 環境変数 GEM_HOME を設定するなり新しいバージョンの RubyGems を インストールするなり対処すること。

使い方

それぞれのドキュメントを参照。

リリース履歴

日付 バージョン 変更内容
2010/08/22 20100822 twsk2html 1.1: IEで地図、ルート図が表示されない不具合を修正
2010/03/21 20100321 初回リリース (tunahtml 1.0, fokan2html 1.0, twsk2html 1.0)

トップ > ソフトウェア > doctools

[前ページ] [次ページ]