diff --git a/docs/conventions.rst b/docs/conventions.rst
index deea85c3..2069ad74 100644
--- a/docs/conventions.rst
+++ b/docs/conventions.rst
@@ -178,6 +178,21 @@ The distribution usually appends those paths to ``$XDG_DATA_DIRS`` on
 the host when installing the ``flatpak`` package. Unless a desktop file is
 exported by Flatpak, host applications cannot access it.
 
+
+The metainfo file along with the other metadata such as icon and desktop
+files is composed into a catalogue by ``appstream``. Since 1.3.4,
+Flatpak Builder by default uses ``appstreamcli`` from `libappstream <https://github.com/ximion/appstream/>`_
+to compose this and executes the following command::
+
+  $ appstreamcli compose --no-partial-urls --prefix=/ --origin=${FLATPAK_ID} --media-baseurl=<repo-media-url> --media-dir=${FLATPAK_DEST}/share/app-info/media --result-root=${FLATPAK_DEST} --data-dir=${FLATPAK_DEST}/share/app-info/xmls --icons-dir=${FLATPAK_DEST}/share/app-info/icons/flatpak --components=${FLATPAK_ID} ${FLATPAK_DEST}
+
+
+``${FLATPAK_ID}`` is the Flatpak application ID and ``${FLATPAK_DEST}``
+is set to ``/app`` for apps and ``/usr`` for runtimes. The ``media-baseurl``
+controls the base URL used for mirroring screenshots. Usually each app
+store will have their own base URL for this. On Flathub this is
+set to ``https://dl.flathub.org/media/``.
+
 Technical conventions
 ---------------------
 
diff --git a/po/de/LC_MESSAGES/conventions.po b/po/de/LC_MESSAGES/conventions.po
index fa0f466a..d7f03ec2 100644
--- a/po/de/LC_MESSAGES/conventions.po
+++ b/po/de/LC_MESSAGES/conventions.po
@@ -9,7 +9,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version:  Flatpak\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-01 08:05+0530\n"
+"POT-Creation-Date: 2025-02-19 19:25+0530\n"
 "PO-Revision-Date: 2019-06-26 05:18-0400\n"
 "Last-Translator: Markus Richter <semanticdesign@pm.me>\n"
 "Language: de\n"
@@ -18,7 +18,7 @@ msgstr ""
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.16.0\n"
+"Generated-By: Babel 2.17.0\n"
 
 #: ../../conventions.rst:2
 msgid "Requirements & Conventions"
@@ -298,10 +298,29 @@ msgid ""
 msgstr ""
 
 #: ../../conventions.rst:182
+msgid ""
+"The metainfo file along with the other metadata such as icon and desktop "
+"files is composed into a catalogue by ``appstream``. Since 1.3.4, Flatpak"
+" Builder by default uses ``appstreamcli`` from `libappstream "
+"<https://github.com/ximion/appstream/>`_ to compose this and executes the"
+" following command::"
+msgstr ""
+
+#: ../../conventions.rst:190
+#, python-brace-format
+msgid ""
+"``${FLATPAK_ID}`` is the Flatpak application ID and ``${FLATPAK_DEST}`` "
+"is set to ``/app`` for apps and ``/usr`` for runtimes. The ``media-"
+"baseurl`` controls the base URL used for mirroring screenshots. Usually "
+"each app store will have their own base URL for this. On Flathub this is "
+"set to ``https://dl.flathub.org/media/``."
+msgstr ""
+
+#: ../../conventions.rst:197
 msgid "Technical conventions"
 msgstr ""
 
-#: ../../conventions.rst:184
+#: ../../conventions.rst:199
 msgid ""
 "The following are standard technical conventions used by Flatpak and "
 "Linux desktops. Those with Linux experience will likely already be aware "
@@ -309,18 +328,18 @@ msgid ""
 " information useful."
 msgstr ""
 
-#: ../../conventions.rst:190
+#: ../../conventions.rst:205
 msgid "D-Bus"
 msgstr ""
 
-#: ../../conventions.rst:192
+#: ../../conventions.rst:207
 msgid ""
 "D-Bus is the standard IPC framework used on Linux desktops. A lot of "
 "applications won't need to use it, but it is supported by Flatpak should "
 "it be required."
 msgstr ""
 
-#: ../../conventions.rst:196
+#: ../../conventions.rst:211
 msgid ""
 "D-Bus can be used for application launching and communicating with some "
 "system services. Applications can also provide their own D-Bus services "
@@ -328,11 +347,11 @@ msgid ""
 "the application ID)."
 msgstr ""
 
-#: ../../conventions.rst:201
+#: ../../conventions.rst:216
 msgid "Filesystem layout"
 msgstr ""
 
-#: ../../conventions.rst:203
+#: ../../conventions.rst:218
 msgid ""
 "Each Flatpak sandbox, which is the environment in which an application is"
 " run, contains the filesystem of the application's runtime. This follows "
@@ -340,7 +359,7 @@ msgid ""
 "<https://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard>`_."
 msgstr ""
 
-#: ../../conventions.rst:208
+#: ../../conventions.rst:223
 msgid ""
 "For example, the root of the sandbox contains the ``/etc`` directory for "
 "configuration files and ``/usr`` for multi-user utilities and "
@@ -349,11 +368,11 @@ msgid ""
 "located."
 msgstr ""
 
-#: ../../conventions.rst:214
+#: ../../conventions.rst:229
 msgid "XDG base directories"
 msgstr ""
 
-#: ../../conventions.rst:216
+#: ../../conventions.rst:231
 msgid ""
 "`XDG base directories <https://specifications.freedesktop.org/basedir-"
 "spec/basedir-spec-latest.html>`_ are standard locations for user-specific"
@@ -361,94 +380,94 @@ msgid ""
 "accessing XDG base directories. These include:"
 msgstr ""
 
-#: ../../conventions.rst:221
+#: ../../conventions.rst:236
 msgid "Electron: XDG base directories can be accessed with ``app.getPath``."
 msgstr ""
 
-#: ../../conventions.rst:222
+#: ../../conventions.rst:237
 msgid ""
 "Glib: XDG base directories can be accessed through the "
 "``g_get_user_cache_dir ()``, ``g_get_user_data_dir ()``, "
 "``g_get_user_config_dir ()`` functions."
 msgstr ""
 
-#: ../../conventions.rst:225
+#: ../../conventions.rst:240
 msgid ""
 "Qt: XDG base directories can be accessed with the `QStandardPaths Class "
 "<https://doc.qt.io/qt-5/qstandardpaths.html>`_."
 msgstr ""
 
-#: ../../conventions.rst:228
+#: ../../conventions.rst:243
 msgid ""
 "However, applications that aren't using one of these toolkits can expect "
 "to find their XDG base directories in the following locations:"
 msgstr ""
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Base directory"
 msgstr ""
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Usage"
 msgstr ""
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Default location"
 msgstr ""
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "XDG_CONFIG_HOME"
 msgstr ""
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "User-specific configuration files"
 msgstr ""
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "~/.var/app/<app-id>/config"
 msgstr ""
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "XDG_DATA_HOME"
 msgstr ""
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "User-specific data"
 msgstr ""
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "~/.var/app/<app-id>/data"
 msgstr ""
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "XDG_CACHE_HOME"
 msgstr ""
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "Non-essential user-specific data"
 msgstr ""
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "~/.var/app/<app-id>/cache"
 msgstr ""
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "XDG_STATE_HOME"
 msgstr ""
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "State data such as undo history"
 msgstr ""
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "~/.var/app/<app-id>/.local/state"
 msgstr ""
 
-#: ../../conventions.rst:240
+#: ../../conventions.rst:255
 msgid "For example, GNOME Dictionary will store user-specific data in::"
 msgstr ""
 
-#: ../../conventions.rst:244
+#: ../../conventions.rst:259
 msgid ""
 "These environment variables are always set by Flatpak and override any "
 "host values. However, if access to directories on the host is needed, the"
@@ -457,7 +476,7 @@ msgid ""
 "variables will be set if they are also available on the host."
 msgstr ""
 
-#: ../../conventions.rst:249
+#: ../../conventions.rst:264
 msgid ""
 "Note that ``$XDG_STATE_HOME`` and ``$HOST_XDG_STATE_HOME`` are only "
 "supported by Flatpak 1.13 and later. If your application needs to work on"
@@ -467,7 +486,7 @@ msgid ""
 ">1.13."
 msgstr ""
 
-#: ../../conventions.rst:255
+#: ../../conventions.rst:270
 msgid ""
 "Also, note that applications can be configured to use non-default base "
 "directory locations (see :doc:`sandbox-permissions`)."
diff --git a/po/es/LC_MESSAGES/conventions.po b/po/es/LC_MESSAGES/conventions.po
index fcf5e87c..dc7b1a20 100644
--- a/po/es/LC_MESSAGES/conventions.po
+++ b/po/es/LC_MESSAGES/conventions.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version:  Flatpak\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-01 08:05+0530\n"
+"POT-Creation-Date: 2025-02-19 19:25+0530\n"
 "PO-Revision-Date: 2018-05-20 10:37-0400\n"
 "Last-Translator: Copied by Zanata <copied-by-zanata@zanata.org>\n"
 "Language: es\n"
@@ -17,7 +17,7 @@ msgstr ""
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.16.0\n"
+"Generated-By: Babel 2.17.0\n"
 
 #: ../../conventions.rst:2
 msgid "Requirements & Conventions"
@@ -297,10 +297,29 @@ msgid ""
 msgstr ""
 
 #: ../../conventions.rst:182
+msgid ""
+"The metainfo file along with the other metadata such as icon and desktop "
+"files is composed into a catalogue by ``appstream``. Since 1.3.4, Flatpak"
+" Builder by default uses ``appstreamcli`` from `libappstream "
+"<https://github.com/ximion/appstream/>`_ to compose this and executes the"
+" following command::"
+msgstr ""
+
+#: ../../conventions.rst:190
+#, python-brace-format
+msgid ""
+"``${FLATPAK_ID}`` is the Flatpak application ID and ``${FLATPAK_DEST}`` "
+"is set to ``/app`` for apps and ``/usr`` for runtimes. The ``media-"
+"baseurl`` controls the base URL used for mirroring screenshots. Usually "
+"each app store will have their own base URL for this. On Flathub this is "
+"set to ``https://dl.flathub.org/media/``."
+msgstr ""
+
+#: ../../conventions.rst:197
 msgid "Technical conventions"
 msgstr ""
 
-#: ../../conventions.rst:184
+#: ../../conventions.rst:199
 msgid ""
 "The following are standard technical conventions used by Flatpak and "
 "Linux desktops. Those with Linux experience will likely already be aware "
@@ -308,18 +327,18 @@ msgid ""
 " information useful."
 msgstr ""
 
-#: ../../conventions.rst:190
+#: ../../conventions.rst:205
 msgid "D-Bus"
 msgstr ""
 
-#: ../../conventions.rst:192
+#: ../../conventions.rst:207
 msgid ""
 "D-Bus is the standard IPC framework used on Linux desktops. A lot of "
 "applications won't need to use it, but it is supported by Flatpak should "
 "it be required."
 msgstr ""
 
-#: ../../conventions.rst:196
+#: ../../conventions.rst:211
 msgid ""
 "D-Bus can be used for application launching and communicating with some "
 "system services. Applications can also provide their own D-Bus services "
@@ -327,11 +346,11 @@ msgid ""
 "the application ID)."
 msgstr ""
 
-#: ../../conventions.rst:201
+#: ../../conventions.rst:216
 msgid "Filesystem layout"
 msgstr ""
 
-#: ../../conventions.rst:203
+#: ../../conventions.rst:218
 msgid ""
 "Each Flatpak sandbox, which is the environment in which an application is"
 " run, contains the filesystem of the application's runtime. This follows "
@@ -339,7 +358,7 @@ msgid ""
 "<https://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard>`_."
 msgstr ""
 
-#: ../../conventions.rst:208
+#: ../../conventions.rst:223
 msgid ""
 "For example, the root of the sandbox contains the ``/etc`` directory for "
 "configuration files and ``/usr`` for multi-user utilities and "
@@ -348,11 +367,11 @@ msgid ""
 "located."
 msgstr ""
 
-#: ../../conventions.rst:214
+#: ../../conventions.rst:229
 msgid "XDG base directories"
 msgstr ""
 
-#: ../../conventions.rst:216
+#: ../../conventions.rst:231
 msgid ""
 "`XDG base directories <https://specifications.freedesktop.org/basedir-"
 "spec/basedir-spec-latest.html>`_ are standard locations for user-specific"
@@ -360,94 +379,94 @@ msgid ""
 "accessing XDG base directories. These include:"
 msgstr ""
 
-#: ../../conventions.rst:221
+#: ../../conventions.rst:236
 msgid "Electron: XDG base directories can be accessed with ``app.getPath``."
 msgstr ""
 
-#: ../../conventions.rst:222
+#: ../../conventions.rst:237
 msgid ""
 "Glib: XDG base directories can be accessed through the "
 "``g_get_user_cache_dir ()``, ``g_get_user_data_dir ()``, "
 "``g_get_user_config_dir ()`` functions."
 msgstr ""
 
-#: ../../conventions.rst:225
+#: ../../conventions.rst:240
 msgid ""
 "Qt: XDG base directories can be accessed with the `QStandardPaths Class "
 "<https://doc.qt.io/qt-5/qstandardpaths.html>`_."
 msgstr ""
 
-#: ../../conventions.rst:228
+#: ../../conventions.rst:243
 msgid ""
 "However, applications that aren't using one of these toolkits can expect "
 "to find their XDG base directories in the following locations:"
 msgstr ""
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Base directory"
 msgstr ""
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Usage"
 msgstr ""
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Default location"
 msgstr ""
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "XDG_CONFIG_HOME"
 msgstr ""
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "User-specific configuration files"
 msgstr ""
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "~/.var/app/<app-id>/config"
 msgstr ""
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "XDG_DATA_HOME"
 msgstr ""
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "User-specific data"
 msgstr ""
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "~/.var/app/<app-id>/data"
 msgstr ""
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "XDG_CACHE_HOME"
 msgstr ""
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "Non-essential user-specific data"
 msgstr ""
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "~/.var/app/<app-id>/cache"
 msgstr ""
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "XDG_STATE_HOME"
 msgstr ""
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "State data such as undo history"
 msgstr ""
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "~/.var/app/<app-id>/.local/state"
 msgstr ""
 
-#: ../../conventions.rst:240
+#: ../../conventions.rst:255
 msgid "For example, GNOME Dictionary will store user-specific data in::"
 msgstr ""
 
-#: ../../conventions.rst:244
+#: ../../conventions.rst:259
 msgid ""
 "These environment variables are always set by Flatpak and override any "
 "host values. However, if access to directories on the host is needed, the"
@@ -456,7 +475,7 @@ msgid ""
 "variables will be set if they are also available on the host."
 msgstr ""
 
-#: ../../conventions.rst:249
+#: ../../conventions.rst:264
 msgid ""
 "Note that ``$XDG_STATE_HOME`` and ``$HOST_XDG_STATE_HOME`` are only "
 "supported by Flatpak 1.13 and later. If your application needs to work on"
@@ -466,7 +485,7 @@ msgid ""
 ">1.13."
 msgstr ""
 
-#: ../../conventions.rst:255
+#: ../../conventions.rst:270
 msgid ""
 "Also, note that applications can be configured to use non-default base "
 "directory locations (see :doc:`sandbox-permissions`)."
diff --git a/po/fr/LC_MESSAGES/conventions.po b/po/fr/LC_MESSAGES/conventions.po
index bfb010f7..026d7d16 100644
--- a/po/fr/LC_MESSAGES/conventions.po
+++ b/po/fr/LC_MESSAGES/conventions.po
@@ -9,7 +9,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version:  Flatpak\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-01 08:05+0530\n"
+"POT-Creation-Date: 2025-02-19 19:25+0530\n"
 "PO-Revision-Date: 2018-05-20 03:50-0400\n"
 "Last-Translator: Baptiste Mille-Mathias <baptiste.millemathias@gmail.com>"
 "\n"
@@ -19,7 +19,7 @@ msgstr ""
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.16.0\n"
+"Generated-By: Babel 2.17.0\n"
 
 #: ../../conventions.rst:2
 msgid "Requirements & Conventions"
@@ -299,10 +299,29 @@ msgid ""
 msgstr ""
 
 #: ../../conventions.rst:182
+msgid ""
+"The metainfo file along with the other metadata such as icon and desktop "
+"files is composed into a catalogue by ``appstream``. Since 1.3.4, Flatpak"
+" Builder by default uses ``appstreamcli`` from `libappstream "
+"<https://github.com/ximion/appstream/>`_ to compose this and executes the"
+" following command::"
+msgstr ""
+
+#: ../../conventions.rst:190
+#, python-brace-format
+msgid ""
+"``${FLATPAK_ID}`` is the Flatpak application ID and ``${FLATPAK_DEST}`` "
+"is set to ``/app`` for apps and ``/usr`` for runtimes. The ``media-"
+"baseurl`` controls the base URL used for mirroring screenshots. Usually "
+"each app store will have their own base URL for this. On Flathub this is "
+"set to ``https://dl.flathub.org/media/``."
+msgstr ""
+
+#: ../../conventions.rst:197
 msgid "Technical conventions"
 msgstr ""
 
-#: ../../conventions.rst:184
+#: ../../conventions.rst:199
 msgid ""
 "The following are standard technical conventions used by Flatpak and "
 "Linux desktops. Those with Linux experience will likely already be aware "
@@ -310,18 +329,18 @@ msgid ""
 " information useful."
 msgstr ""
 
-#: ../../conventions.rst:190
+#: ../../conventions.rst:205
 msgid "D-Bus"
 msgstr "D-Bus"
 
-#: ../../conventions.rst:192
+#: ../../conventions.rst:207
 msgid ""
 "D-Bus is the standard IPC framework used on Linux desktops. A lot of "
 "applications won't need to use it, but it is supported by Flatpak should "
 "it be required."
 msgstr ""
 
-#: ../../conventions.rst:196
+#: ../../conventions.rst:211
 msgid ""
 "D-Bus can be used for application launching and communicating with some "
 "system services. Applications can also provide their own D-Bus services "
@@ -329,11 +348,11 @@ msgid ""
 "the application ID)."
 msgstr ""
 
-#: ../../conventions.rst:201
+#: ../../conventions.rst:216
 msgid "Filesystem layout"
 msgstr ""
 
-#: ../../conventions.rst:203
+#: ../../conventions.rst:218
 msgid ""
 "Each Flatpak sandbox, which is the environment in which an application is"
 " run, contains the filesystem of the application's runtime. This follows "
@@ -341,7 +360,7 @@ msgid ""
 "<https://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard>`_."
 msgstr ""
 
-#: ../../conventions.rst:208
+#: ../../conventions.rst:223
 msgid ""
 "For example, the root of the sandbox contains the ``/etc`` directory for "
 "configuration files and ``/usr`` for multi-user utilities and "
@@ -350,11 +369,11 @@ msgid ""
 "located."
 msgstr ""
 
-#: ../../conventions.rst:214
+#: ../../conventions.rst:229
 msgid "XDG base directories"
 msgstr ""
 
-#: ../../conventions.rst:216
+#: ../../conventions.rst:231
 msgid ""
 "`XDG base directories <https://specifications.freedesktop.org/basedir-"
 "spec/basedir-spec-latest.html>`_ are standard locations for user-specific"
@@ -362,95 +381,95 @@ msgid ""
 "accessing XDG base directories. These include:"
 msgstr ""
 
-#: ../../conventions.rst:221
+#: ../../conventions.rst:236
 msgid "Electron: XDG base directories can be accessed with ``app.getPath``."
 msgstr ""
 
-#: ../../conventions.rst:222
+#: ../../conventions.rst:237
 msgid ""
 "Glib: XDG base directories can be accessed through the "
 "``g_get_user_cache_dir ()``, ``g_get_user_data_dir ()``, "
 "``g_get_user_config_dir ()`` functions."
 msgstr ""
 
-#: ../../conventions.rst:225
+#: ../../conventions.rst:240
 msgid ""
 "Qt: XDG base directories can be accessed with the `QStandardPaths Class "
 "<https://doc.qt.io/qt-5/qstandardpaths.html>`_."
 msgstr ""
 
-#: ../../conventions.rst:228
+#: ../../conventions.rst:243
 msgid ""
 "However, applications that aren't using one of these toolkits can expect "
 "to find their XDG base directories in the following locations:"
 msgstr ""
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Base directory"
 msgstr ""
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Usage"
 msgstr ""
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Default location"
 msgstr ""
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "XDG_CONFIG_HOME"
 msgstr "XDG_CONFIG_HOME"
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "User-specific configuration files"
 msgstr ""
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "~/.var/app/<app-id>/config"
 msgstr "~/.var/app/<app-id>/config"
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "XDG_DATA_HOME"
 msgstr "XDG_DATA_HOME"
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "User-specific data"
 msgstr ""
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "~/.var/app/<app-id>/data"
 msgstr "~/.var/app/<app-id>/data"
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "XDG_CACHE_HOME"
 msgstr "XDG_CACHE_HOME"
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "Non-essential user-specific data"
 msgstr ""
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "~/.var/app/<app-id>/cache"
 msgstr "~/.var/app/<app-id>/cache"
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "XDG_STATE_HOME"
 msgstr ""
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "State data such as undo history"
 msgstr ""
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 #, fuzzy
 msgid "~/.var/app/<app-id>/.local/state"
 msgstr "~/.var/app/<app-id>/cache"
 
-#: ../../conventions.rst:240
+#: ../../conventions.rst:255
 msgid "For example, GNOME Dictionary will store user-specific data in::"
 msgstr ""
 
-#: ../../conventions.rst:244
+#: ../../conventions.rst:259
 msgid ""
 "These environment variables are always set by Flatpak and override any "
 "host values. However, if access to directories on the host is needed, the"
@@ -459,7 +478,7 @@ msgid ""
 "variables will be set if they are also available on the host."
 msgstr ""
 
-#: ../../conventions.rst:249
+#: ../../conventions.rst:264
 msgid ""
 "Note that ``$XDG_STATE_HOME`` and ``$HOST_XDG_STATE_HOME`` are only "
 "supported by Flatpak 1.13 and later. If your application needs to work on"
@@ -469,7 +488,7 @@ msgid ""
 ">1.13."
 msgstr ""
 
-#: ../../conventions.rst:255
+#: ../../conventions.rst:270
 msgid ""
 "Also, note that applications can be configured to use non-default base "
 "directory locations (see :doc:`sandbox-permissions`)."
diff --git a/po/ko/LC_MESSAGES/conventions.po b/po/ko/LC_MESSAGES/conventions.po
index 952b6033..32711bb5 100644
--- a/po/ko/LC_MESSAGES/conventions.po
+++ b/po/ko/LC_MESSAGES/conventions.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version:  Flatpak\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-01 08:05+0530\n"
+"POT-Creation-Date: 2025-02-19 19:25+0530\n"
 "PO-Revision-Date: 2018-05-20 10:37-0400\n"
 "Last-Translator: Copied by Zanata <copied-by-zanata@zanata.org>\n"
 "Language: ko\n"
@@ -17,7 +17,7 @@ msgstr ""
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.16.0\n"
+"Generated-By: Babel 2.17.0\n"
 
 #: ../../conventions.rst:2
 msgid "Requirements & Conventions"
@@ -297,10 +297,29 @@ msgid ""
 msgstr ""
 
 #: ../../conventions.rst:182
+msgid ""
+"The metainfo file along with the other metadata such as icon and desktop "
+"files is composed into a catalogue by ``appstream``. Since 1.3.4, Flatpak"
+" Builder by default uses ``appstreamcli`` from `libappstream "
+"<https://github.com/ximion/appstream/>`_ to compose this and executes the"
+" following command::"
+msgstr ""
+
+#: ../../conventions.rst:190
+#, python-brace-format
+msgid ""
+"``${FLATPAK_ID}`` is the Flatpak application ID and ``${FLATPAK_DEST}`` "
+"is set to ``/app`` for apps and ``/usr`` for runtimes. The ``media-"
+"baseurl`` controls the base URL used for mirroring screenshots. Usually "
+"each app store will have their own base URL for this. On Flathub this is "
+"set to ``https://dl.flathub.org/media/``."
+msgstr ""
+
+#: ../../conventions.rst:197
 msgid "Technical conventions"
 msgstr ""
 
-#: ../../conventions.rst:184
+#: ../../conventions.rst:199
 msgid ""
 "The following are standard technical conventions used by Flatpak and "
 "Linux desktops. Those with Linux experience will likely already be aware "
@@ -308,18 +327,18 @@ msgid ""
 " information useful."
 msgstr ""
 
-#: ../../conventions.rst:190
+#: ../../conventions.rst:205
 msgid "D-Bus"
 msgstr ""
 
-#: ../../conventions.rst:192
+#: ../../conventions.rst:207
 msgid ""
 "D-Bus is the standard IPC framework used on Linux desktops. A lot of "
 "applications won't need to use it, but it is supported by Flatpak should "
 "it be required."
 msgstr ""
 
-#: ../../conventions.rst:196
+#: ../../conventions.rst:211
 msgid ""
 "D-Bus can be used for application launching and communicating with some "
 "system services. Applications can also provide their own D-Bus services "
@@ -327,11 +346,11 @@ msgid ""
 "the application ID)."
 msgstr ""
 
-#: ../../conventions.rst:201
+#: ../../conventions.rst:216
 msgid "Filesystem layout"
 msgstr ""
 
-#: ../../conventions.rst:203
+#: ../../conventions.rst:218
 msgid ""
 "Each Flatpak sandbox, which is the environment in which an application is"
 " run, contains the filesystem of the application's runtime. This follows "
@@ -339,7 +358,7 @@ msgid ""
 "<https://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard>`_."
 msgstr ""
 
-#: ../../conventions.rst:208
+#: ../../conventions.rst:223
 msgid ""
 "For example, the root of the sandbox contains the ``/etc`` directory for "
 "configuration files and ``/usr`` for multi-user utilities and "
@@ -348,11 +367,11 @@ msgid ""
 "located."
 msgstr ""
 
-#: ../../conventions.rst:214
+#: ../../conventions.rst:229
 msgid "XDG base directories"
 msgstr ""
 
-#: ../../conventions.rst:216
+#: ../../conventions.rst:231
 msgid ""
 "`XDG base directories <https://specifications.freedesktop.org/basedir-"
 "spec/basedir-spec-latest.html>`_ are standard locations for user-specific"
@@ -360,94 +379,94 @@ msgid ""
 "accessing XDG base directories. These include:"
 msgstr ""
 
-#: ../../conventions.rst:221
+#: ../../conventions.rst:236
 msgid "Electron: XDG base directories can be accessed with ``app.getPath``."
 msgstr ""
 
-#: ../../conventions.rst:222
+#: ../../conventions.rst:237
 msgid ""
 "Glib: XDG base directories can be accessed through the "
 "``g_get_user_cache_dir ()``, ``g_get_user_data_dir ()``, "
 "``g_get_user_config_dir ()`` functions."
 msgstr ""
 
-#: ../../conventions.rst:225
+#: ../../conventions.rst:240
 msgid ""
 "Qt: XDG base directories can be accessed with the `QStandardPaths Class "
 "<https://doc.qt.io/qt-5/qstandardpaths.html>`_."
 msgstr ""
 
-#: ../../conventions.rst:228
+#: ../../conventions.rst:243
 msgid ""
 "However, applications that aren't using one of these toolkits can expect "
 "to find their XDG base directories in the following locations:"
 msgstr ""
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Base directory"
 msgstr ""
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Usage"
 msgstr ""
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Default location"
 msgstr ""
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "XDG_CONFIG_HOME"
 msgstr ""
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "User-specific configuration files"
 msgstr ""
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "~/.var/app/<app-id>/config"
 msgstr ""
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "XDG_DATA_HOME"
 msgstr ""
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "User-specific data"
 msgstr ""
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "~/.var/app/<app-id>/data"
 msgstr ""
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "XDG_CACHE_HOME"
 msgstr ""
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "Non-essential user-specific data"
 msgstr ""
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "~/.var/app/<app-id>/cache"
 msgstr ""
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "XDG_STATE_HOME"
 msgstr ""
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "State data such as undo history"
 msgstr ""
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "~/.var/app/<app-id>/.local/state"
 msgstr ""
 
-#: ../../conventions.rst:240
+#: ../../conventions.rst:255
 msgid "For example, GNOME Dictionary will store user-specific data in::"
 msgstr ""
 
-#: ../../conventions.rst:244
+#: ../../conventions.rst:259
 msgid ""
 "These environment variables are always set by Flatpak and override any "
 "host values. However, if access to directories on the host is needed, the"
@@ -456,7 +475,7 @@ msgid ""
 "variables will be set if they are also available on the host."
 msgstr ""
 
-#: ../../conventions.rst:249
+#: ../../conventions.rst:264
 msgid ""
 "Note that ``$XDG_STATE_HOME`` and ``$HOST_XDG_STATE_HOME`` are only "
 "supported by Flatpak 1.13 and later. If your application needs to work on"
@@ -466,7 +485,7 @@ msgid ""
 ">1.13."
 msgstr ""
 
-#: ../../conventions.rst:255
+#: ../../conventions.rst:270
 msgid ""
 "Also, note that applications can be configured to use non-default base "
 "directory locations (see :doc:`sandbox-permissions`)."
diff --git a/po/pt_BR/LC_MESSAGES/conventions.po b/po/pt_BR/LC_MESSAGES/conventions.po
index f4f45016..f8256f96 100644
--- a/po/pt_BR/LC_MESSAGES/conventions.po
+++ b/po/pt_BR/LC_MESSAGES/conventions.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flatpak \n"
 "Report-Msgid-Bugs-To: https://github.com/flatpak/flatpak-docs/issues\n"
-"POT-Creation-Date: 2024-12-01 08:05+0530\n"
+"POT-Creation-Date: 2025-02-19 19:25+0530\n"
 "PO-Revision-Date: 2023-05-31 14:22-0300\n"
 "Last-Translator: Rafael Fontenelle <rafaelff@gnome.org>\n"
 "Language: pt_BR\n"
@@ -17,7 +17,7 @@ msgstr ""
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.16.0\n"
+"Generated-By: Babel 2.17.0\n"
 
 #: ../../conventions.rst:2
 msgid "Requirements & Conventions"
@@ -410,10 +410,29 @@ msgid ""
 msgstr ""
 
 #: ../../conventions.rst:182
+msgid ""
+"The metainfo file along with the other metadata such as icon and desktop "
+"files is composed into a catalogue by ``appstream``. Since 1.3.4, Flatpak"
+" Builder by default uses ``appstreamcli`` from `libappstream "
+"<https://github.com/ximion/appstream/>`_ to compose this and executes the"
+" following command::"
+msgstr ""
+
+#: ../../conventions.rst:190
+#, python-brace-format
+msgid ""
+"``${FLATPAK_ID}`` is the Flatpak application ID and ``${FLATPAK_DEST}`` "
+"is set to ``/app`` for apps and ``/usr`` for runtimes. The ``media-"
+"baseurl`` controls the base URL used for mirroring screenshots. Usually "
+"each app store will have their own base URL for this. On Flathub this is "
+"set to ``https://dl.flathub.org/media/``."
+msgstr ""
+
+#: ../../conventions.rst:197
 msgid "Technical conventions"
 msgstr "Convenções técnicas"
 
-#: ../../conventions.rst:184
+#: ../../conventions.rst:199
 msgid ""
 "The following are standard technical conventions used by Flatpak and "
 "Linux desktops. Those with Linux experience will likely already be aware "
@@ -425,11 +444,11 @@ msgstr ""
 "já estarão cientes deles. No entanto, os desenvolvedores que são novos no"
 " Linux podem achar algumas dessas informações úteis."
 
-#: ../../conventions.rst:190
+#: ../../conventions.rst:205
 msgid "D-Bus"
 msgstr "D-Bus"
 
-#: ../../conventions.rst:192
+#: ../../conventions.rst:207
 msgid ""
 "D-Bus is the standard IPC framework used on Linux desktops. A lot of "
 "applications won't need to use it, but it is supported by Flatpak should "
@@ -439,7 +458,7 @@ msgstr ""
 "aplicativos não precisarão usá-lo, mas o Flatpak fornece suporte a ele, "
 "caso seja necessário."
 
-#: ../../conventions.rst:196
+#: ../../conventions.rst:211
 msgid ""
 "D-Bus can be used for application launching and communicating with some "
 "system services. Applications can also provide their own D-Bus services "
@@ -451,11 +470,11 @@ msgstr ""
 "D-Bus (ao fazer isso, o nome do serviço D-Bus deve ser o mesmo que o ID "
 "do aplicativo)."
 
-#: ../../conventions.rst:201
+#: ../../conventions.rst:216
 msgid "Filesystem layout"
 msgstr "Layout de sistema de arquivos"
 
-#: ../../conventions.rst:203
+#: ../../conventions.rst:218
 msgid ""
 "Each Flatpak sandbox, which is the environment in which an application is"
 " run, contains the filesystem of the application's runtime. This follows "
@@ -467,7 +486,7 @@ msgstr ""
 "segue as `convenções padrão do sistema de arquivos Linux "
 "<https://pt.wikipedia.org/wiki/Filesystem_Hierarchy_Standard>`_."
 
-#: ../../conventions.rst:208
+#: ../../conventions.rst:223
 #, fuzzy
 msgid ""
 "For example, the root of the sandbox contains the ``/etc`` directory for "
@@ -481,11 +500,11 @@ msgstr ""
 "Além disso, cada sandbox contém um diretório ``/app`` de nível superior, "
 "onde os arquivos do aplicativo estão localizados."
 
-#: ../../conventions.rst:214
+#: ../../conventions.rst:229
 msgid "XDG base directories"
 msgstr "Diretórios base XDG"
 
-#: ../../conventions.rst:216
+#: ../../conventions.rst:231
 msgid ""
 "`XDG base directories <https://specifications.freedesktop.org/basedir-"
 "spec/basedir-spec-latest.html>`_ are standard locations for user-specific"
@@ -497,12 +516,12 @@ msgstr ""
 "específicos do usuário. Os kits de ferramentas populares fornecem funções"
 " de conveniência para acessar os diretórios base do XDG. Esses incluem:"
 
-#: ../../conventions.rst:221
+#: ../../conventions.rst:236
 #, fuzzy
 msgid "Electron: XDG base directories can be accessed with ``app.getPath``."
 msgstr "Electron: os diretórios base XDG podem ser acessados com ``app.getPath``"
 
-#: ../../conventions.rst:222
+#: ../../conventions.rst:237
 #, fuzzy
 msgid ""
 "Glib: XDG base directories can be accessed through the "
@@ -513,7 +532,7 @@ msgstr ""
 "``g_get_user_cache_dir ()``, ``g_get_user_data_dir ()`` e "
 "``g_get_user_config_dir ()``"
 
-#: ../../conventions.rst:225
+#: ../../conventions.rst:240
 #, fuzzy
 msgid ""
 "Qt: XDG base directories can be accessed with the `QStandardPaths Class "
@@ -522,7 +541,7 @@ msgstr ""
 "Qt: fornece acesso aos diretórios base XDG com a `classe QStandardPaths "
 "<https://doc.qt.io/qt-5/qstandardpaths.html>`_"
 
-#: ../../conventions.rst:228
+#: ../../conventions.rst:243
 msgid ""
 "However, applications that aren't using one of these toolkits can expect "
 "to find their XDG base directories in the following locations:"
@@ -531,73 +550,73 @@ msgstr ""
 "ferramentas podem esperar encontrar seus diretórios base XDG nos "
 "seguintes locais:"
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Base directory"
 msgstr "Diretório base"
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Usage"
 msgstr "Uso"
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Default location"
 msgstr "Local padrão"
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "XDG_CONFIG_HOME"
 msgstr "XDG_CONFIG_HOME"
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "User-specific configuration files"
 msgstr "Arquivos de configuração específicos do usuário"
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "~/.var/app/<app-id>/config"
 msgstr "~/.var/app/<id-aplicativo>/config"
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "XDG_DATA_HOME"
 msgstr "XDG_DATA_HOME"
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "User-specific data"
 msgstr "Dados específicos do usuário"
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "~/.var/app/<app-id>/data"
 msgstr "~/.var/app/<id-aplicativo>/data"
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "XDG_CACHE_HOME"
 msgstr "XDG_CACHE_HOME"
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "Non-essential user-specific data"
 msgstr "Dados não essenciais específicos do usuário"
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "~/.var/app/<app-id>/cache"
 msgstr "~/.var/app/<id-aplicativo>/cache"
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "XDG_STATE_HOME"
 msgstr "XDG_STATE_HOME"
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "State data such as undo history"
 msgstr "Dados de estado, tais como histórico de desfazimento"
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "~/.var/app/<app-id>/.local/state"
 msgstr "~/.var/app/<id-aplicativo>/.local/state"
 
-#: ../../conventions.rst:240
+#: ../../conventions.rst:255
 msgid "For example, GNOME Dictionary will store user-specific data in::"
 msgstr ""
 "Por exemplo, Dicionário do GNOME vai armazenar dados específicos do "
 "usuário em::"
 
-#: ../../conventions.rst:244
+#: ../../conventions.rst:259
 msgid ""
 "These environment variables are always set by Flatpak and override any "
 "host values. However, if access to directories on the host is needed, the"
@@ -606,7 +625,7 @@ msgid ""
 "variables will be set if they are also available on the host."
 msgstr ""
 
-#: ../../conventions.rst:249
+#: ../../conventions.rst:264
 #, fuzzy
 msgid ""
 "Note that ``$XDG_STATE_HOME`` and ``$HOST_XDG_STATE_HOME`` are only "
@@ -622,7 +641,7 @@ msgstr ""
 "``--unset-env=XDG_STATE_HOME`` de acabamento (finish) para que o "
 "aplicativo use o diretório correto , ainda que usando o Flatpak >1.13."
 
-#: ../../conventions.rst:255
+#: ../../conventions.rst:270
 #, fuzzy
 msgid ""
 "Also, note that applications can be configured to use non-default base "
diff --git a/po/ru/LC_MESSAGES/conventions.po b/po/ru/LC_MESSAGES/conventions.po
index fb557e23..ed6e7703 100644
--- a/po/ru/LC_MESSAGES/conventions.po
+++ b/po/ru/LC_MESSAGES/conventions.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version:  Flatpak\n"
 "Report-Msgid-Bugs-To: https://github.com/flatpak/flatpak-docs/issues\n"
-"POT-Creation-Date: 2024-12-01 08:05+0530\n"
+"POT-Creation-Date: 2025-02-19 19:25+0530\n"
 "PO-Revision-Date: 2023-11-06 21:31+0700\n"
 "Last-Translator: Dmitry <dmitrydmitry761@gmail.com>\n"
 "Language: ru\n"
@@ -18,7 +18,7 @@ msgstr ""
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.16.0\n"
+"Generated-By: Babel 2.17.0\n"
 
 #: ../../conventions.rst:2
 msgid "Requirements & Conventions"
@@ -413,10 +413,29 @@ msgid ""
 msgstr ""
 
 #: ../../conventions.rst:182
+msgid ""
+"The metainfo file along with the other metadata such as icon and desktop "
+"files is composed into a catalogue by ``appstream``. Since 1.3.4, Flatpak"
+" Builder by default uses ``appstreamcli`` from `libappstream "
+"<https://github.com/ximion/appstream/>`_ to compose this and executes the"
+" following command::"
+msgstr ""
+
+#: ../../conventions.rst:190
+#, python-brace-format
+msgid ""
+"``${FLATPAK_ID}`` is the Flatpak application ID and ``${FLATPAK_DEST}`` "
+"is set to ``/app`` for apps and ``/usr`` for runtimes. The ``media-"
+"baseurl`` controls the base URL used for mirroring screenshots. Usually "
+"each app store will have their own base URL for this. On Flathub this is "
+"set to ``https://dl.flathub.org/media/``."
+msgstr ""
+
+#: ../../conventions.rst:197
 msgid "Technical conventions"
 msgstr "Технические соглашения"
 
-#: ../../conventions.rst:184
+#: ../../conventions.rst:199
 msgid ""
 "The following are standard technical conventions used by Flatpak and "
 "Linux desktops. Those with Linux experience will likely already be aware "
@@ -428,11 +447,11 @@ msgstr ""
 "уже знают о них. Однако разработчикам, которые не знакомы с Linux, часть "
 "этой информации может оказаться полезной."
 
-#: ../../conventions.rst:190
+#: ../../conventions.rst:205
 msgid "D-Bus"
 msgstr "D-Bus"
 
-#: ../../conventions.rst:192
+#: ../../conventions.rst:207
 msgid ""
 "D-Bus is the standard IPC framework used on Linux desktops. A lot of "
 "applications won't need to use it, but it is supported by Flatpak should "
@@ -442,7 +461,7 @@ msgstr ""
 "компьютерах Linux. Многим приложениям не нужно его использовать, но "
 "Flatpak поддерживает его, если это необходимо."
 
-#: ../../conventions.rst:196
+#: ../../conventions.rst:211
 msgid ""
 "D-Bus can be used for application launching and communicating with some "
 "system services. Applications can also provide their own D-Bus services "
@@ -454,11 +473,11 @@ msgstr ""
 "собственные службы D-Bus (при этом ожидается, что имя службы D-Bus будет "
 "таким же, как идентификатор приложения)."
 
-#: ../../conventions.rst:201
+#: ../../conventions.rst:216
 msgid "Filesystem layout"
 msgstr "Схема файловой системы"
 
-#: ../../conventions.rst:203
+#: ../../conventions.rst:218
 msgid ""
 "Each Flatpak sandbox, which is the environment in which an application is"
 " run, contains the filesystem of the application's runtime. This follows "
@@ -470,7 +489,7 @@ msgstr ""
 "приложения. Это соответствует `стандартным соглашениям о файловой системе"
 " Linux <https://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard>`_."
 
-#: ../../conventions.rst:208
+#: ../../conventions.rst:223
 #, fuzzy
 msgid ""
 "For example, the root of the sandbox contains the ``/etc`` directory for "
@@ -484,11 +503,11 @@ msgstr ""
 "дополнение к этому каждая песочница содержит каталог верхнего уровня "
 "``/app``, в котором находятся собственные файлы приложения."
 
-#: ../../conventions.rst:214
+#: ../../conventions.rst:229
 msgid "XDG base directories"
 msgstr "Базовые каталоги XDG"
 
-#: ../../conventions.rst:216
+#: ../../conventions.rst:231
 msgid ""
 "`XDG base directories <https://specifications.freedesktop.org/basedir-"
 "spec/basedir-spec-latest.html>`_ are standard locations for user-specific"
@@ -501,14 +520,14 @@ msgstr ""
 "инструментов предоставляют удобные функции для доступа к базовым "
 "каталогам XDG. К ним относятся:"
 
-#: ../../conventions.rst:221
+#: ../../conventions.rst:236
 #, fuzzy
 msgid "Electron: XDG base directories can be accessed with ``app.getPath``."
 msgstr ""
 "Electron: доступ к базовым каталогам XDG можно получить с помощью "
 "``app.getPath``"
 
-#: ../../conventions.rst:222
+#: ../../conventions.rst:237
 #, fuzzy
 msgid ""
 "Glib: XDG base directories can be accessed through the "
@@ -519,7 +538,7 @@ msgstr ""
 "``g_get_user_cache_dir()``, ``g_get_user_data_dir()``, "
 "``g_get_user_config_dir()``"
 
-#: ../../conventions.rst:225
+#: ../../conventions.rst:240
 #, fuzzy
 msgid ""
 "Qt: XDG base directories can be accessed with the `QStandardPaths Class "
@@ -528,7 +547,7 @@ msgstr ""
 "Qt: предоставляет доступ к базовым каталогам XDG с помощью QStandardPaths"
 " <https://doc.qt.io/qt-5/qstandardpaths.html>`_"
 
-#: ../../conventions.rst:228
+#: ../../conventions.rst:243
 msgid ""
 "However, applications that aren't using one of these toolkits can expect "
 "to find their XDG base directories in the following locations:"
@@ -536,71 +555,71 @@ msgstr ""
 "Однако приложения, которые не используют один из этих наборов "
 "инструментов, могут найти свои базовые каталоги XDG в следующих местах:"
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Base directory"
 msgstr "Базовый каталог"
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Usage"
 msgstr "Применение"
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Default location"
 msgstr "Местоположение по умолчанию"
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "XDG_CONFIG_HOME"
 msgstr "XDG_CONFIG_HOME"
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "User-specific configuration files"
 msgstr "Пользовательские файлы конфигурации"
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "~/.var/app/<app-id>/config"
 msgstr "~/.var/app/<app-id>/config"
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "XDG_DATA_HOME"
 msgstr "XDG_DATA_HOME"
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "User-specific data"
 msgstr "Пользовательские данные"
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "~/.var/app/<app-id>/data"
 msgstr "~/.var/app/<app-id>/data"
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "XDG_CACHE_HOME"
 msgstr "XDG_CACHE_HOME"
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "Non-essential user-specific data"
 msgstr "Несущественные пользовательские данные"
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "~/.var/app/<app-id>/cache"
 msgstr "~/.var/app/<app-id>/cache"
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "XDG_STATE_HOME"
 msgstr "XDG_STATE_HOME"
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "State data such as undo history"
 msgstr "Данные состояния, такие как история отмен"
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "~/.var/app/<app-id>/.local/state"
 msgstr "~/.var/app/<app-id>/.local/state"
 
-#: ../../conventions.rst:240
+#: ../../conventions.rst:255
 msgid "For example, GNOME Dictionary will store user-specific data in::"
 msgstr "Например, словарь GNOME будет хранить пользовательские данные в::"
 
-#: ../../conventions.rst:244
+#: ../../conventions.rst:259
 msgid ""
 "These environment variables are always set by Flatpak and override any "
 "host values. However, if access to directories on the host is needed, the"
@@ -609,7 +628,7 @@ msgid ""
 "variables will be set if they are also available on the host."
 msgstr ""
 
-#: ../../conventions.rst:249
+#: ../../conventions.rst:264
 #, fuzzy
 msgid ""
 "Note that ``$XDG_STATE_HOME`` and ``$HOST_XDG_STATE_HOME`` are only "
@@ -626,7 +645,7 @@ msgstr ""
 "env=XDG_STATE_HOME``, чтобы приложение использовало правильный каталог. ,"
 " даже после того, как Flatpak позже был обновлен до > 1.13."
 
-#: ../../conventions.rst:255
+#: ../../conventions.rst:270
 #, fuzzy
 msgid ""
 "Also, note that applications can be configured to use non-default base "
diff --git a/po/zh_CN/LC_MESSAGES/conventions.po b/po/zh_CN/LC_MESSAGES/conventions.po
index f642b748..5ef012db 100644
--- a/po/zh_CN/LC_MESSAGES/conventions.po
+++ b/po/zh_CN/LC_MESSAGES/conventions.po
@@ -5,7 +5,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version:  Flatpak\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-01 08:05+0530\n"
+"POT-Creation-Date: 2025-02-19 19:25+0530\n"
 "PO-Revision-Date: 2018-11-03 01:31-0400\n"
 "Last-Translator: PikachuHy <pikachuhy@163.com>\n"
 "Language: zh_Hans_CN\n"
@@ -14,7 +14,7 @@ msgstr ""
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.16.0\n"
+"Generated-By: Babel 2.17.0\n"
 
 #: ../../conventions.rst:2
 msgid "Requirements & Conventions"
@@ -324,10 +324,29 @@ msgid ""
 msgstr ""
 
 #: ../../conventions.rst:182
+msgid ""
+"The metainfo file along with the other metadata such as icon and desktop "
+"files is composed into a catalogue by ``appstream``. Since 1.3.4, Flatpak"
+" Builder by default uses ``appstreamcli`` from `libappstream "
+"<https://github.com/ximion/appstream/>`_ to compose this and executes the"
+" following command::"
+msgstr ""
+
+#: ../../conventions.rst:190
+#, python-brace-format
+msgid ""
+"``${FLATPAK_ID}`` is the Flatpak application ID and ``${FLATPAK_DEST}`` "
+"is set to ``/app`` for apps and ``/usr`` for runtimes. The ``media-"
+"baseurl`` controls the base URL used for mirroring screenshots. Usually "
+"each app store will have their own base URL for this. On Flathub this is "
+"set to ``https://dl.flathub.org/media/``."
+msgstr ""
+
+#: ../../conventions.rst:197
 msgid "Technical conventions"
 msgstr "技术规范"
 
-#: ../../conventions.rst:184
+#: ../../conventions.rst:199
 msgid ""
 "The following are standard technical conventions used by Flatpak and "
 "Linux desktops. Those with Linux experience will likely already be aware "
@@ -335,11 +354,11 @@ msgid ""
 " information useful."
 msgstr "Flatpak和多数Linux桌面都遵循下列标准技术规范。有Linux使用经验的用户对此可能已有了解。首次使用Linux的开发者同样可以在这里找到有用的信息。"
 
-#: ../../conventions.rst:190
+#: ../../conventions.rst:205
 msgid "D-Bus"
 msgstr "D-Bus"
 
-#: ../../conventions.rst:192
+#: ../../conventions.rst:207
 msgid ""
 "D-Bus is the standard IPC framework used on Linux desktops. A lot of "
 "applications won't need to use it, but it is supported by Flatpak should "
@@ -348,7 +367,7 @@ msgstr ""
 "D-Bus是Linux桌面使用的标准IPC（进程间通讯，译者注）框架。大多数应用程序并不会用到D-Bus；但如果需要，Flatpak也同样提供D-"
 "Bus支持。"
 
-#: ../../conventions.rst:196
+#: ../../conventions.rst:211
 msgid ""
 "D-Bus can be used for application launching and communicating with some "
 "system services. Applications can also provide their own D-Bus services "
@@ -358,11 +377,11 @@ msgstr ""
 "D-Bus可用于启动应用程序，以及系统服务之间的交互。应用程序也可以实现它们自己的D-"
 "Bus服务（此时，D-Bus服务的名称必须与应用程序的ID一致）。"
 
-#: ../../conventions.rst:201
+#: ../../conventions.rst:216
 msgid "Filesystem layout"
 msgstr "Filesystem layout（文件系统布局，译者注）"
 
-#: ../../conventions.rst:203
+#: ../../conventions.rst:218
 msgid ""
 "Each Flatpak sandbox, which is the environment in which an application is"
 " run, contains the filesystem of the application's runtime. This follows "
@@ -374,7 +393,7 @@ msgstr ""
 "<https://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard>`_ "
 "（标准Linux文件系统约定，译者注）。"
 
-#: ../../conventions.rst:208
+#: ../../conventions.rst:223
 #, fuzzy
 msgid ""
 "For example, the root of the sandbox contains the ``/etc`` directory for "
@@ -386,11 +405,11 @@ msgstr ""
 "举个例子，沙箱根目录包含  ``/etc``  用于配置文件和  ``/usr``  "
 "用于多用户utilities和应用。除此之外，每个沙箱包含一个顶级  ``/app/``  目录，用于应用自己文件的存放。"
 
-#: ../../conventions.rst:214
+#: ../../conventions.rst:229
 msgid "XDG base directories"
 msgstr "XDG基本目录"
 
-#: ../../conventions.rst:216
+#: ../../conventions.rst:231
 #, fuzzy
 msgid ""
 "`XDG base directories <https://specifications.freedesktop.org/basedir-"
@@ -401,12 +420,12 @@ msgstr ""
 "`XDG基本目录 <https://standards.freedesktop.org/basedir-spec/basedir-spec-"
 "latest.html>`_  指定用户应用数据的位置标准。很多工具包都提供了访问XDG基本目录的快捷方法。如:"
 
-#: ../../conventions.rst:221
+#: ../../conventions.rst:236
 #, fuzzy
 msgid "Electron: XDG base directories can be accessed with ``app.getPath``."
 msgstr "Electron: 使用 ``app.getPath`` 访问XDG基本目录"
 
-#: ../../conventions.rst:222
+#: ../../conventions.rst:237
 #, fuzzy
 msgid ""
 "Glib: XDG base directories can be accessed through the "
@@ -416,7 +435,7 @@ msgstr ""
 "Glib: 通过 ``g_get_user_cache_dir ()``, ``g_get_user_data_dir ()``, "
 "``g_get_user_config_dir ()`` 函数访问XDG基本目录"
 
-#: ../../conventions.rst:225
+#: ../../conventions.rst:240
 #, fuzzy
 msgid ""
 "Qt: XDG base directories can be accessed with the `QStandardPaths Class "
@@ -425,78 +444,78 @@ msgstr ""
 "Qt: 通过 `QStandardPaths Class "
 "<http://doc.qt.io/qt-5/qstandardpaths.html>`_ 访问XDG基本目录"
 
-#: ../../conventions.rst:228
+#: ../../conventions.rst:243
 msgid ""
 "However, applications that aren't using one of these toolkits can expect "
 "to find their XDG base directories in the following locations:"
 msgstr "如果应用没有使用上述工具包，也可以通过下面的方式找到XDG基本目录："
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Base directory"
 msgstr "基本目录"
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Usage"
 msgstr "用途"
 
-#: ../../conventions.rst:232
+#: ../../conventions.rst:247
 msgid "Default location"
 msgstr "默认位置"
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "XDG_CONFIG_HOME"
 msgstr "XDG_CONFIG_HOME"
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "User-specific configuration files"
 msgstr "具体用户配置文件"
 
-#: ../../conventions.rst:234
+#: ../../conventions.rst:249
 msgid "~/.var/app/<app-id>/config"
 msgstr "~/.var/app/<app-id>/config"
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "XDG_DATA_HOME"
 msgstr "XDG_DATA_HOME"
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "User-specific data"
 msgstr "具体用户数据"
 
-#: ../../conventions.rst:235
+#: ../../conventions.rst:250
 msgid "~/.var/app/<app-id>/data"
 msgstr "~/.var/app/<app-id>/data"
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "XDG_CACHE_HOME"
 msgstr "XDG_CACHE_HOME"
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "Non-essential user-specific data"
 msgstr "Non-essential user-specific data（非基本具体用户数据，译者注）"
 
-#: ../../conventions.rst:236
+#: ../../conventions.rst:251
 msgid "~/.var/app/<app-id>/cache"
 msgstr "~/.var/app/<app-id>/cache"
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "XDG_STATE_HOME"
 msgstr ""
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 msgid "State data such as undo history"
 msgstr ""
 
-#: ../../conventions.rst:237
+#: ../../conventions.rst:252
 #, fuzzy
 msgid "~/.var/app/<app-id>/.local/state"
 msgstr "~/.var/app/<app-id>/cache"
 
-#: ../../conventions.rst:240
+#: ../../conventions.rst:255
 msgid "For example, GNOME Dictionary will store user-specific data in::"
 msgstr "举个例子，GNOME Dictionary会把具体用户数据存放在::"
 
-#: ../../conventions.rst:244
+#: ../../conventions.rst:259
 msgid ""
 "These environment variables are always set by Flatpak and override any "
 "host values. However, if access to directories on the host is needed, the"
@@ -505,7 +524,7 @@ msgid ""
 "variables will be set if they are also available on the host."
 msgstr ""
 
-#: ../../conventions.rst:249
+#: ../../conventions.rst:264
 msgid ""
 "Note that ``$XDG_STATE_HOME`` and ``$HOST_XDG_STATE_HOME`` are only "
 "supported by Flatpak 1.13 and later. If your application needs to work on"
@@ -515,7 +534,7 @@ msgid ""
 ">1.13."
 msgstr ""
 
-#: ../../conventions.rst:255
+#: ../../conventions.rst:270
 #, fuzzy
 msgid ""
 "Also, note that applications can be configured to use non-default base "