How to translate Docs

Docs are written using Latex, a widely used language used in writing technical documentation. It has some specific keywords and symbols that needs to be kept intact. Here are few simplified guidelines to get you started:

  1. Anything that begins with \ is a known as a command. Example, \textbf, \chapter, \label, \item, etc.

  2. \begin and \end are collectively known as environment. Anything inside them are part of the environment.

  3. { or [ marks the beginning and } or ] marks the ending of an argument i.e. something you supply to a function (or say, a machine). Example, \textbf{App Manager} (display App Manager is bold).

  4. While most arguments can be edited, a few cannot. Examples:

  5. \label{ch:pages}. Here the argument cannot be edited. Similar commands are \includegraphics, \includesvg, \url, \ref, etc.

  6. \hyperref[sec:main-page]{Main Page}. Here the first argument cannot be edited while the latter might be edited. Similar commands are \href, \hyperlink, \begin{name}, \end{name} where name can be anything such as itemize, tebular, etc.

  7. \caption{A caption}. Here the argument can be edited. Similar commands are \chapter, \section, \subsection, \subsubsection, \paragraph, etc.

    Use your intuition or ask question if you're confused.

Those who were part of the old team on Crowdin

You can still find your translations here: https://crowdin.com/project/app-manager-docs. Please do not edit anything there as the project has been discontinued. However, you can use it to migrate your translations on Weblate. Partially completed languages will be deleted permanently from Crowdin when a threshold is reached.

For New Contributors

Weblate does not offer membership control in their OSS license. As the platform is getting popular, more abusive behaviour is being noticed. As a result, even if you contribute to App Manager, your contribution will not be added to the project unless you submit a request via GitHub or E-Mail asserting that you've read and understood the translation policies (click the Info tab). Existing contributors will not be affected by this (but translations policies are still applicable to them).

Translation status

401 Strings 19%
Browse Translate
19,235 Words 13%
136,332 Characters 14%

Strings status

Strings Words Characters
401 19,235 136,332
All strings Browse Translate Zen
78 2,618 19,191
Translated strings Browse Translate Zen
323 16,617 117,141
Unfinished strings Browse Translate Zen
323 16,617 117,141
Untranslated strings Browse Translate Zen
12 130 974
Strings with suggestions Browse Translate Zen
312 16,558 116,668
Unfinished strings without suggestions Browse Translate Zen
29 3,121 22,420
Strings with any failing checks Browse Translate Zen
10 1,455 10,488
Translated strings with any failing checks Browse Translate Zen
1 1 43
Failing check: Unchanged translation Browse Translate Zen
1 242 1,821
Failing check: Mismatched full stop Browse Translate Zen
19 1,666 11,932
Failing check: Has been translated Browse Translate Zen
9 1,454 10,445
Failing check: Mismatching line breaks Browse Translate Zen
401 19,235 136,332
Strings without a label Browse Translate Zen

Other components

Component Approved Translated Unfinished Unfinished words Unfinished characters Untranslated Checks Suggestions Comments
Disclaimer GPL-3.0-or-later 0% 0 0 0 0 0 0 0
Main GPL-3.0-or-later 1% 0 0 0 0 6 1 0
Browse all components

Overview

Project website muntashirakon.github.io/AppManager
Instructions for translators

Translating App Manager

Some of the regular translators have complained that some new contributors are hampering their efforts by repeatedly mistranslating strings and/or translating strings without context because they do not actually use the app or are not particularly familiar with its features. Translating App Manager requires some domain-specific knowledge meaning that not everybody is able to understand the context of a string unless they are familiar with it. In the light of these events, we feel the necessity to enforce some rules and regulations to limit such abusive behaviours.

Requirements

  1. You should have an account in GitHub so that you can communicate with the other contributors should you encounter any issues or have problems understanding the context of a string.
  2. You must have some knowledge regarding Android ecosystem. For example, you must be familiar with terms such as permissions, API/SDK, components, signatures, app operations, etc.
  3. You must only translate App Manager into a language you are quite familiar with in the context that you actually use the language to communicate with people. Learning a language only theoretically may make you expert on the language, you may still lack the knowledge regarding how people actually use the language in real life. “No translation” is better than “bad translation”. While it is perfectly okay to take help from a machine, final translations should be decided by you, not the machine.

Penalties

  1. If we are convinced that you didn't fulfil the requirements above, we shall permanently block your account.

  2. If we discover any attempts of spamming or any other malicious behaviour, your account will be blocked permanently. No appeal can be made against the decision.

  3. If we find that you are involved in mistranslating a string either intentionally or due to machine translations, or involved in a translation war where you are the adversary, you're account will be blocked temporarily or permanently depending on how abusive your actions were.

  4. The use of NSFW is considered an abusive behaviour, and if you use such words in a comment in Weblate's App Manager project, you will be blocked temporarily.

    Except penalty no. 2, you can appeal against the decision using the official channels such as GitHub, Matrix or E-Mail.

Changes to the policies

Changes to the policies shall be announced via the announcements.

Effective since: 7 February 2023 Last edit: 18 September 2023 (Replaced Telegram with Matrix)
Project maintainers User avatar muntashir
Translation license GNU General Public License v3.0 or later
Translation process
  • Translations can be made directly.
  • Translation suggestions can be made.
  • Any authenticated user can contribute.
  • The translation uses monolingual files.
  • The translation base language is editable.
Source code repository https://github.com/MuntashirAkon/AppManager.git
Repository branch master
Last remote commit [ADB] Add a "manual" option in the pairing dialog prompt 0a05a3844
User avatar muntashir authored yesterday
Last commit in Weblate [Locale] Update translation for Portuguese 2bb8276b7
User avatar cairobraga authored 5 days ago
Weblate repository https://hosted.weblate.org/git/app-manager/main/
File mask docs/raw/*/strings.xml
Monolingual base language file docs/raw/en/strings.xml
Translation file Download docs/raw/ru/strings.xml
Last change Nov. 14, 2024, 6:28 p.m.
Last change made by None
Language Russian
Language code ru
Text direction Left to right
Number of speakers 193,498,207
Number of plurals 3
Plural type One/few/many
Plurals One 1, 21, 31, 41, 51, 61, 71, 81, 91, 101, …
Few 2, 3, 4, 22, 23, 24, 32, 33, 34, 42, …
Many 0, 5, 6, 7, 8, 9, 10, 11, 12, 13, …
Plural formula n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2
2 weeks ago

String statistics

Strings percent Hosted strings Words percent Hosted words Characters percent Hosted characters
Total 401 19,235 136,332
Translated 19% 78 13% 2,618 14% 19,191
Needs editing 0% 0 0% 0 0% 0
Read-only 0% 0 0% 0 0% 0
Failing checks 7% 29 16% 3,121 16% 22,420
Strings with suggestions 2% 12 1% 130 1% 974
Untranslated strings 80% 323 86% 16,617 85% 117,141
Last 12 months Previous

Activity in last 12 months

2 changes 3 changes 12 changes 0 changes 13 changes 0 changes 87 changes 0 changes 1 change 2 changes 42 changes 0 changes 4 changes 0 changes 49 changes 0 changes 0 changes 0 changes 38 changes 12 changes 1 change 90 changes 0 changes 5 changes
DecJanFebMarAprMayJunJulAugSepOctNov

Quick numbers

19,235
Hosted words
401
Hosted strings
19%
Translated
0
Contributors
and previous 30 days

Trends of last 30 days

—
Hosted words
+100%
—
Hosted strings
+100%
+1%
Translated
+19%
—
Contributors
—
User avatar None

Changes committed
Changes committed a month ago
User avatar Vladik01-11

Translation changed
At present, the supported versions are v3.1.7 and v4.0.0 (stable), v4.1.0 (alpha and debug releases).
Previous versions of App Manager may contain security vulnerabilities and should not be used.
Сейчас поддерживаемые версии это v3.0.01.7 -- v3.0.3 4.0.0 (стабильные), v34.1.0 (альфа релизы). Предыдущие версии App

Manager могут содержать уязвимости безопасности и не должны быть использованы.
a month ago
User avatar Vladik01-11

Contributor joined
Contributor joined a month ago
User avatar None

Resource updated
The “docs/raw/ru/strings.xml” file was changed. a month ago
User avatar None

String updated in the repository
At present, the supported versions are v3.1.7 and v4.0.0 (stable), v4.1.0 (alpha and debug releases).
Previous versions of App Manager may contain security vulnerabilities and should not be used.
Сейчас поддерживаемые версии это v3.0.0 -- v3.0.3 (стабильные), v3.1.0 (альфа релизы). Предыдущие версии App

Manager могут содержать уязвимости безопасности и не должны быть использованы.
a month ago
User avatar None

Changes committed
Changes committed 2 months ago
User avatar None

Resource updated
The “docs/raw/ru/strings.xml” file was changed. 2 months ago
User avatar None

String updated in the repository
Short for \textbf{Network policy} or network policies.
It is usually located in the Android settings under \textbf{Mobile data \& Wifi} section in the app info page of an app.
Not all policies are guaranteed to be included in this page (e.g.\ Samsung), and not all settings are well-understood due to lack of documentation.
App Manager can display all the net policies declared in the \href{https://android.googlesource.com/platform/frameworks/base/+/master/core/java/android/net/NetworkPolicyManager.java}{NetworkPolicyManager}.
Policies unknown to App Manager will have a \textit{Unknown} prefix along with the policy constant name and number in the hexadecimal format.
Unknown policies should be reported to App Manager for inclusion.

Net policy allows a user to configure certain networking behaviour of an app without modifying the ip tables directly and/or running a firewall app.
However, the features it offers largely depend on Android version and ROM. A list of known net policies are listed below:

\begin{enumerate}
\item \textbf{None} or \textbf{\texttt{POLICY\_NONE}}: (AOSP) No specific network policy is set.
System can still assign rules depending on the nature of the app.

\item \textbf{Reject background data on metered networks} or \textbf{\texttt{POLICY\_REJECT\_METERED\_BACKGROUND}}: (AOSP) Reject network usage on metered networks when the application is in background.

\item \textbf{Allow background data on metered networks even when Data Saver is on} or \textbf{\texttt{POLICY\_ALLOW\_METERED\_BACKGROUND}}: (AOSP) Allow metered network use in the background even when data saving mode is enabled.

\item \textbf{Reject cellular data} or \textbf{\texttt{POLICY\_REJECT\_CELLULAR}} (Android 11+) or \textbf{\texttt{POLICY\_REJECT\_ON\_DATA}} (up to Android 10): (Lineage OS) Reject mobile/cellular data.
Signals network unavailable to the configured app as if the mobile data is inactive.

\item \textbf{Reject VPN data} or \textbf{\texttt{POLICY\_REJECT\_VPN}} (Android 11+) or \textbf{\texttt{POLICY\_REJECT\_ON\_VPN}} (up to Android 10): (Lineage OS) Reject VPN data.
Signals network unavailable to the configured app as if the VPN is inactive.

\item \textbf{Reject Wi-Fi data} or \textbf{\texttt{POLICY\_REJECT\_WIFI}} (Android 11+) or \textbf{\texttt{POLICY\_REJECT\_ON\_WLAN}} (up to Android 10): (Lineage OS) Reject Wi-Fi data.
Signals network unavailable to the configured app as if the device is not connected to a Wi-Fi network.

\item \textbf{Disable network access} or \textbf{\texttt{POLICY\_REJECT\_ALL}} (Android 11+) or \textbf{\texttt{POLICY\_NETWORK\_ISOLATED}} (up to Android 10): (Lineage OS) Reject network access in all circumstances.
This is not the same as enforcing the other three policies above, and is the recommended policy for dodgy apps.
If this policy is enforced, there is no need to enforce the other policies.

\item \textbf{\texttt{POLICY\_ALLOW\_METERED\_IN\_ROAMING}}: (Samsung) Possibly allow metered network use during roaming.
Exact meaning is currently unknown.

\item \textbf{\texttt{POLICY\_ALLOW\_WHITELIST\_IN\_ROAMING}}: (Samsung) Possibly allow network use during roaming.
Exact meaning is currently unknown.

\item \textbf{Reject data on metered networks} or \textbf{\texttt{POLICY\_REJECT\_METERED}}: (Motorola) Reject network usage if it is a metered network.

\item \textbf{Reject background data} or \textbf{\texttt{POLICY\_REJECT\_BACKGROUND}}: (Motorola) Reject network usage in the background.

\item \textbf{Disable network access} or \textbf{\texttt{POLICY\_REJECT\_ALL}}: (Motorola) Reject network access altogether.
Like Lineage OS, it blocks internet connections via iptables. But whether it signals the unavailability of network to the configured app is not known.
\end{enumerate}

\begin{tip}{Note}
Corresponding Lineage OS patches are as follows:
\begin{enumerate}
\item \href{https://github.com/LineageOS/android\_frameworks\_base/commit/a04932bafbbf7d99efd18276152cc2c9c9b2073e}{fw/b: Squash of app fw restriction commits}
\item \href{https://github.com/LineageOS/android\_frameworks\_base/commit/02c8c82854348f52afe2199f310f44b5f578b5b8}{fw/b: Add support for per app network isolation}
\end{enumerate}
\end{tip}
 
2 months ago
User avatar None

String updated in the repository
Backup options (internally known as backup flags) let you customise the backups on the fly.
However, the customisations will not be remembered for the future backups.
If you want to customise this dialog, use \hyperref[subsubsec:settings-backup-options]{Backup Options} in the \hyperref[sec:settings-page]{Settings page}.

A complete description of the backup options is given below:
\begin{itemize}
\item \textbf{APK files.} Whether to back up the APK files.
This includes the \textit{base APK} file along with the \texttt{split APK} files if they exist.

\item \textbf{Internal data.} Whether to back up the internal data directories.
These directories are located at \texttt{/data/user/<user\_id>} and (for Android N or later) \texttt{/data/user\_de/<user\_id>}.

\item \textbf{External data.} Whether to back up data directories located in the internal memory as well as SD Card (if exists).
External data directories often contain non-essential app data or media files (instead of using the dedicated media folder) and may increase the backup size.
However, it might be essential for some apps.
Although it isn't checked by default (as it might dramatically increase the size of the backups), you may have to check it in order to ensure a smooth restore of your backups.
\begin{warning}{Caution}
Internal data folders should always be backed up if you are going to back up the external data folders.
However, it could be useful to back up only the external folders if the app in question downloads a lot of assets from the Internet.
\end{warning}

\item \textbf{OBB and media.} Whether to back up or restore the OBB and the media directories located in the
external storage or the SD Card.
This is useful for games and the graphical software which actually use these folders.

\item \textbf{Cache.} Android apps have multiple cache directories located at every data directories (both internal and external).
There are two types of cache: \textbf{cache} and \textbf{code cache}.
Disabling this option excludes both cache directories from all the data directories.
It is generally advised to exclude cache directories since most apps do not clear the cache regularly and usually handled by the OS itself.
Apps such as Telegram may use a very large cache (depending on the storage space) which may dramatically increase the backup size.
When it is disabled, AM also ignores the \textbf{no\_backup} directories.

\item \textbf{Extras.} Backup/restore app permissions, net policy, battery optimization, SSAID, etc., enabled by default.
Note that, blocking rules are applied \textit{after} applying the extras.
So, if an item is present in both places, it will be overwritten (i.e., the one from the blocking rules will be used).

\item \textbf{Rules.} This option lets you back up blocking rules configured within App Manager.
This might come in handy if you have customised permissions or block some components using App Manager as they will
also be backed up or restored when you enable this option.

\item \textbf{Backup Multiple.} Whether this is a multiple backup.
By default, backups are saved using their user ID\@.
Enabling this option allows you to create additional backups.
These backups use the current date-time as the default backup name, but you can also specify custom backup name
using the input field displayed when you click on the \textbf{Backup} button.

\item \textbf{Custom users.} Backup or restore for the selected users instead of only the current user.
This option is only displayed if the system has more than one user.

\item \textbf{Skip signature checks.} When taking a backup, checksum of every file (as well as the signing
certificate(s) of the base APK file) is generated and stored in the \texttt{checksums.txt} file.
When you restore the backup, the checksums are generated again and are matched with the checksums stored in the said file.
Enabling this option will disable the signature checks.
This option is applied only when you restore a backup.
During backup, the checksums are generated regardless of this option.
\begin{warning}{Caution}
You should always disable this option to ensure that your backups are not modified by any third-party applications.
However, this would only work if you enabled encryption.
\end{warning}
\end{itemize}

\seealsoinline{\hyperref[subsubsec:settings-encryption]{Settings: Encryption}}
 
2 months ago
User avatar None

String added in the repository
Depending on the device and the version of operating system, you have to enable \textbf{Disable Permission Monitoring}.
 
2 months ago
Browse all translation changes