Differences

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

--- gnome:extensions:create_an_extension [2022/07/23 12:28] – 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 ======
-[[Gnome:Extensions:Create an Extension|Create an Extension]]
+===== Creating the files for an extension =====
-----
+Extensions only require two mandatory files, so create them:
-===== Distributing an Extension =====
+  * [[Gnome:Extensions:extension.js|extension.js]]
+  * [[Gnome:Extensions:metadata.json|metadata.json]]
-Extensions are distributed as Zip files with only two required files:
+Optionally create additional files:
-  * metadata.json
+  * See [[Gnome:Extensions:prefs.js|prefs.js]]
-  * extension.js
 ----
-===== Installation of an extension =====
+===== Distributing an Extension =====
-Extension are installed in one of two places.
+Extensions are distributed as Zip files with the two required files:
-For User Extensions,
 <code bash>
-~/.local/share/gnome-shell/extensions/example@blah/
+example@blah.zip
-</code>
+    extension.js
+    metadata.json
-For System Extensions,
-<code bash>
-/usr/share/gnome-shell/extensions/example@blah/
 </code>
 ----
-===== Complete Extension =====
-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 49: / Line 44: @@
     prefs.js
     stylesheet.css
+</code>
+<WRAP info>
+**NOTE:**
+  * The topic of GSettings and the schemas/ directory is explained on the [[https://gjs.guide/extensions/development/preferences.html|Preferences]] page.
+  * The topic of Gettext and the locale/ directory is explained on the [[https://gjs.guide/extensions/development/translations.html|Translations]] page
+</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>