|
64 | 64 | > [!WARNING] |
65 | 65 | > **Linux** only tested on **Debian 12** on both **X11** & **Wayland**. |
66 | 66 |
|
67 | | -## Translation Status |
68 | | - |
69 | | -You can find the current translation status in [TRANSLATION.md](https://github.com/sourcegit-scm/sourcegit/blob/develop/TRANSLATION.md) |
70 | | - |
71 | | -### Translate Utility Script |
72 | | - |
73 | | -A script that assists with translations by reading the target language, comparing it with the base language, and going through missing keys one by one, so the translator can provide the translations interactively without needing to check each key manually. |
74 | | - |
75 | | -#### Usage |
76 | | - |
77 | | -Check for a given language (e.g., `pt_BR`) and optionally check for missing translations: |
78 | | - |
79 | | -```bash |
80 | | -python translate_helper.py pt_BR [--check] |
81 | | -``` |
82 | | - |
83 | | -- `pt_BR` is the target language code (change as needed), it should correspond to a file named `pt_BR.axaml` in the `src/Resources/Locales/` directory, so you can replace it with any other language code you want to translate, e.g., `de_DE`, `es_ES`, etc. |
84 | | -- `--check` is an optional flag used to only check for missing keys without prompting for translations, useful for getting a list of missing translations. |
85 | | - |
86 | | -The script will read the base language file (`en_US.axaml`) and the target language file (e.g., `pt_BR.axaml`), identify missing keys, and prompt you to provide translations for those keys. If the `--check` flag is used, it will only list the missing keys without prompting for translations. |
87 | | - |
88 | 67 | ## How to Use |
89 | 68 |
|
90 | 69 | **To use this tool, you need to install Git(>=2.25.1) first.** |
91 | 70 |
|
92 | 71 | You can download the latest stable from [Releases](https://github.com/sourcegit-scm/sourcegit/releases/latest) or download workflow artifacts from [GitHub Actions](https://github.com/sourcegit-scm/sourcegit/actions) to try this app based on latest commits. |
93 | 72 |
|
94 | | -This software creates a folder `$"{System.Environment.SpecialFolder.ApplicationData}/SourceGit"`, which is platform-dependent, to store user settings, downloaded avatars and crash logs. |
| 73 | +This software creates a folder, which is platform-dependent, to store user settings, downloaded avatars and crash logs. |
95 | 74 |
|
96 | | -| OS | PATH | |
97 | | -|---------|-----------------------------------------------------| |
98 | | -| Windows | `%APPDATA%\SourceGit` | |
99 | | -| Linux | `${HOME}/.config/SourceGit` or `${HOME}/.sourcegit` | |
100 | | -| macOS | `${HOME}/Library/Application Support/SourceGit` | |
| 75 | +| OS | PATH | |
| 76 | +|---------|-------------------------------------------| |
| 77 | +| Windows | `%APPDATA%\SourceGit` | |
| 78 | +| Linux | `~/.sourcegit` | |
| 79 | +| macOS | `~/Library/Application Support/SourceGit` | |
101 | 80 |
|
102 | 81 | > [!TIP] |
103 | 82 | > * You can open this data storage directory from the main menu `Open Data Storage Directory`. |
104 | | -> * You can create a `data` folder next to the `SourceGit` executable to force this app to store data (user settings, downloaded avatars and crash logs) into it (Portable-Mode). Only works on Windows. |
| 83 | +> * You can create a `data` folder next to the `SourceGit` executable to force this app to store data (user settings, downloaded avatars and crash logs) into it (Portable-Mode). Only works with Windows packages and Linux AppImages. |
105 | 84 |
|
106 | 85 | For **Windows** users: |
107 | 86 |
|
@@ -261,6 +240,27 @@ Thanks to all the people who contribute. |
261 | 240 |
|
262 | 241 | [](https://github.com/sourcegit-scm/sourcegit/graphs/contributors) |
263 | 242 |
|
| 243 | +## Translation Status |
| 244 | + |
| 245 | +You can find the current translation status in [TRANSLATION.md](https://github.com/sourcegit-scm/sourcegit/blob/develop/TRANSLATION.md) |
| 246 | + |
| 247 | +### Translate Utility Script |
| 248 | + |
| 249 | +A script that assists with translations by reading the target language, comparing it with the base language, and going through missing keys one by one, so the translator can provide the translations interactively without needing to check each key manually. |
| 250 | + |
| 251 | +#### Usage |
| 252 | + |
| 253 | +Check for a given language (e.g., `pt_BR`) and optionally check for missing translations: |
| 254 | + |
| 255 | +```bash |
| 256 | +python translate_helper.py pt_BR [--check] |
| 257 | +``` |
| 258 | + |
| 259 | +- `pt_BR` is the target language code (change as needed), it should correspond to a file named `pt_BR.axaml` in the `src/Resources/Locales/` directory, so you can replace it with any other language code you want to translate, e.g., `de_DE`, `es_ES`, etc. |
| 260 | +- `--check` is an optional flag used to only check for missing keys without prompting for translations, useful for getting a list of missing translations. |
| 261 | + |
| 262 | +The script will read the base language file (`en_US.axaml`) and the target language file (e.g., `pt_BR.axaml`), identify missing keys, and prompt you to provide translations for those keys. If the `--check` flag is used, it will only list the missing keys without prompting for translations. |
| 263 | + |
264 | 264 | ## Third-Party Components |
265 | 265 |
|
266 | 266 | For detailed license information, see [THIRD-PARTY-LICENSES.md](THIRD-PARTY-LICENSES.md). |
0 commit comments