Firefox HELP へのフィードバック

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

Firefox に内蔵の日本語版 HELP へのご意見等はこちらにお願いします。

日本語版の作業ファイルのページ

http://www.geocities.jp/chimantaea_mirabilis/FirefoxHelp/
本家 HELP のバグ

http://www.mozilla.org/projects/help-viewer/bugs.php

Firefox 1.0 以降の日本語版 HELP を引き継いでくれる方も募集します。

追記1:
常駐トピックに変更 by dynamis
追記2:
SUMO については下記フォーラムで扱うことになったため一般トピックに戻しました - by dynamis
http://forums.firehacks.org/trans/viewforum.php?f=30

ゲスト

Quote:

内部のスタイルシートなしで表示すると Win, Mac, Unix ごとの記述がすべて表示されてしまいます。

といわれたわけですが、
1.0.7リリースの付属のものをメニューから開いたわけだから、
このヘルプ自体がまともに働いていないと判断するのが正しいんでしょうか。

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

（Firefox ヘルプについての続き）

Quote:

Firefoxヘルプの「用語の違い」に「対象をファイルに保存リンクをディスクにダウンロード」
とあるのが、これは(バージョンによる差異?)別々の2つが一緒になっているように思える

---------------

うーむ。
手元の環境（Windows 2000 SP4 + Firefox 1.0.7）では、
新規プロファイルを作成してみましたが再現しませんでした。
Mozilla/5.0 (Windows; U; Windows NT 5.0; ja-JP; rv:1.7.12) Gecko/20050915

お使いの OS は何でしょうか？

この仕組みは全言語共通なので、英語版でも同じです。
日本語版についても、1.0.x リリースでは、言語パックの修正が許可されていないそうなので、
ヘルプファイルは、1.0 から 1.0.7 まで、すべて同じはずです。

以前のバージョンではどうでしたか？

ゲスト

テーマ変えたら再現しますね。
他は同じ環境です

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

Firefox ヘルプにつ� wrote:

テーマ変えたら再現しますね。
他は同じ環境です

もしかしたら、そのテーマが原因かも。
テーマは何ですか？

#再現条件を書いていただければ、他の人でもテストできるので、
#当たり前のことでも詳しく書いていただけるとありがたいです。

ゲスト

walnutで確実に再現しています。
walnut_for_firefox-1.0.9-fx.jar
他は知りません

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

Firefox ヘルプにつ� wrote:

walnutで確実に再現しています。
walnut_for_firefox-1.0.9-fx.jar
他は知りません

walnut_for_firefox-1.0.22-fx.jar で確認しました。
やはり、テーマのせいでした。

walnut のテーマに含まれる /help/helpFileLayout.css が、
Firefox本体の /help/helpFileLayout.css を置き換えているのですが、
walnut の方には、肝心の

Code:

@import url('chrome://help/content/platformClasses.css');

の行がありませんでした。

このファイル(platformClasses.css')が、ヘルプ中のOS別の記述を決めています。
Windows 版では、下記のようになっています。

Code:

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

テーマ作者への連絡先がないので、Mozilla Update の方に書いときました。 Wink

https://addons.mozilla.org/themes/moreinfo.php?id=122

Alfred's Themes - Walnut
http://www.geocities.com/AlfredKayser/mozilla/walnut.htm

登録日: 2003年10月 05日 記事: 1744

現在ヘルプ注で使用されている UI 文字列(など？)は em で強調表示されているようで、斜体になっていますが、やはり日本語を斜体で表示するのは好ましくない気がします。
かといって太字にすると strong が使用されている項目名(など？)と区別がつかなくなってしまうので困ったところなのですが、先日から(JLP 的には 1.0.20~)

Code:

p em:before, dd em:before, li em:before { content: "@@[@@"; }
p em:after, dd em:after, li em:after { content: "@@]@@"; }

によって他の場所同様に [UI 文字列] と括られるようになりました。
# 括弧記号は OS 別切り分け対象
括弧が着くことで区別は十分につくと思われるので、フォントのスタイルは normal に戻してしまった方が読みやすいのではないでしょうか。

Code:

p em, dd em, li em { font-style: normal; }
p em:before, dd em:before, li em:before { content: "@@[@@"; }
p em:after, dd em:after, li em:after { content: "@@]@@"; }

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

dynamis wrote:

括弧が着くことで区別は十分につくと思われるので、フォントのスタイルは normal に戻してしまった方が読みやすいのではないでしょうか。

Code:

p em, dd em, li em { font-style: normal; }
p em:before, dd em:before, li em:before { content: "@@[@@"; }
p em:after, dd em:after, li em:after { content: "@@]@@"; }

フォントのスタイルを normal にしてみました。

Code:

em { font-style: normal; }

オプションのヘルプ(prefs.xhtml) で、
オプション名が見出しにのようになっているところにまで
[ ] が付いてしまうのが気になりますが、どうなんでしょう。

↓ のあとに が入るような行

Code:

<h3 id="privacy_saved_forms">フォームデータ</h3>
Web ページのフォームや検索バーに入力した内容を保存する 
Web フォームに入力した情報は &brandShortName; に記憶され、

登録日: 2003年10月 05日 記事: 1744

mar wrote:

dynamis wrote:

括弧が着くことで区別は十分につくと思われるので、フォントのスタイルは normal に戻してしまった方が読みやすいのではないでしょうか。

Code:

p em, dd em, li em { font-style: normal; }
p em:before, dd em:before, li em:before { content: "@@[@@"; }
p em:after, dd em:after, li em:after { content: "@@]@@"; }

フォントのスタイルを normal にしてみました。

Code:

em { font-style: normal; }

いただいたパッチを適用し、normal になったことを確認しました。

mar wrote:

オプションのヘルプ(prefs.xhtml) で、
オプション名が見出しにのようになっているところにまで
[ ] が付いてしまうのが気になりますが、どうなんでしょう。

↓ のあとに が入るような行

Code:

<h3 id="privacy_saved_forms">フォームデータ</h3>
Web ページのフォームや検索バーに入力した内容を保存する 
Web フォームに入力した情報は &brandShortName; に記憶され、

少し整理すると
「インターネットに直接接続する」や「自動的に更新をダウンロードしてインストールする」あるいは JavaScript 詳細設定の「ウィンドウの移動または大きさの変更」などは <dt> であり、太字になっていますね。これらは最上位の radiobotton に対してのみということかな？

 が使われて太字になっているのは、続けてコロンが来る場合を含め、行内で強調したい時みたいですね。

そして、それ以外の場合の UI 文字列に となっているようですね。

個人的趣味としては、<dt> になっているものも になっているものも UI 文字列なのだから、書式が揃っていて欲しいです。 mar さんが気にされているとおりタイトル形式になっているものを [] でくくるというのは違和感があるということも踏まえると
・ string は [string] ではなく string
あるいは
・ string は [string] ではなく string で、 <dt>string</dt> も string ではなく string
などと表題になっている UI 文字列のスタイルが統一されている方が好きです。

実際には影響の大きさなどからしても前者かなぁ。
ただ、CSS に前方参照(次の要素が～といった条件)ってなかったような気がします。私の思いつく範囲では html 側の修正無しで実現不能です。

html 側について string を string とした上で

Code:

p em.uiHeader, dd em.uiHeader, li em.uiHeader { font-weight: bold; }
p em.uiHeader:before, dd em.uiHeader:before, li em.uiHeader:before { content: ""; }
p em.uiHeader:after, dd em.uiHeader:after, li em.uiHeader:after { content: ""; }

をスタイルに追加するのが一番副作用が少ないかな？
# 個人的には UI 文字列を でなく にする時点で help の筆者に共感できてなかったりするので、いっそそれ以外の すべてに としてしまいたい気分もあるけど、余計なことは控えましょう…(^^;

ゲスト

御苦労様です。
firefox-1.5.ja.langpack-1.0.22.xpi
些細なことですが、"Helpへようこそ" で "ヘルプウィンドウを使う" のリンクが機能していません。

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

RGV wrote:

些細なことですが、"Helpへようこそ" で "ヘルプウィンドウを使う" のリンクが機能していません。

ご指摘ありがとうございます。修正しました。

dynamis wrote:

# 個人的には UI 文字列を でなく にする時点で help の筆者に共感できてなかったりするので、いっそそれ以外の すべてに としてしまいたい気分もあるけど、余計なことは控えましょう…(^^;

タグを全部書き換えてしまいたいところですが、結局そのままです。 Rolling Eyes

ゲスト

mar wrote:

RGV wrote:

些細なことですが、"Helpへようこそ" で "ヘルプウィンドウを使う" のリンクが機能していません。

ご指摘ありがとうございます。修正しました。

JLP 1.0.23 にて反映を確認しました。御苦労様でした。

1.5b2 Mac です。

ヘルプを起動すると最初にコンテンツ部に表示されるのに目次では2番目です。（1番目は「ヘルプウインドウを使う」）
これはこういうものなのでしょうか？

あと「〜へようこそ」って、あまり使わないと思います。観光地の入口にある看板みたい。コンピュータの世界ではしばしば見かけるのでみなさん違和感が無いのかな…？
目次やタイトルでは「はじめに」、文章中の場合は「Mozilla Firefox をご利用いただきありがとうございます。」などがいいんじゃないかと思いました。

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

Anonymous wrote:

ヘルプを起動すると最初にコンテンツ部に表示されるのに目次では2番目です。（1番目は「ヘルプウインドウを使う」）
これはこういうものなのでしょうか？

ソース内部の事情で、「ヘルプウインドウを使う」のページとそれ以外のページが
別々のディレクトリに収められているため、こういう順番になっています。
（help.rdf で指定されています。）

もう少し詳しく書くと、「ヘルプウインドウを使う」のページはヘルプツールキットの一部なので、
拡張機能がヘルプウインドウを利用すると、このページが目次に含まれるようになっています。

Anonymous wrote:

あと「～へようこそ」って、あまり使わないと思います。観光地の入口にある看板みたい。コンピュータの世界ではしばしば見かけるのでみなさん違和感が無いのかな…？
目次やタイトルでは「はじめに」、文章中の場合は「Mozilla Firefox をご利用いただきありがとうございます。」などがいいんじゃないかと思いました。

この個所は直訳です。（原文では "Welcome to Mozilla Firefox Help" ）
英語のアプリケーションのヘルプは "Welcome to ~" か "What's ~" が多いので、
翻訳したヘルプに多い、決まり文句みたいなものですね。

日本語が原文のヘルプでは「はじめに」が多いようですが、
タイトルに &brandFullName; (Mozilla Firefox) が入ってるので、削っていいものかどうか・・・
#マーケティングに関わるような Confused