Thunderbird HELP 試作版

登録日: 2004年1月 09日 記事: 552

Thunderbird のオンラインヘルプの拡張をつくってみました。

Thunderbird Help 0.1.2 (人柱版)
http://mar.skillup.jp/ThunderbirdHelp/tbh-0.1_test-2.xpi

Calender Help 0.0.2 のヘルプビュアーをベースに、いくつか修正をしています。
ロケールは en-US のみ。Win2k + Tb 0.9+(20041113) で動作確認をしています。
とりあえずエラーなしで表示できますが、あくまでも開発版なので、テスト用のプロファイルをつくるなどして試してください。

＊ヘルプを呼び出すショートカットキー(F1)は、まだ利きません。
＊文書が古いです。（1年前のもの）
＊索引はまだ空っぽです。

登録日: 2004年1月 09日 記事: 552

それっぽくなったので、試作版に昇格。 Smile

Thunderbird Help 0.1.3 (試作版)
http://mar.skillup.jp/ThunderbirdHelp/tbh-0.1_test-3.xpi

Win2k 上の Tb 0.9+(20041114) で動作確認をしています。
Help > Help Contents から呼び出してください。

変更点：
＊アドレス帳とメール作成ウィンドウのヘルプメニューにも項目を追加。
＊ヘルプメニューのアクセスキーを 'H' から 'C' に変更。
＊ツールバーのアイコンを FirefoxHelp から拝借。
＊スクリプトもいくつか拝借。
＊ja-JP ロケールを追加。
＊キーボードショートカットのページを更新。

不具合：
警告が出てページ内のリンクが利かない。
0.9 リリース版にインストールすると、JavaScript コンソールにエラーがでる。
ヘルプを呼び出すショートカットキー(F1) は、何故かメール作成ウィンドウでは有効になる。
肝心のヘルプの内容が足りない。

登録日: 2004年11月 06日 記事: 45 所在地: Japan

tbh-0.1_test-2.xpi をThunderbird 0.9 + Pink 版JLPで日本語化 win2k の環境で試してみましたが、英語のままという以外は大きな問題はありませんでした。
明日にでも tbh-0.1_test-3.xpi でも試してみます。

文書の元は Documentation - Mozilla Help Viewer Project の thunderbird のところにあるものでしょうか。

登録日: 2004年1月 09日 記事: 552

Pink さん、ご報告ありがとうございます。

Pink wrote:

tbh-0.1_test-2.xpi をThunderbird 0.9 + Pink 版JLPで日本語化 win2k の環境で試してみましたが、英語のままという以外は大きな問題はありませんでした。
明日にでも tbh-0.1_test-3.xpi でも試してみます。

今日か明日ぐらいに 0.1.4 を出します。
致命的なエラーは無いと思いますが、JavaScript コンソールを開きながら確認していただけるとありがたいです。

Pink wrote:

文書の元は Documentation - Mozilla Help Viewer Project の thunderbird のところにあるものでしょうか。

そうです。元の拡張 (tbh-0.1.xpi) も、ついこの間までそこに放置されていたものです。
キーボードショートカットだけは Thunderbird Help のページを見ながら更新しました。

登録日: 2004年1月 09日 記事: 552

Thunderbird Help 0.1.4 (試作版)
http://mar.skillup.jp/ThunderbirdHelp/tbh-0.1_test-4.xpi

変更点：
＊目次のリンク切れを修正。
＊ページのリロード機能がうまくいかないので無効化。
＊ja-JP ロケールの文書を和訳。
＊"How To Share Mail Between Windows and Linux" を勝手に追加。(未訳)
＊"Using the Help Window" を FirefoxHelp からコピーして更新。
＊目次と索引を整理。
＊その他修正。

和訳文書の用語とかコマンドは JLP を確認していないので所々違うと思います。
あとは、本家のナイトリービルドにあわせながら先のバグを修正していくだけです。
#かなり厄介ですが Confused

追記(11/18,18:00)：
ja-JP ロケール内のファイルで UTF-8 に変換し忘れたものがあったので差し換えました。

登録日: 2004年1月 09日 記事: 552

Thunderbird Help 0.1.5 (試作版)
http://mar.skillup.jp/ThunderbirdHelp/tbh-0.1_test-5.xpi

変更点：
＊ヘルプを呼び出すショートカットキー(F1) が利かないバグを修正。
＊"How To Share Mail Between Windows and Linux" を和訳。
＊用語等を修正。
＊その他修正。

ページ内のリンクが利かないバグは修正の目処が立っていません。
Thunderbird 本体の変更が必要そうな気がしますが、セキュリティーホールにならないようにしたいので、思い切って無効化したほうがいいでしょうか？

#リンク。
[Bug-org 253334]Thunderbird needs a Help Viewer
http://www.geocities.jp/chimantaea_mirabilis/ThunderbirdHelp/

登録日: 2004年1月 09日 記事: 552

本家の [Bug 253334] へ test-5 をコミットしました。(bugzilla 初投稿 Smile

)
一応、ja-JP ロケールは抜いてあります。

動作報告やご意見などは、引き続きこのトピックでも受け付けます。m(_ _)m

登録日: 2004年1月 09日 記事: 552

Thunderbird Help 0.1.6 (試作版)
http://mar.skillup.jp/ThunderbirdHelp/tbh-0.1_test-6.xpi

変更点：
＊ Trunk build 1.0+(20050402) に対応。
＊ツールバーのカスタマイズを完了すると JavaScript コンソールにエラーが出る問題を修正。

ヘルプ文書のほうも少しずつ出来てきているようです。
英語で書ける方は、ぜひ参加してください。
Thunderbird:Help Documentation:Base

登録日: 2004年1月 09日 記事: 552

Thunderbird Help 0.2.2 (試作版)
http://mar.skillup.jp/ThunderbirdHelp/tbh-0.2_test-2.xpi

Thunderbird Help Viewer

主な変更点：
＊ソースコードを Firefox のヘルプビューアに合わせて入れ替え。
＊1.8 branch build の 2.0a1(20060504) に対応。
＊ページ内リンクのために、[bug 320628] のパッチを適用。
＊一時的に、"gFindBar.initFindBar();" を "initFindBar();" に修正。

バグ：
＊ページの履歴が使えない。

Code:

Error: uncaught exception: [Exception... "Invalid InterfaceID" nsresult: "0x80570018 (NS_ERROR_XPC_BAD_IID)" location: "JS frame :: chrome://help/content/help.js :: init :: line 105" data: no]

help.js の該当行

Code:

102: // Initialize history.
103: getWebNavigation().sessionHistory =
104: Components.classes["@mozilla.org/browser/shistory;1"]
105: .createInstance(Components.interfaces.nsISHistory);
106: window.XULBrowserWindow = new nsHelpStatusHandler();

Firefox ではセッションヒストリーの初期化ができるのに、
Thunderbird では仕方が違うか、本体のコードが追いついてないのでしょうか？

#J.Walden 氏のおかげで、Thunderbird に Help Viewer のための修正がかなり入ってます。 Smile

#FAYT とか、Help toolkit の汎用化とか・・・

登録日: 2004年1月 09日 記事: 552

Thunderbird Help 0.2.3 (試作版)
http://mar.skillup.jp/ThunderbirdHelp/tbh-0.2_test-3.xpi

Thunderbird Help Viewer

主な変更点：
＊1.8 branch build の 2.0a1(20060524) に対応。
＊"initFindBar();" を "gFindBar.initFindBar();" に戻した。
＊メニューの追加位置を変更。
＊本家の作成作業中の文書を追加。
　(Welcome page, Menu Reference, Keyboard Shortcuts, Managing Your Accounts)
＊追加した文書を 2.0a1 に合わせて勝手に修正。

その他：
追加した文書は未訳＆未完成です。
キーボードショートカットの一覧は、Obsolete な方の文書と合わせて整理しました。
索引ファイル(thunderbird-index1.rdf) には手を付けていません。
platformClasses.css は、Win2k の環境なので

Quote:

.noWin, .mac, .unix { display: none; }

になっています。

登録日: 2004年1月 09日 記事: 552

Thunderbird Help 0.2.4 (試作版)
http://mar.withfirefox.org/ThunderbirdHelp/tbh-0.2_test-4.xpi

#こっちに投稿し忘れ

主な変更点：
＊ 1.8 branch build 2.0a1(2006070504) に対応。
＊本家 mozilla Wiki の 2006-07-05 現在の文書を追加。
(Using the Address Book, Connecting to an LDAP address book )
＊追加した文書を Thunderbird 2.0a1 に合わせて修正。(未訳・未完成)

Thunderbird には nsISHistory が定義されていないらしいのですが、
ここらへんの事情をどなたかご存知ないですか？
[Bug 340669] nsISHistory required for View Source (undefined for Thunderbird)

登録日: 2006年9月 25日 記事: 693

mar wrote:

Thunderbird には nsISHistory が定義されていないらしいのですが、
ここらへんの事情をどなたかご存知ないですか？

そのうち書こうと思っている間にすっかり時間が経ってしまって、今でも意味があるのか不明ですが

Windows 版では、ビルドされた全てのファイルがインストーラ版や ZIP 版に含められているわけではなくて、必要なファイルのみを取り出して作られているのですが、その取り出すファイルのリストに、nsISHistory の定義が入ったファイルが含められていないためです。

# なんでリストに含められていないのかは、単に本体では使ってないからじゃないかと。

具体的には shistory.xpt というタイプライブラリファイルなのですが、Windows 版のパッケージングの過程で取り除かれているだけなので、Linux 版には入っていたりします。
また、このファイルは、本体側にある必要はなく、拡張側で持つこともできるので、Linux 版の Thunderbird から取り出したファイルを、拡張に含めれば Windows でも問題なく使えるはずです。

ただし nsISHistory の定義が、Thunderbird 2 と、今の trunk とでは違っているので、このファイルを拡張に含める場合は、2.0.0.* 用と trunk 用では含めるべき shistory.xpt が違います。
つまり、ひとつの拡張で両方に対応することはできません。
(両方含めておいて、バージョン判別して片方だけインストールするようなスクリプトを作れば、不可能ではないですが…)

なお、似たような話として、 DOM Inspector に必要なタイプライブラリファイルは、Firefox では本体と一緒に配布されているのですが、Thunderbird では上記の「取り出すファイルリスト」に含まれていません。
そのため DOM Inspector for Thunderbird and Sunbird のうち Thunderbird 用には、上記のように必要なタイプライブラリを Thunderbird Linux 版から抜き出して、拡張機能側に含めています。
Firefox では 2 と trunk 両対応のものがあるのに、Thunderbird 2 と trunk 両対応のものがないのは、そのへんが原因の根っこだったりします。

登録日: 2004年1月 09日 記事: 552

あ wrote:

具体的には shistory.xpt というタイプライブラリファイルなのですが、Windows 版のパッケージングの過程で取り除かれているだけなので、Linux 版には入っていたりします。
また、このファイルは、本体側にある必要はなく、拡張側で持つこともできるので、Linux 版の Thunderbird から取り出したファイルを、拡張に含めれば Windows でも問題なく使えるはずです。

情報ありがとうございます。
しばらく放置してましたが、またやってみようと思います。
# 最初に手をつけたときは Thunderbird 2.0 に入ったらいいなとか思ってましたが、ついにリリースされてしまいました。 Laughing

あ wrote:

ただし nsISHistory の定義が、Thunderbird 2 と、今の trunk とでは違っているので、このファイルを拡張に含める場合は、2.0.0.* 用と trunk 用では含めるべき shistory.xpt が違います。
つまり、ひとつの拡張で両方に対応することはできません。
(両方含めておいて、バージョン判別して片方だけインストールするようなスクリプトを作れば、不可能ではないですが…)

内蔵ヘルプですから両対応にはしません。※
Branch と Trunk よりも、Firefox と Thunderbird で共通のコンポーネントを使うことのほうが重要なのです。

※追記：
試作版 0.2.4 が [1.6.* ～ 3.0.*] 対応になってますが、現在の Trunk には対応していません。

登録日: 2004年1月 09日 記事: 552

Thunderbird Help 0.2.5 (試作版)

主な変更点：
＊ 1.8 branch build 2.0.0.4pre(2007042603) に対応。（2.0 リリースでも動作確認済み）
＊ Linux版(2007-04-23)の shistory.xpt を同梱。

shistory.xpt を同梱したら、Windows でも履歴が使えるようになりました。
あさん、ありがとうございます。 Very Happy