真・HTML help文字化け対策

真・HTML help
文字化け対策
倉澤望 (鍋太郎)
@nabetaro
真・HTML help文字化け対策 Powered by Rabbit 1.0.4

自己紹介
✓ nabetaro
✓ プログラマー
✓ Debian JP で主にドキュメント
翻訳
✓ http://about.me/nabetaro
1/21

今日のお題

✓ 索引が文字化けしないHTML
helpを配布元に作ってもらお
う

2/21

あるいは

✓ HTML help への手向けの言葉
(-人-) ﾅﾑｰ

3/21

HTML help とは
✓ Microsoft Compiled HTML
Help のこと
✓ 拡張子は .chm
✓ Windows98 からサポートされ
ている(いた)
✓ 新しいヘルプ形式に移行すると
のこと 4/21

ぶっちゃけ

✓ オワコン?
✓ 今のうちに言っておくことにす
る

5/21

HTML helpを配布している
(いた)OSS
✓ PHP
✓ MySQL (今、見つからない)
✓ TortoiseSVN
✓ 他にもあるかも
6/21

共通の悩み

✓ 日本語版chmをダウンロード
してみたら……
✓ 索引が化けてて、検索できない

7/21

よくある対処法

✓ chmをダウンロードする
✓ デコンパイルする
✓ ビルドする

ちょ、作りなおすのかよ……
8/21

ちょいまち

✓ デコンパイルして、そのままビ
ルド?
✓ 間の処理なし?

なんでそれで文字化け治るの?
9/21

TortoiseSVNでは……

✓ 文書は DocBook Lite で書か
れている

10/21

ひとつのDocBook Lite文
書から複数のフォーマット
✓ 単一HTML
✓ 複数HTML
✓ PDF
✓ HTML help
11/21

HTML help の文字化けは?

2005年12月に日本語ヘルプができてから、
2008年4月まで、索引が化けていた

✓ 本家でも問題視
✓ 日本語だけの問題ではない
12/21

使用するツールの問題?
✓ 文字化け修正に使うhhc.exe
と、本家で使っているhhc.exe
は同一
✓ 言語によって、ツールの差異は
ない
✓ 中間生成物も差異はない
13/21

環境の問題?

✓ 本家は日本語OSじゃないだろ
う
✓ 今時(当時)、言語ごとに専用
OSにするとは思えない
✓ Locale変えられるんじゃない?
14/21

コントロールパネルから

15/21

中国語のヘルプで試す

✓ そのままやると索引が化ける
✓ Localeを中国語に
✓ 中国語のヘルプで同じhhc.exe
を使っても化けない

16/21

本家に相談

✓ つたない英語でlocaleを変える
とよい事を説明
✓ MSに一時的にロケールを変え
る AppLocale があるけど
GUI で使いにくい
17/21

本家の Stefan から
✓ コマンドラインで使える
SBAppLocale ってのがある
✓ でも文書のビルドスクリプトに
詳しくないからパッチ書いて
http://www.steelbytes.com/?
mid=45
18/21

パッチ書いて送信

✓ めでたく、本家のchmも化け
なくなった

19/21

まとめ

✓ HTML help の文字化けは
Locale が原因
✓ hhc.exe実行時に Localeを変
えると良い
✓ SBAppLocaleが良さそう
20/21

まとめ

✓ みんなもパッチ書いて本家に投
げるといいと思うよ

21/21

Recomendados