[[PageOutline]] = 新 Vine-manual 構想 = ドキュメントの追加を容易にするためにパッケージの構成変更を行う。 == ツール類 == === Vine-manual-base === 共通的に使う画像、スタイルシートなど。また、マニュアルを登録するコマンド、目次を更新するコマンドも用意。 [wiki:Vine-manual/Vine-manual-base] === vine-manual-build === Docbook XML から静的な HTML を作成するラッパースクリプト === vine-manual-skel === 新しくマニュアルを作成する際に雛形を作成できる vine-manual-init を提供。 {{{ $ vine-manual-init -d rescue-guide -v 0.9 vine-rescue-guide }}} ==== 0.1 のバグ ==== * ドキュメントの book 要素の ID が @PACKAGEDIR になっている。(次バージョンで修正) == ドキュメントのパッケージ構成 == idの重複等をできるかぎり避けるため、マニュアル毎にパッケージを作成し、 /usr/share/doc/Vine-manual/hoge-guide のようなディレクトリに静的 HTML をインストールする。 基本は、yelp 用のファイルをインストールする。サブパッケージとして静的HTMLを vine-manual-build により生成し、格納する。 === vine-install-guide === インストールガイド (task-* には含めない?) === vine-desktop-guide === Vine Linux デスクトップユーザーガイド === vine-cui-guide === Vine Linux CUI ユーザーガイド === vine-emacs-guide === Emacs 活用ガイド === vine-tex-guide === 日本語 TeX 活用ガイド === vine-making-rpm === RPMパッケージの作成方法 === vine-developers-guide === Vine Linux 開発者ガイド (task-*には含めない?) === vine-documentation-guide === Vine Linux マニュアル作成ガイド(task-*には含めない?) === task-vine-manual === すべてのマニュアルをインストールするためのバーチャルパッケージ === vine-rescue-guide === 準備中。インストールメディアでレスキューモードを利用する手順について記述予定。 === その他 === == Web への展開例 == 今のところ、DocumentRoot が、/var/www/vinelinux.org/ であると決め打ち。配置先に書き込み権限がない場合、make install* は、sudo で実行してください。 === vine-manual-base === {{{ $ ./configure --enable-web $ make $ make install }}} /var/www/vinelinux.org/docs/vine6/{css,images} にスタイルシート、画像が配置される。 === vine-manual-build === rpm パッケージをインストール === ドキュメント類 === {{{ $ ./configure --enable-web $ make figuresdir=/var/www/vinelinux.org/docs/vine6/package-dir/figures install $ cd help $ vine-manual-build -i /docs/vine6/images -c /docs/vine6/css/vine.css -w package-name.xml $ make xmldir=/var/www/vinelinux.org/docs/vine6/package-dir install-html }}} package-name は、パッケージ名に置き換えてください。 package-dir の基準 ||パッケージ名||package-dir|| ||vine-cui-guide||cui-guide|| ||vine-desktop-guide||desktop-guide|| ||vine-developers-guide||developers-guide|| ||vine-emacs-guide||emacs-guide|| ||vine-install-guide||install-guide|| ||vine-making-rpm||making-rpm|| ||vine-plus-guide||VinePlus|| ||vine-tex-guide||tex-guide|| ||vine-vlgpl||VLGPL||