ヘルプメンテナンスガイドライン
ヘルプファイルのメンテに参加いただける人向けに,ガイドライン案をまとめました.
ヘルプファイルソースについて
- ヘルプのソースは次の理由により,ヘルプましん(うな氏)の形式で管理します.
- MicrosoftのHTML Help Workshopで作成するHHPファイルにはバグがある.
- ヘルプましん以外に使いやすいヘルプ作成ツールを見かけない.
修正や変更の配布
ファイル単位で差し替え
差分ファイルで配布
- help/trunkの作業コピーをローカルに用意できる方なら,svn差分は簡単に作成できるでしょう.もしくはDiff差分とか.ただしバイナリの変更を伴う修正の場合は,無理に差分ファイルにこだわる必要はないと思います.
Subversion(コミット権限のある人)
- サクラエディタ本体の開発と違い,ドキュメントのバグがクリティカルな障害を招くことも少ないでしょうから,いきなりコミットしても良いと思います.
むしろ更新停滞するほうがデメリット
- TortoiseSVNを使う人のためのconfig例です.
[auto-props]
*.hh = svn:eol-style=native;svn:mime-type=text/plain
*.txt = svn:eol-style=native;svn:mime-type=text/plain
*.png = svn:mime-type=image/png
*.html = svn:eol-style=native;svn:mime-type=text/html
*.css = svn:eol-style=native;svn:mime-type=text/css
*.XHP = svn:eol-style=CRLF;svn:mime-type=text/plain
*.XHC = svn:mime-type=application/octet-stream
配布方法
- wikiのDocument
- 編集したhtmlファイルやpngファイルをそのまま添付して頂いて結構です.もちろん差分ファイルも可です.
- 画像ファイル,コンパイル済みサンプルなどでもOKです.とくに制限は考えておりません.
- 新機能対応時のコンテンツのみの提供(wiki形式など)でも構いません.動作を確認して説明文をまとめていただけるだけでも,ずいぶん助かります.ついでに新機能レビューとしていち早くユーザーに紹介できるので,何かと便利.
- sourceforge.netのpatches
- 差分ファイルを投稿する場所ですから,あまりヘルプ開発向きではありませんが,修正の内容次第で各自判断とします.
- 最低限ヘルプの修正であることが分かるようSummaryに明示してください.エディタ本体のソースコードの修正と紛らわしいので.
その他注意事項
- いまのところ,画像ファイルは次のように統一しています.
- ファイル形式:png
- 色数:4bit(16色)
- ウィンドウとボタン:Windows クラシック スタイル
- 配色: Windows クラシック
- フォントサイズ:標準
- タイトルバーは"RGB=(0,0,128),グラデーションなし" でキャプチャする
- ヘルプましんのプロジェクトファイル(*.XHP)は,開くだけで内容が書き換わります.プロジェクトファイル(*.XHP)やコンテンツファイル(*.XHC)のフルパスを記録しているためです.公開時は該当行を削除することをお勧めします.