真・HTML help文字化け対策

真・HTML help文字化け対策 Powered by Rabbit 1.0.4

真・HTML help文字化け対策

倉澤望 (鍋太郎) @nabetaro


自己紹介

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

Documents