blob: 8d91ae7fbc3458e37a82e02a43f286363473d8b5 (
plain)
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
110
111
112
113
|
---
title: Pakowanie motywów
slug: Pakowanie_motywów
tags:
- Dodatki
- Motywy
- Toolkit API
- Wszystkie_kategorie
translation_of: Mozilla/Thunderbird/Thunderbird_extensions/Theme_Packaging
---
<p> </p>
<p>Poniższy artykuł opisuje operację pakowania <a href="pl/Motywy">motywów</a> dla Firefoksa oraz Thunderbirda.</p>
<h3 id="Za.C5.82o.C5.BCenia" name="Za.C5.82o.C5.BCenia">Założenia</h3>
<p>Tworzenie motywów dla Firefoksa lub Thunderbirda wymaga znajomości Cascading Stylesheets (<a href="pl/CSS">CSS</a>), prawdopodobnie <a href="pl/XBL">XBL</a> oraz projektowania grafiki i wyczucia estetyki (...lub też nie). Poniższy artykuł opisuje jedynie jak pakowane są motywy, aby pokazać je w oknie Motywów Firefoksa.</p>
<h3 id="Struktura_plik.C3.B3w_motywu" name="Struktura_plik.C3.B3w_motywu">Struktura plików motywu</h3>
<p>Motywy Firefoksa/Thunderbirda pakowane są do plików JAR o następującej strukturze:</p>
<pre class="eval">motyw.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>Na najwyższym poziomie musi się znajdować plik <a href="pl/Rejestracja_Chrome">chrome.manifest</a> (Firefoks/Thunderbird 1.5) lub contents.rdf rejestrujący chrom dla motywu (jak poprzednio) oraz manifest <a href="pl/Install.rdf">install.rdf</a> określający informacje wyświetlane w oknie Motywy.</li>
<li>preview.png jest obrazkiem podglądu pokazywanym podczas przeglądania okna Motywy. Może posiadać dowolny rozmiar.</li>
<li>icon.png jest ikoną o rozmiarze 32x32 w formacie PNG (może posiadać przeźroczystość alpha) pokazywaną w liście motywów w oknie Motywy.</li>
</ul>
<h3 id="install.rdf" name="install.rdf">install.rdf</h3>
<p>Twój manifest <a href="pl/Install.rdf">install.rdf</a> będzie wyglądał podobnie do poniższego:</p>
<pre class="eval"><?xml version="1.0"?>
<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>">
<Description about="urn:mozilla:install-manifest">
<em:type>4</em:type><i>more properties</i>
</Description>
</RDF>
</pre>
<h4 id="Wymagane_w.C5.82asno.C5.9Bci_install.rdf" name="Wymagane_w.C5.82asno.C5.9Bci_install.rdf">Wymagane własności install.rdf</h4>
<p>Plik install.rdf musi posiadać następujące własności. By dowiedzieć się więcej zobacz <a href="pl/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="Opcjonalne_w.C5.82asno.C5.9Bci_install.rdf" name="Opcjonalne_w.C5.82asno.C5.9Bci_install.rdf">Opcjonalne własności 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><b>Uwaga</b>: jeśli twój motyw będzie dostępny na stronie <a class="external" href="http://addons.mozilla.org" rel="freelink">http://addons.mozilla.org</a> nie powinien on zawierać własności updateURL.</p>
<h4 id="Przyk.C5.82adowy_plik_install.rdf" name="Przyk.C5.82adowy_plik_install.rdf">Przykładowy plik install.rdf</h4>
<pre class="eval"><?xml version="1.0"?>
<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>">
<Description about="urn:mozilla:install-manifest">
<em:id>{18b64b56-d42f-428d-a88c-baa413bc413f}</em:id>
<em:version>1.0</em:version>
<em:type>4</em:type>
<!-- Target Application this extension can install into,
with minimum and maximum supported versions. -->
<em:targetApplication>
<Description>
<em:id>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</em:id>
<em:minVersion>0.8</em:minVersion>
<em:maxVersion>0.9</em:maxVersion>
</Description>
</em:targetApplication>
<!-- Front End MetaData -->
<em:name>New Theme 1</em:name>
<em:description>A test theme for Firefox</em:description>
<em:creator>Ben Goodger</em:creator>
<em:contributor>John Doe</em:contributor>
<em:homepageURL><span class="nowiki">http://www.bengoodger.com/</span></em:homepageURL>
<!-- Front End Integration Hooks (used by Theme Manager)-->
<em:internalName>newtheme1</em:internalName>
</Description>
</RDF>
</pre>
<p>Poniższe GUID przykładowych aplikacji docelowych można użyć w swoich własnościach targetApplication:</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="Oficjalne_dokumentacje_dla_Toolkit_API" name="Oficjalne_dokumentacje_dla_Toolkit_API">Oficjalne dokumentacje dla <a href="pl/Toolkit_API">Toolkit API</a></h3>
<p>
</p><ul>
<li><a href="/en/Bundles" title="en/Bundles">Structure of an Installable Bundle</a>: describes the common structure of installable bundles, including extensions, themes, and XULRunner applications</li>
<li><a href="/en/Extension_Packaging" title="en/Extension_Packaging">Extension Packaging</a>: specific information about how to package extensions</li>
<li><a href="/en/Theme_Packaging" title="en/Theme_Packaging">Theme Packaging</a>: specific information about how to package themes</li>
<li><a href="/en/Multiple_Item_Packaging" title="en/Multiple_Item_Packaging">Multiple-item Extension Packaging</a>: specific information about multiple-item extension XPIs</li>
<li><a href="/en/XUL_Application_Packaging" title="en/XUL_Application_Packaging">XUL Application Packaging</a>: specific information about how to package XULRunner applications</li>
<li><a href="/en/Chrome_Registration" title="en/Chrome_Registration">Chrome Registration</a></li>
<li><a href="/en-US/docs/Mozilla/Tech/XUL/Printing">Printing in XUL Apps</a></li>
</ul>
|