エンジョイブラウザ説明書

この文書は、日韓翻訳掲示板 GoKorea / KJ CLUB の閲覧を支援するMozillaアドオン『エンジョイブラウザ』 Version 2.0系 β版の説明書です。 バージョンアップにより、この文書内容と実際が一致しなくなる可能性があります。 なお、このアドオンに関連した問題・損害等が発生しても、開発者は一切の責任を負いません。

目次

• 第一章 主要機能の概略
• 第二章 オプション設定ウインドウ
• 第三章 エンジョイブラウザ サイドバー
• 第四章 テーマ開発・カスタムスタイル
• 第五章 ＦＡＱ
• 第六章 雑記

主要機能の概略の目次

• ログイン機能で快適スタート
• 翻訳掲示板の閲覧を快適にする
• 迷惑ユーザーを消してしまう「あぼ～ん」
• 不正行為から利用者を防御する「クラッシュブレーカー」
• 便利機能で快適投稿
• ツールバーボタンで簡単アクセス
• サイドバーで簡単アクセス

ログイン機能で快適スタート

ボタンを一回押すだけでログインできる便利機能です。IDとパスワードをその都度入力する煩わしがなくなります。

翻訳掲示板の閲覧を快適にする

スタイル(スキン)機能による外観変更機能

迷惑ユーザーを消してしまう「あぼ～ん」

掲示板には、連投を行ったり、ただ罵倒を繰り返すだけの迷惑なユーザーが存在します。

エンジョイブラウザでは迷惑ユーザーを表示から消してしまうことができます。

また、気に入ったユーザーを強調表示することもできます。

フィルタ対象ID/ニックネームの設定

不正行為から利用者を防御する「クラッシュブレーカー」

KJCLUBやGOKOREAには極めて深刻な脆弱性があります。

この機能を有効にすると、不正手段で登録情報を盗まれたり、ID自体の盗難を防げるかもしれません。

他に、閲覧妨害コメントなどを除去したり、既知のウイルスやグロテスク画像のスレッドを排除できます。

便利機能で快適投稿

以上のほかに、翻訳掲示板でコミュニケーションをする上で便利な機能がたくさんあります。

簡易翻訳

数値文字参照変換

ツールバーボタンで簡単アクセス

ツールバー

ツールバーボタン サイドバー開閉ボタン エンジョイブラウザのサイドバーを開閉するボタンです。詳しくは、サイドバーで簡単アクセスを参照。 なお、第2ボタン等を押すことでメニューを開くことができます。ドロップダウンメニューにはオプション設定やフィルタリング ユーザーIDリストやあぼーんのON/OFFを切り替えるスイッチがあります。

ツールバーへの登録方法

サイドバーで簡単アクセス

サイドバー

サイドバーを使用することで、主要掲示板やサービスへ簡単にアクセスすることが出来ます。 サイドバーでできること カテゴリーリスト 掲示板カテゴリーや主要ページに簡単にアクセスできます。 ログイン GoKorea/KJClubへのログイン機能です。 フィルタ フィルタ対象のID/ニックネームを登録・管理することができます。 エンブラ中央チャット エンブラユーザー同士がリアルタイムで会話できる機能です。翻訳チャット機能も搭載されています。 簡易翻訳 日本語と韓国語を相互翻訳する機能です。 数値文字参照変換 特殊文字を数値文字に変換します。投稿時にこのコードを使用することで、翻訳されずに相手へ伝わります。

サイドバーの開閉方法

オプション設定ウインドウの目次

• 一般オプション
• スタイル (スキン)
• ヘルプ

一般オプション

一般オプション

一般オプション2

サイドバー設定

フィルタリングの基本設定

安全な閲覧設定

スタイル (スキン)

スタイル(スキン)を使用することで、表示デザインを変えることが出来ます。

Firefoxのテーマ機能を組み合わせることで、さらに多彩なブラウジングをすることが出来ます。

基本スタイル

カスタムスタイル

ヘルプ

追加機能のインストール

携帯電話との連携

翻訳掲示板／チャット選択タブ

各機能タブ

ログイン

掲示板にログインする機能です。

掲示板のユーザーIDを獲得していないときは、先に掲示板サイトでユーザーID獲得の手続きをする必要があります。

翻訳掲示板 ／ 知識と交流

翻訳掲示板の掲示板カテゴリーです。

カテゴリー別のルールや主題にあった発言・行動をする必要があります。

フィルタ

迷惑行為者を登録する機能です。

「一般」に登録すると、その者のスレッドは - abone - 表示になって見えなくなります。

「完全」に登録すると、その者のスレッドは除去されます。

「マーク」に登録すると、その者のID等が強調表示されて、探しやすくなります。

簡易翻訳

「日→韓」もしくは「韓→日」にテキストを翻訳できます。

数値文字参照変換

テキストをHTTP Entities文字列に変換できます。

この変換を行った文字をコメントなどで使用すると、翻訳が実行されずにそのまま相手(韓国側)へと表示させることができます。

KJCLUBの高機能スレッド編集時などでは、この変換の効果がない場合があります。

エンブラ中央チャット

サイドバーの「Chat」タブを開くと、「エンブラ中央チャット」というチャットサービスが開きます。

このチャットでエンブラ利用者との情報交換を行うことができます。

このチャットには携帯のブラウザから接続することもできます。携帯からの接続については、エンブラのオプション設定の「ヘルプ」→「携帯電話との連携」を参照してください。

セッションリセット

概略

KJCLUBの掲示板サービスは、アクセス集中等の理由でたまに接続ができなくなります。その時は、「セッションリセット」という作業を行うことで、接続を回復できることがあります。

方法

サイドバーの「KJCLUB」タブの上にポインターを置き、マウスの第2ボタンを押してポップアップメニューを開いて、「セッションリセット」を選択します。

この作業を行ったあと、再度掲示板に接続してみてください。

それでもダメなときは?

セッションリセットをおこなっても問題が解消できないときは、ブラウザの再起動やシステムの再起動で解消できることがあります。

何をしてもだめなときは、KJCLUBで本格的なトラブルが発生している可能性があります。チャット等で情報交換でもしながら、トラブル解消までマターリとお待ちください。

エンジョイブラウザでは、エンブラサイドバーやスレッド一覧・スレッド内容等の外観を変更することができます。

この章では、基本的な外観を提供するテーマを作成するための技術情報が記述してあります。

必要のない方は読まずに次章のＦＡＱまで飛んでしまいましょう。

基本事項

初めての方はイメージをつかんでもらうために、テーマのテンプレートを覗いてみてください。→ これがエンブラのテーマ構造の基本です。

背景事情を考慮願います

• 現在のエンブラは(特に拡張ブラウジングにおいては)、各掲示板サイトのHTML文書に介入を行い、修正等を行った結果のHTMLを表示しています。
• エンブラはその際、テーマ等による表示介入の簡便化を目的に、主要なHTML要素に特定のidもしくはclass属性等を割り当てています。
• テーマはこの属性を指標に、主にカスケードスタイルシート(CSS)を使用して、外観を構築します。
• 拡張ブラウジング用の基本的なスタイルは、すでに構築されています。テーマ作成では、この基本スタイルを元に変更部分のみ記述するという手法を使います。
• 各翻訳掲示板がすでに使用しているスタイルや属性値が、エンブラの表示において影響を与えますので、それを考慮した設計をする必要があります。

仕様変更に注意

• 将来の掲示板サイト仕様変更により、属性値や基礎的な外観変更が発生する可能性があります。
• 現在のエンジョイブラウザーはβ版です。属性値等の仕様変更が発生する可能性があります。

カスケードスタイルシート(CSS)の記述方法

基本事項

• カスケードスタイルシート(CSS)の基本的なリファレンスに関しては、各解説サイトを参照してください。
• 基本的に、CSS2で規定されている「属性セレクタ」(Attribute selectors)を使用します。これ以外の方法での記述は推奨しません。
• スタイル値の記述においては基本的に、 !important を使用して、オーバーライトを強制してください。( color: red !important; のように記述 )
• スタイルシート内で重複してスタイルが指示されたときは、後方に記述されたスタイル指示が優先されます。
• テーマ開発に際して、Mozilla固有のスタイルである「CSS Mozilla 拡張仕様」も使用可能です。
• カスケードスタイルシート(CSS)の文字コードはUTF-8です(BOMあり)。SHIFT-JIS等の使用は推奨しません。

基本的な記述具体例

例: id="sample" に対してのスタイルを指定する場合。

非推奨: #sample { }

推奨: [id="sample"] { }

☞ 旧来のセレクタではなく、CSS2の属性セレクタを使用する。

例: class="sample" に対してのスタイルを指定する場合。

非推奨: .sample { }

推奨: [class="sample"] { }

☞ クラスに関しても旧来のセレクタではなく、CSS2の属性セレクタを使用する。

例: <table id="sample"> に対してのスタイルを指定する場合。

非推奨: table#sample { }

非推奨: #sample { }

非推奨: table[id="sample"] { }

推奨: [id="sample"] { }

☞ すでに属性値が割り当てられているタグに対しては、基本的にタグ名による二重限定は行わない。また、属性セレクタを使用する。

例: id="sample" に対して、赤色のテキストを指定する場合。

非推奨: [id="sample"] { color:red; }

推奨: [id="sample"] { color:red !important; }

☞ スタイルの使用を強制してください。

例: rgbaを使用して50%透過の白背景色指定する場合。

非推奨: { background-color: rgba(255,255,255,0.5) !important; }

推奨: { background-color: rgb(255,255,255) !important; background-color: rgba(255,255,255,0.5) !important; }

☞ アルファブレンドカラー指定(rgba)が使用できるのは、Firefox3.0以降のみ。互換性を考慮した記述をする。

デバッグの方法

W3C CSS Validation Serviceを使用すると効果的です。

このValidation Serviceを使用するときは、 @-moz-document 部分は除去し、@-moz-document ....... { ～ } 内部の 「～」の部分のみ貼り付けてチェックを実施してください。(そうしないと構文エラーがでます)

Mozilla固有の物やrgba等、このチェッカで対応していない物に関しては警告がでます。

テンプレート集

簡単な改造でテーマを作ることができるテンプレート集です。

• スレッド一覧に背景画像を表示するテーマ

参考

• W3CWorking Draft - Selectors
• CSSセレクタに関するおさらい
• MDC CSS
• MDC CSS リファレンス
• MDC CSS Mozilla 拡張仕様

テーマのファイル構造

ファイル・フォルダ名には1バイト系文字のみ使用可能。(日本語・ハングル等使用不可)

  /my_theme      フォルダ。名前は任意
    theme.css    エンブラテーマを記述したスタイルシート
    preview.jpg   プレビュー画像(幅320ドットを推奨)
    ...

theme.cssとpreview.jpg以外には、そのテーマで他に使用するリソース(画像等)を含めることになります。

(※β版注 将来、theme.xml というテーマ情報を記述したファイルを含めることが推奨になる可能性があります)

拡張ブラウジングと標準ブラウジングの違いについて

(この項目は、まだ未記述)

翻訳掲示板文書介入に関する情報

基本事項

翻訳掲示板文書(スレッド一覧および内容)は、各掲示板の文書を元にしたHTML(HyperText Markup Language)です。

前述の各事項に従ってスタイルを記述します。

基本記述

以下のように介入対象文書を限定し、この括弧内にCSSを記述します。

@-moz-document
	url-prefix(http://www.gokorea.jp/),
	url-prefix(http://www.gojapan.com/),
	url-prefix(http://www.kjclub.com/)
{

}

以後、翻訳掲示板文書介入に関するスタイル記述は、上記括弧内に記述されているものとします。

W3C CSS Validation Serviceを使用してデバッグするときは、{ } の内部のみをチェッカにかけてください。

各構成部に介入するためのid,class等の情報

現在のエンブラはβ1版です。まだ未確定のため、記載内容は保証しません。

idとclassで、"enjoy_" と書いてある部分は、おそらくこのま確定になります。

各要素が論理的な包合関係になっていないのは、各掲示板の構造がそうなっているためです。将来、包合関係が変更される可能性があります。

[id="enjoy_body"]

エンブラテーマが処理対象とする領域です。

[id="enjoy_navigation"]

文書カテゴリー表題とリンクを含んだ装飾的なヘッダ部です。

[id="enjoy_categoryheader"]

カテゴリー説明を記述した文書です。エンブラの設定によっては、この部分が除去されます。

[id="enjoy_searchheader"]

検索フォームや移動リンクを含んだヘッダ部です。

[id="enjoy_thread_header"]

[class="enjoy_thread_header"]

[id="enjoy_thread"]

スレッド内容です。

[id="enjoy_thread_body"]

スレッド内容です。

[id="enjoy_thread_transarea"]

スレッド内容の翻訳結果の部分です。

[id="enjoy_commentlist"]

コメントリストの部分です。

[id="enjoy_threadlist_header"]

スレッドリストのヘッダ部です。

[column="enjoy_column_number_header"]

[column="enjoy_column_title_header"]

[column="enjoy_column_userid_header"]

[column="enjoy_column_date_header"]

[column="enjoy_column_hit_header"]

[column="enjoy_column_updown_header"]

[id="enjoy_threadlist"]

スレッドリストの内容部です。

[id="enjoy_threadlist_body"]

スレッドリストの内容部です。

[class="enjoy_threadleaf"]

スレッドリストの各リーフです。

• [username="ニックネーム"]
• [userid="ユーザーID"]
• [nation="国籍(jp/kr)"]
• [mark="マーク状態(true/false)"]
• [abone="一般除去状態(true/false)"]
• [perfect="完全除去状態(true/false)"]
• [stripe="縞々表示のためのストライプ状態(0/1交互)"]

[column="enjoy_column_number"]

スレッド番号のカラムです。スレッド実番号と違い、スレッド削除等で数値が変化することに留意してください。

[column="enjoy_column_title"]

スレッドのタイトルとリンクを含んだカラムです。

[column="enjoy_column_userid"]

ユーザー名のカラムです。通常はニックネーム表示です。エンブラ設定により、ユーザーID表示に切り替えられます。

[column="enjoy_column_date"]

日付のカラムです。Gokorea/GoJapanでは「年/月/日」表示。KJでは「月/日」表示です。

[column="enjoy_column_hit"]

ヒット数のカラムです。

[column="enjoy_column_updown"]

推奨／非推奨のカラムです。GoKorea/GoJapan/同好会には存在しません。

[class="enjoy_threadleaf_border"]

スレッドリーフ間を分離するボーダー部です。GoKorea/GoJapanでは存在しません。

サイドバー介入に関する情報

基本事項

サイドバー文書の形式は、XUL(ズール／XML User Interface Language)です。

タグ名が違うだけでスタイルシートの記述方法に変化はありません。基本的には前述の各事項に従ってスタイルを記述します。

基本記述

以下のように介入対象文書を限定し、この括弧内にCSSを記述します。

@-moz-document url-prefix(chrome://enjoybrowser/content/sidebar.xul)
{

}

以後、サイドバー介入に関するスタイル記述は、上記括弧内に記述されているものとします。

W3C CSS Validation Serviceを使用してデバッグするときは、{ } の内部のみをチェッカにかけてください。

各構成部に介入するためのid,class等の情報

現在のエンブラはβ1版です。まだ未確定のため、記載しません。

現行サイドバーのid,classは近日中に変更される可能性があります。

エンブラから通知される基本状態フラグ

[id="enjoy_body] が記述されたタグで、以下の状態属性が通知されます。

属性セレクタを使用することで、これらの状態をテーマに反映させることができます。(例: basecolor="green" の時の状態を id="sample" 反映させるときは [basecolor="green"] [id="sample"] { } )

スタイル指示

basecolor

スキン設定のカラー[red,green,blue、無指定時は空白] (例 green)
利用者が望む色調の指示です。将来、pink,yellow,cyan,white,blackなどの指示が追加される可能性があります。

theme

スキン設定のスタイル[classic,funny] (例 classic)
真面目表示／可愛い表示、といった利用者の嗜好の情報です。この属性を見て表示を切り替えるといいかもしれません。

character

スキン設定のキャラクター表示可否[true/false] (例 true)
人物・動物などのキャラクター画像を表示させるときは、この属性で表示/非表示を切り替えられるようにすることを推奨します。

highspec

スキン設定の高性能PC指定[透過等積極使用可=true,ダメなら=false] (例 true)
特に位置指定で「fixed」を用いた場合に半透過を使用すると、PCへの負荷が格段に高くなります。この属性値によって、そのエフェクトの使用可否を判断させることを推奨します。

scale

スキン設定のスケーリング指定[normal,small,middle,large,huge、通常はnormal] (例 normal)

文書情報

document

文書属性[スレッド一覧=list,スレッド内容=read] (例 list)

category

カテゴリー [GoKoreaならtb=の値,kjclubならtname=の値,エンジョイ同好会ならbid=の値] (例 transEconomy1)

bbs

この文書のBBS名[kjclub,kjclub_enjoy,gokorea,gojapan] (例 gokorea)

marks

この文書内でMARKした数 (例 0)

abones

この文書内でABONEした数 (例 0)

システム情報

firefox3

Firefox3判定 [Firefox3レベル以降のMozillaの場合はtrue] (例 true)

online

オンライン状態[true/false] (例 true)

時刻

year

文書ロード時の時刻[年] (例 2009)

month

文書ロード時の時刻[月(01が1月,01～12)] (例 03)

date

文書ロード時の時刻[日(01～31)] (例 08)

day

文書ロード時の時刻[曜日(0が日曜日)] (例 0)

hours

文書ロード時の時刻[時(00～23)] (例 10)

minutes

文書ロード時の時刻[分(00～59)] (例 55)

seconds

文書ロード時の時刻[秒(00～59)] (例 43)

time

文書ロード時の時刻[1970年からの経過マイクロ秒S] (例 1236477343751)

ランダム値

random10

ランダムな数値[0～9] (例 6)

random10b

ランダムな数値[0～9] (例 2)

random100

ランダムな数値[00～99] (例 47)

インターネットとの接続状態を示すonlineは、文書ロード完了後にも動的に情報が変化します。

時刻を示す各属性は、将来動的に情報が変化するようになる可能性があります。(従って、secondsやtimeをランダム値の代わりに使用して、背景を大きく変化させる等のトリックは推奨しません)

month,date,hours,minutes,secondsおよびrandom100については、一桁の時は接頭に0がついて2桁になることに注意。(※ Ver 2.0.0.85以降)

設置および配置方式について

HTTPネットワークによる設置・配布

エンブラ2.0正式版が公開されるまでは、この方式を推奨します。

メリット

オンライン上のリソースを修正することで、配布後のサポート対応が容易。利用者は手軽に取り扱える。

デメリット

利用時にネットワークアクセスの必要があるので、ある程度の帯域がある常時接続回線を持った利用者に限られる。設置者側で自由アクセスが許可されているHTTPサーバーを用意する必要がある。

展開状態のローカルPC内設置・配布

主にテーマ開発時に行う設置方式です。

メリット

開発時に使用する場合、変更作業が容易。設置後は基本的にネットワークアクセスの必要がない。

デメリット

リソースが含まれる分、配布サイズが大きくなる。配布方式としては利用者側に設置の手間がかかる。配布後は修正等のサポートが難しい。

このイメージをそのまま1ファイルにパッキングしたものが、次の「エンブラテーマパッケージ」です。

エンブラテーマパッケージ(etp)による設置・配布

エンブラ2.0β版では、まだ仕様が確定していないため、この方式での配布を行うとトラブルが発生する可能性かあります。

メリット

一度ダウンロードしてしまえば、利用者は手軽に取り扱える。設置後は基本的にネットワークアクセスの必要がない。

デメリット

リソースが含まれる分、配布サイズが大きくなる。配布後は修正等のサポートが少し難しい。

エンブラテーマパッケージ(etp)の作り方

パッキング方法

1. 前項の「展開状態のローカルPC内設置・配布」の方法でテーマを作り、一つのフォルダ内におさめる。(例 /my_theme 、theme.css一つと幅320pxのプレビュー画像(preview.jpg)を必ず含める)
2. それをフォルダごとzip圧縮。(例 enbra-theme-mytheme.zip 中身は /my_theme フォルダ)
3. 拡張子を etp にする。 (例 enbra-theme-mytheme.etp)
4. エンブラにインストールしてみて、正常動作をすることを確認して、完成。

テーマの公開と宣伝

KJCLUBのエンブラ テーマ公開スレッドにて、テーマの公開とPRができますのでご利用ください。

この公開ページには、エンブラのテーマ設定ページから利用者がアクセスできます。

公式サイトについて

公式サイトのアドレスはどこですか?

http://www.netfont7.net/enjoybrowser/ です

β版について

β版とは?

開発中のエンジョイブラウザという意味です。不具合と未対応項目が多数あります。

1.0系の enbra://enjoybrowser/ アドレスについて

ENJOYKOREAスレッド一覧を実アドレスへ変換する方法

変換元: enbra://enjoybrowser/bbs/list?category=CATEGORY

変換後: http://www.enjoykorea.jp/tbbs/list.php?board_id=CATEGORY

ENJOYKOREAスレッド内容を実アドレスへ変換する方法

変換元: enbra://enjoybrowser/bbs/read?category=CATEGORY&nid=NID

変換後: http://www.enjoykorea.jp/tbbs/read.php?board_id=CATEGORY&nid=NID

フィルタリングについて

あぼーん(ABONE)とはどういう意味ですか?

2ちゃんねるに端を発するウェブ用語で、投稿削除の表示です。

韓国側、通常ブラウジングモードで、一部のIDがフィルタリングされない

この問題は当面、解消の見込みはありません。

沢山のIDを登録したら、一部のIDがフィルタリングされない

Firefoxプロファイルの容量超過です。

ボックス一つあたり、500程度のIDを登録すると、IDがそれ以上登録できなくなる可能性があります。沢山登録するときは注意しましょう。

サイドバーについて

MAC版Firefoxで表示がおかしくなる

原因不明です。この問題は当面、解消の見込みはありません。

KJCLUBについて

ニックネーム登録の最高文字数は?

63文字までです。

スキンについて

たまにスキンが使用できなくなる

1, スキンを使用するためにはFirefox起動時にインターネットへ接続されている必要があります。

2, スキンが設置されているサーバーが動作不良を起こしている可能性があります。その場合は、スキンの使用を一時中止してください。

スキンを使用するとPCが重くなる

スキンによってはPCの性能が高くないと、動作が重くなる場合があります。

ログインについて

ログイン時に、パスワードが記憶されない、パスワードが誤って記憶される

Firefoxのオプションで、(セキュリティー→)パスワード管理の項目で、 http://www.kjclub.com や http://www.gokorea.jp に記憶されているIDとパスワードを消去してみましょう。

KJCLUBで一定時間がたつとログアウトされてしまう

KJCLUBでは約30分間放置すると、自動的にログアウトしてしまうという問題があります。

この点を留意して閲覧を行うか、EnjoyBrowserのログイン自動維持機能を利用しましょう。

そのほかの動作不良について

不具合情報の通報先はどこですか?

「エンブラ中央チャット」で私に呼びかけてください。

韓国語の文章が変です

開発者が日本人です。

間違い単語については、間違った箇所と文字、そして正しい単語をお知らせいただければ、修正するかもしれません。

コメントが大量にあるとき、解析動作が長い。

拡張ブラウジングモードON、コメント内の荒らしを重篤患者認定(透明あぼーん)、誤訳辞典OFF、ウイルス・ブラクラ警告をOFFにしてみてください。

一部動作に「表示しない」 「機能しない」などの不具合がある。

Firefox 1.5、2.0系のブラウザを使用している方は、Firefox 3.0を使用してみて下さい。

具体的な症状をnetfont7に通報してください。

今まで正常に動作していたのに、急に動作や表示が変になった。ログイン出来なくなった

掲示板のシステムが不意に変更された可能性があります。netfont7にその状態を通報し、enjoybrowserのアップデートをお待ちください。(対応完了まで、通常のログインを行い、通常ブラウジングでご利用ください)

Firefoxの起動に非常に時間がかかるようになった

拡張スタイル(スキン)を使用しているときは、それが原因の可能性があります。拡張スタイルを無効にしてみてください。

ログインについて (重要)

通信経路上もしくはご使用のPCにおいて不正な動作が行われた場合、ログインIDおよびパスワードを盗まれる可能性がありますので、EnjoyBrowserでのログインを行うときはご考慮願います。

なお、これが理由の問題・被害に関しても、EnjoyBrowser開発者は一切責任を負いませんので、ご了承下さい。