files/ja/theme_packaging/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

---
title: テーマの梱包
slug: Theme_Packaging
tags:
  - Add-ons
  - MDC Project
  - NeedsUpdate
  - Themes
  - Toolkit API
translation_of: Mozilla/Thunderbird/Thunderbird_extensions/Theme_Packaging
---
<p> </p>
<p>このドキュメントは、Firefox と Thunderbird のための <a href="ja/Themes">テーマ</a> を梱包する方法について書かれています。</p>
<div class="note">
 <p>このページの情報は古くなっています。最新の情報に更新してください。</p>
</div>
<h3 id=".E5.BF.85.E9.A0.88.E6.9D.A1.E4.BB.B6" name=".E5.BF.85.E9.A0.88.E6.9D.A1.E4.BB.B6">必須条件</h3>
<p>Firefox や Thunderbird のテーマを作成するには、スタイルシート(<a href="ja/CSS">CSS</a>) および少しの <a href="ja/XBL">XBL</a> の知識、グラフィックデザインのスキルと美的感覚(無くても良いかもしれない) が必要です。このドキュメントは、テーマを Firefox のテーマウィンドウに表示するために、どのように梱包されているかについて書かれています。</p>
<h3 id=".E3.83.86.E3.83.BC.E3.83.9E.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.81.AE.E3.83.AC.E3.82.A4.E3.82.A2.E3.82.A6.E3.83.88" name=".E3.83.86.E3.83.BC.E3.83.9E.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.81.AE.E3.83.AC.E3.82.A4.E3.82.A2.E3.82.A6.E3.83.88">テーマファイルのレイアウト</h3>
<p>Firefox/Thunderbird のテーマは、以下の構造の JAR ファイルに梱包されています:</p>
<pre class="eval">theme.jar:
  install.rdf
  contents.rdf
  preview.png
  icon.png
  browser/<i>files</i>
  global/<i>files</i>
  mozapps/<i>files</i>
  communicator/<i>files</i>
  ...

</pre>
<ul>
 <li>テーマの chrome を登録する <a href="ja/Chrome.manifest">chrome.manifest</a> (Firefox/Thunderbird 1.5 以降) または contents.rdf はトップレベルになければいけません。また、テーマウィンドウに表示されるメタデータを指定する <a href="ja/Install.rdf">install.rdf</a> マニフェストも同様です。</li>
 <li>preview.png は、テーマウィンドウのプレビュー領域に表示されるプレビュー画像です。この画像サイズは任意です。</li>
 <li>icon.png は、テーマウィンドウのテーマ一覧に表示される 32x32 サイズの PNG(アルファ透過を含む) 形式の画像です。</li>
</ul>
<h3 id="install.rdf" name="install.rdf">install.rdf</h3>
<p><a href="ja/Install.rdf">install.rdf</a> マニフェストは以下のようになります:</p>
<pre class="eval">&lt;?xml version="1.0"?&gt;

&lt;RDF xmlns="<span class="nowiki">http://www.w3.org/1999/02/22-rdf-syntax-ns#</span>"
     xmlns:em="<span class="nowiki">http://www.mozilla.org/2004/em-rdf#</span>"&gt;

  &lt;Description about="urn:mozilla:install-manifest"&gt;
    &lt;em:type&gt;4&lt;/em:type&gt;<i>more properties</i>
  &lt;/Description&gt;
&lt;/RDF&gt;
</pre>
<h4 id=".E5.BF.85.E9.A0.88.E3.81.AE_install.rdf_.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3" name=".E5.BF.85.E9.A0.88.E3.81.AE_install.rdf_.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3">必須の install.rdf プロパティ</h4>
<p>install.rdf には以下のプロパティが含まれていなければいけません。詳しくは <a href="ja/Install.rdf">install.rdf リファレンス</a> をご覧ください:</p>
<ul>
 <li>em:id</li>
 <li>em:version</li>
 <li>em:type</li>
 <li>em:targetApplication</li>
 <li>em:name</li>
 <li>em:internalName</li>
</ul>
<h4 id=".E4.BB.BB.E6.84.8F.E3.81.AE_install.rdf_.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3" name=".E4.BB.BB.E6.84.8F.E3.81.AE_install.rdf_.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3">任意の install.rdf プロパティ</h4>
<ul>
 <li>em:description</li>
 <li>em:creator</li>
 <li>em:contributor</li>
 <li>em:homepageURL</li>
 <li>em:updateURL</li>
</ul>
<p>あなたのテーマを <a class="external" href="http://addons.mozilla.org" rel="freelink">http://addons.mozilla.org</a> ウェブサイト上で利用可能にする場合は、updateURL を含めないように注意してください。</p>
<h4 id="install.rdf_.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.81.AE.E3.82.B5.E3.83.B3.E3.83.97.E3.83.AB" name="install.rdf_.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.81.AE.E3.82.B5.E3.83.B3.E3.83.97.E3.83.AB">install.rdf ファイルのサンプル</h4>
<pre class="eval">&lt;?xml version="1.0"?&gt;

&lt;RDF xmlns="<span class="nowiki">http://www.w3.org/1999/02/22-rdf-syntax-ns#</span>"
     xmlns:em="<span class="nowiki">http://www.mozilla.org/2004/em-rdf#</span>"&gt;

  &lt;Description about="urn:mozilla:install-manifest"&gt;
    &lt;em:id&gt;{18b64b56-d42f-428d-a88c-baa413bc413f}&lt;/em:id&gt;
    &lt;em:version&gt;1.0&lt;/em:version&gt;
    &lt;em:type&gt;4&lt;/em:type&gt;

    &lt;!-- Target Application this extension can install into,
         with minimum and maximum supported versions. --&gt;
    &lt;em:targetApplication&gt;
      &lt;Description&gt;
        &lt;em:id&gt;{ec8030f7-c20a-464f-9b0e-13a3a9e97384}&lt;/em:id&gt;
        &lt;em:minVersion&gt;0.8&lt;/em:minVersion&gt;
        &lt;em:maxVersion&gt;0.9&lt;/em:maxVersion&gt;
      &lt;/Description&gt;
    &lt;/em:targetApplication&gt;

    &lt;!-- Front End MetaData --&gt;
    &lt;em:name&gt;New Theme 1&lt;/em:name&gt;
    &lt;em:description&gt;A test theme for Firefox&lt;/em:description&gt;
    &lt;em:creator&gt;Ben Goodger&lt;/em:creator&gt;
    &lt;em:contributor&gt;John Doe&lt;/em:contributor&gt;
    &lt;em:homepageURL&gt;<span class="nowiki">http://www.bengoodger.com/</span>&lt;/em:homepageURL&gt;

    &lt;!-- Front End Integration Hooks (used by Theme Manager)--&gt;
    &lt;em:internalName&gt;newtheme1&lt;/em:internalName&gt;
  &lt;/Description&gt;
&lt;/RDF&gt;
</pre>
<p>以下は targetApplication プロパティで使用する、共通のターゲットアプリケーションの GUID です:</p>
<pre class="eval">Firefox      {ec8030f7-c20a-464f-9b0e-13a3a9e97384}
Thunderbird  {3550f703-e582-4d05-9a08-453d09bdfdc6}
Sunbird      {718e30fb-e89b-41dd-9da7-e25a45638b28}
</pre>
<h3 id="Toolkit_API_.E3.81.AE.E3.81.9F.E3.82.81.E3.81.AE.E5.85.AC.E5.BC.8F.E3.83.AA.E3.83.95.E3.82.A1.E3.83.AC.E3.83.B3.E3.82.B9" name="Toolkit_API_.E3.81.AE.E3.81.9F.E3.82.81.E3.81.AE.E5.85.AC.E5.BC.8F.E3.83.AA.E3.83.95.E3.82.A1.E3.83.AC.E3.83.B3.E3.82.B9"><a href="ja/Toolkit_API">Toolkit API</a> のための公式リファレンス</h3>
<div>
 {{page("/en-US/docs/Toolkit_API/Official_References")}}</div>