From edf1532d971b52183871d4dc8f0b47bc52a13f23 Mon Sep 17 00:00:00 2001 From: bbhtt Date: Wed, 5 Feb 2025 01:11:06 +0530 Subject: [PATCH] Update po files --- po/de/LC_MESSAGES/debugging.po | 20 ++- po/de/LC_MESSAGES/electron.po | 94 ++++++---- po/de/LC_MESSAGES/manifests.po | 163 ++++++++++++----- po/de/LC_MESSAGES/sandbox-permissions.po | 34 +++- po/es/LC_MESSAGES/debugging.po | 20 ++- po/es/LC_MESSAGES/electron.po | 94 ++++++---- po/es/LC_MESSAGES/manifests.po | 163 ++++++++++++----- po/es/LC_MESSAGES/sandbox-permissions.po | 34 +++- po/fr/LC_MESSAGES/debugging.po | 20 ++- po/fr/LC_MESSAGES/electron.po | 94 ++++++---- po/fr/LC_MESSAGES/manifests.po | 163 ++++++++++++----- po/fr/LC_MESSAGES/sandbox-permissions.po | 34 +++- po/ko/LC_MESSAGES/debugging.po | 20 ++- po/ko/LC_MESSAGES/electron.po | 94 ++++++---- po/ko/LC_MESSAGES/manifests.po | 163 ++++++++++++----- po/ko/LC_MESSAGES/sandbox-permissions.po | 34 +++- po/pt_BR/LC_MESSAGES/debugging.po | 20 ++- po/pt_BR/LC_MESSAGES/electron.po | 94 ++++++---- po/pt_BR/LC_MESSAGES/manifests.po | 184 ++++++++++++------- po/pt_BR/LC_MESSAGES/sandbox-permissions.po | 34 +++- po/ru/LC_MESSAGES/debugging.po | 20 ++- po/ru/LC_MESSAGES/electron.po | 94 ++++++---- po/ru/LC_MESSAGES/manifests.po | 185 +++++++++++++------- po/ru/LC_MESSAGES/sandbox-permissions.po | 34 +++- po/zh_CN/LC_MESSAGES/debugging.po | 20 ++- po/zh_CN/LC_MESSAGES/electron.po | 94 ++++++---- po/zh_CN/LC_MESSAGES/manifests.po | 165 ++++++++++++----- po/zh_CN/LC_MESSAGES/sandbox-permissions.po | 34 +++- 28 files changed, 1531 insertions(+), 691 deletions(-) diff --git a/po/de/LC_MESSAGES/debugging.po b/po/de/LC_MESSAGES/debugging.po index 9eca32ae..bd666d7e 100644 --- a/po/de/LC_MESSAGES/debugging.po +++ b/po/de/LC_MESSAGES/debugging.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-03 21:11+0530\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-05-20 10:36-0400\n" "Last-Translator: Copied by Zanata \n" "Language: de\n" @@ -256,8 +256,8 @@ msgstr "" #: ../../debugging.rst:183 msgid "" -"Session or system bus traffic can be audited by passing ``--log-session-" -"bus`` and ``--log-system-bus`` respectively to ``flatpak run``::" +"Session bus traffic can be audited by passing ``--log-session-bus`` to " +"``flatpak run``::" msgstr "" #: ../../debugging.rst:188 @@ -267,6 +267,13 @@ msgid "" "required::" msgstr "" +#: ../../debugging.rst:194 +msgid "" +"Similarly, system bus traffic can be audited by passing ``--log-system-" +"bus`` to ``flatpak run``. This also requires a system bus name to be " +"present in the permissions. If not a bogus bus name can be passed::" +msgstr "" + #~ msgid "Running debugging tools" #~ msgstr "" @@ -358,3 +365,10 @@ msgstr "" #~ "names`` or ``--own-names`` required::" #~ msgstr "" +#~ msgid "" +#~ "Session or system bus traffic can " +#~ "be audited by passing ``--log-" +#~ "session-bus`` and ``--log-system-bus`` " +#~ "respectively to ``flatpak run``::" +#~ msgstr "" + diff --git a/po/de/LC_MESSAGES/electron.po b/po/de/LC_MESSAGES/electron.po index 4c381f61..d57350dc 100644 --- a/po/de/LC_MESSAGES/electron.po +++ b/po/de/LC_MESSAGES/electron.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -156,14 +156,14 @@ msgid "" "access." msgstr "" -#: ../../electron.rst:126 +#: ../../electron.rst:127 msgid "" "Native wayland support in electron is experimental and often unstable. It" " is advised to stick with the X11 and Xwayland configuration above as the" " default." msgstr "" -#: ../../electron.rst:130 +#: ../../electron.rst:131 msgid "" "To enable experimental `native Wayland` support in Electron>=20, the " "``--ozone-platform-hint=auto`` flag can be passed to the program. `auto` " @@ -171,25 +171,26 @@ msgid "" "otherwise." msgstr "" -#: ../../electron.rst:135 +#: ../../electron.rst:136 msgid "" "The recommended option is to leave it to the user. So ``--socket=x11`` " "should be used in manifest and Wayland can be tested with::" msgstr "" -#: ../../electron.rst:140 +#: ../../electron.rst:141 msgid "" "To make native wayland the `default` for users ``--socket=fallback-x11`` " "and ``--socket=wayland`` must be used in the manifest." msgstr "" -#: ../../electron.rst:143 +#: ../../electron.rst:144 msgid "" -"Client-side window decorations in native wayland can be enabled by " -"passing ``--enable-features=WaylandWindowDecorations`` (Electron>=17)." +"For Electron versions between 17 and 27, client-side window decorations " +"in native wayland can be enabled by passing ``--enable-" +"features=WaylandWindowDecorations``." msgstr "" -#: ../../electron.rst:146 +#: ../../electron.rst:147 msgid "" "Electron uses ``libnotify`` on Linux to provide desktop notifications. " "libnotify `since 0.8.0 " @@ -200,17 +201,17 @@ msgid "" "name=org.freedesktop.Notifications`` is not required." msgstr "" -#: ../../electron.rst:152 +#: ../../electron.rst:153 msgid "" "``org.electronjs.Electron2.BaseApp`` since ``branch/23.08`` comes with " "``libnotify>=0.8.0``" msgstr "" -#: ../../electron.rst:158 +#: ../../electron.rst:159 msgid "Using correct desktop file name" msgstr "" -#: ../../electron.rst:160 +#: ../../electron.rst:161 msgid "" "It's important for Linux applications to set the correct desktop file " "name. If not, it can lead to problems like missing the window icon under " @@ -221,7 +222,7 @@ msgid "" "\"com.example.MyApp.desktop\"``." msgstr "" -#: ../../electron.rst:164 +#: ../../electron.rst:165 msgid "" "In case you repack a binary, you can use the ``patch-desktop-filename`` " "script provided by the BaseApp. Each Electron binary ships with " @@ -231,11 +232,11 @@ msgid "" "${FLATPAK_DEST}/my-app/resources/app.asar``." msgstr "" -#: ../../electron.rst:169 +#: ../../electron.rst:170 msgid "Build options" msgstr "" -#: ../../electron.rst:171 +#: ../../electron.rst:172 msgid "" "These build options aren't strictly necessary, but can be useful if " "something goes wrong. ``env`` allows setting an array of environment " @@ -243,18 +244,18 @@ msgid "" "that ``npm`` gives us more detailed error messages." msgstr "" -#: ../../electron.rst:187 +#: ../../electron.rst:188 msgid "The application module" msgstr "" -#: ../../electron.rst:189 +#: ../../electron.rst:190 msgid "" "The final section of the manifest defines how the application module " "should be built. This is where some of the additional logic for Electron " "and Node.js can be found." msgstr "" -#: ../../electron.rst:193 +#: ../../electron.rst:194 msgid "" "By default, ``flatpak-builder`` doesn't allow build tools to access the " "network. This means that tools which rely on downloading sources will not" @@ -263,7 +264,7 @@ msgid "" "means that these will be found when it comes to the build." msgstr "" -#: ../../electron.rst:199 +#: ../../electron.rst:200 msgid "" "The next part of the manifest describes how the application should be " "built. The simple buildsystem option is used, which allows a sequence of " @@ -271,15 +272,15 @@ msgid "" "location and hash of the application are also specified." msgstr "" -#: ../../electron.rst:222 +#: ../../electron.rst:223 msgid "Bundling NPM packages" msgstr "" -#: ../../electron.rst:224 +#: ../../electron.rst:225 msgid "The next line is how NPM modules get bundled as part of Flatpaks:" msgstr "" -#: ../../electron.rst:230 +#: ../../electron.rst:231 msgid "" "Since even simple Node.js applications depend on dozens of packages, it " "would be impractical to specify all of them as part of a manifest file. A" @@ -289,7 +290,7 @@ msgid "" "sources." msgstr "" -#: ../../electron.rst:236 +#: ../../electron.rst:237 msgid "" "The Python script requires a ``package-lock.json`` (or ``yarn.lock``) " "file. This file contains information about the packages that an " @@ -298,7 +299,7 @@ msgid "" " then run as follows::" msgstr "" -#: ../../electron.rst:243 +#: ../../electron.rst:244 msgid "" "This generates the manifest JSON needed to build the NPM/Yarn packages " "for the application, which are outputted to a file called ``generated-" @@ -309,22 +310,22 @@ msgid "" "above." msgstr "" -#: ../../electron.rst:251 +#: ../../electron.rst:252 msgid "Launching the app" msgstr "" -#: ../../electron.rst:253 +#: ../../electron.rst:254 msgid "" "The Electron app is run through a simple script. This can be given any " "name but must be specified in the manifest's ``\"command\":`` property. " "See below a sample wrapper for launching app:" msgstr "" -#: ../../electron.rst:265 +#: ../../electron.rst:266 msgid "Build commands" msgstr "" -#: ../../electron.rst:267 +#: ../../electron.rst:268 msgid "" "Last but not least, since the simple build option is being used, a list " "of build commands must be provided. As can be seen, ``npm`` is run with " @@ -334,7 +335,7 @@ msgid "" "``/app/bin/`` so that it will be on ``$PATH``:" msgstr "" -#: ../../electron.rst:289 +#: ../../electron.rst:290 msgid "" "Note that if the application you are trying to package contains a " "``build`` block in ``package.json`` with instructions for Linux, this can" @@ -343,18 +344,18 @@ msgid "" "configuration that will try to download AppImage binaries:" msgstr "" -#: ../../electron.rst:299 +#: ../../electron.rst:300 msgid "" "The preferred way of fixing this, is not a patch, but a build-time edit " "using ``jq``. The following command will replace ``\"target\": " "\"AppImage\"`` with ``\"target\": \"dir\"``:" msgstr "" -#: ../../electron.rst:306 +#: ../../electron.rst:307 msgid "Make setProgressBar and setBadgeCount work" msgstr "" -#: ../../electron.rst:307 +#: ../../electron.rst:308 msgid "" "The `setProgressBar `_ and `setBadgeCount " @@ -368,12 +369,13 @@ msgid "" "extension and `Plank `_." msgstr "" -#: ../../electron.rst:310 +#: ../../electron.rst:311 msgid "" "To make it work in Flatpak, the app needs to :ref:`use the correct " -"desktop filename `. The Flatpak also needs " -"the ``--talk-name=com.canonical.Unity`` permission. Electron versions " -"earlier than v32 checks `checks if it's running on Unity or KDE " +"desktop filename ` in its embedded " +"`package.json` file. The Flatpak also needs the ``--talk-" +"name=com.canonical.Unity`` permission. Electron versions earlier than v32" +" checks `checks if it's running on Unity or KDE " "`_" " before using the UnityLauncherAPI." msgstr "" @@ -432,3 +434,23 @@ msgstr "" #~ "for sound and enables network access:" #~ msgstr "" +#~ msgid "" +#~ "Client-side window decorations in native" +#~ " wayland can be enabled by passing" +#~ " ``--enable-features=WaylandWindowDecorations`` " +#~ "(Electron>=17)." +#~ msgstr "" + +#~ msgid "" +#~ "To make it work in Flatpak, the" +#~ " app needs to :ref:`use the correct" +#~ " desktop filename `. The Flatpak also needs the" +#~ " ``--talk-name=com.canonical.Unity`` permission. " +#~ "Electron versions earlier than v32 " +#~ "checks `checks if it's running on " +#~ "Unity or KDE " +#~ "`_" +#~ " before using the UnityLauncherAPI." +#~ msgstr "" + diff --git a/po/de/LC_MESSAGES/manifests.po b/po/de/LC_MESSAGES/manifests.po index 5760c777..9dce17a3 100644 --- a/po/de/LC_MESSAGES/manifests.po +++ b/po/de/LC_MESSAGES/manifests.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-05-20 10:36-0400\n" "Last-Translator: Copied by Zanata \n" "Language: de\n" @@ -212,137 +212,165 @@ msgstr "" #: ../../manifests.rst:146 msgid "" -"GNOME Dictionary's modules section is short, since it just contains the " -"application itself, and looks like:" +"Modules are built in the order they are declared in the manifest. If any " +"module changes, that module and all the subsequent modules below it will " +"be rebuilt, otherwise it should use the cache." msgstr "" -#: ../../manifests.rst:163 +#: ../../manifests.rst:150 +msgid "" +"The general recommendation is to place the \"main\" module, usually the " +"module for the main application as the last module in the manifest but if" +" there is a module which gets updated often and is independent from the " +"rest, that module can also be placed as the last module to avoid " +"rebuilding everything else." +msgstr "" + +#: ../../manifests.rst:156 +msgid "" +"Modules can either be nested to clearly show the dependency structure or " +"be linearly declared." +msgstr "" + +#: ../../manifests.rst:236 msgid "" "As can be seen, each listed module has a ``name`` (which can be freely " "assigned) and a list of ``sources``. Each source has a ``type``, and " "available types include:" msgstr "" -#: ../../manifests.rst:167 +#: ../../manifests.rst:240 msgid "``archive`` - ``.tar`` or ``.zip`` archive files" msgstr "" -#: ../../manifests.rst:168 +#: ../../manifests.rst:241 msgid "``git`` - Git repositories" msgstr "" -#: ../../manifests.rst:169 +#: ../../manifests.rst:242 msgid "``bzr`` - Bazaar repositories" msgstr "" -#: ../../manifests.rst:170 +#: ../../manifests.rst:243 msgid "``file`` - local/remote files (these are copied into the source directory)" msgstr "" -#: ../../manifests.rst:171 +#: ../../manifests.rst:244 msgid "``dir`` - local directories (these are copied into the source directory)" msgstr "" -#: ../../manifests.rst:172 +#: ../../manifests.rst:245 msgid "" "``script`` - an array of shell commands (these are put in a shellscript " "file)" msgstr "" -#: ../../manifests.rst:174 +#: ../../manifests.rst:247 msgid "" "``shell`` - an array of shell commands that are run during source " "extraction" msgstr "" -#: ../../manifests.rst:175 +#: ../../manifests.rst:248 msgid "``patch`` - a patch (are applied to the source directory)" msgstr "" -#: ../../manifests.rst:176 +#: ../../manifests.rst:249 msgid "" "``extra-data`` - data that can be downloaded at install time; this can " "include archive or package files" msgstr "" -#: ../../manifests.rst:179 +#: ../../manifests.rst:252 msgid "" "Different properties are available for each source type, which are listed" " in the :doc:`module-sources`." msgstr "" -#: ../../manifests.rst:183 +#: ../../manifests.rst:256 msgid "Supported build systems" msgstr "" -#: ../../manifests.rst:185 +#: ../../manifests.rst:258 msgid "Modules can be built with a variety of build systems, including:" msgstr "" -#: ../../manifests.rst:187 +#: ../../manifests.rst:260 msgid "" "`autotools `_" msgstr "" -#: ../../manifests.rst:188 +#: ../../manifests.rst:261 msgid "`cmake `_" msgstr "" -#: ../../manifests.rst:189 +#: ../../manifests.rst:262 msgid "`cmake-ninja `_" msgstr "" -#: ../../manifests.rst:190 +#: ../../manifests.rst:263 msgid "`meson `_" msgstr "" -#: ../../manifests.rst:191 +#: ../../manifests.rst:264 msgid "`qmake `_" msgstr "" -#: ../../manifests.rst:192 -msgid "the \"`Build API `_\"" -msgstr "" - -#: ../../manifests.rst:194 +#: ../../manifests.rst:266 msgid "" "A \"simple\" build method is also available, which allows a series of " "commands to be specified." msgstr "" -#: ../../manifests.rst:198 -msgid "Shared Modules" +#: ../../manifests.rst:269 +msgid "" +"Each of the above buildsystem sets up the installation prefix, libdir " +"etc. and runs a series of commands to configure (``meson setup``, or " +"``./autogen.sh, ./configure`` or ``cmake``), build, install (``ninja " +"install, make install`` etc.) and optionally run tests (``make check, " +"ninja test`` etc.)." msgstr "" -#: ../../manifests.rst:200 +#: ../../manifests.rst:275 msgid "" -"`Shared Modules (or shared-modules) `_ is a repository containing various manifests to build common " -"libraries. It is intended to be used as a git submodule." +"Thus they can also be achieved by using the ``simple`` buildsystem and " +"manually specifying the commands." msgstr "" -#: ../../manifests.rst:202 -msgid "To add it to your repository, run this command:" +#: ../../manifests.rst:280 +msgid "" +"Using the proper buildsystem is almost always preferred rather than " +"manually handling the correct setup." +msgstr "" + +#: ../../manifests.rst:283 +msgid "An example is provided below." msgstr "" -#: ../../manifests.rst:208 -msgid "Then, add whichever module you want. In this example, we will use `gtk2`:" +#: ../../manifests.rst:333 +msgid "Shared Modules" msgstr "" -#: ../../manifests.rst:215 -msgid "To update the submodule, run this command:" +#: ../../manifests.rst:335 +msgid "" +"Flathub contains a `shared modules `_ repository containing build manifests for commonly used " +"modules. These are usally shared by apps on Flathub and maintained in a " +"single place. The repository is intended to be used as a git submodule." msgstr "" -#: ../../manifests.rst:221 -msgid "To remove the submodule, run these commands:" +#: ../../manifests.rst:340 +msgid "" +"Please see the `readme `_ for details on how to use this." msgstr "" -#: ../../manifests.rst:231 +#: ../../manifests.rst:344 msgid "Flatpak Builder Tools" msgstr "" -#: ../../manifests.rst:233 +#: ../../manifests.rst:346 msgid "" "`Flatpak Builder Tools (or flatpak-builder-tools) " "`_ is a collection of " @@ -351,15 +379,14 @@ msgid "" " platform." msgstr "" -#: ../../manifests.rst:236 +#: ../../manifests.rst:349 msgid "Example manifests" msgstr "" -#: ../../manifests.rst:238 +#: ../../manifests.rst:351 msgid "" -"A `complete manifest for GNOME Dictionary built from Git " -"`_." -" It is also possible to browse `all the manifests hosted by Flathub " +"Flathub hosts a large collection of applications and the respective " +"manifests can be browsed and searched via `GitHub " "`_." msgstr "" @@ -508,3 +535,45 @@ msgstr "" #~ "reference`." #~ msgstr "" +#~ msgid "" +#~ "GNOME Dictionary's modules section is " +#~ "short, since it just contains the " +#~ "application itself, and looks like:" +#~ msgstr "" + +#~ msgid "the \"`Build API `_\"" +#~ msgstr "" + +#~ msgid "" +#~ "`Shared Modules (or shared-modules) " +#~ "`_ is a" +#~ " repository containing various manifests to" +#~ " build common libraries. It is " +#~ "intended to be used as a git " +#~ "submodule." +#~ msgstr "" + +#~ msgid "To add it to your repository, run this command:" +#~ msgstr "" + +#~ msgid "" +#~ "Then, add whichever module you want. " +#~ "In this example, we will use " +#~ "`gtk2`:" +#~ msgstr "" + +#~ msgid "To update the submodule, run this command:" +#~ msgstr "" + +#~ msgid "To remove the submodule, run these commands:" +#~ msgstr "" + +#~ msgid "" +#~ "A `complete manifest for GNOME " +#~ "Dictionary built from Git " +#~ "`_." +#~ " It is also possible to browse " +#~ "`all the manifests hosted by Flathub " +#~ "`_." +#~ msgstr "" + diff --git a/po/de/LC_MESSAGES/sandbox-permissions.po b/po/de/LC_MESSAGES/sandbox-permissions.po index 7ba2118c..dc01c8e6 100644 --- a/po/de/LC_MESSAGES/sandbox-permissions.po +++ b/po/de/LC_MESSAGES/sandbox-permissions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-03 21:08+0530\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-05-20 10:36-0400\n" "Last-Translator: Copied by Zanata \n" "Language: de\n" @@ -1030,11 +1030,27 @@ msgid "" "manifest, as there are no D-Bus services named ``org.gtk.vfs``." msgstr "" -#: ../../sandbox-permissions.rst:428 +#: ../../sandbox-permissions.rst:427 +msgid "" +"These permission grants the app, the ability to communicate with the gvfs" +" daemon and backends running on host. Depending on the backends installed" +" or running on host, it grants the ability to list mounted devices (USB, " +"optical etc.), detach/format/eject them, mount them locally, read and " +"write data. This is usually used with network storages like WebDAV, " +"Google Drive, SMB etc. but backends exist for MTP/PTP, `USB " +"`_," +" special locations like ``trash://`` and the `local filesystem " +"`_" +" too. So the app can access, read and write data from all of these " +"locations provided the daemon and backends are installed and running on " +"host." +msgstr "" + +#: ../../sandbox-permissions.rst:441 msgid "External drive access" msgstr "" -#: ../../sandbox-permissions.rst:430 +#: ../../sandbox-permissions.rst:443 msgid "" "External drives are mounted by the host system using systemd, udev, udisk" " fstab etc. and each of them can have different defaults. Flatpak has no " @@ -1042,30 +1058,30 @@ msgid "" "permissions should work in most cases::" msgstr "" -#: ../../sandbox-permissions.rst:439 +#: ../../sandbox-permissions.rst:452 msgid "" "If ``--filesystem=host`` is used ``/media, /run/media`` is shared " "automatically if they exist." msgstr "" -#: ../../sandbox-permissions.rst:442 +#: ../../sandbox-permissions.rst:455 msgid "" "Note that these should not have subpaths in them unless the value of the " "subpath can be consistently pre-determined. Block device naming depends " "on the kernel/fstab configuration and cannot be pre-determined." msgstr "" -#: ../../sandbox-permissions.rst:447 +#: ../../sandbox-permissions.rst:460 msgid "Footnotes" msgstr "" -#: ../../sandbox-permissions.rst:448 +#: ../../sandbox-permissions.rst:461 msgid "" "This is not necessarily required, but without it the X11 shared memory " "extension will not work, which is very bad for X11 performance." msgstr "" -#: ../../sandbox-permissions.rst:450 +#: ../../sandbox-permissions.rst:463 msgid "" "Giving network access also grants access to all host services listening " "on abstract Unix sockets (due to how network namespaces work), and these " @@ -1074,7 +1090,7 @@ msgid "" "secure distribution should disable these and just use regular sockets." msgstr "" -#: ../../sandbox-permissions.rst:455 +#: ../../sandbox-permissions.rst:468 msgid "" "``xdg-{cache, config, data}`` bind mounts the paths from host to the per-" "app sandbox directory. Inside the sandbox ``$XDG_CACHE_HOME``, " diff --git a/po/es/LC_MESSAGES/debugging.po b/po/es/LC_MESSAGES/debugging.po index 5fcdf203..b0328c0b 100644 --- a/po/es/LC_MESSAGES/debugging.po +++ b/po/es/LC_MESSAGES/debugging.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-03 21:11+0530\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: es\n" @@ -256,8 +256,8 @@ msgstr "" #: ../../debugging.rst:183 msgid "" -"Session or system bus traffic can be audited by passing ``--log-session-" -"bus`` and ``--log-system-bus`` respectively to ``flatpak run``::" +"Session bus traffic can be audited by passing ``--log-session-bus`` to " +"``flatpak run``::" msgstr "" #: ../../debugging.rst:188 @@ -267,6 +267,13 @@ msgid "" "required::" msgstr "" +#: ../../debugging.rst:194 +msgid "" +"Similarly, system bus traffic can be audited by passing ``--log-system-" +"bus`` to ``flatpak run``. This also requires a system bus name to be " +"present in the permissions. If not a bogus bus name can be passed::" +msgstr "" + #~ msgid "Running debugging tools" #~ msgstr "" @@ -358,3 +365,10 @@ msgstr "" #~ "names`` or ``--own-names`` required::" #~ msgstr "" +#~ msgid "" +#~ "Session or system bus traffic can " +#~ "be audited by passing ``--log-" +#~ "session-bus`` and ``--log-system-bus`` " +#~ "respectively to ``flatpak run``::" +#~ msgstr "" + diff --git a/po/es/LC_MESSAGES/electron.po b/po/es/LC_MESSAGES/electron.po index 4c381f61..d57350dc 100644 --- a/po/es/LC_MESSAGES/electron.po +++ b/po/es/LC_MESSAGES/electron.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -156,14 +156,14 @@ msgid "" "access." msgstr "" -#: ../../electron.rst:126 +#: ../../electron.rst:127 msgid "" "Native wayland support in electron is experimental and often unstable. It" " is advised to stick with the X11 and Xwayland configuration above as the" " default." msgstr "" -#: ../../electron.rst:130 +#: ../../electron.rst:131 msgid "" "To enable experimental `native Wayland` support in Electron>=20, the " "``--ozone-platform-hint=auto`` flag can be passed to the program. `auto` " @@ -171,25 +171,26 @@ msgid "" "otherwise." msgstr "" -#: ../../electron.rst:135 +#: ../../electron.rst:136 msgid "" "The recommended option is to leave it to the user. So ``--socket=x11`` " "should be used in manifest and Wayland can be tested with::" msgstr "" -#: ../../electron.rst:140 +#: ../../electron.rst:141 msgid "" "To make native wayland the `default` for users ``--socket=fallback-x11`` " "and ``--socket=wayland`` must be used in the manifest." msgstr "" -#: ../../electron.rst:143 +#: ../../electron.rst:144 msgid "" -"Client-side window decorations in native wayland can be enabled by " -"passing ``--enable-features=WaylandWindowDecorations`` (Electron>=17)." +"For Electron versions between 17 and 27, client-side window decorations " +"in native wayland can be enabled by passing ``--enable-" +"features=WaylandWindowDecorations``." msgstr "" -#: ../../electron.rst:146 +#: ../../electron.rst:147 msgid "" "Electron uses ``libnotify`` on Linux to provide desktop notifications. " "libnotify `since 0.8.0 " @@ -200,17 +201,17 @@ msgid "" "name=org.freedesktop.Notifications`` is not required." msgstr "" -#: ../../electron.rst:152 +#: ../../electron.rst:153 msgid "" "``org.electronjs.Electron2.BaseApp`` since ``branch/23.08`` comes with " "``libnotify>=0.8.0``" msgstr "" -#: ../../electron.rst:158 +#: ../../electron.rst:159 msgid "Using correct desktop file name" msgstr "" -#: ../../electron.rst:160 +#: ../../electron.rst:161 msgid "" "It's important for Linux applications to set the correct desktop file " "name. If not, it can lead to problems like missing the window icon under " @@ -221,7 +222,7 @@ msgid "" "\"com.example.MyApp.desktop\"``." msgstr "" -#: ../../electron.rst:164 +#: ../../electron.rst:165 msgid "" "In case you repack a binary, you can use the ``patch-desktop-filename`` " "script provided by the BaseApp. Each Electron binary ships with " @@ -231,11 +232,11 @@ msgid "" "${FLATPAK_DEST}/my-app/resources/app.asar``." msgstr "" -#: ../../electron.rst:169 +#: ../../electron.rst:170 msgid "Build options" msgstr "" -#: ../../electron.rst:171 +#: ../../electron.rst:172 msgid "" "These build options aren't strictly necessary, but can be useful if " "something goes wrong. ``env`` allows setting an array of environment " @@ -243,18 +244,18 @@ msgid "" "that ``npm`` gives us more detailed error messages." msgstr "" -#: ../../electron.rst:187 +#: ../../electron.rst:188 msgid "The application module" msgstr "" -#: ../../electron.rst:189 +#: ../../electron.rst:190 msgid "" "The final section of the manifest defines how the application module " "should be built. This is where some of the additional logic for Electron " "and Node.js can be found." msgstr "" -#: ../../electron.rst:193 +#: ../../electron.rst:194 msgid "" "By default, ``flatpak-builder`` doesn't allow build tools to access the " "network. This means that tools which rely on downloading sources will not" @@ -263,7 +264,7 @@ msgid "" "means that these will be found when it comes to the build." msgstr "" -#: ../../electron.rst:199 +#: ../../electron.rst:200 msgid "" "The next part of the manifest describes how the application should be " "built. The simple buildsystem option is used, which allows a sequence of " @@ -271,15 +272,15 @@ msgid "" "location and hash of the application are also specified." msgstr "" -#: ../../electron.rst:222 +#: ../../electron.rst:223 msgid "Bundling NPM packages" msgstr "" -#: ../../electron.rst:224 +#: ../../electron.rst:225 msgid "The next line is how NPM modules get bundled as part of Flatpaks:" msgstr "" -#: ../../electron.rst:230 +#: ../../electron.rst:231 msgid "" "Since even simple Node.js applications depend on dozens of packages, it " "would be impractical to specify all of them as part of a manifest file. A" @@ -289,7 +290,7 @@ msgid "" "sources." msgstr "" -#: ../../electron.rst:236 +#: ../../electron.rst:237 msgid "" "The Python script requires a ``package-lock.json`` (or ``yarn.lock``) " "file. This file contains information about the packages that an " @@ -298,7 +299,7 @@ msgid "" " then run as follows::" msgstr "" -#: ../../electron.rst:243 +#: ../../electron.rst:244 msgid "" "This generates the manifest JSON needed to build the NPM/Yarn packages " "for the application, which are outputted to a file called ``generated-" @@ -309,22 +310,22 @@ msgid "" "above." msgstr "" -#: ../../electron.rst:251 +#: ../../electron.rst:252 msgid "Launching the app" msgstr "" -#: ../../electron.rst:253 +#: ../../electron.rst:254 msgid "" "The Electron app is run through a simple script. This can be given any " "name but must be specified in the manifest's ``\"command\":`` property. " "See below a sample wrapper for launching app:" msgstr "" -#: ../../electron.rst:265 +#: ../../electron.rst:266 msgid "Build commands" msgstr "" -#: ../../electron.rst:267 +#: ../../electron.rst:268 msgid "" "Last but not least, since the simple build option is being used, a list " "of build commands must be provided. As can be seen, ``npm`` is run with " @@ -334,7 +335,7 @@ msgid "" "``/app/bin/`` so that it will be on ``$PATH``:" msgstr "" -#: ../../electron.rst:289 +#: ../../electron.rst:290 msgid "" "Note that if the application you are trying to package contains a " "``build`` block in ``package.json`` with instructions for Linux, this can" @@ -343,18 +344,18 @@ msgid "" "configuration that will try to download AppImage binaries:" msgstr "" -#: ../../electron.rst:299 +#: ../../electron.rst:300 msgid "" "The preferred way of fixing this, is not a patch, but a build-time edit " "using ``jq``. The following command will replace ``\"target\": " "\"AppImage\"`` with ``\"target\": \"dir\"``:" msgstr "" -#: ../../electron.rst:306 +#: ../../electron.rst:307 msgid "Make setProgressBar and setBadgeCount work" msgstr "" -#: ../../electron.rst:307 +#: ../../electron.rst:308 msgid "" "The `setProgressBar `_ and `setBadgeCount " @@ -368,12 +369,13 @@ msgid "" "extension and `Plank `_." msgstr "" -#: ../../electron.rst:310 +#: ../../electron.rst:311 msgid "" "To make it work in Flatpak, the app needs to :ref:`use the correct " -"desktop filename `. The Flatpak also needs " -"the ``--talk-name=com.canonical.Unity`` permission. Electron versions " -"earlier than v32 checks `checks if it's running on Unity or KDE " +"desktop filename ` in its embedded " +"`package.json` file. The Flatpak also needs the ``--talk-" +"name=com.canonical.Unity`` permission. Electron versions earlier than v32" +" checks `checks if it's running on Unity or KDE " "`_" " before using the UnityLauncherAPI." msgstr "" @@ -432,3 +434,23 @@ msgstr "" #~ "for sound and enables network access:" #~ msgstr "" +#~ msgid "" +#~ "Client-side window decorations in native" +#~ " wayland can be enabled by passing" +#~ " ``--enable-features=WaylandWindowDecorations`` " +#~ "(Electron>=17)." +#~ msgstr "" + +#~ msgid "" +#~ "To make it work in Flatpak, the" +#~ " app needs to :ref:`use the correct" +#~ " desktop filename `. The Flatpak also needs the" +#~ " ``--talk-name=com.canonical.Unity`` permission. " +#~ "Electron versions earlier than v32 " +#~ "checks `checks if it's running on " +#~ "Unity or KDE " +#~ "`_" +#~ " before using the UnityLauncherAPI." +#~ msgstr "" + diff --git a/po/es/LC_MESSAGES/manifests.po b/po/es/LC_MESSAGES/manifests.po index 6019873d..15f94bc0 100644 --- a/po/es/LC_MESSAGES/manifests.po +++ b/po/es/LC_MESSAGES/manifests.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: es\n" @@ -212,137 +212,165 @@ msgstr "" #: ../../manifests.rst:146 msgid "" -"GNOME Dictionary's modules section is short, since it just contains the " -"application itself, and looks like:" +"Modules are built in the order they are declared in the manifest. If any " +"module changes, that module and all the subsequent modules below it will " +"be rebuilt, otherwise it should use the cache." msgstr "" -#: ../../manifests.rst:163 +#: ../../manifests.rst:150 +msgid "" +"The general recommendation is to place the \"main\" module, usually the " +"module for the main application as the last module in the manifest but if" +" there is a module which gets updated often and is independent from the " +"rest, that module can also be placed as the last module to avoid " +"rebuilding everything else." +msgstr "" + +#: ../../manifests.rst:156 +msgid "" +"Modules can either be nested to clearly show the dependency structure or " +"be linearly declared." +msgstr "" + +#: ../../manifests.rst:236 msgid "" "As can be seen, each listed module has a ``name`` (which can be freely " "assigned) and a list of ``sources``. Each source has a ``type``, and " "available types include:" msgstr "" -#: ../../manifests.rst:167 +#: ../../manifests.rst:240 msgid "``archive`` - ``.tar`` or ``.zip`` archive files" msgstr "" -#: ../../manifests.rst:168 +#: ../../manifests.rst:241 msgid "``git`` - Git repositories" msgstr "" -#: ../../manifests.rst:169 +#: ../../manifests.rst:242 msgid "``bzr`` - Bazaar repositories" msgstr "" -#: ../../manifests.rst:170 +#: ../../manifests.rst:243 msgid "``file`` - local/remote files (these are copied into the source directory)" msgstr "" -#: ../../manifests.rst:171 +#: ../../manifests.rst:244 msgid "``dir`` - local directories (these are copied into the source directory)" msgstr "" -#: ../../manifests.rst:172 +#: ../../manifests.rst:245 msgid "" "``script`` - an array of shell commands (these are put in a shellscript " "file)" msgstr "" -#: ../../manifests.rst:174 +#: ../../manifests.rst:247 msgid "" "``shell`` - an array of shell commands that are run during source " "extraction" msgstr "" -#: ../../manifests.rst:175 +#: ../../manifests.rst:248 msgid "``patch`` - a patch (are applied to the source directory)" msgstr "" -#: ../../manifests.rst:176 +#: ../../manifests.rst:249 msgid "" "``extra-data`` - data that can be downloaded at install time; this can " "include archive or package files" msgstr "" -#: ../../manifests.rst:179 +#: ../../manifests.rst:252 msgid "" "Different properties are available for each source type, which are listed" " in the :doc:`module-sources`." msgstr "" -#: ../../manifests.rst:183 +#: ../../manifests.rst:256 msgid "Supported build systems" msgstr "" -#: ../../manifests.rst:185 +#: ../../manifests.rst:258 msgid "Modules can be built with a variety of build systems, including:" msgstr "" -#: ../../manifests.rst:187 +#: ../../manifests.rst:260 msgid "" "`autotools `_" msgstr "" -#: ../../manifests.rst:188 +#: ../../manifests.rst:261 msgid "`cmake `_" msgstr "" -#: ../../manifests.rst:189 +#: ../../manifests.rst:262 msgid "`cmake-ninja `_" msgstr "" -#: ../../manifests.rst:190 +#: ../../manifests.rst:263 msgid "`meson `_" msgstr "" -#: ../../manifests.rst:191 +#: ../../manifests.rst:264 msgid "`qmake `_" msgstr "" -#: ../../manifests.rst:192 -msgid "the \"`Build API `_\"" -msgstr "" - -#: ../../manifests.rst:194 +#: ../../manifests.rst:266 msgid "" "A \"simple\" build method is also available, which allows a series of " "commands to be specified." msgstr "" -#: ../../manifests.rst:198 -msgid "Shared Modules" +#: ../../manifests.rst:269 +msgid "" +"Each of the above buildsystem sets up the installation prefix, libdir " +"etc. and runs a series of commands to configure (``meson setup``, or " +"``./autogen.sh, ./configure`` or ``cmake``), build, install (``ninja " +"install, make install`` etc.) and optionally run tests (``make check, " +"ninja test`` etc.)." msgstr "" -#: ../../manifests.rst:200 +#: ../../manifests.rst:275 msgid "" -"`Shared Modules (or shared-modules) `_ is a repository containing various manifests to build common " -"libraries. It is intended to be used as a git submodule." +"Thus they can also be achieved by using the ``simple`` buildsystem and " +"manually specifying the commands." msgstr "" -#: ../../manifests.rst:202 -msgid "To add it to your repository, run this command:" +#: ../../manifests.rst:280 +msgid "" +"Using the proper buildsystem is almost always preferred rather than " +"manually handling the correct setup." +msgstr "" + +#: ../../manifests.rst:283 +msgid "An example is provided below." msgstr "" -#: ../../manifests.rst:208 -msgid "Then, add whichever module you want. In this example, we will use `gtk2`:" +#: ../../manifests.rst:333 +msgid "Shared Modules" msgstr "" -#: ../../manifests.rst:215 -msgid "To update the submodule, run this command:" +#: ../../manifests.rst:335 +msgid "" +"Flathub contains a `shared modules `_ repository containing build manifests for commonly used " +"modules. These are usally shared by apps on Flathub and maintained in a " +"single place. The repository is intended to be used as a git submodule." msgstr "" -#: ../../manifests.rst:221 -msgid "To remove the submodule, run these commands:" +#: ../../manifests.rst:340 +msgid "" +"Please see the `readme `_ for details on how to use this." msgstr "" -#: ../../manifests.rst:231 +#: ../../manifests.rst:344 msgid "Flatpak Builder Tools" msgstr "" -#: ../../manifests.rst:233 +#: ../../manifests.rst:346 msgid "" "`Flatpak Builder Tools (or flatpak-builder-tools) " "`_ is a collection of " @@ -351,15 +379,14 @@ msgid "" " platform." msgstr "" -#: ../../manifests.rst:236 +#: ../../manifests.rst:349 msgid "Example manifests" msgstr "" -#: ../../manifests.rst:238 +#: ../../manifests.rst:351 msgid "" -"A `complete manifest for GNOME Dictionary built from Git " -"`_." -" It is also possible to browse `all the manifests hosted by Flathub " +"Flathub hosts a large collection of applications and the respective " +"manifests can be browsed and searched via `GitHub " "`_." msgstr "" @@ -508,3 +535,45 @@ msgstr "" #~ "reference`." #~ msgstr "" +#~ msgid "" +#~ "GNOME Dictionary's modules section is " +#~ "short, since it just contains the " +#~ "application itself, and looks like:" +#~ msgstr "" + +#~ msgid "the \"`Build API `_\"" +#~ msgstr "" + +#~ msgid "" +#~ "`Shared Modules (or shared-modules) " +#~ "`_ is a" +#~ " repository containing various manifests to" +#~ " build common libraries. It is " +#~ "intended to be used as a git " +#~ "submodule." +#~ msgstr "" + +#~ msgid "To add it to your repository, run this command:" +#~ msgstr "" + +#~ msgid "" +#~ "Then, add whichever module you want. " +#~ "In this example, we will use " +#~ "`gtk2`:" +#~ msgstr "" + +#~ msgid "To update the submodule, run this command:" +#~ msgstr "" + +#~ msgid "To remove the submodule, run these commands:" +#~ msgstr "" + +#~ msgid "" +#~ "A `complete manifest for GNOME " +#~ "Dictionary built from Git " +#~ "`_." +#~ " It is also possible to browse " +#~ "`all the manifests hosted by Flathub " +#~ "`_." +#~ msgstr "" + diff --git a/po/es/LC_MESSAGES/sandbox-permissions.po b/po/es/LC_MESSAGES/sandbox-permissions.po index e040d58a..29a5c313 100644 --- a/po/es/LC_MESSAGES/sandbox-permissions.po +++ b/po/es/LC_MESSAGES/sandbox-permissions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-03 21:08+0530\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: es\n" @@ -1030,11 +1030,27 @@ msgid "" "manifest, as there are no D-Bus services named ``org.gtk.vfs``." msgstr "" -#: ../../sandbox-permissions.rst:428 +#: ../../sandbox-permissions.rst:427 +msgid "" +"These permission grants the app, the ability to communicate with the gvfs" +" daemon and backends running on host. Depending on the backends installed" +" or running on host, it grants the ability to list mounted devices (USB, " +"optical etc.), detach/format/eject them, mount them locally, read and " +"write data. This is usually used with network storages like WebDAV, " +"Google Drive, SMB etc. but backends exist for MTP/PTP, `USB " +"`_," +" special locations like ``trash://`` and the `local filesystem " +"`_" +" too. So the app can access, read and write data from all of these " +"locations provided the daemon and backends are installed and running on " +"host." +msgstr "" + +#: ../../sandbox-permissions.rst:441 msgid "External drive access" msgstr "" -#: ../../sandbox-permissions.rst:430 +#: ../../sandbox-permissions.rst:443 msgid "" "External drives are mounted by the host system using systemd, udev, udisk" " fstab etc. and each of them can have different defaults. Flatpak has no " @@ -1042,30 +1058,30 @@ msgid "" "permissions should work in most cases::" msgstr "" -#: ../../sandbox-permissions.rst:439 +#: ../../sandbox-permissions.rst:452 msgid "" "If ``--filesystem=host`` is used ``/media, /run/media`` is shared " "automatically if they exist." msgstr "" -#: ../../sandbox-permissions.rst:442 +#: ../../sandbox-permissions.rst:455 msgid "" "Note that these should not have subpaths in them unless the value of the " "subpath can be consistently pre-determined. Block device naming depends " "on the kernel/fstab configuration and cannot be pre-determined." msgstr "" -#: ../../sandbox-permissions.rst:447 +#: ../../sandbox-permissions.rst:460 msgid "Footnotes" msgstr "" -#: ../../sandbox-permissions.rst:448 +#: ../../sandbox-permissions.rst:461 msgid "" "This is not necessarily required, but without it the X11 shared memory " "extension will not work, which is very bad for X11 performance." msgstr "" -#: ../../sandbox-permissions.rst:450 +#: ../../sandbox-permissions.rst:463 msgid "" "Giving network access also grants access to all host services listening " "on abstract Unix sockets (due to how network namespaces work), and these " @@ -1074,7 +1090,7 @@ msgid "" "secure distribution should disable these and just use regular sockets." msgstr "" -#: ../../sandbox-permissions.rst:455 +#: ../../sandbox-permissions.rst:468 msgid "" "``xdg-{cache, config, data}`` bind mounts the paths from host to the per-" "app sandbox directory. Inside the sandbox ``$XDG_CACHE_HOME``, " diff --git a/po/fr/LC_MESSAGES/debugging.po b/po/fr/LC_MESSAGES/debugging.po index 66f1aa32..67bd237d 100644 --- a/po/fr/LC_MESSAGES/debugging.po +++ b/po/fr/LC_MESSAGES/debugging.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-03 21:11+0530\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: fr\n" @@ -256,8 +256,8 @@ msgstr "" #: ../../debugging.rst:183 msgid "" -"Session or system bus traffic can be audited by passing ``--log-session-" -"bus`` and ``--log-system-bus`` respectively to ``flatpak run``::" +"Session bus traffic can be audited by passing ``--log-session-bus`` to " +"``flatpak run``::" msgstr "" #: ../../debugging.rst:188 @@ -267,6 +267,13 @@ msgid "" "required::" msgstr "" +#: ../../debugging.rst:194 +msgid "" +"Similarly, system bus traffic can be audited by passing ``--log-system-" +"bus`` to ``flatpak run``. This also requires a system bus name to be " +"present in the permissions. If not a bogus bus name can be passed::" +msgstr "" + #~ msgid "Running debugging tools" #~ msgstr "" @@ -358,3 +365,10 @@ msgstr "" #~ "names`` or ``--own-names`` required::" #~ msgstr "" +#~ msgid "" +#~ "Session or system bus traffic can " +#~ "be audited by passing ``--log-" +#~ "session-bus`` and ``--log-system-bus`` " +#~ "respectively to ``flatpak run``::" +#~ msgstr "" + diff --git a/po/fr/LC_MESSAGES/electron.po b/po/fr/LC_MESSAGES/electron.po index 4c381f61..d57350dc 100644 --- a/po/fr/LC_MESSAGES/electron.po +++ b/po/fr/LC_MESSAGES/electron.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -156,14 +156,14 @@ msgid "" "access." msgstr "" -#: ../../electron.rst:126 +#: ../../electron.rst:127 msgid "" "Native wayland support in electron is experimental and often unstable. It" " is advised to stick with the X11 and Xwayland configuration above as the" " default." msgstr "" -#: ../../electron.rst:130 +#: ../../electron.rst:131 msgid "" "To enable experimental `native Wayland` support in Electron>=20, the " "``--ozone-platform-hint=auto`` flag can be passed to the program. `auto` " @@ -171,25 +171,26 @@ msgid "" "otherwise." msgstr "" -#: ../../electron.rst:135 +#: ../../electron.rst:136 msgid "" "The recommended option is to leave it to the user. So ``--socket=x11`` " "should be used in manifest and Wayland can be tested with::" msgstr "" -#: ../../electron.rst:140 +#: ../../electron.rst:141 msgid "" "To make native wayland the `default` for users ``--socket=fallback-x11`` " "and ``--socket=wayland`` must be used in the manifest." msgstr "" -#: ../../electron.rst:143 +#: ../../electron.rst:144 msgid "" -"Client-side window decorations in native wayland can be enabled by " -"passing ``--enable-features=WaylandWindowDecorations`` (Electron>=17)." +"For Electron versions between 17 and 27, client-side window decorations " +"in native wayland can be enabled by passing ``--enable-" +"features=WaylandWindowDecorations``." msgstr "" -#: ../../electron.rst:146 +#: ../../electron.rst:147 msgid "" "Electron uses ``libnotify`` on Linux to provide desktop notifications. " "libnotify `since 0.8.0 " @@ -200,17 +201,17 @@ msgid "" "name=org.freedesktop.Notifications`` is not required." msgstr "" -#: ../../electron.rst:152 +#: ../../electron.rst:153 msgid "" "``org.electronjs.Electron2.BaseApp`` since ``branch/23.08`` comes with " "``libnotify>=0.8.0``" msgstr "" -#: ../../electron.rst:158 +#: ../../electron.rst:159 msgid "Using correct desktop file name" msgstr "" -#: ../../electron.rst:160 +#: ../../electron.rst:161 msgid "" "It's important for Linux applications to set the correct desktop file " "name. If not, it can lead to problems like missing the window icon under " @@ -221,7 +222,7 @@ msgid "" "\"com.example.MyApp.desktop\"``." msgstr "" -#: ../../electron.rst:164 +#: ../../electron.rst:165 msgid "" "In case you repack a binary, you can use the ``patch-desktop-filename`` " "script provided by the BaseApp. Each Electron binary ships with " @@ -231,11 +232,11 @@ msgid "" "${FLATPAK_DEST}/my-app/resources/app.asar``." msgstr "" -#: ../../electron.rst:169 +#: ../../electron.rst:170 msgid "Build options" msgstr "" -#: ../../electron.rst:171 +#: ../../electron.rst:172 msgid "" "These build options aren't strictly necessary, but can be useful if " "something goes wrong. ``env`` allows setting an array of environment " @@ -243,18 +244,18 @@ msgid "" "that ``npm`` gives us more detailed error messages." msgstr "" -#: ../../electron.rst:187 +#: ../../electron.rst:188 msgid "The application module" msgstr "" -#: ../../electron.rst:189 +#: ../../electron.rst:190 msgid "" "The final section of the manifest defines how the application module " "should be built. This is where some of the additional logic for Electron " "and Node.js can be found." msgstr "" -#: ../../electron.rst:193 +#: ../../electron.rst:194 msgid "" "By default, ``flatpak-builder`` doesn't allow build tools to access the " "network. This means that tools which rely on downloading sources will not" @@ -263,7 +264,7 @@ msgid "" "means that these will be found when it comes to the build." msgstr "" -#: ../../electron.rst:199 +#: ../../electron.rst:200 msgid "" "The next part of the manifest describes how the application should be " "built. The simple buildsystem option is used, which allows a sequence of " @@ -271,15 +272,15 @@ msgid "" "location and hash of the application are also specified." msgstr "" -#: ../../electron.rst:222 +#: ../../electron.rst:223 msgid "Bundling NPM packages" msgstr "" -#: ../../electron.rst:224 +#: ../../electron.rst:225 msgid "The next line is how NPM modules get bundled as part of Flatpaks:" msgstr "" -#: ../../electron.rst:230 +#: ../../electron.rst:231 msgid "" "Since even simple Node.js applications depend on dozens of packages, it " "would be impractical to specify all of them as part of a manifest file. A" @@ -289,7 +290,7 @@ msgid "" "sources." msgstr "" -#: ../../electron.rst:236 +#: ../../electron.rst:237 msgid "" "The Python script requires a ``package-lock.json`` (or ``yarn.lock``) " "file. This file contains information about the packages that an " @@ -298,7 +299,7 @@ msgid "" " then run as follows::" msgstr "" -#: ../../electron.rst:243 +#: ../../electron.rst:244 msgid "" "This generates the manifest JSON needed to build the NPM/Yarn packages " "for the application, which are outputted to a file called ``generated-" @@ -309,22 +310,22 @@ msgid "" "above." msgstr "" -#: ../../electron.rst:251 +#: ../../electron.rst:252 msgid "Launching the app" msgstr "" -#: ../../electron.rst:253 +#: ../../electron.rst:254 msgid "" "The Electron app is run through a simple script. This can be given any " "name but must be specified in the manifest's ``\"command\":`` property. " "See below a sample wrapper for launching app:" msgstr "" -#: ../../electron.rst:265 +#: ../../electron.rst:266 msgid "Build commands" msgstr "" -#: ../../electron.rst:267 +#: ../../electron.rst:268 msgid "" "Last but not least, since the simple build option is being used, a list " "of build commands must be provided. As can be seen, ``npm`` is run with " @@ -334,7 +335,7 @@ msgid "" "``/app/bin/`` so that it will be on ``$PATH``:" msgstr "" -#: ../../electron.rst:289 +#: ../../electron.rst:290 msgid "" "Note that if the application you are trying to package contains a " "``build`` block in ``package.json`` with instructions for Linux, this can" @@ -343,18 +344,18 @@ msgid "" "configuration that will try to download AppImage binaries:" msgstr "" -#: ../../electron.rst:299 +#: ../../electron.rst:300 msgid "" "The preferred way of fixing this, is not a patch, but a build-time edit " "using ``jq``. The following command will replace ``\"target\": " "\"AppImage\"`` with ``\"target\": \"dir\"``:" msgstr "" -#: ../../electron.rst:306 +#: ../../electron.rst:307 msgid "Make setProgressBar and setBadgeCount work" msgstr "" -#: ../../electron.rst:307 +#: ../../electron.rst:308 msgid "" "The `setProgressBar `_ and `setBadgeCount " @@ -368,12 +369,13 @@ msgid "" "extension and `Plank `_." msgstr "" -#: ../../electron.rst:310 +#: ../../electron.rst:311 msgid "" "To make it work in Flatpak, the app needs to :ref:`use the correct " -"desktop filename `. The Flatpak also needs " -"the ``--talk-name=com.canonical.Unity`` permission. Electron versions " -"earlier than v32 checks `checks if it's running on Unity or KDE " +"desktop filename ` in its embedded " +"`package.json` file. The Flatpak also needs the ``--talk-" +"name=com.canonical.Unity`` permission. Electron versions earlier than v32" +" checks `checks if it's running on Unity or KDE " "`_" " before using the UnityLauncherAPI." msgstr "" @@ -432,3 +434,23 @@ msgstr "" #~ "for sound and enables network access:" #~ msgstr "" +#~ msgid "" +#~ "Client-side window decorations in native" +#~ " wayland can be enabled by passing" +#~ " ``--enable-features=WaylandWindowDecorations`` " +#~ "(Electron>=17)." +#~ msgstr "" + +#~ msgid "" +#~ "To make it work in Flatpak, the" +#~ " app needs to :ref:`use the correct" +#~ " desktop filename `. The Flatpak also needs the" +#~ " ``--talk-name=com.canonical.Unity`` permission. " +#~ "Electron versions earlier than v32 " +#~ "checks `checks if it's running on " +#~ "Unity or KDE " +#~ "`_" +#~ " before using the UnityLauncherAPI." +#~ msgstr "" + diff --git a/po/fr/LC_MESSAGES/manifests.po b/po/fr/LC_MESSAGES/manifests.po index 36558280..beb685c8 100644 --- a/po/fr/LC_MESSAGES/manifests.po +++ b/po/fr/LC_MESSAGES/manifests.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: fr\n" @@ -212,137 +212,165 @@ msgstr "" #: ../../manifests.rst:146 msgid "" -"GNOME Dictionary's modules section is short, since it just contains the " -"application itself, and looks like:" +"Modules are built in the order they are declared in the manifest. If any " +"module changes, that module and all the subsequent modules below it will " +"be rebuilt, otherwise it should use the cache." msgstr "" -#: ../../manifests.rst:163 +#: ../../manifests.rst:150 +msgid "" +"The general recommendation is to place the \"main\" module, usually the " +"module for the main application as the last module in the manifest but if" +" there is a module which gets updated often and is independent from the " +"rest, that module can also be placed as the last module to avoid " +"rebuilding everything else." +msgstr "" + +#: ../../manifests.rst:156 +msgid "" +"Modules can either be nested to clearly show the dependency structure or " +"be linearly declared." +msgstr "" + +#: ../../manifests.rst:236 msgid "" "As can be seen, each listed module has a ``name`` (which can be freely " "assigned) and a list of ``sources``. Each source has a ``type``, and " "available types include:" msgstr "" -#: ../../manifests.rst:167 +#: ../../manifests.rst:240 msgid "``archive`` - ``.tar`` or ``.zip`` archive files" msgstr "" -#: ../../manifests.rst:168 +#: ../../manifests.rst:241 msgid "``git`` - Git repositories" msgstr "" -#: ../../manifests.rst:169 +#: ../../manifests.rst:242 msgid "``bzr`` - Bazaar repositories" msgstr "" -#: ../../manifests.rst:170 +#: ../../manifests.rst:243 msgid "``file`` - local/remote files (these are copied into the source directory)" msgstr "" -#: ../../manifests.rst:171 +#: ../../manifests.rst:244 msgid "``dir`` - local directories (these are copied into the source directory)" msgstr "" -#: ../../manifests.rst:172 +#: ../../manifests.rst:245 msgid "" "``script`` - an array of shell commands (these are put in a shellscript " "file)" msgstr "" -#: ../../manifests.rst:174 +#: ../../manifests.rst:247 msgid "" "``shell`` - an array of shell commands that are run during source " "extraction" msgstr "" -#: ../../manifests.rst:175 +#: ../../manifests.rst:248 msgid "``patch`` - a patch (are applied to the source directory)" msgstr "" -#: ../../manifests.rst:176 +#: ../../manifests.rst:249 msgid "" "``extra-data`` - data that can be downloaded at install time; this can " "include archive or package files" msgstr "" -#: ../../manifests.rst:179 +#: ../../manifests.rst:252 msgid "" "Different properties are available for each source type, which are listed" " in the :doc:`module-sources`." msgstr "" -#: ../../manifests.rst:183 +#: ../../manifests.rst:256 msgid "Supported build systems" msgstr "" -#: ../../manifests.rst:185 +#: ../../manifests.rst:258 msgid "Modules can be built with a variety of build systems, including:" msgstr "" -#: ../../manifests.rst:187 +#: ../../manifests.rst:260 msgid "" "`autotools `_" msgstr "" -#: ../../manifests.rst:188 +#: ../../manifests.rst:261 msgid "`cmake `_" msgstr "" -#: ../../manifests.rst:189 +#: ../../manifests.rst:262 msgid "`cmake-ninja `_" msgstr "" -#: ../../manifests.rst:190 +#: ../../manifests.rst:263 msgid "`meson `_" msgstr "" -#: ../../manifests.rst:191 +#: ../../manifests.rst:264 msgid "`qmake `_" msgstr "" -#: ../../manifests.rst:192 -msgid "the \"`Build API `_\"" -msgstr "" - -#: ../../manifests.rst:194 +#: ../../manifests.rst:266 msgid "" "A \"simple\" build method is also available, which allows a series of " "commands to be specified." msgstr "" -#: ../../manifests.rst:198 -msgid "Shared Modules" +#: ../../manifests.rst:269 +msgid "" +"Each of the above buildsystem sets up the installation prefix, libdir " +"etc. and runs a series of commands to configure (``meson setup``, or " +"``./autogen.sh, ./configure`` or ``cmake``), build, install (``ninja " +"install, make install`` etc.) and optionally run tests (``make check, " +"ninja test`` etc.)." msgstr "" -#: ../../manifests.rst:200 +#: ../../manifests.rst:275 msgid "" -"`Shared Modules (or shared-modules) `_ is a repository containing various manifests to build common " -"libraries. It is intended to be used as a git submodule." +"Thus they can also be achieved by using the ``simple`` buildsystem and " +"manually specifying the commands." msgstr "" -#: ../../manifests.rst:202 -msgid "To add it to your repository, run this command:" +#: ../../manifests.rst:280 +msgid "" +"Using the proper buildsystem is almost always preferred rather than " +"manually handling the correct setup." +msgstr "" + +#: ../../manifests.rst:283 +msgid "An example is provided below." msgstr "" -#: ../../manifests.rst:208 -msgid "Then, add whichever module you want. In this example, we will use `gtk2`:" +#: ../../manifests.rst:333 +msgid "Shared Modules" msgstr "" -#: ../../manifests.rst:215 -msgid "To update the submodule, run this command:" +#: ../../manifests.rst:335 +msgid "" +"Flathub contains a `shared modules `_ repository containing build manifests for commonly used " +"modules. These are usally shared by apps on Flathub and maintained in a " +"single place. The repository is intended to be used as a git submodule." msgstr "" -#: ../../manifests.rst:221 -msgid "To remove the submodule, run these commands:" +#: ../../manifests.rst:340 +msgid "" +"Please see the `readme `_ for details on how to use this." msgstr "" -#: ../../manifests.rst:231 +#: ../../manifests.rst:344 msgid "Flatpak Builder Tools" msgstr "" -#: ../../manifests.rst:233 +#: ../../manifests.rst:346 msgid "" "`Flatpak Builder Tools (or flatpak-builder-tools) " "`_ is a collection of " @@ -351,15 +379,14 @@ msgid "" " platform." msgstr "" -#: ../../manifests.rst:236 +#: ../../manifests.rst:349 msgid "Example manifests" msgstr "" -#: ../../manifests.rst:238 +#: ../../manifests.rst:351 msgid "" -"A `complete manifest for GNOME Dictionary built from Git " -"`_." -" It is also possible to browse `all the manifests hosted by Flathub " +"Flathub hosts a large collection of applications and the respective " +"manifests can be browsed and searched via `GitHub " "`_." msgstr "" @@ -508,3 +535,45 @@ msgstr "" #~ "reference`." #~ msgstr "" +#~ msgid "" +#~ "GNOME Dictionary's modules section is " +#~ "short, since it just contains the " +#~ "application itself, and looks like:" +#~ msgstr "" + +#~ msgid "the \"`Build API `_\"" +#~ msgstr "" + +#~ msgid "" +#~ "`Shared Modules (or shared-modules) " +#~ "`_ is a" +#~ " repository containing various manifests to" +#~ " build common libraries. It is " +#~ "intended to be used as a git " +#~ "submodule." +#~ msgstr "" + +#~ msgid "To add it to your repository, run this command:" +#~ msgstr "" + +#~ msgid "" +#~ "Then, add whichever module you want. " +#~ "In this example, we will use " +#~ "`gtk2`:" +#~ msgstr "" + +#~ msgid "To update the submodule, run this command:" +#~ msgstr "" + +#~ msgid "To remove the submodule, run these commands:" +#~ msgstr "" + +#~ msgid "" +#~ "A `complete manifest for GNOME " +#~ "Dictionary built from Git " +#~ "`_." +#~ " It is also possible to browse " +#~ "`all the manifests hosted by Flathub " +#~ "`_." +#~ msgstr "" + diff --git a/po/fr/LC_MESSAGES/sandbox-permissions.po b/po/fr/LC_MESSAGES/sandbox-permissions.po index ac476cb0..0902a183 100644 --- a/po/fr/LC_MESSAGES/sandbox-permissions.po +++ b/po/fr/LC_MESSAGES/sandbox-permissions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-03 21:08+0530\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: fr\n" @@ -1030,11 +1030,27 @@ msgid "" "manifest, as there are no D-Bus services named ``org.gtk.vfs``." msgstr "" -#: ../../sandbox-permissions.rst:428 +#: ../../sandbox-permissions.rst:427 +msgid "" +"These permission grants the app, the ability to communicate with the gvfs" +" daemon and backends running on host. Depending on the backends installed" +" or running on host, it grants the ability to list mounted devices (USB, " +"optical etc.), detach/format/eject them, mount them locally, read and " +"write data. This is usually used with network storages like WebDAV, " +"Google Drive, SMB etc. but backends exist for MTP/PTP, `USB " +"`_," +" special locations like ``trash://`` and the `local filesystem " +"`_" +" too. So the app can access, read and write data from all of these " +"locations provided the daemon and backends are installed and running on " +"host." +msgstr "" + +#: ../../sandbox-permissions.rst:441 msgid "External drive access" msgstr "" -#: ../../sandbox-permissions.rst:430 +#: ../../sandbox-permissions.rst:443 msgid "" "External drives are mounted by the host system using systemd, udev, udisk" " fstab etc. and each of them can have different defaults. Flatpak has no " @@ -1042,30 +1058,30 @@ msgid "" "permissions should work in most cases::" msgstr "" -#: ../../sandbox-permissions.rst:439 +#: ../../sandbox-permissions.rst:452 msgid "" "If ``--filesystem=host`` is used ``/media, /run/media`` is shared " "automatically if they exist." msgstr "" -#: ../../sandbox-permissions.rst:442 +#: ../../sandbox-permissions.rst:455 msgid "" "Note that these should not have subpaths in them unless the value of the " "subpath can be consistently pre-determined. Block device naming depends " "on the kernel/fstab configuration and cannot be pre-determined." msgstr "" -#: ../../sandbox-permissions.rst:447 +#: ../../sandbox-permissions.rst:460 msgid "Footnotes" msgstr "" -#: ../../sandbox-permissions.rst:448 +#: ../../sandbox-permissions.rst:461 msgid "" "This is not necessarily required, but without it the X11 shared memory " "extension will not work, which is very bad for X11 performance." msgstr "" -#: ../../sandbox-permissions.rst:450 +#: ../../sandbox-permissions.rst:463 msgid "" "Giving network access also grants access to all host services listening " "on abstract Unix sockets (due to how network namespaces work), and these " @@ -1074,7 +1090,7 @@ msgid "" "secure distribution should disable these and just use regular sockets." msgstr "" -#: ../../sandbox-permissions.rst:455 +#: ../../sandbox-permissions.rst:468 msgid "" "``xdg-{cache, config, data}`` bind mounts the paths from host to the per-" "app sandbox directory. Inside the sandbox ``$XDG_CACHE_HOME``, " diff --git a/po/ko/LC_MESSAGES/debugging.po b/po/ko/LC_MESSAGES/debugging.po index f4ac74f4..e866f3f5 100644 --- a/po/ko/LC_MESSAGES/debugging.po +++ b/po/ko/LC_MESSAGES/debugging.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-03 21:11+0530\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: ko\n" @@ -256,8 +256,8 @@ msgstr "" #: ../../debugging.rst:183 msgid "" -"Session or system bus traffic can be audited by passing ``--log-session-" -"bus`` and ``--log-system-bus`` respectively to ``flatpak run``::" +"Session bus traffic can be audited by passing ``--log-session-bus`` to " +"``flatpak run``::" msgstr "" #: ../../debugging.rst:188 @@ -267,6 +267,13 @@ msgid "" "required::" msgstr "" +#: ../../debugging.rst:194 +msgid "" +"Similarly, system bus traffic can be audited by passing ``--log-system-" +"bus`` to ``flatpak run``. This also requires a system bus name to be " +"present in the permissions. If not a bogus bus name can be passed::" +msgstr "" + #~ msgid "Running debugging tools" #~ msgstr "" @@ -358,3 +365,10 @@ msgstr "" #~ "names`` or ``--own-names`` required::" #~ msgstr "" +#~ msgid "" +#~ "Session or system bus traffic can " +#~ "be audited by passing ``--log-" +#~ "session-bus`` and ``--log-system-bus`` " +#~ "respectively to ``flatpak run``::" +#~ msgstr "" + diff --git a/po/ko/LC_MESSAGES/electron.po b/po/ko/LC_MESSAGES/electron.po index 4c381f61..d57350dc 100644 --- a/po/ko/LC_MESSAGES/electron.po +++ b/po/ko/LC_MESSAGES/electron.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -156,14 +156,14 @@ msgid "" "access." msgstr "" -#: ../../electron.rst:126 +#: ../../electron.rst:127 msgid "" "Native wayland support in electron is experimental and often unstable. It" " is advised to stick with the X11 and Xwayland configuration above as the" " default." msgstr "" -#: ../../electron.rst:130 +#: ../../electron.rst:131 msgid "" "To enable experimental `native Wayland` support in Electron>=20, the " "``--ozone-platform-hint=auto`` flag can be passed to the program. `auto` " @@ -171,25 +171,26 @@ msgid "" "otherwise." msgstr "" -#: ../../electron.rst:135 +#: ../../electron.rst:136 msgid "" "The recommended option is to leave it to the user. So ``--socket=x11`` " "should be used in manifest and Wayland can be tested with::" msgstr "" -#: ../../electron.rst:140 +#: ../../electron.rst:141 msgid "" "To make native wayland the `default` for users ``--socket=fallback-x11`` " "and ``--socket=wayland`` must be used in the manifest." msgstr "" -#: ../../electron.rst:143 +#: ../../electron.rst:144 msgid "" -"Client-side window decorations in native wayland can be enabled by " -"passing ``--enable-features=WaylandWindowDecorations`` (Electron>=17)." +"For Electron versions between 17 and 27, client-side window decorations " +"in native wayland can be enabled by passing ``--enable-" +"features=WaylandWindowDecorations``." msgstr "" -#: ../../electron.rst:146 +#: ../../electron.rst:147 msgid "" "Electron uses ``libnotify`` on Linux to provide desktop notifications. " "libnotify `since 0.8.0 " @@ -200,17 +201,17 @@ msgid "" "name=org.freedesktop.Notifications`` is not required." msgstr "" -#: ../../electron.rst:152 +#: ../../electron.rst:153 msgid "" "``org.electronjs.Electron2.BaseApp`` since ``branch/23.08`` comes with " "``libnotify>=0.8.0``" msgstr "" -#: ../../electron.rst:158 +#: ../../electron.rst:159 msgid "Using correct desktop file name" msgstr "" -#: ../../electron.rst:160 +#: ../../electron.rst:161 msgid "" "It's important for Linux applications to set the correct desktop file " "name. If not, it can lead to problems like missing the window icon under " @@ -221,7 +222,7 @@ msgid "" "\"com.example.MyApp.desktop\"``." msgstr "" -#: ../../electron.rst:164 +#: ../../electron.rst:165 msgid "" "In case you repack a binary, you can use the ``patch-desktop-filename`` " "script provided by the BaseApp. Each Electron binary ships with " @@ -231,11 +232,11 @@ msgid "" "${FLATPAK_DEST}/my-app/resources/app.asar``." msgstr "" -#: ../../electron.rst:169 +#: ../../electron.rst:170 msgid "Build options" msgstr "" -#: ../../electron.rst:171 +#: ../../electron.rst:172 msgid "" "These build options aren't strictly necessary, but can be useful if " "something goes wrong. ``env`` allows setting an array of environment " @@ -243,18 +244,18 @@ msgid "" "that ``npm`` gives us more detailed error messages." msgstr "" -#: ../../electron.rst:187 +#: ../../electron.rst:188 msgid "The application module" msgstr "" -#: ../../electron.rst:189 +#: ../../electron.rst:190 msgid "" "The final section of the manifest defines how the application module " "should be built. This is where some of the additional logic for Electron " "and Node.js can be found." msgstr "" -#: ../../electron.rst:193 +#: ../../electron.rst:194 msgid "" "By default, ``flatpak-builder`` doesn't allow build tools to access the " "network. This means that tools which rely on downloading sources will not" @@ -263,7 +264,7 @@ msgid "" "means that these will be found when it comes to the build." msgstr "" -#: ../../electron.rst:199 +#: ../../electron.rst:200 msgid "" "The next part of the manifest describes how the application should be " "built. The simple buildsystem option is used, which allows a sequence of " @@ -271,15 +272,15 @@ msgid "" "location and hash of the application are also specified." msgstr "" -#: ../../electron.rst:222 +#: ../../electron.rst:223 msgid "Bundling NPM packages" msgstr "" -#: ../../electron.rst:224 +#: ../../electron.rst:225 msgid "The next line is how NPM modules get bundled as part of Flatpaks:" msgstr "" -#: ../../electron.rst:230 +#: ../../electron.rst:231 msgid "" "Since even simple Node.js applications depend on dozens of packages, it " "would be impractical to specify all of them as part of a manifest file. A" @@ -289,7 +290,7 @@ msgid "" "sources." msgstr "" -#: ../../electron.rst:236 +#: ../../electron.rst:237 msgid "" "The Python script requires a ``package-lock.json`` (or ``yarn.lock``) " "file. This file contains information about the packages that an " @@ -298,7 +299,7 @@ msgid "" " then run as follows::" msgstr "" -#: ../../electron.rst:243 +#: ../../electron.rst:244 msgid "" "This generates the manifest JSON needed to build the NPM/Yarn packages " "for the application, which are outputted to a file called ``generated-" @@ -309,22 +310,22 @@ msgid "" "above." msgstr "" -#: ../../electron.rst:251 +#: ../../electron.rst:252 msgid "Launching the app" msgstr "" -#: ../../electron.rst:253 +#: ../../electron.rst:254 msgid "" "The Electron app is run through a simple script. This can be given any " "name but must be specified in the manifest's ``\"command\":`` property. " "See below a sample wrapper for launching app:" msgstr "" -#: ../../electron.rst:265 +#: ../../electron.rst:266 msgid "Build commands" msgstr "" -#: ../../electron.rst:267 +#: ../../electron.rst:268 msgid "" "Last but not least, since the simple build option is being used, a list " "of build commands must be provided. As can be seen, ``npm`` is run with " @@ -334,7 +335,7 @@ msgid "" "``/app/bin/`` so that it will be on ``$PATH``:" msgstr "" -#: ../../electron.rst:289 +#: ../../electron.rst:290 msgid "" "Note that if the application you are trying to package contains a " "``build`` block in ``package.json`` with instructions for Linux, this can" @@ -343,18 +344,18 @@ msgid "" "configuration that will try to download AppImage binaries:" msgstr "" -#: ../../electron.rst:299 +#: ../../electron.rst:300 msgid "" "The preferred way of fixing this, is not a patch, but a build-time edit " "using ``jq``. The following command will replace ``\"target\": " "\"AppImage\"`` with ``\"target\": \"dir\"``:" msgstr "" -#: ../../electron.rst:306 +#: ../../electron.rst:307 msgid "Make setProgressBar and setBadgeCount work" msgstr "" -#: ../../electron.rst:307 +#: ../../electron.rst:308 msgid "" "The `setProgressBar `_ and `setBadgeCount " @@ -368,12 +369,13 @@ msgid "" "extension and `Plank `_." msgstr "" -#: ../../electron.rst:310 +#: ../../electron.rst:311 msgid "" "To make it work in Flatpak, the app needs to :ref:`use the correct " -"desktop filename `. The Flatpak also needs " -"the ``--talk-name=com.canonical.Unity`` permission. Electron versions " -"earlier than v32 checks `checks if it's running on Unity or KDE " +"desktop filename ` in its embedded " +"`package.json` file. The Flatpak also needs the ``--talk-" +"name=com.canonical.Unity`` permission. Electron versions earlier than v32" +" checks `checks if it's running on Unity or KDE " "`_" " before using the UnityLauncherAPI." msgstr "" @@ -432,3 +434,23 @@ msgstr "" #~ "for sound and enables network access:" #~ msgstr "" +#~ msgid "" +#~ "Client-side window decorations in native" +#~ " wayland can be enabled by passing" +#~ " ``--enable-features=WaylandWindowDecorations`` " +#~ "(Electron>=17)." +#~ msgstr "" + +#~ msgid "" +#~ "To make it work in Flatpak, the" +#~ " app needs to :ref:`use the correct" +#~ " desktop filename `. The Flatpak also needs the" +#~ " ``--talk-name=com.canonical.Unity`` permission. " +#~ "Electron versions earlier than v32 " +#~ "checks `checks if it's running on " +#~ "Unity or KDE " +#~ "`_" +#~ " before using the UnityLauncherAPI." +#~ msgstr "" + diff --git a/po/ko/LC_MESSAGES/manifests.po b/po/ko/LC_MESSAGES/manifests.po index 58634c71..f5feaac0 100644 --- a/po/ko/LC_MESSAGES/manifests.po +++ b/po/ko/LC_MESSAGES/manifests.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: ko\n" @@ -219,137 +219,165 @@ msgstr "" #: ../../manifests.rst:146 msgid "" -"GNOME Dictionary's modules section is short, since it just contains the " -"application itself, and looks like:" +"Modules are built in the order they are declared in the manifest. If any " +"module changes, that module and all the subsequent modules below it will " +"be rebuilt, otherwise it should use the cache." msgstr "" -#: ../../manifests.rst:163 +#: ../../manifests.rst:150 +msgid "" +"The general recommendation is to place the \"main\" module, usually the " +"module for the main application as the last module in the manifest but if" +" there is a module which gets updated often and is independent from the " +"rest, that module can also be placed as the last module to avoid " +"rebuilding everything else." +msgstr "" + +#: ../../manifests.rst:156 +msgid "" +"Modules can either be nested to clearly show the dependency structure or " +"be linearly declared." +msgstr "" + +#: ../../manifests.rst:236 msgid "" "As can be seen, each listed module has a ``name`` (which can be freely " "assigned) and a list of ``sources``. Each source has a ``type``, and " "available types include:" msgstr "" -#: ../../manifests.rst:167 +#: ../../manifests.rst:240 msgid "``archive`` - ``.tar`` or ``.zip`` archive files" msgstr "" -#: ../../manifests.rst:168 +#: ../../manifests.rst:241 msgid "``git`` - Git repositories" msgstr "" -#: ../../manifests.rst:169 +#: ../../manifests.rst:242 msgid "``bzr`` - Bazaar repositories" msgstr "" -#: ../../manifests.rst:170 +#: ../../manifests.rst:243 msgid "``file`` - local/remote files (these are copied into the source directory)" msgstr "" -#: ../../manifests.rst:171 +#: ../../manifests.rst:244 msgid "``dir`` - local directories (these are copied into the source directory)" msgstr "" -#: ../../manifests.rst:172 +#: ../../manifests.rst:245 msgid "" "``script`` - an array of shell commands (these are put in a shellscript " "file)" msgstr "" -#: ../../manifests.rst:174 +#: ../../manifests.rst:247 msgid "" "``shell`` - an array of shell commands that are run during source " "extraction" msgstr "" -#: ../../manifests.rst:175 +#: ../../manifests.rst:248 msgid "``patch`` - a patch (are applied to the source directory)" msgstr "" -#: ../../manifests.rst:176 +#: ../../manifests.rst:249 msgid "" "``extra-data`` - data that can be downloaded at install time; this can " "include archive or package files" msgstr "" -#: ../../manifests.rst:179 +#: ../../manifests.rst:252 msgid "" "Different properties are available for each source type, which are listed" " in the :doc:`module-sources`." msgstr "" -#: ../../manifests.rst:183 +#: ../../manifests.rst:256 msgid "Supported build systems" msgstr "" -#: ../../manifests.rst:185 +#: ../../manifests.rst:258 msgid "Modules can be built with a variety of build systems, including:" msgstr "" -#: ../../manifests.rst:187 +#: ../../manifests.rst:260 msgid "" "`autotools `_" msgstr "" -#: ../../manifests.rst:188 +#: ../../manifests.rst:261 msgid "`cmake `_" msgstr "" -#: ../../manifests.rst:189 +#: ../../manifests.rst:262 msgid "`cmake-ninja `_" msgstr "" -#: ../../manifests.rst:190 +#: ../../manifests.rst:263 msgid "`meson `_" msgstr "" -#: ../../manifests.rst:191 +#: ../../manifests.rst:264 msgid "`qmake `_" msgstr "" -#: ../../manifests.rst:192 -msgid "the \"`Build API `_\"" -msgstr "" - -#: ../../manifests.rst:194 +#: ../../manifests.rst:266 msgid "" "A \"simple\" build method is also available, which allows a series of " "commands to be specified." msgstr "" -#: ../../manifests.rst:198 -msgid "Shared Modules" +#: ../../manifests.rst:269 +msgid "" +"Each of the above buildsystem sets up the installation prefix, libdir " +"etc. and runs a series of commands to configure (``meson setup``, or " +"``./autogen.sh, ./configure`` or ``cmake``), build, install (``ninja " +"install, make install`` etc.) and optionally run tests (``make check, " +"ninja test`` etc.)." msgstr "" -#: ../../manifests.rst:200 +#: ../../manifests.rst:275 msgid "" -"`Shared Modules (or shared-modules) `_ is a repository containing various manifests to build common " -"libraries. It is intended to be used as a git submodule." +"Thus they can also be achieved by using the ``simple`` buildsystem and " +"manually specifying the commands." msgstr "" -#: ../../manifests.rst:202 -msgid "To add it to your repository, run this command:" +#: ../../manifests.rst:280 +msgid "" +"Using the proper buildsystem is almost always preferred rather than " +"manually handling the correct setup." +msgstr "" + +#: ../../manifests.rst:283 +msgid "An example is provided below." msgstr "" -#: ../../manifests.rst:208 -msgid "Then, add whichever module you want. In this example, we will use `gtk2`:" +#: ../../manifests.rst:333 +msgid "Shared Modules" msgstr "" -#: ../../manifests.rst:215 -msgid "To update the submodule, run this command:" +#: ../../manifests.rst:335 +msgid "" +"Flathub contains a `shared modules `_ repository containing build manifests for commonly used " +"modules. These are usally shared by apps on Flathub and maintained in a " +"single place. The repository is intended to be used as a git submodule." msgstr "" -#: ../../manifests.rst:221 -msgid "To remove the submodule, run these commands:" +#: ../../manifests.rst:340 +msgid "" +"Please see the `readme `_ for details on how to use this." msgstr "" -#: ../../manifests.rst:231 +#: ../../manifests.rst:344 msgid "Flatpak Builder Tools" msgstr "" -#: ../../manifests.rst:233 +#: ../../manifests.rst:346 msgid "" "`Flatpak Builder Tools (or flatpak-builder-tools) " "`_ is a collection of " @@ -358,15 +386,14 @@ msgid "" " platform." msgstr "" -#: ../../manifests.rst:236 +#: ../../manifests.rst:349 msgid "Example manifests" msgstr "Manifest 예제" -#: ../../manifests.rst:238 +#: ../../manifests.rst:351 msgid "" -"A `complete manifest for GNOME Dictionary built from Git " -"`_." -" It is also possible to browse `all the manifests hosted by Flathub " +"Flathub hosts a large collection of applications and the respective " +"manifests can be browsed and searched via `GitHub " "`_." msgstr "" @@ -514,3 +541,45 @@ msgstr "" #~ "reference`." #~ msgstr "" +#~ msgid "" +#~ "GNOME Dictionary's modules section is " +#~ "short, since it just contains the " +#~ "application itself, and looks like:" +#~ msgstr "" + +#~ msgid "the \"`Build API `_\"" +#~ msgstr "" + +#~ msgid "" +#~ "`Shared Modules (or shared-modules) " +#~ "`_ is a" +#~ " repository containing various manifests to" +#~ " build common libraries. It is " +#~ "intended to be used as a git " +#~ "submodule." +#~ msgstr "" + +#~ msgid "To add it to your repository, run this command:" +#~ msgstr "" + +#~ msgid "" +#~ "Then, add whichever module you want. " +#~ "In this example, we will use " +#~ "`gtk2`:" +#~ msgstr "" + +#~ msgid "To update the submodule, run this command:" +#~ msgstr "" + +#~ msgid "To remove the submodule, run these commands:" +#~ msgstr "" + +#~ msgid "" +#~ "A `complete manifest for GNOME " +#~ "Dictionary built from Git " +#~ "`_." +#~ " It is also possible to browse " +#~ "`all the manifests hosted by Flathub " +#~ "`_." +#~ msgstr "" + diff --git a/po/ko/LC_MESSAGES/sandbox-permissions.po b/po/ko/LC_MESSAGES/sandbox-permissions.po index 8d29696d..28728e24 100644 --- a/po/ko/LC_MESSAGES/sandbox-permissions.po +++ b/po/ko/LC_MESSAGES/sandbox-permissions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-03 21:08+0530\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: ko\n" @@ -1037,11 +1037,27 @@ msgid "" "manifest, as there are no D-Bus services named ``org.gtk.vfs``." msgstr "" -#: ../../sandbox-permissions.rst:428 +#: ../../sandbox-permissions.rst:427 +msgid "" +"These permission grants the app, the ability to communicate with the gvfs" +" daemon and backends running on host. Depending on the backends installed" +" or running on host, it grants the ability to list mounted devices (USB, " +"optical etc.), detach/format/eject them, mount them locally, read and " +"write data. This is usually used with network storages like WebDAV, " +"Google Drive, SMB etc. but backends exist for MTP/PTP, `USB " +"`_," +" special locations like ``trash://`` and the `local filesystem " +"`_" +" too. So the app can access, read and write data from all of these " +"locations provided the daemon and backends are installed and running on " +"host." +msgstr "" + +#: ../../sandbox-permissions.rst:441 msgid "External drive access" msgstr "" -#: ../../sandbox-permissions.rst:430 +#: ../../sandbox-permissions.rst:443 msgid "" "External drives are mounted by the host system using systemd, udev, udisk" " fstab etc. and each of them can have different defaults. Flatpak has no " @@ -1049,30 +1065,30 @@ msgid "" "permissions should work in most cases::" msgstr "" -#: ../../sandbox-permissions.rst:439 +#: ../../sandbox-permissions.rst:452 msgid "" "If ``--filesystem=host`` is used ``/media, /run/media`` is shared " "automatically if they exist." msgstr "" -#: ../../sandbox-permissions.rst:442 +#: ../../sandbox-permissions.rst:455 msgid "" "Note that these should not have subpaths in them unless the value of the " "subpath can be consistently pre-determined. Block device naming depends " "on the kernel/fstab configuration and cannot be pre-determined." msgstr "" -#: ../../sandbox-permissions.rst:447 +#: ../../sandbox-permissions.rst:460 msgid "Footnotes" msgstr "" -#: ../../sandbox-permissions.rst:448 +#: ../../sandbox-permissions.rst:461 msgid "" "This is not necessarily required, but without it the X11 shared memory " "extension will not work, which is very bad for X11 performance." msgstr "" -#: ../../sandbox-permissions.rst:450 +#: ../../sandbox-permissions.rst:463 msgid "" "Giving network access also grants access to all host services listening " "on abstract Unix sockets (due to how network namespaces work), and these " @@ -1081,7 +1097,7 @@ msgid "" "secure distribution should disable these and just use regular sockets." msgstr "" -#: ../../sandbox-permissions.rst:455 +#: ../../sandbox-permissions.rst:468 msgid "" "``xdg-{cache, config, data}`` bind mounts the paths from host to the per-" "app sandbox directory. Inside the sandbox ``$XDG_CACHE_HOME``, " diff --git a/po/pt_BR/LC_MESSAGES/debugging.po b/po/pt_BR/LC_MESSAGES/debugging.po index b93b26da..a6c1058f 100644 --- a/po/pt_BR/LC_MESSAGES/debugging.po +++ b/po/pt_BR/LC_MESSAGES/debugging.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-03 21:11+0530\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2022-10-04 10:58-0300\n" "Last-Translator: Rafael Fontenelle \n" "Language: pt_BR\n" @@ -287,8 +287,8 @@ msgstr "" #: ../../debugging.rst:183 msgid "" -"Session or system bus traffic can be audited by passing ``--log-session-" -"bus`` and ``--log-system-bus`` respectively to ``flatpak run``::" +"Session bus traffic can be audited by passing ``--log-session-bus`` to " +"``flatpak run``::" msgstr "" #: ../../debugging.rst:188 @@ -298,6 +298,13 @@ msgid "" "required::" msgstr "" +#: ../../debugging.rst:194 +msgid "" +"Similarly, system bus traffic can be audited by passing ``--log-system-" +"bus`` to ``flatpak run``. This also requires a system bus name to be " +"present in the permissions. If not a bogus bus name can be passed::" +msgstr "" + #~ msgid "" #~ "Because Flatpak runs each application " #~ "inside a sandbox, debugging tools can't" @@ -392,3 +399,10 @@ msgstr "" #~ "names`` or ``--own-names`` required::" #~ msgstr "" +#~ msgid "" +#~ "Session or system bus traffic can " +#~ "be audited by passing ``--log-" +#~ "session-bus`` and ``--log-system-bus`` " +#~ "respectively to ``flatpak run``::" +#~ msgstr "" + diff --git a/po/pt_BR/LC_MESSAGES/electron.po b/po/pt_BR/LC_MESSAGES/electron.po index bbf9d946..b0d91f4c 100644 --- a/po/pt_BR/LC_MESSAGES/electron.po +++ b/po/pt_BR/LC_MESSAGES/electron.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-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2022-09-29 14:47-0300\n" "Last-Translator: Rafael Fontenelle \n" "Language: pt_BR\n" @@ -209,14 +209,14 @@ msgid "" "access." msgstr "" -#: ../../electron.rst:126 +#: ../../electron.rst:127 msgid "" "Native wayland support in electron is experimental and often unstable. It" " is advised to stick with the X11 and Xwayland configuration above as the" " default." msgstr "" -#: ../../electron.rst:130 +#: ../../electron.rst:131 msgid "" "To enable experimental `native Wayland` support in Electron>=20, the " "``--ozone-platform-hint=auto`` flag can be passed to the program. `auto` " @@ -224,25 +224,26 @@ msgid "" "otherwise." msgstr "" -#: ../../electron.rst:135 +#: ../../electron.rst:136 msgid "" "The recommended option is to leave it to the user. So ``--socket=x11`` " "should be used in manifest and Wayland can be tested with::" msgstr "" -#: ../../electron.rst:140 +#: ../../electron.rst:141 msgid "" "To make native wayland the `default` for users ``--socket=fallback-x11`` " "and ``--socket=wayland`` must be used in the manifest." msgstr "" -#: ../../electron.rst:143 +#: ../../electron.rst:144 msgid "" -"Client-side window decorations in native wayland can be enabled by " -"passing ``--enable-features=WaylandWindowDecorations`` (Electron>=17)." +"For Electron versions between 17 and 27, client-side window decorations " +"in native wayland can be enabled by passing ``--enable-" +"features=WaylandWindowDecorations``." msgstr "" -#: ../../electron.rst:146 +#: ../../electron.rst:147 msgid "" "Electron uses ``libnotify`` on Linux to provide desktop notifications. " "libnotify `since 0.8.0 " @@ -253,17 +254,17 @@ msgid "" "name=org.freedesktop.Notifications`` is not required." msgstr "" -#: ../../electron.rst:152 +#: ../../electron.rst:153 msgid "" "``org.electronjs.Electron2.BaseApp`` since ``branch/23.08`` comes with " "``libnotify>=0.8.0``" msgstr "" -#: ../../electron.rst:158 +#: ../../electron.rst:159 msgid "Using correct desktop file name" msgstr "" -#: ../../electron.rst:160 +#: ../../electron.rst:161 msgid "" "It's important for Linux applications to set the correct desktop file " "name. If not, it can lead to problems like missing the window icon under " @@ -274,7 +275,7 @@ msgid "" "\"com.example.MyApp.desktop\"``." msgstr "" -#: ../../electron.rst:164 +#: ../../electron.rst:165 msgid "" "In case you repack a binary, you can use the ``patch-desktop-filename`` " "script provided by the BaseApp. Each Electron binary ships with " @@ -284,11 +285,11 @@ msgid "" "${FLATPAK_DEST}/my-app/resources/app.asar``." msgstr "" -#: ../../electron.rst:169 +#: ../../electron.rst:170 msgid "Build options" msgstr "Opções de compilação" -#: ../../electron.rst:171 +#: ../../electron.rst:172 msgid "" "These build options aren't strictly necessary, but can be useful if " "something goes wrong. ``env`` allows setting an array of environment " @@ -301,11 +302,11 @@ msgstr "" " ``info``, para que ``npm`` nos forneça mensagens de erro mais " "detalhadas." -#: ../../electron.rst:187 +#: ../../electron.rst:188 msgid "The application module" msgstr "O módulo do aplicativo" -#: ../../electron.rst:189 +#: ../../electron.rst:190 msgid "" "The final section of the manifest defines how the application module " "should be built. This is where some of the additional logic for Electron " @@ -315,7 +316,7 @@ msgstr "" "compilado. É aqui que algumas das lógicas adicionais para Electron e " "Node.js podem ser encontradas." -#: ../../electron.rst:193 +#: ../../electron.rst:194 msgid "" "By default, ``flatpak-builder`` doesn't allow build tools to access the " "network. This means that tools which rely on downloading sources will not" @@ -330,7 +331,7 @@ msgstr "" " ambiente ``electron_config_cache`` significa que elas serão encontradas " "quando se trata da compilação." -#: ../../electron.rst:199 +#: ../../electron.rst:200 msgid "" "The next part of the manifest describes how the application should be " "built. The simple buildsystem option is used, which allows a sequence of " @@ -343,17 +344,17 @@ msgstr "" "compilação. O local do download e o hash do aplicativo também são " "especificados." -#: ../../electron.rst:222 +#: ../../electron.rst:223 msgid "Bundling NPM packages" msgstr "Empacotando pacotes NPM" -#: ../../electron.rst:224 +#: ../../electron.rst:225 msgid "The next line is how NPM modules get bundled as part of Flatpaks:" msgstr "" "A próxima linha é como os módulos NPM são empacotados como parte de " "Flatpaks:" -#: ../../electron.rst:230 +#: ../../electron.rst:231 msgid "" "Since even simple Node.js applications depend on dozens of packages, it " "would be impractical to specify all of them as part of a manifest file. A" @@ -369,7 +370,7 @@ msgstr "" "para baixar pacotes Node.js com o NPM ou Yarn e inclui-los nas fontes do " "aplicativo." -#: ../../electron.rst:236 +#: ../../electron.rst:237 msgid "" "The Python script requires a ``package-lock.json`` (or ``yarn.lock``) " "file. This file contains information about the packages that an " @@ -383,7 +384,7 @@ msgstr "" "--package-lock-only`` no diretório raiz de um aplicativo. O script é " "então executado da seguinte maneira::" -#: ../../electron.rst:243 +#: ../../electron.rst:244 msgid "" "This generates the manifest JSON needed to build the NPM/Yarn packages " "for the application, which are outputted to a file called ``generated-" @@ -401,11 +402,11 @@ msgstr "" "``generated-source.json`` como um linha na seção do manifesto, como visto" " acima." -#: ../../electron.rst:251 +#: ../../electron.rst:252 msgid "Launching the app" msgstr "Iniciando o aplicativo" -#: ../../electron.rst:253 +#: ../../electron.rst:254 msgid "" "The Electron app is run through a simple script. This can be given any " "name but must be specified in the manifest's ``\"command\":`` property. " @@ -416,11 +417,11 @@ msgstr "" "``\"command\":`` do manifesto. Veja abaixo um exemplo de wrapper para " "iniciar um aplicativo:" -#: ../../electron.rst:265 +#: ../../electron.rst:266 msgid "Build commands" msgstr "Comandos de compilação" -#: ../../electron.rst:267 +#: ../../electron.rst:268 msgid "" "Last but not least, since the simple build option is being used, a list " "of build commands must be provided. As can be seen, ``npm`` is run with " @@ -437,7 +438,7 @@ msgstr "" "Finalmente, o script ``run.sh`` é instalado em ``/app/bin/`` para que ele" " esteja em ``$PATH``:" -#: ../../electron.rst:289 +#: ../../electron.rst:290 msgid "" "Note that if the application you are trying to package contains a " "``build`` block in ``package.json`` with instructions for Linux, this can" @@ -452,7 +453,7 @@ msgstr "" "seguir mostra uma configuração que tentará baixar os binários do " "AppImage:" -#: ../../electron.rst:299 +#: ../../electron.rst:300 msgid "" "The preferred way of fixing this, is not a patch, but a build-time edit " "using ``jq``. The following command will replace ``\"target\": " @@ -462,11 +463,11 @@ msgstr "" "tempo de construção usando ``jq``. O comando a seguir substituirá " "``\"target\": \"AppImage\"`` por ``\"target\": \"dir\"``:" -#: ../../electron.rst:306 +#: ../../electron.rst:307 msgid "Make setProgressBar and setBadgeCount work" msgstr "" -#: ../../electron.rst:307 +#: ../../electron.rst:308 msgid "" "The `setProgressBar `_ and `setBadgeCount " @@ -480,12 +481,13 @@ msgid "" "extension and `Plank `_." msgstr "" -#: ../../electron.rst:310 +#: ../../electron.rst:311 msgid "" "To make it work in Flatpak, the app needs to :ref:`use the correct " -"desktop filename `. The Flatpak also needs " -"the ``--talk-name=com.canonical.Unity`` permission. Electron versions " -"earlier than v32 checks `checks if it's running on Unity or KDE " +"desktop filename ` in its embedded " +"`package.json` file. The Flatpak also needs the ``--talk-" +"name=com.canonical.Unity`` permission. Electron versions earlier than v32" +" checks `checks if it's running on Unity or KDE " "`_" " before using the UnityLauncherAPI." msgstr "" @@ -545,3 +547,23 @@ msgstr "" #~ msgid "Then you can run the build::" #~ msgstr "Então, você pode executar a compilação::" +#~ msgid "" +#~ "Client-side window decorations in native" +#~ " wayland can be enabled by passing" +#~ " ``--enable-features=WaylandWindowDecorations`` " +#~ "(Electron>=17)." +#~ msgstr "" + +#~ msgid "" +#~ "To make it work in Flatpak, the" +#~ " app needs to :ref:`use the correct" +#~ " desktop filename `. The Flatpak also needs the" +#~ " ``--talk-name=com.canonical.Unity`` permission. " +#~ "Electron versions earlier than v32 " +#~ "checks `checks if it's running on " +#~ "Unity or KDE " +#~ "`_" +#~ " before using the UnityLauncherAPI." +#~ msgstr "" + diff --git a/po/pt_BR/LC_MESSAGES/manifests.po b/po/pt_BR/LC_MESSAGES/manifests.po index 23a3496c..9ac93590 100644 --- a/po/pt_BR/LC_MESSAGES/manifests.po +++ b/po/pt_BR/LC_MESSAGES/manifests.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-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2022-11-03 12:09-0300\n" "Last-Translator: Rafael Fontenelle \n" "Language: pt_BR\n" @@ -274,13 +274,27 @@ msgstr "" #: ../../manifests.rst:146 msgid "" -"GNOME Dictionary's modules section is short, since it just contains the " -"application itself, and looks like:" +"Modules are built in the order they are declared in the manifest. If any " +"module changes, that module and all the subsequent modules below it will " +"be rebuilt, otherwise it should use the cache." msgstr "" -"A seção de módulos do Dicionário do GNOME é curta, pois contém apenas o " -"próprio aplicativo e se parece com:" -#: ../../manifests.rst:163 +#: ../../manifests.rst:150 +msgid "" +"The general recommendation is to place the \"main\" module, usually the " +"module for the main application as the last module in the manifest but if" +" there is a module which gets updated often and is independent from the " +"rest, that module can also be placed as the last module to avoid " +"rebuilding everything else." +msgstr "" + +#: ../../manifests.rst:156 +msgid "" +"Modules can either be nested to clearly show the dependency structure or " +"be linearly declared." +msgstr "" + +#: ../../manifests.rst:236 msgid "" "As can be seen, each listed module has a ``name`` (which can be freely " "assigned) and a list of ``sources``. Each source has a ``type``, and " @@ -290,31 +304,31 @@ msgstr "" " atribuído livremente) e uma lista de ``sources``. Cada fonte possui um " "``type``, e os tipos disponíveis incluem:" -#: ../../manifests.rst:167 +#: ../../manifests.rst:240 msgid "``archive`` - ``.tar`` or ``.zip`` archive files" msgstr "``archive`` – arquivos em ``.tar`` ou ``.zip``" -#: ../../manifests.rst:168 +#: ../../manifests.rst:241 msgid "``git`` - Git repositories" msgstr "``git`` – repositórios Git" -#: ../../manifests.rst:169 +#: ../../manifests.rst:242 msgid "``bzr`` - Bazaar repositories" msgstr "``bzr`` – repositórios Bazaar" -#: ../../manifests.rst:170 +#: ../../manifests.rst:243 msgid "``file`` - local/remote files (these are copied into the source directory)" msgstr "" "``file`` – arquivos locais/remotos (esses são copiados para dentro do " "diretório fonte)" -#: ../../manifests.rst:171 +#: ../../manifests.rst:244 msgid "``dir`` - local directories (these are copied into the source directory)" msgstr "" "``dir`` – diretórios locais (esses são copiados para dentro do diretório " "fonte)" -#: ../../manifests.rst:172 +#: ../../manifests.rst:245 msgid "" "``script`` - an array of shell commands (these are put in a shellscript " "file)" @@ -322,7 +336,7 @@ msgstr "" "``script`` – um vetor de comandos shell (esses são colocados em um " "arquivo de script shell)" -#: ../../manifests.rst:174 +#: ../../manifests.rst:247 msgid "" "``shell`` - an array of shell commands that are run during source " "extraction" @@ -330,11 +344,11 @@ msgstr "" "``shell`` – um vetor de comandos shell que são executados durante a " "extração do fonte" -#: ../../manifests.rst:175 +#: ../../manifests.rst:248 msgid "``patch`` - a patch (are applied to the source directory)" msgstr "``patch`` – um patch (são aplicados ao diretório fonte)" -#: ../../manifests.rst:176 +#: ../../manifests.rst:249 msgid "" "``extra-data`` - data that can be downloaded at install time; this can " "include archive or package files" @@ -342,7 +356,7 @@ msgstr "" "``extra-data`` – dados que podem ser baixados em tempo de instalação; " "esto pode incluir um arquivo compactado ou arquivos de pacote" -#: ../../manifests.rst:179 +#: ../../manifests.rst:252 #, fuzzy msgid "" "Different properties are available for each source type, which are listed" @@ -351,17 +365,17 @@ msgstr "" "Diferentes propriedades estão disponíveis para cada tipo de fonte, " "listadas em :doc:`flatpak-builder-command-reference`." -#: ../../manifests.rst:183 +#: ../../manifests.rst:256 msgid "Supported build systems" msgstr "Suporte a sistemas de compilação" -#: ../../manifests.rst:185 +#: ../../manifests.rst:258 msgid "Modules can be built with a variety of build systems, including:" msgstr "" "Os módulos podem ser compilados com uma variedade de sistemas de " "construção, incluindo:" -#: ../../manifests.rst:187 +#: ../../manifests.rst:260 msgid "" "`autotools `_" @@ -369,27 +383,23 @@ msgstr "" "`autotools `_" -#: ../../manifests.rst:188 +#: ../../manifests.rst:261 msgid "`cmake `_" msgstr "`cmake `_" -#: ../../manifests.rst:189 +#: ../../manifests.rst:262 msgid "`cmake-ninja `_" msgstr "`cmake-ninja `_" -#: ../../manifests.rst:190 +#: ../../manifests.rst:263 msgid "`meson `_" msgstr "`meson `_" -#: ../../manifests.rst:191 +#: ../../manifests.rst:264 msgid "`qmake `_" msgstr "`qmake `_" -#: ../../manifests.rst:192 -msgid "the \"`Build API `_\"" -msgstr "a “`Build API `_”" - -#: ../../manifests.rst:194 +#: ../../manifests.rst:266 msgid "" "A \"simple\" build method is also available, which allows a series of " "commands to be specified." @@ -397,41 +407,58 @@ msgstr "" "Um método de compilação “simples” também está disponível, o que permite " "que uma série de comandos seja especificada." -#: ../../manifests.rst:198 +#: ../../manifests.rst:269 +msgid "" +"Each of the above buildsystem sets up the installation prefix, libdir " +"etc. and runs a series of commands to configure (``meson setup``, or " +"``./autogen.sh, ./configure`` or ``cmake``), build, install (``ninja " +"install, make install`` etc.) and optionally run tests (``make check, " +"ninja test`` etc.)." +msgstr "" + +#: ../../manifests.rst:275 +msgid "" +"Thus they can also be achieved by using the ``simple`` buildsystem and " +"manually specifying the commands." +msgstr "" + +#: ../../manifests.rst:280 +msgid "" +"Using the proper buildsystem is almost always preferred rather than " +"manually handling the correct setup." +msgstr "" + +#: ../../manifests.rst:283 +msgid "An example is provided below." +msgstr "" + +#: ../../manifests.rst:333 msgid "Shared Modules" msgstr "Shared Modules" -#: ../../manifests.rst:200 +#: ../../manifests.rst:335 +#, fuzzy msgid "" -"`Shared Modules (or shared-modules) `_ is a repository containing various manifests to build common " -"libraries. It is intended to be used as a git submodule." +"Flathub contains a `shared modules `_ repository containing build manifests for commonly used " +"modules. These are usally shared by apps on Flathub and maintained in a " +"single place. The repository is intended to be used as a git submodule." msgstr "" "`Shared Modules (ou shared-modules) `_ é um repositório contendo vários manifestos para compilar " "bibliotecas comuns. Destina-se a ser usado como um submódulo git." -#: ../../manifests.rst:202 -msgid "To add it to your repository, run this command:" -msgstr "Para adicioná-lo ao seu repositório, execute este comando:" - -#: ../../manifests.rst:208 -msgid "Then, add whichever module you want. In this example, we will use `gtk2`:" -msgstr "Em seguida, adicione o módulo desejado. Neste exemplo, usaremos `gtk2`:" - -#: ../../manifests.rst:215 -msgid "To update the submodule, run this command:" -msgstr "Para atualizar o submódulo, execute este comando:" - -#: ../../manifests.rst:221 -msgid "To remove the submodule, run these commands:" -msgstr "Para remover o submódulo, execute estes comandos:" +#: ../../manifests.rst:340 +msgid "" +"Please see the `readme `_ for details on how to use this." +msgstr "" -#: ../../manifests.rst:231 +#: ../../manifests.rst:344 msgid "Flatpak Builder Tools" msgstr "Flatpak Builder Tools" -#: ../../manifests.rst:233 +#: ../../manifests.rst:346 msgid "" "`Flatpak Builder Tools (or flatpak-builder-tools) " "`_ is a collection of " @@ -445,21 +472,16 @@ msgstr "" "diretório contém instruções para gerar um manifesto para a respectiva " "plataforma." -#: ../../manifests.rst:236 +#: ../../manifests.rst:349 msgid "Example manifests" msgstr "Exemplo de manifestos " -#: ../../manifests.rst:238 +#: ../../manifests.rst:351 msgid "" -"A `complete manifest for GNOME Dictionary built from Git " -"`_." -" It is also possible to browse `all the manifests hosted by Flathub " +"Flathub hosts a large collection of applications and the respective " +"manifests can be browsed and searched via `GitHub " "`_." msgstr "" -"Um `manifesto completo para o Dicionário do GNOME criado a partir do Git " -"`_." -" Também é possível navegar por `todos os manifestos hospedados pelo " -"Flathub `_." #~ msgid "" #~ "A `complete manifest for GNOME " @@ -509,3 +531,47 @@ msgstr "" #~ "por esse módulo específico serão " #~ "correspondidos." +#~ msgid "" +#~ "GNOME Dictionary's modules section is " +#~ "short, since it just contains the " +#~ "application itself, and looks like:" +#~ msgstr "" +#~ "A seção de módulos do Dicionário " +#~ "do GNOME é curta, pois contém " +#~ "apenas o próprio aplicativo e se " +#~ "parece com:" + +#~ msgid "the \"`Build API `_\"" +#~ msgstr "a “`Build API `_”" + +#~ msgid "To add it to your repository, run this command:" +#~ msgstr "Para adicioná-lo ao seu repositório, execute este comando:" + +#~ msgid "" +#~ "Then, add whichever module you want. " +#~ "In this example, we will use " +#~ "`gtk2`:" +#~ msgstr "Em seguida, adicione o módulo desejado. Neste exemplo, usaremos `gtk2`:" + +#~ msgid "To update the submodule, run this command:" +#~ msgstr "Para atualizar o submódulo, execute este comando:" + +#~ msgid "To remove the submodule, run these commands:" +#~ msgstr "Para remover o submódulo, execute estes comandos:" + +#~ msgid "" +#~ "A `complete manifest for GNOME " +#~ "Dictionary built from Git " +#~ "`_." +#~ " It is also possible to browse " +#~ "`all the manifests hosted by Flathub " +#~ "`_." +#~ msgstr "" +#~ "Um `manifesto completo para o Dicionário" +#~ " do GNOME criado a partir do " +#~ "Git " +#~ "`_." +#~ " Também é possível navegar por `todos" +#~ " os manifestos hospedados pelo Flathub " +#~ "`_." + diff --git a/po/pt_BR/LC_MESSAGES/sandbox-permissions.po b/po/pt_BR/LC_MESSAGES/sandbox-permissions.po index 526eb68f..86b114e9 100644 --- a/po/pt_BR/LC_MESSAGES/sandbox-permissions.po +++ b/po/pt_BR/LC_MESSAGES/sandbox-permissions.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-03 21:08+0530\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2023-05-31 14:38-0300\n" "Last-Translator: Rafael Fontenelle \n" "Language: pt_BR\n" @@ -1154,11 +1154,27 @@ msgstr "" "Nenhum aplicativo deve usar ``--talk-name=org.gtk.vfs`` em seu manifesto," " pois não há serviços D-Bus chamados ``org.gtk.vfs``." -#: ../../sandbox-permissions.rst:428 +#: ../../sandbox-permissions.rst:427 +msgid "" +"These permission grants the app, the ability to communicate with the gvfs" +" daemon and backends running on host. Depending on the backends installed" +" or running on host, it grants the ability to list mounted devices (USB, " +"optical etc.), detach/format/eject them, mount them locally, read and " +"write data. This is usually used with network storages like WebDAV, " +"Google Drive, SMB etc. but backends exist for MTP/PTP, `USB " +"`_," +" special locations like ``trash://`` and the `local filesystem " +"`_" +" too. So the app can access, read and write data from all of these " +"locations provided the daemon and backends are installed and running on " +"host." +msgstr "" + +#: ../../sandbox-permissions.rst:441 msgid "External drive access" msgstr "" -#: ../../sandbox-permissions.rst:430 +#: ../../sandbox-permissions.rst:443 msgid "" "External drives are mounted by the host system using systemd, udev, udisk" " fstab etc. and each of them can have different defaults. Flatpak has no " @@ -1166,30 +1182,30 @@ msgid "" "permissions should work in most cases::" msgstr "" -#: ../../sandbox-permissions.rst:439 +#: ../../sandbox-permissions.rst:452 msgid "" "If ``--filesystem=host`` is used ``/media, /run/media`` is shared " "automatically if they exist." msgstr "" -#: ../../sandbox-permissions.rst:442 +#: ../../sandbox-permissions.rst:455 msgid "" "Note that these should not have subpaths in them unless the value of the " "subpath can be consistently pre-determined. Block device naming depends " "on the kernel/fstab configuration and cannot be pre-determined." msgstr "" -#: ../../sandbox-permissions.rst:447 +#: ../../sandbox-permissions.rst:460 msgid "Footnotes" msgstr "" -#: ../../sandbox-permissions.rst:448 +#: ../../sandbox-permissions.rst:461 msgid "" "This is not necessarily required, but without it the X11 shared memory " "extension will not work, which is very bad for X11 performance." msgstr "" -#: ../../sandbox-permissions.rst:450 +#: ../../sandbox-permissions.rst:463 msgid "" "Giving network access also grants access to all host services listening " "on abstract Unix sockets (due to how network namespaces work), and these " @@ -1198,7 +1214,7 @@ msgid "" "secure distribution should disable these and just use regular sockets." msgstr "" -#: ../../sandbox-permissions.rst:455 +#: ../../sandbox-permissions.rst:468 msgid "" "``xdg-{cache, config, data}`` bind mounts the paths from host to the per-" "app sandbox directory. Inside the sandbox ``$XDG_CACHE_HOME``, " diff --git a/po/ru/LC_MESSAGES/debugging.po b/po/ru/LC_MESSAGES/debugging.po index 8cac9022..9078502f 100644 --- a/po/ru/LC_MESSAGES/debugging.po +++ b/po/ru/LC_MESSAGES/debugging.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-03 21:11+0530\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2023-01-04 21:32+0700\n" "Last-Translator: Dmitry \n" "Language: ru\n" @@ -289,8 +289,8 @@ msgstr "" #: ../../debugging.rst:183 msgid "" -"Session or system bus traffic can be audited by passing ``--log-session-" -"bus`` and ``--log-system-bus`` respectively to ``flatpak run``::" +"Session bus traffic can be audited by passing ``--log-session-bus`` to " +"``flatpak run``::" msgstr "" #: ../../debugging.rst:188 @@ -300,6 +300,13 @@ msgid "" "required::" msgstr "" +#: ../../debugging.rst:194 +msgid "" +"Similarly, system bus traffic can be audited by passing ``--log-system-" +"bus`` to ``flatpak run``. This also requires a system bus name to be " +"present in the permissions. If not a bogus bus name can be passed::" +msgstr "" + #~ msgid "" #~ "Because Flatpak runs each application " #~ "inside a sandbox, debugging tools can't" @@ -392,3 +399,10 @@ msgstr "" #~ "names`` or ``--own-names`` required::" #~ msgstr "" +#~ msgid "" +#~ "Session or system bus traffic can " +#~ "be audited by passing ``--log-" +#~ "session-bus`` and ``--log-system-bus`` " +#~ "respectively to ``flatpak run``::" +#~ msgstr "" + diff --git a/po/ru/LC_MESSAGES/electron.po b/po/ru/LC_MESSAGES/electron.po index 60cf1b06..f94bdf65 100644 --- a/po/ru/LC_MESSAGES/electron.po +++ b/po/ru/LC_MESSAGES/electron.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2023-02-04 00:21+0700\n" "Last-Translator: Dmitry \n" "Language: ru\n" @@ -210,14 +210,14 @@ msgid "" "access." msgstr "" -#: ../../electron.rst:126 +#: ../../electron.rst:127 msgid "" "Native wayland support in electron is experimental and often unstable. It" " is advised to stick with the X11 and Xwayland configuration above as the" " default." msgstr "" -#: ../../electron.rst:130 +#: ../../electron.rst:131 msgid "" "To enable experimental `native Wayland` support in Electron>=20, the " "``--ozone-platform-hint=auto`` flag can be passed to the program. `auto` " @@ -225,25 +225,26 @@ msgid "" "otherwise." msgstr "" -#: ../../electron.rst:135 +#: ../../electron.rst:136 msgid "" "The recommended option is to leave it to the user. So ``--socket=x11`` " "should be used in manifest and Wayland can be tested with::" msgstr "" -#: ../../electron.rst:140 +#: ../../electron.rst:141 msgid "" "To make native wayland the `default` for users ``--socket=fallback-x11`` " "and ``--socket=wayland`` must be used in the manifest." msgstr "" -#: ../../electron.rst:143 +#: ../../electron.rst:144 msgid "" -"Client-side window decorations in native wayland can be enabled by " -"passing ``--enable-features=WaylandWindowDecorations`` (Electron>=17)." +"For Electron versions between 17 and 27, client-side window decorations " +"in native wayland can be enabled by passing ``--enable-" +"features=WaylandWindowDecorations``." msgstr "" -#: ../../electron.rst:146 +#: ../../electron.rst:147 msgid "" "Electron uses ``libnotify`` on Linux to provide desktop notifications. " "libnotify `since 0.8.0 " @@ -254,17 +255,17 @@ msgid "" "name=org.freedesktop.Notifications`` is not required." msgstr "" -#: ../../electron.rst:152 +#: ../../electron.rst:153 msgid "" "``org.electronjs.Electron2.BaseApp`` since ``branch/23.08`` comes with " "``libnotify>=0.8.0``" msgstr "" -#: ../../electron.rst:158 +#: ../../electron.rst:159 msgid "Using correct desktop file name" msgstr "" -#: ../../electron.rst:160 +#: ../../electron.rst:161 msgid "" "It's important for Linux applications to set the correct desktop file " "name. If not, it can lead to problems like missing the window icon under " @@ -275,7 +276,7 @@ msgid "" "\"com.example.MyApp.desktop\"``." msgstr "" -#: ../../electron.rst:164 +#: ../../electron.rst:165 msgid "" "In case you repack a binary, you can use the ``patch-desktop-filename`` " "script provided by the BaseApp. Each Electron binary ships with " @@ -285,11 +286,11 @@ msgid "" "${FLATPAK_DEST}/my-app/resources/app.asar``." msgstr "" -#: ../../electron.rst:169 +#: ../../electron.rst:170 msgid "Build options" msgstr "Варианты сборки" -#: ../../electron.rst:171 +#: ../../electron.rst:172 msgid "" "These build options aren't strictly necessary, but can be useful if " "something goes wrong. ``env`` allows setting an array of environment " @@ -301,11 +302,11 @@ msgstr "" " среды, в этом случае мы устанавливаем ``NPM_CONFIG_LOGLEVEL`` на " "``info``, чтобы ``npm`` давал нам более подробные сообщения об ошибках." -#: ../../electron.rst:187 +#: ../../electron.rst:188 msgid "The application module" msgstr "Модуль приложения" -#: ../../electron.rst:189 +#: ../../electron.rst:190 msgid "" "The final section of the manifest defines how the application module " "should be built. This is where some of the additional logic for Electron " @@ -315,7 +316,7 @@ msgstr "" "приложения. Здесь можно найти дополнительную логику для Electron и " "Node.js." -#: ../../electron.rst:193 +#: ../../electron.rst:194 msgid "" "By default, ``flatpak-builder`` doesn't allow build tools to access the " "network. This means that tools which rely on downloading sources will not" @@ -329,7 +330,7 @@ msgstr "" "до запуска сборки. Установка переменной окружения " "``electronic_config_cache`` означает, что они будут найдены при сборке." -#: ../../electron.rst:199 +#: ../../electron.rst:200 msgid "" "The next part of the manifest describes how the application should be " "built. The simple buildsystem option is used, which allows a sequence of " @@ -341,17 +342,17 @@ msgstr "" "последовательность команд, используемых для сборки. Также указывается " "место загрузки и хеш приложения." -#: ../../electron.rst:222 +#: ../../electron.rst:223 msgid "Bundling NPM packages" msgstr "Объединение пакетов NPM" -#: ../../electron.rst:224 +#: ../../electron.rst:225 msgid "The next line is how NPM modules get bundled as part of Flatpaks:" msgstr "" "В следующей строке показано, как модули NPM объединяются как часть " "Flatpaks:" -#: ../../electron.rst:230 +#: ../../electron.rst:231 msgid "" "Since even simple Node.js applications depend on dozens of packages, it " "would be impractical to specify all of them as part of a manifest file. A" @@ -366,7 +367,7 @@ msgstr "" "/flatpak-builder-tools/tree/master/node>`__ для загрузки пакетов Node.js " "с помощью NPM или Yarn и включения их в исходный код приложения." -#: ../../electron.rst:236 +#: ../../electron.rst:237 msgid "" "The Python script requires a ``package-lock.json`` (or ``yarn.lock``) " "file. This file contains information about the packages that an " @@ -380,7 +381,7 @@ msgstr "" "--package-lock-only`` из корневого каталога приложения. Затем скрипт " "запускается следующим образом::" -#: ../../electron.rst:243 +#: ../../electron.rst:244 msgid "" "This generates the manifest JSON needed to build the NPM/Yarn packages " "for the application, which are outputted to a file called ``generated-" @@ -398,11 +399,11 @@ msgstr "" "``generated-source.json`` в качестве строка в разделе манифеста, как " "показано выше." -#: ../../electron.rst:251 +#: ../../electron.rst:252 msgid "Launching the app" msgstr "Запуск приложения" -#: ../../electron.rst:253 +#: ../../electron.rst:254 msgid "" "The Electron app is run through a simple script. This can be given any " "name but must be specified in the manifest's ``\"command\":`` property. " @@ -413,11 +414,11 @@ msgstr "" "``\"command\":`` манифеста. Ниже приведен пример оболочки для запуска " "приложения:" -#: ../../electron.rst:265 +#: ../../electron.rst:266 msgid "Build commands" msgstr "Команды сборки" -#: ../../electron.rst:267 +#: ../../electron.rst:268 msgid "" "Last but not least, since the simple build option is being used, a list " "of build commands must be provided. As can be seen, ``npm`` is run with " @@ -433,7 +434,7 @@ msgstr "" "``/app/main/``. Наконец, скрипт ``run.sh`` устанавливается в " "``/app/bin/``, так что он будет находиться в ``$PATH``:" -#: ../../electron.rst:289 +#: ../../electron.rst:290 msgid "" "Note that if the application you are trying to package contains a " "``build`` block in ``package.json`` with instructions for Linux, this can" @@ -448,7 +449,7 @@ msgstr "" "опция `--dir`). В следующем примере показана конфигурация, которая " "попытается загрузить двоичные файлы AppImage:" -#: ../../electron.rst:299 +#: ../../electron.rst:300 msgid "" "The preferred way of fixing this, is not a patch, but a build-time edit " "using ``jq``. The following command will replace ``\"target\": " @@ -458,11 +459,11 @@ msgstr "" "время сборки с использованием ``jq``. Следующая команда заменит " "``\"target\": \"AppImage\"`` на ``\"target\": \"dir\"``:" -#: ../../electron.rst:306 +#: ../../electron.rst:307 msgid "Make setProgressBar and setBadgeCount work" msgstr "" -#: ../../electron.rst:307 +#: ../../electron.rst:308 msgid "" "The `setProgressBar `_ and `setBadgeCount " @@ -476,12 +477,13 @@ msgid "" "extension and `Plank `_." msgstr "" -#: ../../electron.rst:310 +#: ../../electron.rst:311 msgid "" "To make it work in Flatpak, the app needs to :ref:`use the correct " -"desktop filename `. The Flatpak also needs " -"the ``--talk-name=com.canonical.Unity`` permission. Electron versions " -"earlier than v32 checks `checks if it's running on Unity or KDE " +"desktop filename ` in its embedded " +"`package.json` file. The Flatpak also needs the ``--talk-" +"name=com.canonical.Unity`` permission. Electron versions earlier than v32" +" checks `checks if it's running on Unity or KDE " "`_" " before using the UnityLauncherAPI." msgstr "" @@ -541,3 +543,23 @@ msgstr "" #~ msgid "Then you can run the build::" #~ msgstr "Затем вы можете запустить сборку::" +#~ msgid "" +#~ "Client-side window decorations in native" +#~ " wayland can be enabled by passing" +#~ " ``--enable-features=WaylandWindowDecorations`` " +#~ "(Electron>=17)." +#~ msgstr "" + +#~ msgid "" +#~ "To make it work in Flatpak, the" +#~ " app needs to :ref:`use the correct" +#~ " desktop filename `. The Flatpak also needs the" +#~ " ``--talk-name=com.canonical.Unity`` permission. " +#~ "Electron versions earlier than v32 " +#~ "checks `checks if it's running on " +#~ "Unity or KDE " +#~ "`_" +#~ " before using the UnityLauncherAPI." +#~ msgstr "" + diff --git a/po/ru/LC_MESSAGES/manifests.po b/po/ru/LC_MESSAGES/manifests.po index 8587f880..39b1d9bc 100644 --- a/po/ru/LC_MESSAGES/manifests.po +++ b/po/ru/LC_MESSAGES/manifests.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-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2023-11-06 21:35+0700\n" "Last-Translator: Dmitry \n" "Language: ru\n" @@ -279,13 +279,27 @@ msgstr "" #: ../../manifests.rst:146 msgid "" -"GNOME Dictionary's modules section is short, since it just contains the " -"application itself, and looks like:" +"Modules are built in the order they are declared in the manifest. If any " +"module changes, that module and all the subsequent modules below it will " +"be rebuilt, otherwise it should use the cache." msgstr "" -"Раздел модулей GNOME Dictionary's короткий, поскольку он содержит только " -"само приложение и выглядит так:" -#: ../../manifests.rst:163 +#: ../../manifests.rst:150 +msgid "" +"The general recommendation is to place the \"main\" module, usually the " +"module for the main application as the last module in the manifest but if" +" there is a module which gets updated often and is independent from the " +"rest, that module can also be placed as the last module to avoid " +"rebuilding everything else." +msgstr "" + +#: ../../manifests.rst:156 +msgid "" +"Modules can either be nested to clearly show the dependency structure or " +"be linearly declared." +msgstr "" + +#: ../../manifests.rst:236 msgid "" "As can be seen, each listed module has a ``name`` (which can be freely " "assigned) and a list of ``sources``. Each source has a ``type``, and " @@ -295,27 +309,27 @@ msgstr "" "присвоено произвольно) и список ``источники`` У каждого источника есть " "``тип``, и доступные типы включают:" -#: ../../manifests.rst:167 +#: ../../manifests.rst:240 msgid "``archive`` - ``.tar`` or ``.zip`` archive files" msgstr "``archive`` - ``.tar`` или ``.zip`` архивные файлы" -#: ../../manifests.rst:168 +#: ../../manifests.rst:241 msgid "``git`` - Git repositories" msgstr "``git`` - Репозитории Git" -#: ../../manifests.rst:169 +#: ../../manifests.rst:242 msgid "``bzr`` - Bazaar repositories" msgstr "``bzr`` - репозитории Bazaar" -#: ../../manifests.rst:170 +#: ../../manifests.rst:243 msgid "``file`` - local/remote files (these are copied into the source directory)" msgstr "``file`` - локальные/удаленные файлы (они копируются в исходный каталог)" -#: ../../manifests.rst:171 +#: ../../manifests.rst:244 msgid "``dir`` - local directories (these are copied into the source directory)" msgstr "``dir`` - локальные каталоги (они копируются в исходный каталог)" -#: ../../manifests.rst:172 +#: ../../manifests.rst:245 msgid "" "``script`` - an array of shell commands (these are put in a shellscript " "file)" @@ -323,7 +337,7 @@ msgstr "" "``script`` - список команд оболочки (они помещаются в файл сценария " "оболочки)" -#: ../../manifests.rst:174 +#: ../../manifests.rst:247 msgid "" "``shell`` - an array of shell commands that are run during source " "extraction" @@ -331,11 +345,11 @@ msgstr "" "``shell`` - массив команд оболочки, которые запускаются во время " "извлечения исходного кода" -#: ../../manifests.rst:175 +#: ../../manifests.rst:248 msgid "``patch`` - a patch (are applied to the source directory)" msgstr "``patch`` - патч (применяются к исходному каталогу)" -#: ../../manifests.rst:176 +#: ../../manifests.rst:249 msgid "" "``extra-data`` - data that can be downloaded at install time; this can " "include archive or package files" @@ -343,7 +357,7 @@ msgstr "" "``extra-data`` - данные, которые можно загрузить во время установки; " "может включать архивные или пакетные файлы" -#: ../../manifests.rst:179 +#: ../../manifests.rst:252 #, fuzzy msgid "" "Different properties are available for each source type, which are listed" @@ -352,17 +366,17 @@ msgstr "" "Для каждого типа источника доступны разные свойства, которые перечислены " "в :doc:`flatpak-builder-command-reference`." -#: ../../manifests.rst:183 +#: ../../manifests.rst:256 msgid "Supported build systems" msgstr "Поддерживаемые системы сборки" -#: ../../manifests.rst:185 +#: ../../manifests.rst:258 msgid "Modules can be built with a variety of build systems, including:" msgstr "" "Модули могут быть построены с использованием различных систем сборки, в " "том числе:" -#: ../../manifests.rst:187 +#: ../../manifests.rst:260 msgid "" "`autotools `_" @@ -370,27 +384,23 @@ msgstr "" "`autotools `_" -#: ../../manifests.rst:188 +#: ../../manifests.rst:261 msgid "`cmake `_" msgstr "`cmake `_" -#: ../../manifests.rst:189 +#: ../../manifests.rst:262 msgid "`cmake-ninja `_" msgstr "`cmake-ninja `_" -#: ../../manifests.rst:190 +#: ../../manifests.rst:263 msgid "`meson `_" msgstr "`meson `_" -#: ../../manifests.rst:191 +#: ../../manifests.rst:264 msgid "`qmake `_" msgstr "`qmake `_" -#: ../../manifests.rst:192 -msgid "the \"`Build API `_\"" -msgstr "the \"`Build API `_\"" - -#: ../../manifests.rst:194 +#: ../../manifests.rst:266 msgid "" "A \"simple\" build method is also available, which allows a series of " "commands to be specified." @@ -398,44 +408,59 @@ msgstr "" "Также доступен «простой» метод сборки, который позволяет указать серию " "команд." -#: ../../manifests.rst:198 +#: ../../manifests.rst:269 +msgid "" +"Each of the above buildsystem sets up the installation prefix, libdir " +"etc. and runs a series of commands to configure (``meson setup``, or " +"``./autogen.sh, ./configure`` or ``cmake``), build, install (``ninja " +"install, make install`` etc.) and optionally run tests (``make check, " +"ninja test`` etc.)." +msgstr "" + +#: ../../manifests.rst:275 +msgid "" +"Thus they can also be achieved by using the ``simple`` buildsystem and " +"manually specifying the commands." +msgstr "" + +#: ../../manifests.rst:280 +msgid "" +"Using the proper buildsystem is almost always preferred rather than " +"manually handling the correct setup." +msgstr "" + +#: ../../manifests.rst:283 +msgid "An example is provided below." +msgstr "" + +#: ../../manifests.rst:333 msgid "Shared Modules" msgstr "Общие модули" -#: ../../manifests.rst:200 +#: ../../manifests.rst:335 +#, fuzzy msgid "" -"`Shared Modules (or shared-modules) `_ is a repository containing various manifests to build common " -"libraries. It is intended to be used as a git submodule." +"Flathub contains a `shared modules `_ repository containing build manifests for commonly used " +"modules. These are usally shared by apps on Flathub and maintained in a " +"single place. The repository is intended to be used as a git submodule." msgstr "" "`Общие модули (или общие модули) `_ — это репозиторий, содержащий различные манифесты для создания" " общих библиотек. Он предназначен для использования в качестве подмодуля " "git." -#: ../../manifests.rst:202 -msgid "To add it to your repository, run this command:" -msgstr "Чтобы добавить его в свой репозиторий, выполните следующую команду:" - -#: ../../manifests.rst:208 -msgid "Then, add whichever module you want. In this example, we will use `gtk2`:" +#: ../../manifests.rst:340 +msgid "" +"Please see the `readme `_ for details on how to use this." msgstr "" -"Затем добавьте любой модуль, который вы хотите. В этом примере мы будем " -"использовать `gtk2`:" - -#: ../../manifests.rst:215 -msgid "To update the submodule, run this command:" -msgstr "Чтобы обновить подмодуль, выполните эту команду:" - -#: ../../manifests.rst:221 -msgid "To remove the submodule, run these commands:" -msgstr "Чтобы удалить подмодуль, выполните следующие команды:" -#: ../../manifests.rst:231 +#: ../../manifests.rst:344 msgid "Flatpak Builder Tools" msgstr "Инструменты для создания Flatpak" -#: ../../manifests.rst:233 +#: ../../manifests.rst:346 msgid "" "`Flatpak Builder Tools (or flatpak-builder-tools) " "`_ is a collection of " @@ -449,21 +474,16 @@ msgstr "" "каталог содержит инструкции по созданию манифеста для соответствующей " "платформы." -#: ../../manifests.rst:236 +#: ../../manifests.rst:349 msgid "Example manifests" msgstr "Примеры манифестов" -#: ../../manifests.rst:238 +#: ../../manifests.rst:351 msgid "" -"A `complete manifest for GNOME Dictionary built from Git " -"`_." -" It is also possible to browse `all the manifests hosted by Flathub " +"Flathub hosts a large collection of applications and the respective " +"manifests can be browsed and searched via `GitHub " "`_." msgstr "" -"Полный манифест для словаря GNOME, созданный на основе Git " -"`_." -" Также можно просматривать все манифесты, размещенные на Flathub " -"`_." #~ msgid "" #~ "A `complete manifest for GNOME " @@ -622,3 +642,48 @@ msgstr "" #~ "будут сопоставлены только имена файлов, " #~ "созданные этим конкретным модулем." +#~ msgid "" +#~ "GNOME Dictionary's modules section is " +#~ "short, since it just contains the " +#~ "application itself, and looks like:" +#~ msgstr "" +#~ "Раздел модулей GNOME Dictionary's короткий," +#~ " поскольку он содержит только само " +#~ "приложение и выглядит так:" + +#~ msgid "the \"`Build API `_\"" +#~ msgstr "the \"`Build API `_\"" + +#~ msgid "To add it to your repository, run this command:" +#~ msgstr "Чтобы добавить его в свой репозиторий, выполните следующую команду:" + +#~ msgid "" +#~ "Then, add whichever module you want. " +#~ "In this example, we will use " +#~ "`gtk2`:" +#~ msgstr "" +#~ "Затем добавьте любой модуль, который вы" +#~ " хотите. В этом примере мы будем " +#~ "использовать `gtk2`:" + +#~ msgid "To update the submodule, run this command:" +#~ msgstr "Чтобы обновить подмодуль, выполните эту команду:" + +#~ msgid "To remove the submodule, run these commands:" +#~ msgstr "Чтобы удалить подмодуль, выполните следующие команды:" + +#~ msgid "" +#~ "A `complete manifest for GNOME " +#~ "Dictionary built from Git " +#~ "`_." +#~ " It is also possible to browse " +#~ "`all the manifests hosted by Flathub " +#~ "`_." +#~ msgstr "" +#~ "Полный манифест для словаря GNOME, " +#~ "созданный на основе Git " +#~ "`_." +#~ " Также можно просматривать все манифесты," +#~ " размещенные на Flathub " +#~ "`_." + diff --git a/po/ru/LC_MESSAGES/sandbox-permissions.po b/po/ru/LC_MESSAGES/sandbox-permissions.po index 21bf69e6..cae5bed0 100644 --- a/po/ru/LC_MESSAGES/sandbox-permissions.po +++ b/po/ru/LC_MESSAGES/sandbox-permissions.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-03 21:08+0530\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2023-11-06 23:55+0700\n" "Last-Translator: Dmitry \n" "Language: ru\n" @@ -1158,11 +1158,27 @@ msgstr "" "Ни одно приложение не должно использовать ``--talk-name=org.gtk.vfs`` в " "своем манифесте, так как нет сервисов D-Bus с именем ``org.gtk.vfs``." -#: ../../sandbox-permissions.rst:428 +#: ../../sandbox-permissions.rst:427 +msgid "" +"These permission grants the app, the ability to communicate with the gvfs" +" daemon and backends running on host. Depending on the backends installed" +" or running on host, it grants the ability to list mounted devices (USB, " +"optical etc.), detach/format/eject them, mount them locally, read and " +"write data. This is usually used with network storages like WebDAV, " +"Google Drive, SMB etc. but backends exist for MTP/PTP, `USB " +"`_," +" special locations like ``trash://`` and the `local filesystem " +"`_" +" too. So the app can access, read and write data from all of these " +"locations provided the daemon and backends are installed and running on " +"host." +msgstr "" + +#: ../../sandbox-permissions.rst:441 msgid "External drive access" msgstr "" -#: ../../sandbox-permissions.rst:430 +#: ../../sandbox-permissions.rst:443 msgid "" "External drives are mounted by the host system using systemd, udev, udisk" " fstab etc. and each of them can have different defaults. Flatpak has no " @@ -1170,30 +1186,30 @@ msgid "" "permissions should work in most cases::" msgstr "" -#: ../../sandbox-permissions.rst:439 +#: ../../sandbox-permissions.rst:452 msgid "" "If ``--filesystem=host`` is used ``/media, /run/media`` is shared " "automatically if they exist." msgstr "" -#: ../../sandbox-permissions.rst:442 +#: ../../sandbox-permissions.rst:455 msgid "" "Note that these should not have subpaths in them unless the value of the " "subpath can be consistently pre-determined. Block device naming depends " "on the kernel/fstab configuration and cannot be pre-determined." msgstr "" -#: ../../sandbox-permissions.rst:447 +#: ../../sandbox-permissions.rst:460 msgid "Footnotes" msgstr "" -#: ../../sandbox-permissions.rst:448 +#: ../../sandbox-permissions.rst:461 msgid "" "This is not necessarily required, but without it the X11 shared memory " "extension will not work, which is very bad for X11 performance." msgstr "" -#: ../../sandbox-permissions.rst:450 +#: ../../sandbox-permissions.rst:463 msgid "" "Giving network access also grants access to all host services listening " "on abstract Unix sockets (due to how network namespaces work), and these " @@ -1202,7 +1218,7 @@ msgid "" "secure distribution should disable these and just use regular sockets." msgstr "" -#: ../../sandbox-permissions.rst:455 +#: ../../sandbox-permissions.rst:468 msgid "" "``xdg-{cache, config, data}`` bind mounts the paths from host to the per-" "app sandbox directory. Inside the sandbox ``$XDG_CACHE_HOME``, " diff --git a/po/zh_CN/LC_MESSAGES/debugging.po b/po/zh_CN/LC_MESSAGES/debugging.po index 9bbecbbf..12da6670 100644 --- a/po/zh_CN/LC_MESSAGES/debugging.po +++ b/po/zh_CN/LC_MESSAGES/debugging.po @@ -4,7 +4,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-03 21:11+0530\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-11-03 01:03-0400\n" "Last-Translator: PikachuHy \n" "Language: zh_Hans_CN\n" @@ -262,8 +262,8 @@ msgstr "" #: ../../debugging.rst:183 msgid "" -"Session or system bus traffic can be audited by passing ``--log-session-" -"bus`` and ``--log-system-bus`` respectively to ``flatpak run``::" +"Session bus traffic can be audited by passing ``--log-session-bus`` to " +"``flatpak run``::" msgstr "" #: ../../debugging.rst:188 @@ -273,6 +273,13 @@ msgid "" "required::" msgstr "" +#: ../../debugging.rst:194 +msgid "" +"Similarly, system bus traffic can be audited by passing ``--log-system-" +"bus`` to ``flatpak run``. This also requires a system bus name to be " +"present in the permissions. If not a bogus bus name can be passed::" +msgstr "" + #~ msgid "" #~ "Because Flatpak runs each application " #~ "inside a sandbox, debugging tools can't" @@ -340,3 +347,10 @@ msgstr "" #~ "names`` or ``--own-names`` required::" #~ msgstr "" +#~ msgid "" +#~ "Session or system bus traffic can " +#~ "be audited by passing ``--log-" +#~ "session-bus`` and ``--log-system-bus`` " +#~ "respectively to ``flatpak run``::" +#~ msgstr "" + diff --git a/po/zh_CN/LC_MESSAGES/electron.po b/po/zh_CN/LC_MESSAGES/electron.po index b0deef61..4ee9ce5a 100644 --- a/po/zh_CN/LC_MESSAGES/electron.po +++ b/po/zh_CN/LC_MESSAGES/electron.po @@ -4,7 +4,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-11-03 12:59-0400\n" "Last-Translator: PikachuHy \n" "Language: zh_Hans_CN\n" @@ -167,14 +167,14 @@ msgid "" "access." msgstr "" -#: ../../electron.rst:126 +#: ../../electron.rst:127 msgid "" "Native wayland support in electron is experimental and often unstable. It" " is advised to stick with the X11 and Xwayland configuration above as the" " default." msgstr "" -#: ../../electron.rst:130 +#: ../../electron.rst:131 msgid "" "To enable experimental `native Wayland` support in Electron>=20, the " "``--ozone-platform-hint=auto`` flag can be passed to the program. `auto` " @@ -182,25 +182,26 @@ msgid "" "otherwise." msgstr "" -#: ../../electron.rst:135 +#: ../../electron.rst:136 msgid "" "The recommended option is to leave it to the user. So ``--socket=x11`` " "should be used in manifest and Wayland can be tested with::" msgstr "" -#: ../../electron.rst:140 +#: ../../electron.rst:141 msgid "" "To make native wayland the `default` for users ``--socket=fallback-x11`` " "and ``--socket=wayland`` must be used in the manifest." msgstr "" -#: ../../electron.rst:143 +#: ../../electron.rst:144 msgid "" -"Client-side window decorations in native wayland can be enabled by " -"passing ``--enable-features=WaylandWindowDecorations`` (Electron>=17)." +"For Electron versions between 17 and 27, client-side window decorations " +"in native wayland can be enabled by passing ``--enable-" +"features=WaylandWindowDecorations``." msgstr "" -#: ../../electron.rst:146 +#: ../../electron.rst:147 msgid "" "Electron uses ``libnotify`` on Linux to provide desktop notifications. " "libnotify `since 0.8.0 " @@ -211,17 +212,17 @@ msgid "" "name=org.freedesktop.Notifications`` is not required." msgstr "" -#: ../../electron.rst:152 +#: ../../electron.rst:153 msgid "" "``org.electronjs.Electron2.BaseApp`` since ``branch/23.08`` comes with " "``libnotify>=0.8.0``" msgstr "" -#: ../../electron.rst:158 +#: ../../electron.rst:159 msgid "Using correct desktop file name" msgstr "" -#: ../../electron.rst:160 +#: ../../electron.rst:161 msgid "" "It's important for Linux applications to set the correct desktop file " "name. If not, it can lead to problems like missing the window icon under " @@ -232,7 +233,7 @@ msgid "" "\"com.example.MyApp.desktop\"``." msgstr "" -#: ../../electron.rst:164 +#: ../../electron.rst:165 msgid "" "In case you repack a binary, you can use the ``patch-desktop-filename`` " "script provided by the BaseApp. Each Electron binary ships with " @@ -242,11 +243,11 @@ msgid "" "${FLATPAK_DEST}/my-app/resources/app.asar``." msgstr "" -#: ../../electron.rst:169 +#: ../../electron.rst:170 msgid "Build options" msgstr "构建选项" -#: ../../electron.rst:171 +#: ../../electron.rst:172 msgid "" "These build options aren't strictly necessary, but can be useful if " "something goes wrong. ``env`` allows setting an array of environment " @@ -256,18 +257,18 @@ msgstr "" "构建选项不是必要的，但是在发生一些错误的时候很有用。 ``env`` 允许设置一个环境变量数组，这时将 " "``NPM_CONFIG_LOGLEVEL`` 设置为 ``info`` 可以让 ``npm`` 给我们更多关于错误的详情。" -#: ../../electron.rst:187 +#: ../../electron.rst:188 msgid "The application module" msgstr "应用模块" -#: ../../electron.rst:189 +#: ../../electron.rst:190 msgid "" "The final section of the manifest defines how the application module " "should be built. This is where some of the additional logic for Electron " "and Node.js can be found." msgstr "清单文件的最后一部分是定义应用模块如何构建。可以找到一些Electron和Node.js的一些附加逻辑。" -#: ../../electron.rst:193 +#: ../../electron.rst:194 msgid "" "By default, ``flatpak-builder`` doesn't allow build tools to access the " "network. This means that tools which rely on downloading sources will not" @@ -279,7 +280,7 @@ msgstr "" "默认不能访问网络。这意味着依赖于下载资源的工具无法工作。因此，Node.js包必须在构建之前提前下载好。设置环境变量 " "``electron_config_cache`` 表明这些包会在构建的时候被找到。" -#: ../../electron.rst:199 +#: ../../electron.rst:200 msgid "" "The next part of the manifest describes how the application should be " "built. The simple buildsystem option is used, which allows a sequence of " @@ -287,15 +288,15 @@ msgid "" "location and hash of the application are also specified." msgstr "清单文件的下一部分描述了怎样构建应用。使用了简单构建系统的选项，允许指定一系列命令来构建。下载地址和应用的hash也会进行指定。" -#: ../../electron.rst:222 +#: ../../electron.rst:223 msgid "Bundling NPM packages" msgstr "绑定NPM包" -#: ../../electron.rst:224 +#: ../../electron.rst:225 msgid "The next line is how NPM modules get bundled as part of Flatpaks:" msgstr "下一行是NPM模块如何作为flatpak的一部分进行绑定：" -#: ../../electron.rst:230 +#: ../../electron.rst:231 #, fuzzy msgid "" "Since even simple Node.js applications depend on dozens of packages, it " @@ -309,7 +310,7 @@ msgstr "" " `_ " "被开发出来，使用NPM下载Node.js包并将他们包含在应用源码里。" -#: ../../electron.rst:236 +#: ../../electron.rst:237 #, fuzzy msgid "" "The Python script requires a ``package-lock.json`` (or ``yarn.lock``) " @@ -322,7 +323,7 @@ msgstr "" " install --package-lock-only`` 生成（示例包含了一个 ``package-lock.json`` " "供参考）。下面运行这个脚本::" -#: ../../electron.rst:243 +#: ../../electron.rst:244 #, fuzzy msgid "" "This generates the manifest JSON needed to build the NPM/Yarn packages " @@ -337,11 +338,11 @@ msgstr "" "的文件。这个文件的内容可以拷贝到应用的清单文件中，但是因为通常它非常长，最好是从主要的清单链接它。如上所示，可以在清单文件中添加一行 " "``generated-source.json`` 来实现链接。" -#: ../../electron.rst:251 +#: ../../electron.rst:252 msgid "Launching the app" msgstr "启动应用" -#: ../../electron.rst:253 +#: ../../electron.rst:254 #, fuzzy msgid "" "The Electron app is run through a simple script. This can be given any " @@ -349,11 +350,11 @@ msgid "" "See below a sample wrapper for launching app:" msgstr "Electron应用通过一个简单的脚本文件运行。可以用任何名字，但是必须在清单文件中 ``“command\":`` 属性指明。" -#: ../../electron.rst:265 +#: ../../electron.rst:266 msgid "Build commands" msgstr "构建命令" -#: ../../electron.rst:267 +#: ../../electron.rst:268 #, fuzzy msgid "" "Last but not least, since the simple build option is being used, a list " @@ -367,7 +368,7 @@ msgstr "" "选项运行，使用的包已经缓存好了。这些被拷贝到了 ``/app/main/`` 。最后 ``run.sh`` 脚本安装到了 " "``/app/bin/`` ，所以最后它会在 ``$PATH`` ：" -#: ../../electron.rst:289 +#: ../../electron.rst:290 msgid "" "Note that if the application you are trying to package contains a " "``build`` block in ``package.json`` with instructions for Linux, this can" @@ -376,18 +377,18 @@ msgid "" "configuration that will try to download AppImage binaries:" msgstr "" -#: ../../electron.rst:299 +#: ../../electron.rst:300 msgid "" "The preferred way of fixing this, is not a patch, but a build-time edit " "using ``jq``. The following command will replace ``\"target\": " "\"AppImage\"`` with ``\"target\": \"dir\"``:" msgstr "" -#: ../../electron.rst:306 +#: ../../electron.rst:307 msgid "Make setProgressBar and setBadgeCount work" msgstr "" -#: ../../electron.rst:307 +#: ../../electron.rst:308 msgid "" "The `setProgressBar `_ and `setBadgeCount " @@ -401,12 +402,13 @@ msgid "" "extension and `Plank `_." msgstr "" -#: ../../electron.rst:310 +#: ../../electron.rst:311 msgid "" "To make it work in Flatpak, the app needs to :ref:`use the correct " -"desktop filename `. The Flatpak also needs " -"the ``--talk-name=com.canonical.Unity`` permission. Electron versions " -"earlier than v32 checks `checks if it's running on Unity or KDE " +"desktop filename ` in its embedded " +"`package.json` file. The Flatpak also needs the ``--talk-" +"name=com.canonical.Unity`` permission. Electron versions earlier than v32" +" checks `checks if it's running on Unity or KDE " "`_" " before using the UnityLauncherAPI." msgstr "" @@ -459,3 +461,23 @@ msgstr "" #~ msgid "Then you can run the build::" #~ msgstr "然后运行构建命令：" +#~ msgid "" +#~ "Client-side window decorations in native" +#~ " wayland can be enabled by passing" +#~ " ``--enable-features=WaylandWindowDecorations`` " +#~ "(Electron>=17)." +#~ msgstr "" + +#~ msgid "" +#~ "To make it work in Flatpak, the" +#~ " app needs to :ref:`use the correct" +#~ " desktop filename `. The Flatpak also needs the" +#~ " ``--talk-name=com.canonical.Unity`` permission. " +#~ "Electron versions earlier than v32 " +#~ "checks `checks if it's running on " +#~ "Unity or KDE " +#~ "`_" +#~ " before using the UnityLauncherAPI." +#~ msgstr "" + diff --git a/po/zh_CN/LC_MESSAGES/manifests.po b/po/zh_CN/LC_MESSAGES/manifests.po index 93710e78..52b1f876 100644 --- a/po/zh_CN/LC_MESSAGES/manifests.po +++ b/po/zh_CN/LC_MESSAGES/manifests.po @@ -4,7 +4,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-11-03 01:52-0400\n" "Last-Translator: PikachuHy \n" "Language: zh_Hans_CN\n" @@ -231,11 +231,27 @@ msgstr "这个模块列表作为构建过程的一部分，指明了每个模块 #: ../../manifests.rst:146 msgid "" -"GNOME Dictionary's modules section is short, since it just contains the " -"application itself, and looks like:" -msgstr "GNOME Dictionary的模块节点是较短的，因为它仅仅包含应用本身，大概如下所示：" +"Modules are built in the order they are declared in the manifest. If any " +"module changes, that module and all the subsequent modules below it will " +"be rebuilt, otherwise it should use the cache." +msgstr "" + +#: ../../manifests.rst:150 +msgid "" +"The general recommendation is to place the \"main\" module, usually the " +"module for the main application as the last module in the manifest but if" +" there is a module which gets updated often and is independent from the " +"rest, that module can also be placed as the last module to avoid " +"rebuilding everything else." +msgstr "" -#: ../../manifests.rst:163 +#: ../../manifests.rst:156 +msgid "" +"Modules can either be nested to clearly show the dependency structure or " +"be linearly declared." +msgstr "" + +#: ../../manifests.rst:236 msgid "" "As can be seen, each listed module has a ``name`` (which can be freely " "assigned) and a list of ``sources``. Each source has a ``type``, and " @@ -244,66 +260,66 @@ msgstr "" "可以看出，每个列出的模块有一个 ``name`` （可以自由分配）和一个 ``sources`` 列表。每个source都有一个 ``type``" " ，可用的type有：" -#: ../../manifests.rst:167 +#: ../../manifests.rst:240 msgid "``archive`` - ``.tar`` or ``.zip`` archive files" msgstr "``archive`` - ``.tar`` or ``.zip`` 归档文件" -#: ../../manifests.rst:168 +#: ../../manifests.rst:241 msgid "``git`` - Git repositories" msgstr "``git`` - Git 仓库" -#: ../../manifests.rst:169 +#: ../../manifests.rst:242 msgid "``bzr`` - Bazaar repositories" msgstr "``bzr`` - Bazaar 仓库" -#: ../../manifests.rst:170 +#: ../../manifests.rst:243 #, fuzzy msgid "``file`` - local/remote files (these are copied into the source directory)" msgstr "``file`` - 本地文件（这些复制到源码目录）" -#: ../../manifests.rst:171 +#: ../../manifests.rst:244 #, fuzzy msgid "``dir`` - local directories (these are copied into the source directory)" msgstr "``dir`` - 本地目录 (这些将复制到源码目录)" -#: ../../manifests.rst:172 +#: ../../manifests.rst:245 msgid "" "``script`` - an array of shell commands (these are put in a shellscript " "file)" msgstr "``script`` - 一个shell命令数组（这些都被放在shell脚本文件里）" -#: ../../manifests.rst:174 +#: ../../manifests.rst:247 msgid "" "``shell`` - an array of shell commands that are run during source " "extraction" msgstr "``shell`` - 再源码抽取期间运行的一组shell命令" -#: ../../manifests.rst:175 +#: ../../manifests.rst:248 msgid "``patch`` - a patch (are applied to the source directory)" msgstr "``patch`` - 补丁（用于源代码目录）" -#: ../../manifests.rst:176 +#: ../../manifests.rst:249 msgid "" "``extra-data`` - data that can be downloaded at install time; this can " "include archive or package files" msgstr "``extra-data`` - 在安装时下载的数据；可以包含归档文件或者package文件" -#: ../../manifests.rst:179 +#: ../../manifests.rst:252 #, fuzzy msgid "" "Different properties are available for each source type, which are listed" " in the :doc:`module-sources`." msgstr "每种source类型有不同的属性，在 :doc:`flatpak-builder-command-reference` 列出了。" -#: ../../manifests.rst:183 +#: ../../manifests.rst:256 msgid "Supported build systems" msgstr "受支持的构建系统" -#: ../../manifests.rst:185 +#: ../../manifests.rst:258 msgid "Modules can be built with a variety of build systems, including:" msgstr "模块可以用多种构建系统构建，包含：" -#: ../../manifests.rst:187 +#: ../../manifests.rst:260 msgid "" "`autotools `_" @@ -311,68 +327,80 @@ msgstr "" "`autotools `_" -#: ../../manifests.rst:188 +#: ../../manifests.rst:261 msgid "`cmake `_" msgstr "`cmake `_" -#: ../../manifests.rst:189 +#: ../../manifests.rst:262 #, fuzzy msgid "`cmake-ninja `_" msgstr "" " `cmake-ninja `_" " , `meson `_ " -#: ../../manifests.rst:190 +#: ../../manifests.rst:263 #, fuzzy msgid "`meson `_" msgstr "`cmake `_" -#: ../../manifests.rst:191 +#: ../../manifests.rst:264 msgid "`qmake `_" msgstr "" -#: ../../manifests.rst:192 -msgid "the \"`Build API `_\"" -msgstr "\" `Build API `_ \"" - -#: ../../manifests.rst:194 +#: ../../manifests.rst:266 msgid "" "A \"simple\" build method is also available, which allows a series of " "commands to be specified." msgstr "一个“简单的”构建方法，需要指定一系列命令。" -#: ../../manifests.rst:198 -msgid "Shared Modules" +#: ../../manifests.rst:269 +msgid "" +"Each of the above buildsystem sets up the installation prefix, libdir " +"etc. and runs a series of commands to configure (``meson setup``, or " +"``./autogen.sh, ./configure`` or ``cmake``), build, install (``ninja " +"install, make install`` etc.) and optionally run tests (``make check, " +"ninja test`` etc.)." msgstr "" -#: ../../manifests.rst:200 +#: ../../manifests.rst:275 msgid "" -"`Shared Modules (or shared-modules) `_ is a repository containing various manifests to build common " -"libraries. It is intended to be used as a git submodule." +"Thus they can also be achieved by using the ``simple`` buildsystem and " +"manually specifying the commands." msgstr "" -#: ../../manifests.rst:202 -msgid "To add it to your repository, run this command:" +#: ../../manifests.rst:280 +msgid "" +"Using the proper buildsystem is almost always preferred rather than " +"manually handling the correct setup." msgstr "" -#: ../../manifests.rst:208 -msgid "Then, add whichever module you want. In this example, we will use `gtk2`:" +#: ../../manifests.rst:283 +msgid "An example is provided below." msgstr "" -#: ../../manifests.rst:215 -msgid "To update the submodule, run this command:" +#: ../../manifests.rst:333 +msgid "Shared Modules" +msgstr "" + +#: ../../manifests.rst:335 +msgid "" +"Flathub contains a `shared modules `_ repository containing build manifests for commonly used " +"modules. These are usally shared by apps on Flathub and maintained in a " +"single place. The repository is intended to be used as a git submodule." msgstr "" -#: ../../manifests.rst:221 -msgid "To remove the submodule, run these commands:" +#: ../../manifests.rst:340 +msgid "" +"Please see the `readme `_ for details on how to use this." msgstr "" -#: ../../manifests.rst:231 +#: ../../manifests.rst:344 msgid "Flatpak Builder Tools" msgstr "" -#: ../../manifests.rst:233 +#: ../../manifests.rst:346 msgid "" "`Flatpak Builder Tools (or flatpak-builder-tools) " "`_ is a collection of " @@ -381,15 +409,14 @@ msgid "" " platform." msgstr "" -#: ../../manifests.rst:236 +#: ../../manifests.rst:349 msgid "Example manifests" msgstr "实例清单文件" -#: ../../manifests.rst:238 +#: ../../manifests.rst:351 msgid "" -"A `complete manifest for GNOME Dictionary built from Git " -"`_." -" It is also possible to browse `all the manifests hosted by Flathub " +"Flathub hosts a large collection of applications and the respective " +"manifests can be browsed and searched via `GitHub " "`_." msgstr "" @@ -451,3 +478,45 @@ msgstr "" #~ "that particular module will be matched." #~ msgstr "cleanup属性可以根据每个模块进行设置，在这种情况下，只会匹配该特定的模块产生的文件名。" +#~ msgid "" +#~ "GNOME Dictionary's modules section is " +#~ "short, since it just contains the " +#~ "application itself, and looks like:" +#~ msgstr "GNOME Dictionary的模块节点是较短的，因为它仅仅包含应用本身，大概如下所示：" + +#~ msgid "the \"`Build API `_\"" +#~ msgstr "\" `Build API `_ \"" + +#~ msgid "" +#~ "`Shared Modules (or shared-modules) " +#~ "`_ is a" +#~ " repository containing various manifests to" +#~ " build common libraries. It is " +#~ "intended to be used as a git " +#~ "submodule." +#~ msgstr "" + +#~ msgid "To add it to your repository, run this command:" +#~ msgstr "" + +#~ msgid "" +#~ "Then, add whichever module you want. " +#~ "In this example, we will use " +#~ "`gtk2`:" +#~ msgstr "" + +#~ msgid "To update the submodule, run this command:" +#~ msgstr "" + +#~ msgid "To remove the submodule, run these commands:" +#~ msgstr "" + +#~ msgid "" +#~ "A `complete manifest for GNOME " +#~ "Dictionary built from Git " +#~ "`_." +#~ " It is also possible to browse " +#~ "`all the manifests hosted by Flathub " +#~ "`_." +#~ msgstr "" + diff --git a/po/zh_CN/LC_MESSAGES/sandbox-permissions.po b/po/zh_CN/LC_MESSAGES/sandbox-permissions.po index 00c3480b..dab4c4ea 100644 --- a/po/zh_CN/LC_MESSAGES/sandbox-permissions.po +++ b/po/zh_CN/LC_MESSAGES/sandbox-permissions.po @@ -4,7 +4,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-03 21:08+0530\n" +"POT-Creation-Date: 2025-02-05 01:10+0530\n" "PO-Revision-Date: 2018-11-03 02:03-0400\n" "Last-Translator: PikachuHy \n" "Language: zh_Hans_CN\n" @@ -1057,11 +1057,27 @@ msgid "" "manifest, as there are no D-Bus services named ``org.gtk.vfs``." msgstr "" -#: ../../sandbox-permissions.rst:428 +#: ../../sandbox-permissions.rst:427 +msgid "" +"These permission grants the app, the ability to communicate with the gvfs" +" daemon and backends running on host. Depending on the backends installed" +" or running on host, it grants the ability to list mounted devices (USB, " +"optical etc.), detach/format/eject them, mount them locally, read and " +"write data. This is usually used with network storages like WebDAV, " +"Google Drive, SMB etc. but backends exist for MTP/PTP, `USB " +"`_," +" special locations like ``trash://`` and the `local filesystem " +"`_" +" too. So the app can access, read and write data from all of these " +"locations provided the daemon and backends are installed and running on " +"host." +msgstr "" + +#: ../../sandbox-permissions.rst:441 msgid "External drive access" msgstr "" -#: ../../sandbox-permissions.rst:430 +#: ../../sandbox-permissions.rst:443 msgid "" "External drives are mounted by the host system using systemd, udev, udisk" " fstab etc. and each of them can have different defaults. Flatpak has no " @@ -1069,30 +1085,30 @@ msgid "" "permissions should work in most cases::" msgstr "" -#: ../../sandbox-permissions.rst:439 +#: ../../sandbox-permissions.rst:452 msgid "" "If ``--filesystem=host`` is used ``/media, /run/media`` is shared " "automatically if they exist." msgstr "" -#: ../../sandbox-permissions.rst:442 +#: ../../sandbox-permissions.rst:455 msgid "" "Note that these should not have subpaths in them unless the value of the " "subpath can be consistently pre-determined. Block device naming depends " "on the kernel/fstab configuration and cannot be pre-determined." msgstr "" -#: ../../sandbox-permissions.rst:447 +#: ../../sandbox-permissions.rst:460 msgid "Footnotes" msgstr "" -#: ../../sandbox-permissions.rst:448 +#: ../../sandbox-permissions.rst:461 msgid "" "This is not necessarily required, but without it the X11 shared memory " "extension will not work, which is very bad for X11 performance." msgstr "" -#: ../../sandbox-permissions.rst:450 +#: ../../sandbox-permissions.rst:463 msgid "" "Giving network access also grants access to all host services listening " "on abstract Unix sockets (due to how network namespaces work), and these " @@ -1101,7 +1117,7 @@ msgid "" "secure distribution should disable these and just use regular sockets." msgstr "" -#: ../../sandbox-permissions.rst:455 +#: ../../sandbox-permissions.rst:468 msgid "" "``xdg-{cache, config, data}`` bind mounts the paths from host to the per-" "app sandbox directory. Inside the sandbox ``$XDG_CACHE_HOME``, "