Merge branch 'develop' into claude/add-reset-compare-view-Shz6L

Author: ybeapps

README.md

@@ -64,10 +64,6 @@
 > [!WARNING]
 > **Linux** only tested on **Debian 12** on both **X11** & **Wayland**.
 
-## Translation Status
-
-You can find the current translation status in [TRANSLATION.md](https://github.com/sourcegit-scm/sourcegit/blob/develop/TRANSLATION.md)
-
 ## How to Use
 
 **To use this tool, you need to install Git(>=2.25.1) first.**
@@ -84,7 +80,7 @@ This software creates a folder `$"{System.Environment.SpecialFolder.ApplicationD
 
 > [!TIP]
 > * You can open this data storage directory from the main menu `Open Data Storage Directory`.
-> * 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.
+> * 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.
 
 For **Windows** users:
 
@@ -148,6 +144,16 @@ For **Linux** users:
 * Maybe you need to set environment variable `AVALONIA_SCREEN_SCALE_FACTORS`. See https://github.com/AvaloniaUI/Avalonia/wiki/Configuring-X11-per-monitor-DPI.
 * If you can NOT type accented characters, such as `ê`, `ó`, try to set the environment variable `AVALONIA_IM_MODULE` to `none`.
 
+## Commandline arguments
+
+Users can also launcher `SourceGit` from commandline. Usage:
+
+```
+<SOURCEGIT_EXEC> <DIR>                       // Open repository in existing `SourceGit` instance or a new one
+<SOURCEGIT_EXEC> --file-history <FILE_PATH>  // Launch `SourceGit` to see the history of a file
+<SOURCEGIT_EXEC> --blame <FILE_PATH>         // Launch `SourceGit` to blame a file (HEAD version only) 
+```
+
 ## OpenAI
 
 This software supports using OpenAI or other AI service that has an OpenAI compatible HTTP API to generate commit message. You need configurate the service in `Preference` window.
@@ -234,6 +240,27 @@ Thanks to all the people who contribute.
 
 [![Contributors](https://contrib.rocks/image?repo=sourcegit-scm/sourcegit&columns=20)](https://github.com/sourcegit-scm/sourcegit/graphs/contributors)
 
+## Translation Status
+
+You can find the current translation status in [TRANSLATION.md](https://github.com/sourcegit-scm/sourcegit/blob/develop/TRANSLATION.md)
+
+### Translate Utility Script
+
+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.
+
+#### Usage
+
+Check for a given language (e.g., `pt_BR`) and optionally check for missing translations:
+
+```bash
+python translate_helper.py pt_BR [--check]
+```
+
+- `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.
+- `--check` is an optional flag used to only check for missing keys without prompting for translations, useful for getting a list of missing translations.
+
+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.
+
 ## Third-Party Components
 
 For detailed license information, see [THIRD-PARTY-LICENSES.md](THIRD-PARTY-LICENSES.md).

THIRD-PARTY-LICENSES.md

@@ -7,14 +7,14 @@ The project uses the following third-party libraries or assets
 ### AvaloniaUI
 
 - **Source**: https://github.com/AvaloniaUI/Avalonia
-- **Version**: 11.3.9
+- **Version**: 11.3.11
 - **License**: MIT License
 - **License Link**: https://github.com/AvaloniaUI/Avalonia/blob/master/licence.md
 
 ### AvaloniaEdit
 
 - **Source**: https://github.com/AvaloniaUI/AvaloniaEdit
-- **Version**: 11.3.0
+- **Version**: 11.4.0-rc1
 - **License**: MIT License
 - **License Link**: https://github.com/AvaloniaUI/AvaloniaEdit/blob/master/LICENSE
 
@@ -28,7 +28,7 @@ The project uses the following third-party libraries or assets
 ### TextMateSharp
 
 - **Source**: https://github.com/danipen/TextMateSharp
-- **Version**: 1.0.70
+- **Version**: 2.0.2
 - **License**: MIT License
 - **License Link**: https://github.com/danipen/TextMateSharp/blob/master/LICENSE.md