VineSeed ML アーカイブ



[VineSeed:026030] Re: 7.x に向けたドキュメント整備要領の変更について

  • From: Munehiro Yamamoto <munepi@xxxxxxxxxxxxxxxx>
  • Subject: [VineSeed:026030] Re: 7.x に向けたドキュメント整備要領の変更について
  • Date: Sat, 19 Jan 2013 10:41:39 +0900
山本@千葉のおうちです。

2013年1月19日 4:11 Yasumichi Akahoshi <yasumichi@xxxxxxxxxxxxx>:
>  これは、テキストエディタで編集できるというよりもオフラインで編集できた方が
> いいという解釈で良いですか?

テキストエディタを使って、
trac wiki のページ作成、削除、編集などできた方がいい
ということです。
これに対しては、いくつか方法は浮かんでいて、
 - エディタの Trac wiki プラグイン/アドオンを使う:trac-wiki.el, VimTrac など
 - テキストブラウザを使う:w3m や emacs-w3m など
で対処できそうです。

trac wiki をオフラインでも編集できたら嬉しいですが、
trac 内に VCS を内包している感じなので、
今まで DocBook XML を svn 管理していたときのように
オフライン時に持ち出しにくいように思っています。
# オフライン時にまで Vine の作業をやるなんて、すばらしいではないか (^^


>  今は試行錯誤の段階ですが、正直、制約はあると思っています。note, warning, important
> に当たる部分をどう表記するかとか。収まるというより、収めるしかないかなと。多少の工夫
> は必要そうです。(汗)

現時点で Vine のドキュメントで使用している DocBook XML の全タグに対して、
trac wiki 記法の一覧
http://trac.vinelinux.org/wiki/WikiFormatting
のどれに対応するか、
対応表を作る必要がありそうですね。
そうすると、Vine のドキュメントを DocBook XML から trac wiki へ移行する際に、
俯瞰しやすいですね。
また、DocBook XML から trac wiki への変換 xsl も正確に作れそうですし。


>  今、とりあえず、大きく 7.x の仕様に依存しないと思われる
>
> 開発者ガイド
> http://trac.vinelinux.org/wiki/docs/developers-guide
>
> を移植中なのでここはこう表記したらいいんじゃないかとかあれば、ご教示いただけると幸いです。

この開発者ガイドを trac Wiki へ移植作業は、どのようにされていますか?
DocBook XML から trac wiki へ変換する xsl を書いておられるのでしょうか?
# たぶん、そうしないと、しんどいですよね (^^;;

--
山本 宗宏 Munehiro "munepi" Yamamoto
    Project Vine Public Relations <munepi@xxxxxxxxxxxxx>
GPG Key ID: 0xC24B55FD
GPG Key Fingerprint: 61EC 85A8 5F34 5E35 91E8  8AD0 1D28 D5DE C24B 55FD
_______________________________________________
VineSeed mailing list
VineSeed@xxxxxxxxxxxxx
http://lists.vinelinux.org/mailman/listinfo/vineseed