diff options
| author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 21:46:22 -0500 |
|---|---|---|
| committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 21:46:22 -0500 |
| commit | a065e04d529da1d847b5062a12c46d916408bf32 (patch) | |
| tree | fe0f8bcec1ff39a3c499a2708222dcf15224ff70 /files/ja/extensions | |
| parent | 218934fa2ed1c702a6d3923d2aa2cc6b43c48684 (diff) | |
| download | translated-content-a065e04d529da1d847b5062a12c46d916408bf32.tar.gz translated-content-a065e04d529da1d847b5062a12c46d916408bf32.tar.bz2 translated-content-a065e04d529da1d847b5062a12c46d916408bf32.zip | |
update based on https://github.com/mdn/yari/issues/2028
Diffstat (limited to 'files/ja/extensions')
21 files changed, 0 insertions, 1450 deletions
diff --git a/files/ja/extensions/bootstrap.js/index.html b/files/ja/extensions/bootstrap.js/index.html deleted file mode 100644 index d41402dbe0..0000000000 --- a/files/ja/extensions/bootstrap.js/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: bootstrap.js -slug: Extensions/bootstrap.js -tags: - - Add-ons - - Bootstrap - - Extensions -translation_of: Extensions/bootstrap.js ---- -<p><code>bootstrap.js</code> スクリプトにはいくつかの特定の関数を含める必要があります。それらは拡張機能を管理するブラウザによって呼び出されます。このスクリプトは特権付きサンドボックス内で実行され、拡張機能の終了時までキャッシュされます。詳しくは <a href="/ja/docs/Extensions/Bootstrapped_extensions">ブートストラップ型拡張機能</a> を参照してください。</p> -<p>以下の例には必要な関数が vsdoc 形式で含まれています。</p> -<pre style="font-family: Consolas; font-size: 13; color: black; background: white;"><span style="color: blue;">function</span> startup(data, reason) { - <span style="color: darkgreen;">/// <summary></span> - <span style="color: darkgreen;">/// ブートストラップデータ構造 @see https://developer.mozilla.org/ja/docs/Extensions/Bootstrapped_extensions#Bootstrap_data</span> - <span style="color: darkgreen;">/// &#10; string id</span> - <span style="color: darkgreen;">/// &#10; string version</span> - <span style="color: darkgreen;">/// &#10; nsIFile installPath</span> - <span style="color: darkgreen;">/// &#10; nsIURI resourceURI</span> - <span style="color: darkgreen;">/// &#10;</span> - <span style="color: darkgreen;">/// 理由の種類:</span> - <span style="color: darkgreen;">/// &#10; APP_STARTUP</span> - <span style="color: darkgreen;">/// &#10; ADDON_ENABLE</span> - <span style="color: darkgreen;">/// &#10; ADDON_INSTALL</span> - <span style="color: darkgreen;">/// &#10; ADDON_UPGRADE</span> - <span style="color: darkgreen;">/// &#10; ADDON_DOWNGRADE</span> - <span style="color: darkgreen;">/// </summary></span> -} -<span style="color: blue;">function</span> shutdown(data, reason) { - <span style="color: darkgreen;">/// <summary></span> - <span style="color: darkgreen;">/// ブートストラップデータ構造 @see https://developer.mozilla.org/ja/docs/Extensions/Bootstrapped_extensions#Bootstrap_data</span> - <span style="color: darkgreen;">/// &#10; string id</span> - <span style="color: darkgreen;">/// &#10; string version</span> - <span style="color: darkgreen;">/// &#10; nsIFile installPath</span> - <span style="color: darkgreen;">/// &#10; nsIURI resourceURI</span> - <span style="color: darkgreen;">/// &#10;</span> - <span style="color: darkgreen;">/// 理由の種類:</span> - <span style="color: darkgreen;">/// &#10; APP_SHUTDOWN</span> - <span style="color: darkgreen;">/// &#10; ADDON_DISABLE</span> - <span style="color: darkgreen;">/// &#10; ADDON_UNINSTALL</span> - <span style="color: darkgreen;">/// &#10; ADDON_UPGRADE</span> - <span style="color: darkgreen;">/// &#10; ADDON_DOWNGRADE</span> - <span style="color: darkgreen;">/// </summary></span> -} -<span style="color: blue;">function</span> install(data, reason) { - <span style="color: darkgreen;">/// <summary></span> - <span style="color: darkgreen;">/// ブートストラップデータ構造 @see https://developer.mozilla.org/ja/docs/Extensions/Bootstrapped_extensions#Bootstrap_data</span> - <span style="color: darkgreen;">/// &#10; string id</span> - <span style="color: darkgreen;">/// &#10; string version</span> - <span style="color: darkgreen;">/// &#10; nsIFile installPath</span> - <span style="color: darkgreen;">/// &#10; nsIURI resourceURI</span> - <span style="color: darkgreen;">/// &#10;</span> - <span style="color: darkgreen;">/// 理由の種類:</span> - <span style="color: darkgreen;">/// &#10; ADDON_INSTALL</span> - <span style="color: darkgreen;">/// &#10; ADDON_UPGRADE</span> - <span style="color: darkgreen;">/// &#10; ADDON_DOWNGRADE</span> - <span style="color: darkgreen;">/// </summary></span> -} -<span style="color: blue;">function</span> uninstall(data, reason) { - <span style="color: darkgreen;">/// <summary></span> - <span style="color: darkgreen;">/// ブートストラップデータ構造 @see https://developer.mozilla.org/ja/docs/Extensions/Bootstrapped_extensions#Bootstrap_data</span> - <span style="color: darkgreen;">/// &#10; string id</span> - <span style="color: darkgreen;">/// &#10; string version</span> - <span style="color: darkgreen;">/// &#10; nsIFile installPath</span> - <span style="color: darkgreen;">/// &#10; nsIURI resourceURI</span> - <span style="color: darkgreen;">/// &#10;</span> - <span style="color: darkgreen;">/// 理由の種類:</span> - <span style="color: darkgreen;">/// &#10; ADDON_UNINSTALL</span> - <span style="color: darkgreen;">/// &#10; ADDON_UPGRADE</span> - <span style="color: darkgreen;">/// &#10; ADDON_DOWNGRADE</span> - <span style="color: darkgreen;">/// </summary></span> -}</pre> diff --git a/files/ja/extensions/bootstrapped_extensions/index.html b/files/ja/extensions/bootstrapped_extensions/index.html deleted file mode 100644 index ed72d81d3d..0000000000 --- a/files/ja/extensions/bootstrapped_extensions/index.html +++ /dev/null @@ -1,386 +0,0 @@ ---- -title: ブートストラップ型拡張機能 -slug: Extensions/Bootstrapped_extensions -tags: - - Add-ons - - Extensions - - Firefox 4 - - Gecko 2.0 - - Guide - - Localization - - NeedsTechnicalReview -translation_of: Archive/Add-ons/Bootstrapped_extensions ---- -<p>{{ gecko_minversion_header("2.0") }}</p> - -<div class="note"> -<p>なお、<a class="link-https" href="https://addons.mozilla.org/en-US/developers/docs/sdk/latest/">Add-on SDK</a>を使って作成された拡張機能はすべて bootstrappedです！ブート処理コードは自動的に生成されるので、それについて考える必要はまったくありません。 Add-on SDKを使っていない? 読むべきです...</p> -</div> - -<p>従来型の拡張機能は<strong>オーバーレイ</strong>を含んでおり、アプリケーションが拡張機能のパッケージから XUL を読み込み、その UI 部品をアプリケーションのユーザインタフェース (UI) 上へ自動的に適用します。この仕組みを使うと、アプリケーションの UI へ部品を追加する拡張機能を比較的簡単に作成できますが、拡張機能の更新、インストール、無効化を行う際にアプリケーションの再起動が必要となります。</p> - -<p>Gecko 2.0 {{ geckoRelease("2.0") }} では新たに<strong>ブートストラップ型拡張機能</strong> (bootstrapped extension) という仕組みが導入されました。これは特別な拡張機能で、オーバーレイを使って独自の UI 部品をアプリケーションへ適用する代わりに、アプリケーションへ動的に部品を挿入できるようにするものです。この処理は、拡張機能のインストール、削除、起動、終了時にブラウザが呼び出す関数を記述した、拡張機能に含まれる特別なスクリプトファイルを使って行われます。</p> - -<p>アプリケーションが行うのはこのスクリプトファイルに書かれた関数を呼び出すことだけで、UI 部品の追加や削除、その他必要とされる起動・終了時の処理などはすべて拡張機能自身が責任を持って行う必要があります。</p> - -<p>この記事ではブートストラップ型拡張機能の仕組みを解説します。移行の段階的で実験的なガイドについては、<a href="https://developer.mozilla.org/en-US/Add-ons/How_to_convert_an_overlay_extension_to_restartless">オーバーレイ拡張機能から再起動なしへの変換</a>に関するこのチュートリアルを参照して下さい。</p> - -<h2 id="起動・終了プロセス">起動・終了プロセス</h2> - -<p>ブートストラップ型拡張機能の重要な機能のひとつに、アプリケーションの指示による任意のタイミングで起動や終了が可能であることが挙げられます。拡張機能の <code>startup</code>() 関数が呼び出されたとき、UI 部品やその他の動作をアプリケーションへ動的に挿入する必要があります。同じように、<code>shutdown</code> 関数が呼び出されたときは、アプリケーションへ追加した部品やそのオブジェクトへの参照をすべて削除しなければなりません。</p> - -<p><code>startup</code> 関数が呼び出される場面はいくつかあります。例えば、</p> - -<ul> - <li>拡張機能が始めてインストールされるとき (その拡張機能がアプリケーションと互換性があり、なおかつ有効化されている場合)</li> - <li>アドオンマネージャの画面上で拡張機能が有効化されるとき</li> - <li>アプリケーション起動時 (その拡張機能がアプリケーションと互換性があり、なおかつ有効化されている場合)</li> -</ul> - -<p><code>shutdown</code> 関数が呼び出される場面は次のようなときです。</p> - -<ul> - <li>拡張機能が削除されるとき (その拡張機能が有効化されている場合)</li> - <li>拡張機能が無効化されるとき</li> - <li>アプリケーション終了時 (その拡張機能が有効化されている場合)</li> -</ul> - -<h2 id="アプリケーションの_UI_変更に関する注意">アプリケーションの UI 変更に関する注意</h2> - -<h3 id="ブートストラップ型拡張機能内の_chrome.manifest">ブートストラップ型拡張機能内の chrome.manifest</h3> - -<p>ブートストラップ型拡張機能に <a href="/ja/docs/Chrome_Registration"><code>chrome.manifest</code></a> ファイルを含めると次のようなことが可能となります。</p> - -<ol> - <li>拡張機能に含まれるコンテンツを <code>chrome://</code> URI を通じて利用可能にする (マニフェスト内の <code>content</code>、<code>locale</code>、<code>skin</code> 命令文を使う)</li> - <li>既存の <code>chrome://</code> URI を自作コンテンツで置き換える (<code>override</code> 命令文を使う)</li> -</ol> - -<p>ブートストラップ型拡張機能の中では使えないマニフェスト命令文もあります。例えば <a href="/ja/docs/XUL_Overlays">XUL オーバーレイ</a> を登録することはできません。詳しくは <a href="/ja/docs/Chrome_Registration"><code>chrome.manifest</code></a> の記事を参照してください。</p> - -<p>Firefox 10 以降では、拡張機能 XPI ファイル内のルートに (<code>install.rdf</code> と同列で) 置かれている <code>chrome.manifest</code> ファイルは自動的に読み込まれます。Firefox 8 と 9 では、{{ ifmethod("nsIComponentManager", "addBootstrappedManifestLocation") }} と {{ ifmethod("nsIComponentManager", "removeBootstrappedManifestLocation") }} を使ってマニフェストを動的に読み込み、終了時に読み込み解除する必要があります。この機能は Firefox 8 未満のバージョンでは使用できません。</p> - -<h3 id="UI_部品の動的な追加">UI 部品の動的な追加</h3> - -<p>ここまで読んで、アプリケーションの UI を変更するブートストラップ型拡張機能を作り始めようと思ったら、最初に次のようなコードを考えましょう。</p> - -<p>まず、関連するアプリケーションの UI 要素を、{{ domxref("document.getElementById()") }} を使って、その ID で参照します。次に、それらを操作して独自の UI 部品を挿入します。例えば、Firefox のメニューバーは <code>document.getElementById("main-menubar")</code> で参照可能です。</p> - -<p>終了時には、追加した UI 部品を必ず削除しましょう。</p> - -<h2 id="ブートストラップ型拡張機能の作成">ブートストラップ型拡張機能の作成</h2> - -<p>拡張機能がブートストラップ型であることを示すには、以下の要素を <a href="/ja/docs/Install_Manifests">インストールマニフェスト</a> へ追加する必要があります。</p> - -<pre class="notranslate"><code><em:bootstrap>true</em:bootstrap></code></pre> - -<p>それから、必要な関数を記述する <a href="/ja/docs/Extensions/bootstrap.js"><code><strong>bootstrap.js</strong></code> ファイル</a> を追加します。これは拡張機能パッケージ内の <a href="/ja/docs/Install_Manifests"><code>install.rdf</code> ファイル</a> と同列で配置します。</p> - -<h3 id="後方互換性">後方互換性</h3> - -<p>Firefox の旧バージョンは <code>bootstrap</code> プロパティや <code>bootstrap.js</code> ファイルを認識できないため、ブートストラップ型と従来型を兼ねた拡張機能の開発は非常に難しいと言えます。まずはブートストラップ型拡張機能として作成し、次に従来のオーバーレイも追加することになります。そうすることで、Firefox の新バージョンは <code>bootstrap.js</code> スクリプトを使い、コンポーネントやオーバーレイを無視しますが、旧バージョンにはオーバーレイを使わせられます。</p> - -<h2 id="ブート処理が呼び出されるタイミング_エントリーポイント">ブート処理が呼び出されるタイミング (エントリーポイント)</h2> - -<p><code>bootstrap.js</code> スクリプトにはいくつかの特定の関数を含める必要があります。それらは拡張機能を管理するブラウザによって呼び出されます。このスクリプトは特権付きサンドボックス内で実行され、拡張機能の終了時までキャッシュされます。</p> - -<h3 id="startup">startup</h3> - -<p>拡張機能がそれ自身を起動する必要があるときに呼び出されます。アプリケーションの起動時や、無効化されている拡張機能が有効化されるとき、更新をインストールするときにも呼び出されます。そのため、アプリケーションの起動中に何度も呼び出される可能性があります。</p> - -<p>このタイミングで、独自の UI 部品を挿入したり、必要な処理を開始したりします。</p> - -<pre class="notranslate">void startup( - data, - reason -); -</pre> - -<h6 id="引数">引数</h6> - -<dl> - <dt><code>data</code></dt> - <dd><a href="#Bootstrap_data">ブートストラップデータ構造</a>。</dd> - <dt><code>reason</code></dt> - <dd><a href="#Reason_constants">理由定数</a> のひとつで、拡張機能が起動されようとしている理由を示します。<code>APP_STARTUP</code>、<code>ADDON_ENABLE</code>、<code>ADDON_INSTALL</code>、<code>ADDON_UPGRADE</code>、<code>ADDON_DOWNGRADE</code> のいずれかになります。</dd> -</dl> - -<h3 id="shutdown">shutdown</h3> - -<p>拡張機能がそれ自身を終了する必要があるときに呼び出されます。アプリケーションの終了時や、拡張機能が更新あるいは無効化されるときなどです。このタイミングで、挿入した UI 部品をすべて削除し、処理を停止し、オブジェクトを破棄する必要があります。</p> - -<pre class="notranslate">void shutdown( - data, - reason -); -</pre> - -<h6 id="引数_2">引数</h6> - -<dl> - <dt><code>data</code></dt> - <dd><a href="#Bootstrap_data">ブートストラップデータ構造</a>。</dd> - <dt><code>reason</code></dt> - <dd><a href="#Reason_constants">理由定数</a> のひとつで、拡張機能が終了されようとしている理由を示します。<code>APP_SHUTDOWN</code>、<code>ADDON_DISABLE</code>、<code>ADDON_UNINSTALL</code>、<code>ADDON_UPGRADE</code>、<code>ADDON_DOWNGRADE</code> のいずれかになります。</dd> -</dl> - -<h3 id="install">install</h3> - -<p>ブートストラップスクリプトにはオプションで <code>install</code> 関数を含めることができます。これは、拡張機能がインストール、更新、あるいはダウングレードされた後、<code>startup</code> 関数の初回呼び出し前に、アプリケーションによって呼び出されます。</p> - -<div class="note"><strong>注:</strong> この関数は、拡張機能が一度も起動されていない場合は呼び出されません。例えば、拡張機能がインストールされたもののアプリケーションの現在のバージョンと互換性がなく、互換性が確保される前に削除された場合、<code>install</code> 関数は一度も呼び出されません。しかし、拡張機能がそのアプリケーションと互換性のあるバージョンへ更新された場合、<code>install</code> 関数はその時点で、<code>startup</code> 関数の初回呼び出し前に呼び出されます。</div> - -<pre class="notranslate">void install( - data, - reason -); -</pre> - -<h6 id="引数_3">引数</h6> - -<dl> - <dt><code>data</code></dt> - <dd><a href="#Bootstrap_data">ブートストラップデータ構造</a>。</dd> - <dt><code>reason</code></dt> - <dd><a href="#Reason_constants">理由定数</a> のひとつで、拡張機能がインストールされようとしている理由を示します。<code>ADDON_INSTALL</code>、<code>ADDON_UPGRADE</code>、<code>ADDON_DOWNGRADE</code> のいずれかになります。</dd> -</dl> - -<h3 id="uninstall">uninstall</h3> - -<p>このオプション関数は、拡張機能の特定のバージョンが削除された後、<code>shutdown</code> 関数の最終呼び出し後に呼び出されます。これは、<code>install</code> 関数が一度も呼び出されていない場合は呼び出されません。</p> - -<div class="note"><strong>注:</strong> <code>uninstall</code> 関数は、拡張機能が無効化されている場合や、アプリケーションの現在のバージョンと互換性がない場合でも呼び出される場合があることに注意してください。このため、この関数を実装する場合は、使用している API がアプリケーションに実装されていない可能性も考慮し、適切に処理することが重要です。なお、この関数は Firefox が起動していないときに外部アプリケーションによって拡張機能が削除された場合には呼び出されません。</div> - -<div class="note"><strong>Note: </strong>Simply having <code>function install() {} </code>IS NOT ENOUGH because if you have code in <code>uninstall </code>it will not run. You MUST run some code in the <code>install </code>function; at the least you must set parameters for the <code>install </code>function, such as: <code>function install(aData, aReason) {}</code>; then uninstall WILL WORK.</div> - -<div class="note"><strong>Note:</strong> If you open the add-on manager and then click "Remove" on an add-on, it will not call uninstall function right away. This is a soft uninstall because of the available "Undo" option. If the add-on manager is closed or another event takes place such that the "Undo" option becomes unavailable, then the hard uninstall takes place and the uninstall function is called.</div> - -<div class="note"><strong>Note:</strong> The uninstall function fires on downgrade and upgrade as well so you should make sure it is an uninstall by doing this:<br> -<code>function uninstall(aData, aReason) {</code><br> -<code> if (aReason == ADDON_UNINSTALL) {</code><br> -<code> console.log('really uninstalling');</code><br> -<code> } else {</code><br> -<code> console.log('not a permanent uninstall, likely an upgrade or downgrade');</code><br> -<code> }</code><br> -<code>}</code></div> - -<pre class="notranslate">void uninstall( - data, - reason -); -</pre> - -<h6 id="引数_4">引数</h6> - -<dl> - <dt><code>data</code></dt> - <dd><a href="#Bootstrap_data">ブートストラップデータ構造</a>。</dd> - <dt><code>reason</code></dt> - <dd><a href="#Reason_constants">理由定数</a> のひとつで、拡張機能が削除されようとしている理由を示します。<code>ADDON_UNINSTALL</code>、<code>ADDON_UPGRADE</code>、<code>ADDON_DOWNGRADE</code> のいずれかになります。</dd> -</dl> - -<h2 id="理由定数">理由定数</h2> - -<p>ブートストラップ関数は <code>reason</code> 引数を取ることができます。拡張機能は、その関数が呼び出された理由をこの引数で確かめられます。理由定数は以下の通りです。</p> - -<table class="standard-table"> - <tbody> - <tr> - <td class="header">定数</td> - <td class="header">値</td> - <td class="header">意味</td> - </tr> - <tr> - <td><code>APP_STARTUP</code></td> - <td>1</td> - <td>アプリケーションが起動されようとしている</td> - </tr> - <tr> - <td><code>APP_SHUTDOWN</code></td> - <td>2</td> - <td>アプリケーションが終了されようとしている</td> - </tr> - <tr> - <td><code>ADDON_ENABLE</code></td> - <td>3</td> - <td>拡張機能が有効化されようとしている</td> - </tr> - <tr> - <td><code>ADDON_DISABLE</code></td> - <td>4</td> - <td>拡張機能が無効化されようとしている (<a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=620541">削除時にも送信されます</a>)</td> - </tr> - <tr> - <td><code>ADDON_INSTALL</code></td> - <td>5</td> - <td>拡張機能がインストールされようとしている</td> - </tr> - <tr> - <td><code>ADDON_UNINSTALL</code></td> - <td>6</td> - <td>拡張機能が削除されようとしている</td> - </tr> - <tr> - <td><code>ADDON_UPGRADE</code></td> - <td>7</td> - <td>拡張機能が更新されようとしている</td> - </tr> - <tr> - <td><code>ADDON_DOWNGRADE</code></td> - <td>8</td> - <td>拡張機能がダウングレードされようとしている</td> - </tr> - </tbody> -</table> - -<h2 id="ブートストラップデータ">ブートストラップデータ</h2> - -<p>上記の各関数 (エントリーポイント) には、その拡張機能に関する有用な情報が含まれるシンプルなデータ構造が渡されます。拡張機能に関するより詳しい情報は <code><a href="/ja/docs/Addons/Add-on_Manager/AddonManager#getAddonByID()">AddonManager.getAddonByID()</a></code> を呼び出すことで取得できます。このデータは単純な JavaScript オブジェクトで、以下のプロパティが含まれます。</p> - -<table class="standard-table"> - <tbody> - <tr> - <td class="header">プロパティ</td> - <td class="header">型</td> - <td class="header">意味</td> - </tr> - <tr> - <td><code>id</code></td> - <td><code>string</code></td> - <td>ブート処理される拡張機能の ID</td> - </tr> - <tr> - <td><code>version</code></td> - <td><code>string</code></td> - <td>ブート処理される拡張機能のバージョン</td> - </tr> - <tr> - <td><code>installPath</code></td> - <td><code>nsIFile</code></td> - <td>ブート処理される拡張機能がインストールされている場所。これは、拡張機能がインストール時に展開されているかどうかによって、ディレクトリもしくは XPI ファイルとなります</td> - </tr> - <tr> - <td><code>resourceURI</code></td> - <td><code>nsIURI</code></td> - <td> - <p>拡張機能ファイルのルートを示す URI。これは、拡張機能がインストール時に展開されているかどうかによって、<code>jar:</code> もしくは <code>file:</code> URI となります {{ gecko_minversion_inline("7.0") }}</p> - </td> - </tr> - </tbody> -</table> - -<table class="standard-table" style="height: 242px; width: 454px;"> - <tbody> - <tr> - <td><code>oldVersion</code></td> - <td><code>string</code></td> - <td>The previously installed version, if the reason is <code>ADDON_UPGRADE</code> or <code>ADDON_DOWNGRADE</code>, and the method is <code>install</code> or <code>startup</code>. {{ gecko_minversion_inline("22.0") }}</td> - </tr> - <tr> - <td><code>newVersion</code></td> - <td><code>string</code></td> - <td>The version to be installed, if the reason is <code>ADDON_UPGRADE</code> or <code>ADDON_DOWNGRADE</code>, and the method is <code>shutdown</code> or <code>uninstall</code>. {{ gecko_minversion_inline("22.0") }}</td> - </tr> - </tbody> -</table> - -<div class="note"> -<p><strong>Note:</strong> An add-on may be upgraded/downgraded at application startup, in this case the <code>startup</code> method reason is <code>APP_STARTUP</code>, and the <code>oldVersion</code> property is not set. Also be aware that in some circumstances an add-on upgrade/downgrade may occur without the <code>uninstall</code> method being called.</p> -</div> - -<h2 id="Add-on_debugger">Add-on debugger</h2> - -<p>From Firefox 31 onwards, you can use the <a href="https://developer.mozilla.org/en-US/Add-ons/Add-on_Debugger">Add-on Debugger</a> to debug bootstrapped add-ons.</p> - -<h2 id="Localization_L10n">Localization (L10n)</h2> - -<p>Localizing bootstrapped add-ons is very much the same since Firefox 7, as that is when chrome.manifest compatibility landed.</p> - -<h3 id="JS_and_JSM_Files_-_Using_Property_Files">JS and JSM Files - Using Property Files</h3> - -<p>To localize your .js and .jsm files you have to use <a href="https://developer.mozilla.org/en-US/docs/XUL/Tutorial/Property_Files">property files</a>.</p> - -<p>The absolute minimum needed here is:</p> - -<ol> - <li>File: install.rdf</li> - <li>File: chrome.manifest</li> - <li>File: bootstrap.js</li> - <li>Folder: locale - <ol> - <li>Folder: VALID_LOCALE_HERE - <ol> - <li>File: ANYTHING.properties</li> - </ol> - </li> - </ol> - </li> -</ol> - -<p>In the locale folder you must have folders for each of the languages you want to provide; each folder must be named a valid locale (ex: en-US). Inside this folder must be a property file. Inside the chrome.manifest file these locale must be defined. For example if you had a subfolder of en-US in locale folder your chrome.manifest file will have to contain: <code>locale NAME_OF_YOUR_ADDON en-US locale/en-US/</code></p> - -<p>Here is an example: <a href="https://github.com/Noitidart/l10n/tree/properties">GitHub :: l10n-properties</a> - on startup of this add-on it will show a prompt saying USA or Great Britain, which ever it deems closest to your locale. You can test different locale by going to about:config and changing preference of general.useragent.locale to en-US and then to en-GB and disabling then re-enabling the add-on.</p> - -<h3 id="XUL_and_HTML_Files_-_Using_Entities_from_DTD_Files">XUL and HTML Files - Using Entities from DTD Files</h3> - -<p>Many times HTML pages are used, however they cannot be localized with DTD files. There are three changes you must make:</p> - -<ol> - <li>You have to change the HTML file's extension to be <code>.xhtml</code></li> - <li>The doctype must be defined point to a DTD file in your locale folder such as: <code><!DOCTYPE html SYSTEM <span class="pl-s1">"chrome://l10n/locale/mozilla.dtd"</span>></code></li> - <li>Must add xmlns attribute to html tag for example: <code><<span class="pl-ent">html</span> <span class="pl-e">xmlns</span>=<span class="pl-s1"><span class="pl-pds">"</span>http://www.w3.org/1999/xhtml<span class="pl-pds">"</span></span>></code></li> - <li>If you have multiple DTD files read on here: <a href="https://developer.mozilla.org/en-US/docs/Using_multiple_DTDs">Using multiple DTDs</a></li> -</ol> - -<p>The bare minimum needed is:</p> - -<ol> - <li>File: install.rdf</li> - <li>File: chrome.manifest</li> - <li>File: bootstrap.js</li> - <li>Folder: locale - <ol> - <li>Folder: VALID_LOCALE_HERE - <ol> - <li>File: ANYTHING.dtd</li> - </ol> - </li> - </ol> - </li> -</ol> - -<p>The chrome.manifest file must include a definition for content for example: <code>content NAME_OF_YOUR_ADDON ./</code></p> - -<p>The chrome.manifest file must also include a line pointing to the locale, just like in the above property section, if you had a folder named en-US in locale, the chrome.manifest file should contain: <code>locale NAME_OF_YOUR_ADDON en-US locale/en-US/</code></p> - -<p>Here is an example add-on that opens an HTML page and a XUL page on install: <a href="https://github.com/Noitidart/l10n/tree/c456cc82a8a66b6d552cd8c2299cd2babc383af0">GitHub :: l10n-xhtml-xul</a>. Here is an example showing how to use a localized HTML page as an options page: <a href="https://github.com/Noitidart/l10n/tree/html-options">GitHub :: l10n-html-options</a>. You can go to about:config and change the value of the preference <code>general.useragent.locale </code>to <code>en-US</code> and then to <code>en-GB</code> and then reload the open pages to see the localization change.</p> - -<h2 id="参考資料">参考資料</h2> - -<ul> - <li>Wladimir Palant さんが、<a class="external" href="http://adblockplus.org/blog/how-many-hacks-does-it-take-to-make-your-extension-install-without-a-restart">既存の拡張機能を書き換える際に発見した問題やバグ</a> を、解決策や回避策とともに解説しています。</li> - <li>Mark Finkle さんが、<a class="external" href="http://starkravingfinkle.org/blog/2011/01/bootstrap-jones-adventures-in-restartless-add-ons/">Android 版 Firefox 用ブートストラップ型拡張機能</a> の簡単なサンプルコードを提供しており、ブートストラップ型拡張機能に <a class="external" href="http://starkravingfinkle.org/blog/2011/01/restartless-add-ons-more-resources/">(オプションウィンドウなどの) リソースを追加する方法</a> や、<code>default/preferences/prefs.js</code> ファイルを使わずに <a class="external" href="http://starkravingfinkle.org/blog/2011/01/restartless-add-ons-%e2%80%93-default-preferences/">デフォルト設定を追加する方法</a> について説明しています。</li> - <li>Kris Maglione さんが、ブートストラップ型拡張機能における <a class="external" href="http://maglione-k.users.sourceforge.net/bootstrapped.xhtml">クリーンアップ手順の必要事項</a> についての記事を書いています。</li> - <li>Edward Lee さんが、自作ブートストラップ型拡張機能に使える <a class="external" href="http://ed.agadak.net/2011/01/restartless-add-on-example-code">役に立つコーディングパターンやサンプル</a> を提供しています。</li> - <li>Erik Vold さんのブートストラップ型拡張機能チュートリアル: - <ul> - <li><a class="external" href="http://erikvold.com/blog/index.cfm/2010/11/3/restartless-restart-addon-for-firefox">Part 1: Introduction</a></li> - <li><a class="external" href="http://erikvold.com/blog/index.cfm/2011/1/2/restartless-firefox-addons-part-2-includes">Part 2: Includes</a></li> - <li><a class="external" href="http://erikvold.com/blog/index.cfm/2011/2/7/restartless-firefox-addons-part-3-icons">Part 3: Icons</a></li> - <li><a class="external" href="http://erikvold.com/blog/index.cfm/2011/2/18/restartless-firefox-addons-part-4-localization-l10n">Part 4: Localization (l10n)</a></li> - <li><a class="external" href="http://erikvold.com/blog/index.cfm/2011/4/1/restartless-firefox-addons-part-5-logging">Part 5: Logging</a></li> - <li><a class="external" href="http://erikvold.com/blog/index.cfm/2011/6/14/restartless-firefox-addons-part-6-better-includes">Part 6: Better Includes</a></li> - <li><a class="external" href="http://erikvold.com/blog/index.cfm/2011/6/19/restartless-firefox-addons-part-7-css">Part 7: CSS</a></li> - <li><a class="external" href="http://erikvold.com/blog/index.cfm/2011/6/19/restartless-firefox-addons-part-8-require-commonjs-and-jetpack">Part 8: Require, CommonJS, and Jetpack</a></li> - </ul> - </li> - <li>Firefox 7 以上で使用可能な <a href="/ja/docs/Extensions/Inline_Options">インラインオプション</a> の記事も参照してください。</li> -</ul> - -<h3 id="日本語の参考資料">日本語の参考資料</h3> - -<ul> - <li>Piro さんによる <a href="http://piro.sakura.ne.jp/xul/doc/20101120fxdevcon/">Jetpack に乗っかれないロートルのための再起動いらずなアドオンの作り方 ～ Bootstrapped Add-on 詳説～</a>、<a href="http://www.mozilla.jp/videos/events/devcon/2010/6b-bootstrapped-addons/">同プレゼン録画</a> と <a href="https://github.com/piroor/restartless">ブートストラップ型拡張機能テンプレート</a></li> - <li>Gomita さんによる <a href="http://www.xuldev.org/misc/docs/modest14/">Android 版 Firefox アドオン開発事始め</a></li> - <li>書籍「<a href="http://firefoxhacks.org/">Firefox Hacks Rebooted</a>」</li> -</ul> diff --git a/files/ja/extensions/community/index.html b/files/ja/extensions/community/index.html deleted file mode 100644 index 6c7aa3594f..0000000000 --- a/files/ja/extensions/community/index.html +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: 拡張機能関連コミュニティ -slug: Extensions/Community -tags: - - Add-ons - - Community - - Extensions - - Links -translation_of: Extensions/Community ---- -<p>もしあなたが<a href="/ja/docs/Extensions">拡張の開発</a>に関係するメーリングリストやニュースグループ、フォーラムあるいは他のコミュニティを知っていたら、ここにリンクを追加してください。</p> -<ul> - - <li><a href="http://forums.mozillazine.org/?c=11">MozillaZine Extensions & Themes フォーラム</a>(英語)</li> - <li><a class="link-irc" href="irc://moznet/%23extdev">moznet IRC ネットワークの #extdev チャンネル - 拡張機能開発についての質問</a>](英語)</li> - <li><a class="link-irc" href="irc://moznet/%23addons">moznet IRC ネットワークの #addons チャンネル - http://addons.mozilla.org についての質問</a>(英語)</li> - <li><a href="http://mozdev.org/mailman/listinfo/project_owners">mozdev プロジェクトオーナのメーリングリスト</a>(英語)</li> - <li><a href="http://kb.mozillazine.org/Extension_development">Mozillazine ナレッジベース</a>(英語)</li> - <li><a href="http://allyourideas.com/index.php?title=Category:Firefox_extension">AllYourIdeas</a> - 拡張のアイディア((REALLY needs a unique CAPTCHA)) (英語)</li> - <li><a href="http://babelzilla.org/">BabelZilla</a> - Mozilla Application の開発者と翻訳者のコミュニティ(英語)</li> - <li><a href="http://wiki.fdiary.net/xul/">XUL Wiki</a></li> -</ul> diff --git a/files/ja/extensions/firefox/index.html b/files/ja/extensions/firefox/index.html deleted file mode 100644 index 6432119d3e..0000000000 --- a/files/ja/extensions/firefox/index.html +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Firefox -slug: Extensions/Firefox -tags: - - Extensions - - Firefox -translation_of: Mozilla/Add-ons ---- -<p>以下の記事は、Firefox のための拡張機能開発の手引きです。すべての Mozilla アプリケーションに適用される<a href="/ja/docs/Extensions" title="Extensions">全般的な拡張機能のドキュメント</a>も参照してください。将来、<a class="link-https" href="https://jetpack.mozillalabs.com/" title="https://jetpack.mozillalabs.com/">Mozilla labs の Jetpack プロジェクト</a>によって開発されている、より小型でシンプルな API を持つ新しい拡張機能を開発することになるかもしれません。</p> -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h2 class="Documentation" id="Documentation" name="Documentation">ドキュメンテーション</h2> - <ul> - <li><a href="/ja/docs/Firefox_addons_developer_guide" title="Firefox_addons_developer_guide">Firefox アドオン開発者ガイド</a><br> - Firefox のアドオン開発のための入門ガイド。</li> - <li><a href="/ja/docs/Creating_Custom_Firefox_Extensions_with_the_Mozilla_Build_System" title="Creating_Custom_Firefox_Extensions_with_the_Mozilla_Build_System">Mozilla ビルドシステムを利用した独自の Firefox 拡張の作成</a><br> - バイナリコンポーネントを使用する拡張機能の開発環境の構築方法。</li> - <li><a href="/ja/docs/Building_an_Extension" title="Building an Extension">Firefox 拡張機能のビルド</a><br> - Firefox の拡張機能をビルドする方法の段階的な説明。</li> - <li><a href="/ja/docs/Updating_extensions_for_Firefox_3.6" title="Updating extensions for Firefox 3.6">拡張機能の Firefox 3.6 向けの更新</a><br> - 拡張機能に影響する Firefox 3.6 の変更点のリストと関連ドキュメントへのリンク。</li> - <li><a href="/ja/docs/Updating_extensions_for_Firefox_3.5" title="Updating extensions for Firefox 3.5">拡張機能の Firefox 3.5 向けの更新</a><br> - 拡張機能に影響する Firefox 3.5 の変更点のリストと関連ドキュメントへのリンク。</li> - <li><a href="/ja/docs/Updating_extensions_for_Firefox_3" title="Updating extensions for Firefox 3">拡張機能の Firefox 3 向けの更新</a><br> - 拡張機能に影響する Firefox 3 の変更点のリストと関連ドキュメントへのリンク。</li> - <li><a href="/ja/docs/Code_snippets" title="Code_snippets">Firefox のコードサンプル</a><br> - 多くの拡張機能で使用される一般的なコード。</li> - </ul> - </td> - <td> - <h2 class="Community" id="Community" name="Community">コミュニティ</h2> - <ul> - <li>Mozilla フォーラムを見る...</li> - <li>{{DiscussionList("dev-extensions", "mozilla.dev.extensions")}}</li> - </ul> - <ul> - <li><a class="link-irc" href="irc://moznet/#extdev">#extdev IRC チャンネル</a></li> - <li><a href="http://forums.mozillazine.org/viewforum.php?f=19">MozillaZine フォーラム</a></li> - <li><a href="http://mozdev.org/mailman/listinfo/project_owners">mozdev project owners</a></li> - <li><a href="/ja/docs/Extensions/Community" title="Extensions/Community">他のコミュニティへのリンク...</a></li> - </ul> - <h2 class="Tools" id="Tools" name="Tools">ツール</h2> - <ul> - <li><a class="link-https" href="https://addons.mozilla.org/ja/firefox/addon/6622" rel="external nofollow" title="https://addons.mozilla.org/ja/firefox/addon/6622">DOM Inspector</a> 実際の DOM を編集 (Firefox と Thunderbird)</li> - <li><a href="http://www.hacksrus.com/~ginda/venkman/" rel="external nofollow" title="http://www.hacksrus.com/~ginda/venkman/">Venkman</a>, JavaScript デバッガ (<a href="http://addons.mozilla.org/ja/firefox/addon/216" rel="external nofollow" title="http://addons.mozilla.org/ja/firefox/addon/216">Firefox</a>, <a href="http://addons.mozilla.org/ja/thunderbird/addon/216" rel="external nofollow" title="http://addons.mozilla.org/ja/thunderbird/addon/216">Thunderbird</a>)</li> - <li><a class="link-https" href="https://addons.mozilla.org/ja/firefox/addon/7434/" rel="external nofollow" title="https://addons.mozilla.org/ja/firefox/addon/7434/">Extension Developer's Extension</a> 開発者向けの必須ユーティリティを統合</li> - <li><a href="http://www.gijsk.com/" rel="external nofollow" title="http://www.gijsk.com/">Chrome List</a> chrome:// のファイルを表示 (<a href="http://addons.mozilla.org/ja/firefox/addon/4453" rel="external nofollow" title="http://addons.mozilla.org/ja/firefox/addon/4453">Firefox</a>, <a href="http://addons.mozilla.org/ja/thunderbird/addon/4453" rel="external nofollow" title="http://addons.mozilla.org/ja/thunderbird/addon/4453">Thunderbird</a>)</li> - <li><a href="http://ted.mielczarek.org/code/mozilla/extensionwiz/" rel="external nofollow" title="http://ted.mielczarek.org/code/mozilla/extensionwiz/">Extension Wizard</a> ウェブベースで拡張機能のスケルトンを生成 (Firefox と Thunderbird)</li> - <li><a href="/ja/docs/JavaScript_shells" title="JavaScript_shells">JavaScript Shells</a> JavaScript のテスト用コード</li> - </ul> - <p>... <a href="/ja/docs/Setting_up_extension_development_environment#Development_extensions" title="Setting up extension development environment#Development extensions">その他のツール</a> ...</p> - <p><span class="alllinks"><a href="/ja/docs/tag/Extensions:Tools" title="tag/Extensions:Tools">すべて見る...</a></span></p> - <h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">関連事項</h2> - <ul> - <li><a href="/ja/docs/XUL" title="XUL">XUL</a>、 <a href="/ja/docs/JavaScript" title="JavaScript">JavaScript</a>、 <a href="/ja/docs/XPCOM" title="XPCOM">XPCOM</a>、 <a href="/ja/docs/Themes" title="Themes">テーマ</a>、 <a href="/ja/docs/Developer_Guide" title="Developing_Mozilla">Developing Mozilla</a></li> - </ul> - </td> - </tr> - </tbody> -</table> diff --git a/files/ja/extensions/index.html b/files/ja/extensions/index.html deleted file mode 100644 index 193a81c7e7..0000000000 --- a/files/ja/extensions/index.html +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: 拡張機能 -slug: Extensions -tags: - - Add-ons - - Extensions - - 要更新 -translation_of: Mozilla/Add-ons ---- -<div> -<p>{{ NoteStart }} WebExtensions 移行以前の情報を含んでいます。原文（英語版）ではこのページは <a href="/ja/docs/Mozilla/Add-ons">Add-ons</a> に自動転送されています。 {{NoteEnd}}</p> - -<p><strong>拡張機能 (Extensions)</strong> は、Firefox や Thunderbird, SeaMonkey などの Mozilla アプリケーションに新しい機能を付け加える小さなアドオンです。ツールバーボタンから全く新しい機能まで何でも付け加えることができます。ダウンロードのサイズが小さく、追加の機能を必要としているユーザに対して、その個々の必要性にあった機能を提供できます。</p> - -<p><a href="/ja/Plugins" title="ja/Plugins">プラグイン</a> は拡張機能とは異なり、ブラウザと外部のプログラムを連携するソフトウェアのことです。<a href="/ja/Creating_OpenSearch_plugins_for_Firefox" title="ja/Creating_OpenSearch_plugins_for_Firefox">検索プラグイン (検索エンジン)</a> は拡張機能ともプラグインとも異なり、ブラウザの検索バーに検索エンジンを追加します。</p> -</div> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h4 id="Documentation" name="Documentation">ドキュメンテーション</h4> - - <p><br> - <strong>全般</strong> (すべての Mozilla アプリケーションに適用):</p> - - <ul> - <li><a href="/ja/Setting_up_extension_development_environment" title="ja/Setting_up_extension_development_environment">拡張機能の開発環境を構築する</a><br> - <small>拡張機能の開発を容易にするために欠かせない、準備に関するノウハウ。</small></li> - <li><a class="internal" href="/ja/Building_an_Extension" title="ja/Building an Extension">拡張機能の作成方法</a><br> - <small>基本的な拡張機能作成の入門的なチュートリアル。</small></li> - <li><a class="internal" href="/ja/Security_best_practices_in_extensions" title="ja/Security best practices in extensions">Security best practices in extensions</a><br> - <small>Guide for developers to ensure users of the extension are safe.</small></li> - <li><a href="/ja/Extension_Packaging" title="ja/Extension_Packaging">拡張機能のパッケージング</a><br> - <small>拡張機能をダウンロード・インストールできるようにするためのパッケージ方法。</small></li> - <li><a href="/ja/Installing_extensions" title="ja/Installing_extensions">拡張機能のインストール</a><br> - <small>プログラム的に拡張機能をインストールする方法。</small></li> - <li><a href="/ja/Submitting_an_add-on_to_AMO" title="ja/Submitting_an_add-on_to_AMO">アドオンの AMO への登録</a><br> - <small>AMO ウェブサイトでアドオンを配布する方法。</small></li> - <li><a href="/ja/Extension_Frequently_Asked_Questions" title="ja/Extension_Frequently_Asked_Questions">拡張機能に関する FAQ</a><br> - <small>拡張機能の開発についての一般的な質問と回答。</small></li> - <li><a href="/ja/Code_snippets" title="ja/Code_snippets">コードサンプル</a><br> - <small>多くの拡張機能で利用されている一般的なコードをご紹介します。<a href="/Special:Tags?tag=Extensions&language=ja" title="Special:Tags?tag=Extensions&language=ja">Extensions</a> タグのついた記事を参照すれば、より多くの例をご覧いただけます</small></li> - </ul> - - <p><a class="internal" href="/ja/Extensions/Firefox" title="ja/Extensions/Firefox"><strong>Firefox</strong></a></p> - - <p><a class="internal" href="/ja/Extensions/Thunderbird" title="ja/Extensions/Thunderbird"><strong>Thunderbird</strong></a></p> - - <p><a class="internal" href="/ja/Extensions/SeaMonkey" title="ja/Extensions/SeaMonkey"><strong>SeaMonkey</strong></a> <a class="internal" href="/ja/Extensions_support_in_SeaMonkey_2" title="ja/Extensions_support_in_SeaMonkey_2"> </a></p> - - <p><a class="external" href="http://starkravingfinkle.org/blog/2009/05/resources-for-fennec-add-on-developers/" title="http://starkravingfinkle.org/blog/2009/05/resources-for-fennec-add-on-developers/"><strong>Fennec</strong></a> (モバイルブラウザ)</p> - - <p> </p> - - <p><span class="alllinks"><a href="/Special:Tags?tag=Extensions&language=ja" title="Special:Tags?tag=Extensions&language=ja">すべて見る...</a></span></p> - </td> - <td> - <h4 id="Community" name="Community">コミュニティ</h4> - - <ul> - <li>Mozilla 拡張機能開発フォーラムを見る...</li> - <li>{{ DiscussionList("dev-extensions", "mozilla.dev.extensions") }}</li> - </ul> - - <ul> - <li><a class="link-irc" href="irc://irc.mozilla.org/extdev">#extdev IRC channel</a></li> - <li><a class="external" href="http://forums.mozillazine.org/?c=11">MozillaZine forum</a></li> - <li><a class="external" href="/devnews/index.php/categories/about-addons" title="https://developer.mozilla.org/editor/fckeditor/core/editor/devnews/index.php/categories/about-addons/">about:addons newsletter</a></li> - <li><a class="external" href="/web-tech" title="https://developer.mozilla.org/editor/fckeditor/core/editor/web-tech/">Mozilla's Web-Tech blog</a></li> - <li><a class="external" href="http://mozdev.org/mailman/listinfo/project_owners">mozdev project owners</a></li> - <li><a class="external" href="http://planet.mozilla.org/" title="http://planet.mozilla.org/">Planet Mozilla</a></li> - <li><a href="/ja/Extensions/Community" title="ja/Extensions/Community">他のコミュニティへのリンク...</a></li> - </ul> - - <h4 id="Tools" name="Tools">ツール</h4> - - <ul> - <li><a class="link-https" href="https://addons.mozilla.org/ja/firefox/addon/6622" rel="external nofollow" title="https://addons.mozilla.org/ja/firefox/addon/6622">DOM Inspector</a> 実際の DOM を編集 (Firefox と Thunderbird)</li> - <li><a class="external" href="http://www.hacksrus.com/~ginda/venkman/" rel="external nofollow" title="http://www.hacksrus.com/~ginda/venkman/">Venkman</a>, JavaScript デバッガ (<a class="external" href="http://addons.mozilla.org/ja/firefox/addon/216" rel="external nofollow" title="http://addons.mozilla.org/ja/firefox/addon/216">Firefox</a>, <a class="external" href="http://addons.mozilla.org/ja/thunderbird/addon/216" rel="external nofollow" title="http://addons.mozilla.org/ja/thunderbird/addon/216">Thunderbird</a>)</li> - <li><a class="link-https" href="https://addons.mozilla.org/ja/firefox/addon/7434/" rel="external nofollow" title="https://addons.mozilla.org/ja/firefox/addon/7434/">Extension Developer's Extension</a> 開発者向けの必須ユーティリティを統合</li> - <li><a class="external" href="http://www.gijsk.com/" rel="external nofollow" title="http://www.gijsk.com/">Chrome List</a> chrome:// のファイルを表示 (<a class="external" href="http://addons.mozilla.org/ja/firefox/addon/4453" rel="external nofollow" title="http://addons.mozilla.org/ja/firefox/addon/4453">Firefox</a>, <a class="external" href="http://addons.mozilla.org/ja/thunderbird/addon/4453" rel="external nofollow" title="http://addons.mozilla.org/ja/thunderbird/addon/4453">Thunderbird</a>)</li> - <li><a class="external" href="http://ted.mielczarek.org/code/mozilla/extensionwiz/" rel="external nofollow" title="http://ted.mielczarek.org/code/mozilla/extensionwiz/">Extension Wizard</a> ウェブベースで拡張機能のスケルトンを生成 (Firefox と Thunderbird)</li> - <li><a href="/ja/JavaScript_shells" title="ja/JavaScript_shells">JavaScript Shells</a> JavaScript のテスト用コード</li> - </ul> - ... <a class="internal" href="/ja/Setting_up_extension_development_environment#Development_extensions" title="ja/Setting up extension development environment#Development extensions">その他のツール</a> ... - - <h4 id="Related_Topics" name="Related_Topics">関連事項</h4> - - <dl> - <dd><a href="/ja/XUL" title="ja/XUL">XUL</a>, <a href="/ja/JavaScript" title="ja/JavaScript">JavaScript</a>, <a href="/ja/XPCOM" title="ja/XPCOM">XPCOM</a>, <a href="/ja/Themes" title="ja/Themes">テーマ</a>, <a href="/ja/Developing_Mozilla" title="ja/Developing_Mozilla">Mozilla の開発</a></dd> - </dl> - </td> - </tr> - </tbody> -</table> - -<p><span class="comment">Categories</span></p> - -<p><span class="comment">Interwiki Language Links</span></p> diff --git a/files/ja/extensions/inline_options/index.html b/files/ja/extensions/inline_options/index.html deleted file mode 100644 index 83665cffab..0000000000 --- a/files/ja/extensions/inline_options/index.html +++ /dev/null @@ -1,172 +0,0 @@ ---- -title: インラインオプション -slug: Extensions/Inline_Options -tags: - - Add-ons - - Extensions - - XUL -translation_of: Archive/Add-ons/Inline_Options ---- -<p>{{ gecko_minversion_header("7.0") }}</p> -<p>Firefox 7 以降、拡張機能の設定を定義する新たな構文が使えるようになりました。これは <a href="/ja/docs/Extensions/Bootstrapped_extensions">ブートストラップ型</a> と従来型のいずれでも使用可能です。この新たな構文で定義された設定のユーザインタフェース (UI) は、<a href="/ja/docs/Addons/Add-on_Manager">アドオンマネージャ</a> 内の拡張機能詳細画面に追加されます。この機能は元々 Android 版 Firefox 向けに提供されたもので、後にデスクトップ版 Firefox も対応しました。</p> -<h2 id="オプションファイル">オプションファイル</h2> -<p>インラインオプションに使用可能な XUL は <a class="external" href="http://mxr.mozilla.org/mozilla-central/source/toolkit/mozapps/extensions/content/setting.xml">いくつかの新要素</a> に限られています。以下が <code>options.xul</code> ファイルの例です。</p> -<pre class="brush: xml"><?xml version="1.0"?> - -<!DOCTYPE mydialog SYSTEM "chrome://myaddon/locale/mydialog.dtd"> - -<vbox xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - <setting type="bool" pref="extensions.myaddon.bool" title="Boolean" desc="真偽値の設定として保存されます" /> -</vbox> -</pre> -<p>なお、ここで実際に使われるのは <code><setting></code> 要素だけです。ルートの <code><vbox></code> は単なるコンテナとして機能し、メイン画面には組み込まれません。スクリプトによる処理を追加したい場合は、下記 <a href="#Display_notifications">表示通知</a> の項目を参照してください。</p> -<h2 id="設定の種類">設定の種類</h2> -<p><code><setting></code> にはいくつかの種類があり、それぞれ異なる <code>type</code> 属性を持ちます。</p> -<table class="standard-table"> - <tbody> - <tr> - <td class="header">type 属性</td> - <td class="header">表示形式</td> - <td class="header">設定の保存形式</td> - </tr> - <tr> - <td><code>bool</code></td> - <td>{{ XULElem("checkbox") }}</td> - <td>真偽値</td> - </tr> - <tr> - <td><code>boolint</code></td> - <td>{{ XULElem("checkbox") }}</td> - <td>整数値 (保存される値を指定するには <code>on</code>/<code>off</code> 属性を使用します)</td> - </tr> - <tr> - <td><code>integer</code></td> - <td>{{ XULElem("textbox") }}</td> - <td>整数値</td> - </tr> - <tr> - <td><code>string</code></td> - <td>{{ XULElem("textbox") }}</td> - <td>文字列</td> - </tr> - <tr> - <td><code>color</code></td> - <td>{{ XULElem("colorpicker") }}</td> - <td>文字列 (<code>#123456</code> の形式)</td> - </tr> - <tr> - <td><code>file</code></td> - <td>参照ボタンとラベル</td> - <td>文字列</td> - </tr> - <tr> - <td><code>directory</code></td> - <td>参照ボタンとラベル</td> - <td>文字列</td> - </tr> - <tr> - <td><code>menulist</code> {{ gecko_minversion_inline("8.0") }}</td> - <td>{{ XULElem("menulist") }}</td> - <td>メニュー項目の値による</td> - </tr> - <tr> - <td><code>radio</code> {{ gecko_minversion_inline("8.0") }}</td> - <td>{{ XULElem("radio") }} ボタン</td> - <td>ラジオボタンの値による</td> - </tr> - <tr> - <td><code>control</code></td> - <td>{{ XULElem("button") }}</td> - <td>設定は保存されません</td> - </tr> - </tbody> -</table> -<p> -<code>pref</code> 属性には保存する設定をフルネームで記述します。 -<code>title</code> 属性はコントロールのラベルとして使われます。説明を追加するには、<code>desc</code> 属性を使うか、<code><setting></code> の子ノードとしてテキストを記述します。</p> -<p>設定は実際の設定値と紐付けられます。ただし、主にアクションに設計されているボタン形式の設定は除きます。</p> -<p>以下にいくつかの例を挙げます。</p> -<pre class="brush: xml"><!-- 真偽値の例 --> -<setting pref="extensions.myaddon.bool1" type="bool" title="真偽値 1"/> -<setting pref="extensions.myaddon.bool2" type="bool" title="真偽値 2"> - 真偽値 2 の説明 -</setting> - -<!-- 整数値として保存される真偽値 --> -<setting pref="extensions.myaddon.boolInt" type="boolint" title="真偽値 3" on="1" off="2"/> - -<!-- 整数値の例 --> -<setting pref="extensions.myaddon.int" type="integer" title="整数値"/> - -<!-- 文字列の例 --> -<setting pref="extensions.myaddon.text" type="string" title="テキスト"/> -<setting pref="extensions.myaddon.password" type="string" title="パスワード" inputtype="password"/> - -<!-- 色の例 --> -<setting pref="extensions.myaddon.color" type="color" title="色"/> - -<!-- ファイルとディレクトリの例 --> -<setting pref="extensions.myaddon.file" type="file" title="ファイル"/> -<setting pref="extensions.myaddon.directory" type="directory" title="ディレクトリ"/> - -<!-- リストの例 (この例では整数値として保存されます) --> -<setting pref="extensions.myaddon.options1" type="menulist" title="オプション 1"> - <menulist> - <menupopup> - <menuitem value="500" label="小"/> - <menuitem value="800" label="中"/> - <menuitem value="1200" label="大"/> - </menupopup> - </menulist> -</setting> - -<!-- ラジオボタンの例 (この例では真偽値として保存されます) --> -<setting pref="extensions.myaddon.options2" type="radio" title="オプション 2"> - <radiogroup> - <radio value="false" label="無効"/> - <radio value="true" label="有効"/> - </radiogroup> -</setting> - -<!-- ボタンの例 - 設定と紐付けられておらず、代わりにコマンドが設定されています --> -<setting title="何かする" type="control"> - <button id="myaddon-button" label="ここをクリック" oncommand="alert('ありがとう！');"/> -</setting> -</pre> -<h2 id="表示通知">表示通知</h2> -<p>設定を保存する用途以外にも設定 UI を使いたい場合は、最初に画面へ組み込まれる前に UI を初期化する必要があるでしょう。オプション XUL がアドオンマネージャ画面へ読み込まれるまではそうした処理ができないため、<code>addon-options-displayed</code> 通知を監視し、設定を初期化します。例えば、</p> -<pre class="brush: js">var observer = { - observe: function(aSubject, aTopic, aData) { - if (aTopic == "addon-options-displayed" && aData == "MY_ADDON@MY_DOMAIN") { - var doc = aSubject; - var control = doc.getElementById("myaddon-pref-control"); - control.value = "テスト"; - } - } -}; - -Services.obs.addObserver(observer, "addon-options-displayed", false); -// アドオンの終了時にオブザーバを削除するのを忘れないでください -</pre> -<p>このコードは、ブートストラップ型拡張機能の場合は <code>bootstrap.js</code> (<code>startup()</code> 関数内) に記述します。従来型拡張機能の場合は (オーバーレイではなく) XPCOM コンポーネントか <a href="/ja/docs/JavaScript_code_modules">JavaScript コードモジュール</a> に記述します。</p> -<div class="geckoVersionNote" style=""> - <p>{{ gecko_callout_heading("13.0") }}</p> - <p>Gecko 13.0 {{ geckoRelease("13.0") }} 以降、<code>addon-options-hidden</code> 通知も監視できるようになりました。これは上と同じサブジェクトとデータを持ち、UI が削除されようとするタイミングを把握できます。この通知を使って、イベントリスナーなど、削除しないとリークする可能性のある参照を削除しましょう。</p> -</div> -<h2 id="オプションファイルの場所の指定">オプションファイルの場所の指定</h2> -<p>アドオンマネージャがインラインオプションファイルを見つけられるようにする方法は 2 通りあります。</p> -<ul> - <li>ファイル名を <code>options.xul</code> とし、拡張機能のルートディレクトリに (<code>install.rdf</code> と同列に) 置く</li> - <li><a href="/ja/docs/Install_Manifests"><code>install.rdf</code></a> を使ってオプションを表示する XUL を指定する。インラインオプションの場合、値を <code>2</code> とした <code>optionsType</code> を追加する必要もあります。 - <pre class="deki-transform"><em:optionsURL><span class="plain">chrome://myaddon/content/options.xul</span></em:optionsURL> -<em:optionsType>2</em:optionsType> -</pre> - 以下のように <a href="/ja/docs/Chrome_Registration"><code>chrome.manifest</code></a> にオーバーライドを追加することで、Firefox の旧バージョンとの互換性を保つことができます。 - <pre class="deki-transform"><span class="plain">override chrome://myaddon/content/options.xul chrome://myaddon/content/oldOptions.xul application={ec8030f7-c20a-464f-9b0e-13a3a9e97384} appversion<=6.*</span> -</pre> - </li> -</ul> -<h2 id="参考資料">参考資料</h2> -<ul> - <li><a class="link-https" href="https://wiki.mozilla.org/Mobile/Fennec/Extensions/Options">https://wiki.mozilla.org/Mobile/Fennec/Extensions/Options</a></li> -</ul> diff --git a/files/ja/extensions/other_resources/index.html b/files/ja/extensions/other_resources/index.html deleted file mode 100644 index 080c30c10a..0000000000 --- a/files/ja/extensions/other_resources/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: その他の情報源 -slug: Extensions/Other_Resources -tags: - - Add-ons - - Extensions -translation_of: Extensions/Other_Resources ---- -<ul> - <li><del>XUL Planet</del></li> - <li><a class="external" href="http://kb.mozillazine.org/Extension_development">Extension development</a> (MozillaZine)</li> - <li><a class="external" href="http://mozilla-firefox-extension-dev.blogspot.com/">Mozilla & Firefox Extension Development blog</a></li> - <li><a class="external" href="http://thunderbirddocs.blogspot.com/">Thunderbird-based extension development</a></li> -</ul> diff --git a/files/ja/extensions/seamonkey/index.html b/files/ja/extensions/seamonkey/index.html deleted file mode 100644 index fd7e36b3d4..0000000000 --- a/files/ja/extensions/seamonkey/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: SeaMonkey -slug: Extensions/SeaMonkey -tags: - - Add-ons - - SeaMonkey - - extensiones -translation_of: Archive/Add-ons/SeaMonkey_2 ---- -<h4 id="Documentation">ドキュメンテーション</h4> -<p> </p> -<ul> <li><a class="internal" href="/ja/Extensions_support_in_SeaMonkey_2" title="ja/Extensions_support_in_SeaMonkey_2">拡張機能の SeaMonkey 2.0 向けの更新</a> <small>Details the changes necessary to get your Firefox, Thunderbird, or SeaMonkey 1.x extension working in SeaMonkey 2.0.</small></li> -</ul> -<div class="noinclude"> -<p>{{ languages( { "en": "en/Extensions/SeaMonkey" } ) }}</p> -</div> diff --git a/files/ja/extensions/thunderbird/building_a_thunderbird_extension/index.html b/files/ja/extensions/thunderbird/building_a_thunderbird_extension/index.html deleted file mode 100644 index 9c5ceab673..0000000000 --- a/files/ja/extensions/thunderbird/building_a_thunderbird_extension/index.html +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: 'Thunderbird 拡張機能のビルド その１: 導入' -slug: Extensions/Thunderbird/Building_a_Thunderbird_extension -tags: - - Add-ons - - Extensions - - thunderbird -translation_of: Mozilla/Thunderbird/Thunderbird_extensions/Building_a_Thunderbird_extension ---- -<p>{{AddonSidebar}}</p> - -<p>Thunderbird は、Mozilla のオープンソースのメールアプリケーションです。 Thunderbird では、<a href="/ja/docs/JavaScript" title="JavaScript">JavaScript</a>、<a href="/ja/docs/Gecko" title="Gecko">Gecko</a>（レイアウトエンジン、<a href="/ja/docs/XUL" title="XUL">XUL</a>（XMLユーザインタフェース言語）、<a href="/ja/docs/XPCOM" title="XPCOM">XPCOM</a>（クロスプラットフォームコンポーネントオブジェクトモデル）など、 Firefox で用いられる多くの技術が利用されています。Firefoxと同じように、Thunderbirdの機能は <a class="external" href="http://addons.mozilla.org/en-US/thunderbird/" title="http://addons.mozilla.org/thunderbird/">拡張機能</a>を使ってカスタマイズできます。</p> - -<p>このチュートリアルでは、Thunderbird 拡張機能の導入とビルド方法を説明します。チュートリアルの構成は次の通りです。</p> - -<ol> - <li>導入(このページ)</li> - <li><a href="/ja/docs/Extensions/Thunderbird/Building_a_Thunderbird_extension_2:_extension_filesystem" title="Extensions/Thunderbird/Building a Thunderbird extension 2: extension filesystem">拡張機能のファイル構成</a> （開発環境の準備）</li> - <li><a href="/ja/docs/Extensions/Thunderbird/Building_a_Thunderbird_extension_3:_install_manifest" title="Extensions/Thunderbird/Building a Thunderbird extension 3: install manifest">インストール マニフェスト</a>（<code>install.rdf</code>ファイルに拡張機能のメタ情報を記載）</li> - <li><a href="/ja/docs/Extensions/Thunderbird/Building_a_Thunderbird_extension_4:_chrome_manifest" title="Extensions/Thunderbird/Building a Thunderbird extension 4: chrome manifest">Chrome マニフェスト</a>（パッケージとオーバーレイの一覧）</li> - <li><a href="/ja/docs/Extensions/Thunderbird/Building_a_Thunderbird_extension_5:_XUL" title="Extensions/Thunderbird/Building a Thunderbird extension 5: XUL">XUL</a> （XML ユーザインタフェース言語で、Thunderbirdのユーザインタフェースを変更する）</li> - <li><a href="/ja/docs/Extensions/Thunderbird/Building_a_Thunderbird_extension_6:_Adding_Javascript" title="Extensions/Thunderbird/Building a Thunderbird extension 6: Adding Javascript">JavaScriptの追加</a> （作成したThunderbird拡張機能に簡単なJavaScriptを追加する方法）</li> - <li><a href="/ja/docs/Extensions/Thunderbird/Building_a_Thunderbird_extension_7:_Installation" title="Extensions/Thunderbird/Building a Thunderbird extension 7: Installation">開発環境へのインストール</a> （開発環境のThunderbirdで拡張機能を動作させる）</li> - <li><a href="/ja/docs/Extensions/Thunderbird/Building_a_Thunderbird_extension_8:_packaging" title="Extensions/Thunderbird/Building a Thunderbird extension 8: packaging">パッケージ化</a> （拡張機能を配布するためのパッケージを作る）</li> - <li><a href="/ja/docs/Extensions/Thunderbird/Building_a_Thunderbird_extension_9:_distributing" title="Extensions/Thunderbird/Building a Thunderbird extension 9: distributing">配布</a> （自分のサイト、または、 <a href="http://addons.mozilla.org/" rel="external nofollow" title="http://addons.mozilla.org/">http://addons.mozilla.org/</a>で）</li> -</ol> - -<p>このチュートリアルは、Thunderbird2,3,5 を対象とします。 Thunderbird のビルドはすべて <a href="http://ftp.mozilla.org/pub/mozilla.org/thunderbird/" title="http://ftp.mozilla.org/pub/mozilla.org/thunderbird/">FTPサイト</a>から手に入れることが出来ます。</p> - -<h2 id="References_and_resources" name="References_and_resources">リファレンスとリソース</h2> - -<h3 id="Tools_and_helper_extensions" name="Tools_and_helper_extensions">ツールとヘルパー拡張機能</h3> - -<p>Thunderbird 拡張機能の開発を助ける多くのツールがありますが、少なくとも以下のツールが必要になります。</p> - -<ul> - <li><a href="http://en.wikipedia.org/wiki/List_of_text_editors" title="http://en.wikipedia.org/wiki/List_of_text_editors">テキストエディター</a>: 拡張機能の書くためにプレーンテキストの記述が可能なエディターが必要です。しかし、多くの開発者はコーディングに適したエディタ（もしくは IDE）を用いて、シンタックスハイライトやコードの色づけ、インデント、自動補完などの機能を利用します。</li> - <li><a href="http://en.wikipedia.org/wiki/Comparison_of_file_archivers" title="http://en.wikipedia.org/wiki/Comparison_of_file_archivers">ファイルアーカイバ</a>: アーカイブファイルの作成に対応している必要があります。</li> -</ul> - -<p>この他にも、テストやデバックのための多くの拡張機能やアプリケーションがあります（JavaScriptコンソール、XPCOMインスペクターなど）。これらに関しては、『<a href="/ja/docs/Setting_up_extension_development_environment" title="Setting up extension development environment">Setting up an extension development environment</a>』をご覧ください。</p> - -<h4 id="Add-on_builder" name="Add-on_builder">アドオンビルダー</h4> - -<p>Firefox もしくは Thunderbird 拡張機能フレームワークを自動生成する<a href="https://addons.mozilla.org/ja/developers/tools/builder">アドオンビルダー</a>があり、<a href="https://addons.mozilla.org/ja/developers/">開発者センター</a>から利用できます。アドオンビルダーは web ベースのユーティリティーで、単純なアドオンファイルのスケルトンを zip 形式で作成します。ウィザードを通してアドオンの基本情報を入力することで、必要なフォルダ構成とメタデータとソースファイル群が作成されます。ソースファイル群にはサンプルコードが記入されていて、すぐに手を入れられるようになっています。</p> - -<p>このチュートリアルで学ぶことのできる多くは、アドオンビルダーによって自動生成されますが、ファイル同士の関係性や内容の構成を説明します。このチュートリアルを読み終わるころには、アドオンの一般的な構成とレイアウトを理解できているはずです。アドオンビルダーを使うことで、新しいアドオンの作成を速くすることができます。</p> - -<h3 id="Documentation" name="Documentation">ドキュメント</h3> - -<ul> - <li><a href="/ja/docs/Extensions/Thunderbird" title="Extensions/Thunderbird">Thunderbird</a></li> - <li><a href="/ja/docs/Firefox_addons_developer_guide" title="Firefox addons developer guide">Firefox アドオン開発ガイド</a>（多くのトピックは Thunderbird と共通します）</li> - <li><a href="http://mxr.mozilla.org/comm-central/" title="http://mxr.mozilla.org/comm-central/">Mozilla cross-reference</a> ソースコードブラウザ ("comm-central" は Thunderbird コードリポジトリの機能を持っています)</li> -</ul> - -<h3 id="Community" name="Community">コミュニティ</h3> - -<p>Thunderbird の開発コミュニティには<a href="http://groups.google.com/group/mozilla.dev.apps.thunderbird/topics?lnk" title="http://groups.google.com/group/mozilla.dev.apps.thunderbird/topics?lnk">メーリングリスト</a>があり、検索可能なアーカイブもあります。さらに、 <a class="link-irc" href="irc://moznet/#maildev" title="irc://moznet/#maildev">IRC チャンネル (#maildev)</a> を通じて、コミュニティとコンタクトを取ることが可能です。</p> - -<div>{{Next("Extensions/Thunderbird/Building_a_Thunderbird_extension_2:_extension_filesystem")}}</div> diff --git a/files/ja/extensions/thunderbird/building_a_thunderbird_extension_2_colon__extension_filesystem/index.html b/files/ja/extensions/thunderbird/building_a_thunderbird_extension_2_colon__extension_filesystem/index.html deleted file mode 100644 index e76b389cdc..0000000000 --- a/files/ja/extensions/thunderbird/building_a_thunderbird_extension_2_colon__extension_filesystem/index.html +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: 'Thunderbird 拡張機能のビルド その２: 拡張機能のファイルレイアウト' -slug: >- - Extensions/Thunderbird/Building_a_Thunderbird_extension_2:_extension_filesystem -translation_of: >- - Mozilla/Thunderbird/Thunderbird_extensions/Building_a_Thunderbird_extension_2:_extension_filesystem ---- -<p>拡張機能は <a href="/ja/docs/Bundles">Bundle</a> としても知られる XPI 形式の圧縮ファイルにパッケージ化され、配布されます。それは<strong> install.rdf </strong>と、 <strong>chrome.manifest</strong> 、 <strong>chrome </strong>フォルダを含みます。 <strong>chrome</strong> フォルダは実際のコンテンツファイルを含む、 <strong>content</strong> フォルダを含みます。コンテンツファイルには実際に何かをする機能拡張のコードを含みます。このチュートリアルが終わったとき、あなたの拡張機能は以下のようになるでしょう:</p> -<pre class="eval">myfirstext.xpi: //created in step 8 - /install.rdf //created in step 3 - /chrome.manifest //created in step 4 - /chrome/ - /chrome/content/ - /chrome/content/myhelloworld.xul //created in step 5 - /chrome/content/overlay.js //created in step 6 - /chrome/locale/* //Building an Extension# <a href="/en/Building_an_Extension#Localization" title="https://developer.mozilla.org/en/Building_an_Extension#Localization">Localization</a> - /defaults/preferences/ //Building an Extension# <a href="/en/Building_an_Extension#Defaults_Files" title="https://developer.mozilla.org/en/Building_an_Extension#Defaults_Files">Defaults Files</a> -</pre> -<p>あなたはこれらのファイルを手動で作成するのではなく、開発者センターにある<a href="/ja/developers/tools/builder">アドオンビルダー</a>を使用することが出来ます。これは必須のファイルとフォルダを含んだ拡張機能フレームワークを含む圧縮パッケージを作成します。解凍した圧縮パッケージの中には、 'myfirstext' と呼ばれるディレクトリがあり、このチュートリアルに従うことでそれらのファイルを編集します。</p> -<p>チュートリアルページに従うことで、 <strong>locale</strong> フォルダと <strong>defaults</strong> フォルダの記述方法、XPIファイルへのそれらのファイルのパッケージの方法を経験するでしょう。 あなたはより一般的なドキュメント『<a href="/ja/docs/Building_an_Extension"><strong>拡張機能のビルド</strong></a>』により <strong>locale</strong> フォルダと <strong>defaults</strong> フォルダについての情報を見つけることが出来るでしょう。<br> - <br> - {{ Previous("Extensions/Thunderbird/Building_a_Thunderbird_extension") }}</p> -<p>{{ Next("Extensions/Thunderbird/Building_a_Thunderbird_extension_3:_install_manifest") }}</p> diff --git a/files/ja/extensions/thunderbird/building_a_thunderbird_extension_3_colon__install_manifest/index.html b/files/ja/extensions/thunderbird/building_a_thunderbird_extension_3_colon__install_manifest/index.html deleted file mode 100644 index bdb84748b9..0000000000 --- a/files/ja/extensions/thunderbird/building_a_thunderbird_extension_3_colon__install_manifest/index.html +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: 'Thunderbird 拡張機能のビルド その３: インストールマニフェスト' -slug: 'Extensions/Thunderbird/Building_a_Thunderbird_extension_3:_install_manifest' -translation_of: >- - Mozilla/Thunderbird/Thunderbird_extensions/Building_a_Thunderbird_extension_3:_install_manifest ---- -<p><code>install.rdf</code> は拡張機能についての一般的な情報を提供するXMLファイルです。</p> -<p><br> - もし<a href="/ja/docs/Extensions/Thunderbird/Building_a_Thunderbird_extension_2:_extension_filesystem">前のステップ</a>にて記述にアドオンビルダーを使用した場合、圧縮パッケージ内にある <code>install.rdf</code> をテキストエディタで開いてください。<br> - 以下に記述された要素内の値は、 あなたがフォーム上で供給した値を元に挿入されます。<br> - このファイルはまた、いくつかの付加的な無視することが出来るオプション値を含みます。</p> -<p>もしファイルを手動で作成した場合、以下の手順に従ってください:<br> - あなたの拡張機能のトップディレクトリ階層にある <code>install.rdf</code> を開き、以下のテキストを貼り付けてください。</p> -<pre class="brush: xml"><?xml version="1.0"?> - -<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#" - xmlns:em="http://www.mozilla.org/2004/em-rdf#"> - - <Description about="urn:mozilla:install-manifest"> - <em:id>myfirstext@jen.zed</em:id> - <em:name>My First Extension</em:name> - <em:version>1.0</em:version> - <em:creator>jenzed</em:creator> - - <em:targetApplication> - <Description> - <em:id>{3550f703-e582-4d05-9a08-453d09bdfdc6}</em:id> - <em:minVersion>1.5</em:minVersion> - <em:maxVersion>5.0.*</em:maxVersion> - </Description> - </em:targetApplication> - - </Description> -</RDF> -</pre> -<p>以下のアイテムはあなたのアプリケーションに合わせて、カスタマイズされるべきです:</p> -<ul> - <li><code><strong><em:id><a class="link-mailto" href="mailto:myfirstext@jen.zed" rel="freelink">myfirstext@jen.zed</a></em:id></strong></code>: 拡張機能のIDです。<br> - 前半は拡張機能の短い名前で、英数小文字で無ければなりません。<br> - 後半はあなたのファーストネームとラストネーム、もしくはあなたの web サイトのトップレベルドメインなどのピリオドで区切られた2つのパートからなる値です。<br> - この値は E メールアドレス形式ですが、 E メールアドレスではありません。<br> - 他の拡張機能と衝突しないように一意の値であるべきです。</li> - <li><code><strong><em:name>My First Extension</em:name></strong></code>: 拡張機能の名前です。Thunderbirdのアドオンマネージャに表示されます。</li> - <li><code><strong><em:version>1.0</em:version></strong></code>: 拡張機能のバージョン番号です。<br> - 拡張機能の新しいバージョンをリリースするたびに更新しなければなりません。<br> - それは Thunderbird のバージョン番号ではありません。（ Thunderbird のバージョン番号は <code>minVersion</code> 、 <code>maxVersion</code> に保存されます。）</li> - <li><code><strong><em:creator>jenzed</em:creator></strong></code>: このオプション値は拡張機能の作者名を保存するのに使われます。</li> - <li><code><strong><em:id>{3550f703-e582-4d05-9a08-453d09bdfdc6}</em:id></strong></code>: アドオンが開発対象としているアプリケーション ID です。これは Mozilla によって定義されます。<br> - 正しいアプリケーション ID は<a class="link-https" href="https://addons.mozilla.org/ja/firefox/pages/appversions" title="https://addons.mozilla.org/ja/firefox/pages/appversions">ここで</a>見つけることが出来ます。<br> - 通常、 ID は変更されず、異なるバージョンの Thunderbird においても常に同じです。</li> - <li><strong><code><em:minVersion>1.5</em:minVersion></code></strong>: 拡張機能が動作することを意図している Thunderbird の初期のバージョンです。<br> - ワイルドカード（"*"）は使用できません。<br> - サポートしているバージョン番号とフォーマットの一覧は、『<a class="external" href="https://addons.mozilla.org/ja/firefox/pages/appversions/" title="http://addons.mozilla.org/ja/firefox/pages/appversions">正しいアプリケーションのバージョン</a>』を見てください。</li> - <li><strong><code><em:maxVersion>5.0.*</em:maxVersion></code></strong>: 拡張機能が動作することを意図している Thunderbird の最新のバージョンです。<br> - 現在使用可能なバージョンよりも高くすることが出来ません。<br> - "5.0.*" は拡張機能が Thunderbird 5.0 と任意のマイナーバージョン 5.0.x のリリースにて機能することを示します。<br> - サポートしているバージョン番号とフォーマットの一覧は、『<a class="external" href="https://addons.mozilla.org/ja/firefox/pages/appversions/" title="http://addons.mozilla.org/ja/firefox/pages/appversions">正しいアプリケーションのバージョン</a>』を見てください。</li> -</ul> -<p><code>install.rdf に記述することが出来るオプション値はもっとあります。それらは</code> 『<a class="internal" href="/ja/docs/Install_Manifests" title="ja/Install Manifests">Install Manifests</a>』に記載されています。<br> - Description 要素の子要素である限り、任意の順番で指定できます。</p> -<p>{{ Previous("Extensions/Thunderbird/Building_a_Thunderbird_extension_2:_extension_filesystem") }}</p> -<p>{{ Next("Extensions/Thunderbird/Building_a_Thunderbird_extension_4:_chrome_manifest") }}</p> diff --git a/files/ja/extensions/thunderbird/building_a_thunderbird_extension_4_colon__chrome_manifest/index.html b/files/ja/extensions/thunderbird/building_a_thunderbird_extension_4_colon__chrome_manifest/index.html deleted file mode 100644 index e12df260ba..0000000000 --- a/files/ja/extensions/thunderbird/building_a_thunderbird_extension_4_colon__chrome_manifest/index.html +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: 'Thunderbird 拡張機能のビルド その４: chrome マニフェスト' -slug: 'Extensions/Thunderbird/Building_a_Thunderbird_extension_4:_chrome_manifest' -translation_of: >- - Mozilla/Thunderbird/Thunderbird_extensions/Building_a_Thunderbird_extension_4:_chrome_manifest ---- -<p><code>chrome.manifest</code> は Thunderbird に対して、パッケージと拡張機能によって提供されるオーバーレイを伝えます。<br> - 作成した <code>chrome.manifest</code> を開き、以下のコードを追加してください。</p> -<pre class="eval">content myfirstext chrome/content/ -</pre> -<ul> - <li><code><strong>content</strong></code> はパッケージ内のマテリアルの種類を示します。</li> - <li><code><strong>myfirstext</strong></code> は<code>chome パッケージの名前を示します。</code> <code>install.rdf 内の</code> <code><em:id> 要素の最初のセグメントで記述したものと同じです。</code></li> - <li><code><strong>chrome/content/</strong></code> は <code>chrome ネームスペース内のパッケージファイルの場所を示します。</code></li> -</ul> -<p>この行はクロムパッケージである <code><strong>myfirstext </strong>のため、私たちが </code><code>chrome.manifest からの相対パスである </code><code style="font: normal normal normal 100%/normal 'Courier New', 'Andale Mono', monospace; color: inherit; font-weight: inherit;">chrome</code>/<code>content</code>/ から、<code>それらの </code><strong>content</strong> ファイルを見つけることが出来ることを表しています。</p> -<p>拡張機能のサポート用に Thunderbird のユーザーインタフェースを変更するため、あなたはオーバレイを作成し、デフォルトの Thunderbird のインターフェースへ統合します。このチュートリアルの後、私たちは<code>デフォルトの messenger.xul</code> に統合するための、 XUL オーバレイファイル を作成するでしょう。ここでのポイントは、私たちは<code>chrome.manifest</code> に作成した後のオーバレイの存在を記入することでしょう。</p> -<p> <code>chrome.manifest の最終行に以下の行を追加してください。</code></p> -<div id="section_8"> - <pre class="eval">overlay <a class="external" rel="freelink">chrome://messenger/content/messenger.xul</a> <a class="external" rel="freelink">chrome://myfirstext/content/myhelloworld.xul</a> -</pre> - これは Thunderbird に対して、 <code>messenger.xul が読み込まれた際に、</code> <code>messenger.xul の中に</code> <code>myhelloworld.xul</code> を統合することを伝えます。<br> - chrome マニフェストのより多くの情報とプロパティをサポートしています。<br> - 『<a href="/ja/docs/Chrome_Registration" rel="internal"> Chrome Manifest </a>』リファレンスを見てください。 - <p> </p> - <p>もし<a href="https://developer.mozilla.org/ja/docs/Extensions/Thunderbird/Building_a_Thunderbird_extension_2:_extension_filesystem">前のステップ</a>にて記述にアドオンビルダーを使用した場合、圧縮パッケージ内にある <code>chrome.manifest</code> をテキストエディタで開いてください。あなたは最初の行にある <code>content</code> の行を見るでしょう。最終行に <code>overlay</code> の行を追加してください。他の<code>overlay</code> の行があったとしても問題にはなりません。</p> -</div> -<div class="note"> - XUL ファイルのレイアウトについてより理解し、あなた自身のオーバレイをデバッグするために <strong><a href="/ja/docs/DOM_Inspector">DOM Inspector </a></strong>のようなアドオンをインストールすることでより便利にすることが出来ます。</div> -<p>{{ Previous("Extensions/Thunderbird/Building_a_Thunderbird_extension_3:_install_manifest") }}</p> -<p>{{ Next("Extensions/Thunderbird/Building_a_Thunderbird_extension_5:_XUL") }}</p> diff --git a/files/ja/extensions/thunderbird/building_a_thunderbird_extension_5_colon__xul/index.html b/files/ja/extensions/thunderbird/building_a_thunderbird_extension_5_colon__xul/index.html deleted file mode 100644 index 30d7902fe8..0000000000 --- a/files/ja/extensions/thunderbird/building_a_thunderbird_extension_5_colon__xul/index.html +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: 'Thunderbird 拡張機能のビルド その５: XUL' -slug: 'Extensions/Thunderbird/Building_a_Thunderbird_extension_5:_XUL' -translation_of: >- - Mozilla/Thunderbird/Thunderbird_extensions/Building_a_Thunderbird_extension_5:_XUL ---- -<p>Thunderbird のユーザインタフェースは <a href="/ja/XUL" title="https://developer.mozilla.org/en/XUL">XUL </a>と <a href="/ja/JavaScript" title="https://developer.mozilla.org/en/JavaScript">JavaScript</a> で記述されています。 XUL はボタン、メニュー、ツールバー、ツリーなどのようなユーザーインタフェースウィジェットを提供する XML です。私たちは新しい XUL DOM 要素をアプリケーションウィンドウに挿入するか、スクリプトを使用する、もしくはイベントハンドラをアタッチしてそれらを変更することによって、ウィジェットを追加します。 While XUL provides the elements of the user interface, actions are written in JavaScript.</p> -<p>私たちの最初の拡張機能で、 Thunderbird のステータスバーにいくつかのテキストを追加します。ステータスバーは <code>messenger.xul</code> の中で実装されています。 To view this XUL file use the <a class="link-https" href="https://addons.mozilla.org/en-US/thunderbird/addon/dom-inspector/" title="https://addons.mozilla.org/en-US/thunderbird/addon/dom-inspector/">DOM Inspector</a> extension or look inside the <a href="/en/About_omni.jar" title="en/About omni.jar">omni.jar</a> archive. <code>messenger.xul</code> の中で、以下のようなステータスバーの記述を見つけるでしょう。</p> -<pre class="brush: xml"><statusbar id="status-bar"> - ... <statusbarpanel>s ... -</statusbar> -</pre> -<p><span class="nowiki"><code><statusbar id="status-bar"></code></span> is a "merge point" for a XUL overlay. <a href="../../../../en/XUL_Overlays" rel="internal">XUL Overlays</a> are a way of attaching other UI widgets to a XUL document at run time. A XUL Overlay is a <code>.xul</code> file that specifies XUL fragments to insert at specific merge points within a <strong>"</strong>master<strong>"</strong> document. These fragments can specify widgets to be inserted, removed or modified.</p> -<p>In this example you are adding a line to the indented statusbar. Therefore it becomes an item owned by the id called "<code>status-bar</code>". This shows how the Thunderbird architecture allows extensions to modify the user experience without modifying the installation files. This also enables version independence between Thunderbird and Thunderbird extensions.</p> -<p><strong>Example XUL Overlay Document</strong></p> -<pre class="brush: html"><?xml version="1.0"?> -<overlay id="sample" -xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - <script type="application/javascript" src="chrome://myfirstext/content/overlay.js"/><!-- A reference to your JavaScript file --> - <statusbar id="status-bar"> - <statusbarpanel id="my-panel" label="Date"/> - </statusbar> -</overlay> -</pre> -<p>The <span class="nowiki"><code><statusbar</code>></span> widget named <code><strong>status-bar</strong></code> specifies the merge point within the application window that we want to attach to. When parsing our overlay file, the XUL engine will take all child elements of the <span class="nowiki"><statusbar></span> tag and merge them with the original XUL document's <span class="nowiki"><statusbar></span> tag. In the example above we have defined a new <span class="nowiki"><statusbarpanel></span> item (that can be referred to as <strong><code>my-panel</code></strong>) which will create a new instance of this widget type and add it at the end of the statusbar. In Thunderbird it will appear as a label at the right side of Thunderbird's statusbar and display "Date". We have also added a <script> tag that contains a reference to the JavaScript file <strong><code>overlay.js</code></strong>. In the next section you will learn how to use JavaScript to modify your label so that it shows the current date.</p> -<p>Take the sample code from above and save it into a new file called <code><strong>myhelloworld.xul</strong></code> within the <code>content</code> folder you created earlier.</p> -<div class="note"> - The <strong>overlay.js</strong> file will be created in a later section and your add-on will still work if the file is missing. For now you can ignore this line, but remember that this is how you reference a JavaScript file.</div> -<p>{{ PreviousNext("Extensions/Thunderbird/Building_a_Thunderbird_extension_4:_chrome_manifest", "Extensions/Thunderbird/Building_a_Thunderbird_extension_6:_Adding_Javascript") }}</p> diff --git a/files/ja/extensions/thunderbird/faq/index.html b/files/ja/extensions/thunderbird/faq/index.html deleted file mode 100644 index 72abe3fb68..0000000000 --- a/files/ja/extensions/thunderbird/faq/index.html +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: FAQ -slug: Extensions/Thunderbird/FAQ -tags: - - Add-ons - - Extensions - - 要更新 -translation_of: Mozilla/Thunderbird/Thunderbird_extensions/FAQ ---- -<p>これは <a href="ja/Extensions/Thunderbird">Thunderbird 拡張機能</a>の開発における最も一般的な問題に対する簡単な回答集です。</p> -<p>開発についてのドキュメントは、私たちのチュートリアルや <a href="ja/Building_a_Thunderbird_extension">Thunderbird 拡張機能の構築</a>または MozillaZine の <a href="ja/Getting_started_with_extension_development_(external)">Getting started tutorial</a>(英語) をお試しください。</p> -<p>{{ 英語版章題("Setting up a development environment") }}</p> -<h3 id=".E9.96.8B.E7.99.BA.E7.92.B0.E5.A2.83.E3.82.92.E3.82.BB.E3.83.83.E3.83.88.E3.82.A2.E3.83.83.E3.83.97.E3.81.99.E3.82.8B" name=".E9.96.8B.E7.99.BA.E7.92.B0.E5.A2.83.E3.82.92.E3.82.BB.E3.83.83.E3.83.88.E3.82.A2.E3.83.83.E3.83.97.E3.81.99.E3.82.8B">開発環境をセットアップする</h3> -<p>開発の前に<a href="ja/Setting_up_extension_development_environment">拡張機能の開発環境のセットアップ</a>を読むのを忘れないでください！</p> -<p>{{ 英語版章題("Creating a Development Profile") }}</p> -<h4 id=".E9.96.8B.E7.99.BA.E7.94.A8.E3.83.97.E3.83.AD.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.82.92.E4.BD.9C.E6.88.90.E3.81.99.E3.82.8B" name=".E9.96.8B.E7.99.BA.E7.94.A8.E3.83.97.E3.83.AD.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.82.92.E4.BD.9C.E6.88.90.E3.81.99.E3.82.8B">開発用プロファイルを作成する</h4> -<p>Thunderbird のナイトリービルドや拡張機能の開発は、あなたのプロファイルやメールを破壊する可能性があるため、プロファイルを分けて開発したものを実行する必要があります。新しいプロファイルを作成するには、シェル (または DOS プロンプト) を開き、次のコマンドを実行してください:</p> -<pre>thunderbird -ProfileManager</pre> -<p>このプロファイルの内部を調べるために、他のプロファイルよりもアクセスしやすいパスと名前にしたいでしょう。</p> -<p>新しいプロファイルで起動するのは簡単です:</p> -<pre>thunderbird -P "profile name"</pre> -<p>{{ 英語版章題("Running Simultaneous Copies of Thunderbird With Different Profiles") }}</p> -<h4 id=".E7.95.B0.E3.81.AA.E3.82.8B.E3.83.97.E3.83.AD.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.81.A7_Thunderbird_.E3.81.AE.E3.82.B3.E3.83.94.E3.83.BC.E3.82.92.E5.90.8C.E6.99.82.E3.81.AB.E8.B5.B7.E5.8B.95.E3.81.99.E3.82.8B" name=".E7.95.B0.E3.81.AA.E3.82.8B.E3.83.97.E3.83.AD.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.81.A7_Thunderbird_.E3.81.AE.E3.82.B3.E3.83.94.E3.83.BC.E3.82.92.E5.90.8C.E6.99.82.E3.81.AB.E8.B5.B7.E5.8B.95.E3.81.99.E3.82.8B">異なるプロファイルで Thunderbird のコピーを同時に起動する</h4> -<p>Thunderbird を異なるプロファイルで起動するには、あなたの個人プロファイルで実行する Thunerbird を残したまま起動するために、次のように環境変数 <i>MOZ_NO_REMOTE</i> を設定する必要があります:</p> -<pre>Windows: set MOZ_NO_REMOTE=1 -*nix: export MOZ_NO_REMOTE=1 -</pre> -<p>便利な方法として、この変数をエクスポートしたシェルスクリプトやバッチファイルから Thunderbird を開発用のプロファイルで起動すると手軽に行うことができます。</p> -<p>{{ languages( { "en": "en/Extensions/Thunderbird/FAQ" } ) }}</p> diff --git a/files/ja/extensions/thunderbird/howtos/common_thunderbird_extension_techniques/add_new_tab/index.html b/files/ja/extensions/thunderbird/howtos/common_thunderbird_extension_techniques/add_new_tab/index.html deleted file mode 100644 index 5d27fc45e1..0000000000 --- a/files/ja/extensions/thunderbird/howtos/common_thunderbird_extension_techniques/add_new_tab/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: 新しいタブの追加 -slug: >- - Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Add_New_Tab -tags: - - missing - - thunderbird -translation_of: >- - Mozilla/Thunderbird/Thunderbird_extensions/HowTos/Common_Thunderbird_Extension_Techniques/Add_New_Tab ---- -<pre class="brush: js">var aURL = "chrome://myext/mytab.xul"; -let tabmail = getMail3Pane().document.getElementById("tabmail"); - -tabmail.openTab("chromeTab", { chromePage: aUrl }); -</pre> diff --git a/files/ja/extensions/thunderbird/howtos/common_thunderbird_extension_techniques/add_toolbar_button/index.html b/files/ja/extensions/thunderbird/howtos/common_thunderbird_extension_techniques/add_toolbar_button/index.html deleted file mode 100644 index 70e174ce3f..0000000000 --- a/files/ja/extensions/thunderbird/howtos/common_thunderbird_extension_techniques/add_toolbar_button/index.html +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: ツールバーボタンの追加 -slug: >- - Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Add_Toolbar_Button -translation_of: >- - Mozilla/Thunderbird/Thunderbird_extensions/HowTos/Common_Thunderbird_Extension_Techniques/Add_Toolbar_Button ---- -<p>XUL オーバーレイのコード例を示します。</p> -<pre class="brush: js"><?xml version="1.0"?> -<?xml-stylesheet href="chrome://demo/skin/overlay.css" type="text/css" ?> - -<overlay id="messengerWindow" xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"> - <script type="application/x-javascript" src="overlay.js" /> - <toolbarpalette id="MailToolbarPalette"> - <toolbarbutton id="demo-button" - class="demo-button toolbarbutton-1" - label="Demo" - type="button" - oncommand="Demo.load();" - /> - </toolbarpalette> -</overlay> -</pre> -<p>以下のコードを CSS ファイルに追加し、 XUL ファイルから参照して下さい。</p> -<pre class="brush: css">#demo-button, [place="palette"] > #demo-button { - list-style-image: url("chrome://demo/skin/icon.png") !important; -} -</pre> diff --git a/files/ja/extensions/thunderbird/howtos/common_thunderbird_extension_techniques/get_thunderbird_version/index.html b/files/ja/extensions/thunderbird/howtos/common_thunderbird_extension_techniques/get_thunderbird_version/index.html deleted file mode 100644 index 4432c0d93c..0000000000 --- a/files/ja/extensions/thunderbird/howtos/common_thunderbird_extension_techniques/get_thunderbird_version/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Thunderbird のバージョンの取得 -slug: >- - Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Get_Thunderbird_version -tags: - - thunderbird -translation_of: >- - Mozilla/Thunderbird/Thunderbird_extensions/HowTos/Common_Thunderbird_Extension_Techniques/Get_Thunderbird_version ---- -<p>Thunderbird 3.0b3pre とそれ以降のバージョンでは、以下のスニペットを用いて Thunderbird のバージョンを取得する事ができます。<br> -（※ 3.0b3pre は <a href="/ja/docs/Toolkit_API/STEEL" title="Toolkit API/STEEL">STEEL</a> がインクルードされた最初のバージョンでした）</p> - - -<pre class="brush:js">var versionChecker = Components.classes["@mozilla.org/xpcom/version-comparator;1"].getService( - Components.interfaces.nsIVersionComparator -); - -if (versionChecker.compare(Application.version, "3.0b4") >= 0) { - // code for >= 3.0b4 -} else { - // code for < 3.0b4 -}</pre> - -<p>3.0b3pre より前のバージョンでは、以下のスニペットで取得可能です。</p> - - -<pre class="brush: js">var version; - -if ( "@mozilla.org/xre/app-info;1" in Components.classes ) { - version = Components.classes["@mozilla.org/xre/app-info;1"].getService( - Components.interfaces.nsIXULAppInfo - ).version; -} else { - version = Components.classes["@mozilla.org/preferences-service;1"].getService( - Components.interfaces.nsIPrefBranch).getCharPref("app.version"); -} - -var versionChecker = Components.classes["@mozilla.org/xpcom/version-comparator;1"].getService( - Components.interfaces.nsIVersionComparator -); - -if ( versionChecker.compare( version, "3.0b3" ) >= 0 ) { - // code for >= 3.0b3 -} else { - // code for < 3.0b3 -}</pre> diff --git a/files/ja/extensions/thunderbird/howtos/common_thunderbird_extension_techniques/index.html b/files/ja/extensions/thunderbird/howtos/common_thunderbird_extension_techniques/index.html deleted file mode 100644 index 2368543e28..0000000000 --- a/files/ja/extensions/thunderbird/howtos/common_thunderbird_extension_techniques/index.html +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Thunderbird 拡張機能の一般的なテクニック -slug: Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques -tags: - - thunderbird -translation_of: >- - Mozilla/Thunderbird/Thunderbird_extensions/HowTos/Common_Thunderbird_Extension_Techniques ---- -<div> - {{tree}}</div> diff --git a/files/ja/extensions/thunderbird/howtos/index.html b/files/ja/extensions/thunderbird/howtos/index.html deleted file mode 100644 index 47430a8154..0000000000 --- a/files/ja/extensions/thunderbird/howtos/index.html +++ /dev/null @@ -1,127 +0,0 @@ ---- -title: Thunderbird HowTos -slug: Extensions/Thunderbird/HowTos -tags: - - Add-ons - - Extensions - - NeedsTranslation - - TopicStub - - thunderbird - - 要更新 -translation_of: Mozilla/Thunderbird/Thunderbird_extensions/HowTos ---- -<p>Please add questions or answers to this page so that other people can benefit from your work. Also, you will see that there are many topics for which there is a question, but no answer. <strong>Please help</strong> by adding an answer! (Adding another question helps too!)</p> - -<p>To get started creating the most basic extension framework, please see <a href="/ja/docs/Extensions/Thunderbird/Building_a_Thunderbird_extension" title="Building a Thunderbird extension">Building a Thunderbird Extension</a>.</p> - -<p>This page is organized into two parts: common TB use cases and common techniques. This provides a quick way to get you started. Both parts are about accomplishing things programatically, but these parts split everything into things users do that you would like to improve, and things you need to do to accomplish that goal.</p> - -<p>See also "<a href="/ja/docs/Extensions/Thunderbird/An_overview_of_the_Thunderbird_interface" title="Extensions/Thunderbird/An overview of the Thunderbird interface">An overview of Thunderbird components</a>". Many of the components described on that page have links to related examples.</p> - -<h2 id="Part_1.3A_Common_Thunderbird_Use_Cases" name="Part_1.3A_Common_Thunderbird_Use_Cases">Part 1: Common Thunderbird Use Cases</h2> - -<p>Each of the pages listed in this section contains a number of related topics. For example, the "Compose New Message" page contains sections that describe how to open a new message window, modify a message body, etc.</p> - -<table style="width: 100%;"> - <tbody> - <tr style="vertical-align: top;"> - <td> - <h3 id="Access_address_book" name="Access_address_book"><a href="/ja/docs/Thunderbird/Address_Book_Examples" title="https://developer.mozilla.org/En/Address_Book_Examples">Access address book</a></h3> - - <ul> - <li><a href="/ja/docs/Thunderbird/Address_Book_Examples#How_do_I_get_all_address_books.3f" title="Address Book Examples#How do I get all address books.3f">Get all address books</a></li> - <li><a href="/ja/docs/Thunderbird/Address_Book_Examples#How_do_I_get_one_address_book.3f" title="Address Book Examples#How do I get one address book.3f">Get one address book</a></li> - <li><a href="/ja/docs/Thunderbird/Address_Book_Examples#How_do_I_search_for_a_particular_contact_property_%28name.2c_email%29.3f" title="Address Book Examples#How do I search for a particular contact property (name.2c email).3f">Search for a particular contact property (name, email)</a></li> - <li><a href="/ja/docs/Thunderbird/Address_Book_Examples#How_do_I_search_for_multiple_contacts.3f" title="Address Book Examples#How do I search for multiple contacts.3f">Search for multiple contacts</a></li> - <li><a href="/ja/docs/Thunderbird/Address_Book_Examples#How_do_I_add.2fedit.2fdelete_contacts.3f" title="Address Book Examples#How do I add.2fedit.2fdelete contacts.3f">Add / edit / Delete contacts</a></li> - <li><a href="/ja/docs/Thunderbird/Address_Book_Examples#How_do_I_add_and_use_my_own_properties.3f" title="Address Book Examples#How do I add and use my own properties.3f">Add and use custom properties</a></li> - <li><a href="/ja/docs/Thunderbird/Address_Book_Examples#How_do_I_add.2fedit.2fdelete_mailing_lists.3f" title="Address Book Examples#How do I add.2fedit.2fdelete mailing lists.3f">Add / edit / delete mailing lists</a></li> - <li><a href="/ja/docs/Thunderbird/Address_Book_Examples#How_do_I_display_properties_dialogs_to_the_user.3f" title="Address Book Examples#How do I display properties dialogs to the user.3f">Display properties dialogs to the user</a></li> - <li><a href="/ja/docs/Thunderbird/Address_Book_Examples#How_do_I_set_up_my_own_address_book.3f" title="Address Book Examples#How do I set up my own address book.3f">Set up custom address book</a></li> - <li><a href="/ja/docs/Thunderbird/Address_Book_Examples#How_do_I.c2.a0set_up_autocomplete_to_use_the_address_book.3f" title="Address Book Examples#How do I.c2.a0set up autocomplete to use the address book.3f">Set up auto-complete to use the address book</a></li> - </ul> - - <h3 id="Compose_new_messages" name="Compose_new_messages"><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Compose_New_Message" title="Extensions/Thunderbird/HowTos/Common Thunderbird Use Cases/Compose New Message">Compose new messages</a></h3> - - <ul> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Compose_New_Message#Open_New_Message_Window" rel="internal">Open New Message Window</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Compose_New_Message#Modify_Recipient_List" rel="internal">Modify Recipient List</a> <strong>TODO</strong></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Compose_New_Message#Modify_Header" rel="internal">Modify Header</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Compose_New_Message#Add_Header" rel="internal">Add Header</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Compose_New_Message#Modify_Message_Body" rel="internal">Modify Message Body</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Compose_New_Message#Intercept_Outgoing_Message" rel="internal">Intercept Outgoing Message</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Compose_New_Message#Get_Access_to_the_Compose_Window_before_the_Editing_is_Started" rel="internal">Get Access to the Compose Window before the Editing is Started</a></li> - </ul> - </td> - <td> - <h3 id="Folders_and_messages" name="Folders_and_messages"><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Open_Folder" title="Extensions/Thunderbird/HowTos/Common Thunderbird Use Cases/Open Folder">Folders and messages</a></h3> - - <ul> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Open_Folder#Perform_Operation_on_Folder" rel="internal">Perform Operation on Folder</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Open_Folder#Determine_Selected_Folder" rel="internal">Determine Selected Folder</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Open_Folder#Check_for_New_Mail" rel="internal">Check for New Mail</a> <strong>TODO</strong></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Open_Folder#Watch_for_New_Mail" rel="internal">Watch for New Mail</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Open_Folder#List_Subfolders" rel="internal">List Subfolder</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Open_Folder#List_Messages" rel="internal">List Message</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Open_Folder#Select_Messages" rel="internal">Select Messages</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Open_Folder#Inspect_Selected_Messages" rel="internal">Inspect Selected Messages</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Open_Folder#Check_if_a_message_is_a_Feed_Item" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Open_Folder#Check_if_a_message_is_a_Feed_Item">Check if a Message is a Feed Item</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Open_Folder#Move_Selected_Messages" rel="internal">Move Selected Message</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Open_Folder#Copy_Selected_Messages" rel="internal">Copy Selected Message</a></li> - </ul> - - <h3 id="View_message" name="View_message"><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/View_Message" title="Extensions/Thunderbird/HowTos/Common Thunderbird Use Cases/View Message">View message</a></h3> - - <ul> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/View_Message#List_Attachments" rel="internal">List Attachments</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/View_Message#Read_Attachment" rel="internal">Read Attachment</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/View_Message#Save_Attachment" rel="internal">Save Attachment</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/View_Message#Access_Message" rel="internal">Access Message</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/View_Message#Get_Message_Body_by_Header" rel="internal">Get Message Body by Header</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/View_Message#Get_Message_Header_by_URI.2fURL" rel="internal">Get Message Header by URI/URL</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/View_Message#section_8" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/View_Message#section_8">Get MIME Headers for any message</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/View_Message#Search_Messages" title="Extensions/Thunderbird/HowTos/Common Thunderbird Use Cases/View Message#Search Messages">Search Messages</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/View_Message#section_8" title="https://developer.mozilla.org/en/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/View_Message#section_8">Display a message yourself using <iframe>s</a></li> - </ul> - - <h3 id="Reply_to_message" name="Reply_to_message"><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Reply_to_Message" title="Extensions/Thunderbird/HowTos/Common Thunderbird Use Cases/Reply to Message">Reply to message</a></h3> - - <ul> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Reply_to_Message#Modify_Quoted_Message_%28before_normal_composition%29" rel="internal" title="Extensions/Thunderbird/HowTos/Common Thunderbird Use Cases/Reply to Message#Modify Quoted Message (before normal composition)">Modify Quoted Message (before normal composition)</a> <strong>TODO</strong></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Reply_to_Message#section_1" title="https://developer.mozilla.org/en/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Reply_to_Message#section_1">Reply to a given message, reply to all, forward it, reply to list, and all variants</a></li> - </ul> - </td> - </tr> - </tbody> -</table> - -<h2 id="Part_2.3A_Common_Thunderbird_Extension_Techniques" name="Part_2.3A_Common_Thunderbird_Extension_Techniques">Part 2: <a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques" title="Extensions/Thunderbird/HowTos/Common Thunderbird Extension Techniques">Common Thunderbird Extension Techniques</a></h2> - -<div class="wiki-tree"> -<ul> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Access_StringBundle_from_Overlay" rel="internal" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Access_StringBundle_from_Overlay">Access StringBundle from Overlay</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Access_Thunderbird_Window_Areas" rel="internal" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Access_Thunderbird_Window_Areas">Access Thunderbird Window Areas</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Access_Window" rel="internal" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Access_Window">Access Window</a> <strong>NEW</strong>!</li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Access_Window_Area" rel="internal" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Access_Window_Area">Access Window Area</a> <strong>TODO</strong></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Add_Toolbar_Button" rel="internal" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Add_Toolbar_Button">Add Toolbar Button</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Add_New_Tab" rel="internal" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Add_New_Tab">Add New Tab</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Add_Option_to_Context_Menu" rel="internal" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Add_Option_to_Context_Menu">Add Option to Context Menu</a> <strong>TODO</strong></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Create_Custom_Column" rel="internal" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Create_Custom_Column">Create Custom Column</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Detect_Opening_Folder" rel="internal" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Detect_Opening_Folder">Detect Opening Folder</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Filter_Incoming_Mail" rel="internal" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Filter_Incoming_Mail">Filter Incoming Mail</a> <strong>NEW!</strong></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Get_Thunderbird_version" rel="internal" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Get_Thunderbird_version">Get Thunderbird version</a></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Modify_Folder_Pane_Display" rel="internal" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Modify_Folder_Pane_Display">Modify Folder Pane Display</a> <strong>TODO</strong></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Modify_Message_List" rel="internal" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Modify_Message_List">Modify Message List</a> <strong>TODO</strong></li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Use_SQLite" rel="internal" title="Extensions/Thunderbird/HowTos/Common_Thunderbird_Extension_Techniques/Use_SQLite">Use SQLite</a></li> -</ul> - -<h3 id="Activity_Manager" name="Activity_Manager">Activity Manager</h3> -</div> - -<ul> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Activity_Manager#Showing_a_user-defined_activity_in_the_Activity_Manager_window" rel="internal"><u>Show a user-defined activity in the Activity Manager window</u></a> <strong>NEW</strong>!</li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Activity_Manager#Showing_a_user-defined_activity_with_cancel_capability_%28JavaScript%29" rel="internal">Show a user-defined activity with cancel capability (JavaScript)</a> in the Activity Manager window <strong>NEW</strong>!</li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Activity_Manager#Showing_a_user-defined_activity_with_undo_capability_%28C.2b.2b%29" rel="internal">Show a user-defined activity with undo capability (C++)</a> in the Activity Manager window <strong>NEW</strong>!</li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Activity_Manager#Adding_an_activity_with_a_custom_context_type" rel="internal"><u>Add an activity with a custom context type</u></a> in the Activity Manager window <strong>NEW</strong>!</li> - <li><a href="/ja/docs/Extensions/Thunderbird/HowTos/Activity_Manager#Adding_a_fully_customized_activity" rel="internal">Add a fully customized activity</a> in the Activity Manager window <strong>NEW</strong>!</li> -</ul> diff --git a/files/ja/extensions/thunderbird/index.html b/files/ja/extensions/thunderbird/index.html deleted file mode 100644 index 0fc66c657d..0000000000 --- a/files/ja/extensions/thunderbird/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Thunderbird -slug: Extensions/Thunderbird -tags: - - Add-ons - - Extensions -translation_of: Mozilla/Thunderbird/Thunderbird_extensions ---- -<div class="callout-box"><strong><a href="/ja/Building_a_Thunderbird_Extension" title="ja/Building_a_Thunderbird_Extension">Thunderbird 用の拡張機能のビルド</a></strong><br> -Thunderbird の拡張機能をビルドする方法をステップバイステップで説明します。</div> - -<div>以下のドキュメンテーションは、Mozilla の Thunderbird メールクライアント用の拡張機能の作成について説明します。<a href="/ja/Extensions" title="ja/Extensions">Firefox の拡張機能</a>と多くの類似点がありますが、始めたばかりの開発者を混乱させるような違いがあります。</div> - -<div><br> -<strong>寄稿者募集中！</strong> <a class="internal" href="/ja/Extensions/Thunderbird/HowTos" title="en/Extensions/Thunderbird/HowTos">how-to 記事の追加</a> (質問や答え、コードスニペットなど)、<a class="internal" href="/en/Extensions/Thunderbird/Useful_newsgroups_discussions" title="En/Extensions/Thunderbird/Useful newsgroups discussions">関連するニュースグループの議論へのリンクと要約</a>、またはチュートリアルの作成など。分からないことがあれば <a class="internal" href="/User:jenzed" title="User:jenzed">jenzed</a> に尋ねてください。</div> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h4 id="Documentation" name="Documentation"><a href="/Special:Tags?tag=Extensions&language=ja" title="Special:Tags?tag=Extensions&language=ja">ドキュメント</a></h4> - - <ul> - <li><a class="internal" href="/ja/Extensions/Thunderbird/Building_a_Thunderbird_extension" title="Ja/Building a Thunderbird extension">Thunderbird の拡張機能のビルド</a> </li> - <li><a class="internal" href="/ja/Extensions/Thunderbird/An_overview_of_the_Thunderbird_interface" title="Ja/Extensions/Thunderbird/An overview of the Thunderbird interface">Thunderbird コンポーネントの概要</a> </li> - <li><a class="internal" href="/ja/Extensions/Thunderbird/Useful_newsgroups_discussions" title="Ja/Extensions/Thunderbird/Useful newsgroups discussions">役立つニュースグループの議論</a> </li> - <li><a class="internal" href="/ja/Extensions/Thunderbird/HowTos" rel="internal" title="ja/Extensions/Thunderbird/HowTos">Thunderbird 拡張機能開発の手引き</a></li> - <li><a class="internal" href="/ja/Extensions/Thunderbird/Thunderbird_developer_reference_docs" title="ja/Extensions/Thunderbird/Thunderbird developer reference docs">開発者のためのリファレンスドキュメント</a>: - <ul> - <li><a class="internal" href="/ja/Folders" rel="external nofollow" title="Ja/Folders">Folder classes</a> </li> - <li><a class="internal" href="/ja/DB_Views_(message_lists)" rel="external nofollow" title="Ja/DB Views (message lists)">DB views (message list)</a> </li> - <li><a class="internal" href="/ja/Message_Summary_Database" rel="external nofollow" title="Ja/Message Summary Database">Message summary database</a> </li> - <li><a class="internal" href="/ja/MailNews_Protocols" rel="external nofollow" title="Ja/MailNews Protocols">MailNews protocols</a> </li> - <li><a class="internal" href="/ja/MailNews%20Filters" rel="internal" title="Ja/MailNews Filters">MailNews filters</a> </li> - <li><a class="internal" href="/ja/Extensions/Thunderbird/Error_reporting_tools" title="ja/Extension Library/Extensions/Thunderbird/Error reporting tools">Error reporting tools</a> <strong>NEW!</strong></li> - </ul> - </li> - <li><a class="external" href="http://kb.mozillazine.org/Category:Thunderbird" title="http://kb.mozillazine.org/Category:Thunderbird">Mozillazine articles on Thunderbird</a></li> - </ul> - </td> - <td> - <h4 id="Community -Edit section" name="Community -Edit section">コミュニティ</h4> - - <ul> - <li>Mozilla のフォーラムをみる</li> - </ul> - - <p>{{ DiscussionList("dev-extensions", "mozilla.dev.extensions") }}</p> - - <ul> - <li><a class="link-irc" href="irc://moznet/#extdev">#extdev IRC チャンネル</a> / <a class="link-irc" href="irc://moznet/#maildev">#maildev IRC チャンネル</a></li> - <li><a class="external" href="http://forums.mozillazine.org/viewforum.php?f=19">MozillaZine フォーラム</a></li> - <li><a class="external" href="http://mozdev.org/mailman/listinfo/project_owners">mozdev プロジェクトオーナ</a></li> - <li><a href="/ja/Extensions/Community" title="ja/Extensions/Community">他のコミュニティのリンク</a></li> - </ul> - - <h4 id="Tools" name="Tools">ツール</h4> - - <ul> - <li><a class="link-https" href="https://addons.mozilla.org/ja/firefox/addon/6622" rel="external nofollow" title="https://addons.mozilla.org/ja/firefox/addon/6622">DOM Inspector</a>: 実際の DOM を編集します。(Firefox および Thunderbird)</li> - <li><a class="external" href="http://www.hacksrus.com/~ginda/venkman/" rel="external nofollow" title="http://www.hacksrus.com/~ginda/venkman/">Venkman</a>: JavaScript デバッガ (<a class="external" href="http://addons.mozilla.org/ja/firefox/addon/216" rel="external nofollow" title="http://addons.mozilla.org/ja/firefox/addon/216">Firefox</a>, <a class="external" href="http://addons.mozilla.org/ja/thunderbird/addon/216" rel="external nofollow" title="http://addons.mozilla.org/ja/thunderbird/addon/216">Thunderbird</a>)</li> - <li><a class="link-https" href="https://addons.mozilla.org/ja/firefox/addon/7434/" rel="external nofollow" title="https://addons.mozilla.org/ja/firefox/addon/7434/">Extension Developer's Extension</a>: 開発ツールスイート</li> - <li><a class="external" href="http://www.gijsk.com/" rel="external nofollow" title="http://www.gijsk.com/">Chrome List</a>: <a class="external" rel="freelink">chrome://</a> ファイルの表示。(<a class="external" href="http://addons.mozilla.org/ja/firefox/addon/4453" rel="external nofollow" title="http://addons.mozilla.org/ja/firefox/addon/4453">Firefox</a>, <a class="external" href="http://addons.mozilla.org/ja/thunderbird/addon/4453" rel="external nofollow" title="http://addons.mozilla.org/ja/thunderbird/addon/4453">Thunderbird</a>)</li> - <li><a class="external" href="http://ted.mielczarek.org/code/mozilla/extensionwiz/" rel="external nofollow" title="http://ted.mielczarek.org/code/mozilla/extensionwiz/">Extension Wizard</a>: Web ベースの拡張機能の骨格を生成するツール。(Firefox および Thunderbird)</li> - </ul> - - <p>... <a class="internal" href="/ja/Setting_up_extension_development_environment#Development_extensions" title="ja/Setting up extension development environment#Development extensions">その他のツール</a> ...</p> - - <p><span class="alllinks"><a href="/Special:Tags?tag=Extensions:Tools&language=ja" title="Special:Tags?tag=Extensions:Tools&language=ja">すべてを見る...</a></span></p> - - <h4 id="Related_Topics" name="Related_Topics">関連するトピック</h4> - - <dl> - <dd><a href="/ja/XUL" title="ja/XUL">XUL</a>, <a href="/ja/JavaScript" title="ja/JavaScript">JavaScript</a>, <a href="/ja/XPCOM" title="ja/XPCOM">XPCOM</a>, <a href="/ja/Themes" title="ja/Themes">テーマ</a>, <a href="/ja/Developing_Mozilla" title="ja/Developing_Mozilla">Mozilla の開発</a></dd> - </dl> - </td> - </tr> - </tbody> -</table> diff --git a/files/ja/extensions/using_the_dom_file_api_in_chrome_code/index.html b/files/ja/extensions/using_the_dom_file_api_in_chrome_code/index.html deleted file mode 100644 index edb3a7a87c..0000000000 --- a/files/ja/extensions/using_the_dom_file_api_in_chrome_code/index.html +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: DOM File API を chrome code で使う -slug: Extensions/Using_the_DOM_File_API_in_chrome_code -translation_of: Extensions/Using_the_DOM_File_API_in_chrome_code ---- -<p>{{ gecko_minversion_header("6.0") }}</p> - -<p><a href="/en/Using_files_from_web_applications" title="en/Using files from web applications">DOM File API</a> を chrome code で使いたければ、 制限なしにそうすることができます。 実際に、 おまけの機能を一つ得ます: ユーザーのコンピューターのファイルへのパスを指定して {{ domxref("File") }} オブジェクトを作ることができます。 これは、特権のあるコードでのみ動きます。 そのため、ウエッブコンテンツでは動きません。 これは、ウエッブコンテンツが自由に彼らのディスクにアクセスすることに関係した危険 から、ユーザーを保護します。 もし、特権無しのコード（ウエッブコンテンツのような）から {{ domxref("File") }} コンストラクタにパスを通せば、 例外が発生します。</p> - -<h2 id="スコープの可用性">スコープの可用性</h2> - -<p>JSM スコープでは、Fileは、特別なことを何一つ必要とせずに、有効です。</p> - -<p>Bootstrap スコープでは、このようにインポートすることが必要です:</p> - -<pre class="default prettyprint prettyprinted notranslate"><code><span class="typ">Cu</span><span class="pun">.</span><span class="pln">importGlobalProperties</span><span class="pun">( [</span><span class="str"> "File" </span><span class="pun">] )</span></code></pre> - -<h2 id="パスを直接書き込んでのファイルの利用">パスを直接書き込んでのファイルの利用</h2> - -<p>パスによるファイルへの参照、単純に直接文字列として書き込むことができます:</p> - -<pre class="brush: js notranslate">var file = File("path/to/some/file"); -</pre> - -<p>クロスプラットホームでの注釈: とはいえ、 直接書き込まれたパスは、プラットホームに依存したセパレータ (これ "/") に起因する、クロスプラットホームでの問題が発生します。 XUL/Mozilla プラットホームでは、Java と同等にひどくない。<code>File.pathSeparator</code> (システムに依存する、パスセパレータ文字<code>)、これは、すべてのパスセパレータを定義することを避ける、良い方法です。</code> それよりも、次の章で説明する、nsIFile::append() メソッドを使え。</p> - -<h2 id="特殊なディレクトリにあるファイルの利用">特殊なディレクトリにあるファイルの利用</h2> - -<p>あなたは、ファイルを利用するためのパスを、獲得し作成するために、ディレクトリサービスを使うことができます。 例えば、あなたのアドオンが、ユーザープロファイル内のファイルを利用する必要があれば、このようにできます:</p> - -<pre class="brush: js notranslate">var dsFile = Components.classes["@mozilla.org/file/directory_service;1"] - .getService(Components.interfaces.nsIProperties) - .get("ProfD", Components.interfaces.nsIFile); - -dsFile.append("myfilename.txt"); - -var file = File(dsFile.path); -</pre> - -<p>この、プロファイルディレクトリへのディレクトリサービスの使用 (ロケーションキー "ProfD" を用いる、 詳細は下記を参照)。そして、 作業をしたいファイルの名前をそえて {{ ifmethod("nsIFile", "append") }}を呼び出す。 最後に、 {{ domxref("File") }} のコンストラクタへ通す文字列を返す{{ ifmethod("nsIFile", "path") }}渡し、{{ domxref("File") }} の実体を作ります。</p> - -<p>さらにもっと簡単にすることができます！実は、 {{ interface("nsIFile") }} オブジェクト自身を直接 <code>File</code> のコンストラクタに渡すことができます。 次のコードにあるように:</p> - -<pre class="brush: js notranslate">var dsFile = Components.classes["@mozilla.org/file/directory_service;1"] - .getService(Components.interfaces.nsIProperties) - .get("ProfD", Components.interfaces.nsIFile); - -dsFile.append("myfilename.txt"); - -var file = File(dsFile);</pre> - -<p>"ProfD" キーなどのような、他のキーも用意されています。 <a href="https://developer.mozilla.org/en/Using_nsIDirectoryService#Known_Locations" title="https://developer.mozilla.org/en/Using_nsIDirectoryService#Known_Locations">known locations </a> を確認してください。</p> - -<h2 id="注釈">注釈</h2> - -<p>Gecko 8.0 {{ geckoRelease("8.0") }}から始まりました。コンポーネントコードの中でもこれは行えます。</p> - -<h2 id="こちらも見て">こちらも見て</h2> - -<ul> - <li><a href="/en/Using_files_from_web_applications" title="en/Using files from web applications">Using files from web applications</a></li> - <li>{{ domxref("File") }}</li> - <li>{{ interface("nsIDirectoryService") }}</li> - <li>{{ interface("nsIFile") }}</li> -</ul> |