wiki:Vine-manual

Version 5 (modified by yasumichi, 13 years ago) (diff)

--

新 Vine-manual 構想

ドキュメントの追加を容易にするためにパッケージの構成変更を行う。

ツール類

Vine-manual-base

共通的に使う画像、スタイルシートなど。また、マニュアルを登録するコマンド、目次を更新するコマンドも用意。

Vine-manual/Vine-manual-base

vine-manual-build

Docbook XML から静的な HTML を作成するラッパースクリプト

vine-manual-skel

新しくマニュアルを作成する際に雛形となるディレクトリを作成できる。

  1. vine-hoge-guide のようなディレクトリを作成
  2. 上記ディレクトリ内でコマンドを叩くと次のようなファイルを作成する。
  • Makefile.am (サブディレクトリにも作成)
  • images/Makefile.am
  • configure.ac
  • vine-hoge-guide.omf.in

(vine-manual-build)に統合するかも。

ドキュメントのパッケージ構成

idの重複等をできるかぎり避けるため、マニュアル毎にパッケージを作成し、 /usr/share/doc/Vine-manual/hoge-guide のようなディレクトリに静的 HTML をインストールする。

基本は、yelp 用のファイルをインストールする。サブパッケージとして静的HTMLを vine-manual-build により生成し、格納する。

vine-install-guide

vine-desktop-guide

vine-cui-guide

vine-emacs-guide

vine-making-rpm

vine-developers-guide

task-vine-manual

すべてのマニュアルをインストールするためのバーチャルパッケージ

その他