Differences

This shows you the differences between two versions of the page.

--- gnome:extensions:create_an_extension [2022/07/23 12:31] – 194.32.120.105
+++ gnome:extensions:create_an_extension [2022/07/23 12:39] (current) – [Complete Extension Zip File Layout] 194.32.120.105
@@ Line 1: / Line 1: @@
 ====== Gnome - Extensions - Create an Extension ======
-===== Distributing an Extension =====
+===== Creating the files for an extension =====
-Extensions are distributed as Zip files with only two required files:
+Extensions only require two mandatory files, so create them:
-  * metadata.json
+  * [[Gnome:Extensions:extension.js|extension.js]]
-  * extension.js
+  * [[Gnome:Extensions:metadata.json|metadata.json]]
-----
+Optionally create additional files:
-===== Installation of an extension =====
+  * See [[Gnome:Extensions:prefs.js|prefs.js]]
-Extension are installed in one of two places.
+----
-For User Extensions,
+===== Distributing an Extension =====
-<code bash>
+Extensions are distributed as Zip files with the two required files:
-~/.local/share/gnome-shell/extensions/example@blah/
-</code>
-For System Extensions,
 <code bash>
-/usr/share/gnome-shell/extensions/example@blah/
+example@blah.zip
+    extension.js
+    metadata.json
 </code>
 ----
-===== Complete Extension Zip File Layout =====
-A more complete, zipped extension usually looks like this:
+==== Complete Extension Zip File Layout ====
+If additional optional files were also used in the extension, then the zip extension usually looks like this:
 <code bash>
@@ Line 54: / Line 53: @@
 </WRAP>
+----
+===== Installation of an extension =====
+Extension are installed in one of two places.
+For User Extensions,
+<code bash>
+~/.local/share/gnome-shell/extensions/example@blah/
+</code>
+For System Extensions,
+<code bash>
+/usr/share/gnome-shell/extensions/example@blah/
+</code>
 ----