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 53%
Browse Translate
19,235 Words 34%
136,332 Characters 35%

Strings status

Strings Words Characters
401 19,235 136,332
All strings Browse Translate Zen
215 6,724 48,627
Translated strings Browse Translate Zen
186 12,511 87,705
Unfinished strings Browse Translate Zen
186 12,511 87,705
Untranslated strings Browse Translate Zen
186 12,511 87,705
Unfinished strings without suggestions Browse Translate Zen
8 2,862 20,586
Strings with any failing checks Browse Translate Zen
8 2,862 20,586
Translated strings with any failing checks Browse Translate Zen
13 2,097 15,637
Translated strings with dismissed checks Browse Translate Zen
1 242 1,821
Failing check: Mismatched full stop Browse Translate Zen
7 2,620 18,765
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 0% 0 0 0 0 0 0 0
Main GPL-3.0 1% 0 0 0 0 0 54 2
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 [Docs] Update documentation d3995a789
User avatar muntashir authored 2 weeks ago
Last commit in Weblate [Locale] Update translation for French 186485342
User avatar acress1 authored yesterday
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/zh-rCN/strings.xml
Last change Oct. 18, 2024, 12:16 a.m.
Last change made by None
Language Chinese (Simplified Han script)
Language code zh_Hans
Text direction Left to right
Number of speakers 1,266,066,359
Number of plurals 1
Plural type None
Plurals
Plural formula 0
2 weeks ago

String statistics

Strings percent Hosted strings Words percent Hosted words Characters percent Hosted characters
Total 401 19,235 136,332
Translated 53% 215 34% 6,724 35% 48,627
Needs editing 0% 0 0% 0 0% 0
Read-only 0% 0 0% 0 0% 0
Failing checks 1% 8 14% 2,862 15% 20,586
Strings with suggestions 0% 0 0% 0 0% 0
Untranslated strings 46% 186 65% 12,511 64% 87,705
Last 12 months Previous

Activity in last 12 months

0 changes 0 changes 2 changes 5 changes 0 changes 0 changes 4 changes 0 changes 75 changes 0 changes 1 change 12 changes 10 changes 0 changes 2 changes 0 changes 10 changes 3 changes 0 changes 0 changes 1 change 0 changes 0 changes 98 changes
Nov Dec Jan Feb Mar Apr May Jun Jul Aug Sep Oct

Quick numbers

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

Trends of last 30 days

+5%
Hosted words
+100%
+4%
Hosted strings
+100%
−2%
Translated
+56%
+100%
Contributors
—
User avatar None

Changes committed
Changes committed 2 weeks ago
User avatar hamburger2048

Translation changed
Configure in-app language. App Manager currently supports 22 (twenty-two) languages.
配置应用内语言。App Manager 目前支持 212 种语言。
2 weeks ago
User avatar hamburger2048

Translation changed
Import/Export Blocking Rules
导入/导出阻止拦截规则
2 weeks ago
User avatar hamburger2048

Translation changed
Blocking Trackers.
阻止拦截跟踪器。
2 weeks ago
User avatar hamburger2048

Translation changed
Blocking Components.
阻止拦截组件。
2 weeks ago
User avatar None

Resource updated
The “docs/raw/zh-rCN/strings.xml” file was changed. 2 weeks 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 weeks 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 weeks 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 weeks ago
User avatar None

String added in the repository
OnePlus (Oxygen OS)
 
2 weeks ago
Browse all translation changes