diff options
| author | AlexanderCurl <alexc@alexc.hu> | 2026-04-18 17:46:06 +0100 |
|---|---|---|
| committer | AlexanderCurl <alexc@alexc.hu> | 2026-04-18 17:46:06 +0100 |
| commit | 70ca3fef77ee8bdc6e3ac28589a6fa08c024cc69 (patch) | |
| tree | ab1123d4067c1b086dd6faa7ee4ea643236b565a /raveos-hyprland-theme/theme-data/DankMaterialShell/quickshell/translations/README.md | |
| parent | 5d94c0a7d44a2255b81815a52a7056a94a39842d (diff) | |
| download | RaveOS-PKGBUILD-70ca3fef77ee8bdc6e3ac28589a6fa08c024cc69.tar.gz RaveOS-PKGBUILD-70ca3fef77ee8bdc6e3ac28589a6fa08c024cc69.zip | |
Replaced file structures for themes in the correct format
Diffstat (limited to 'raveos-hyprland-theme/theme-data/DankMaterialShell/quickshell/translations/README.md')
| -rw-r--r-- | raveos-hyprland-theme/theme-data/DankMaterialShell/quickshell/translations/README.md | 64 |
1 files changed, 64 insertions, 0 deletions
diff --git a/raveos-hyprland-theme/theme-data/DankMaterialShell/quickshell/translations/README.md b/raveos-hyprland-theme/theme-data/DankMaterialShell/quickshell/translations/README.md new file mode 100644 index 0000000..19fc178 --- /dev/null +++ b/raveos-hyprland-theme/theme-data/DankMaterialShell/quickshell/translations/README.md @@ -0,0 +1,64 @@ +# DankMaterialShell Translations + +This directory contains translation files for DankMaterialShell extracted from all qsTr() calls in the QML codebase. + +## Files + +- **en.json** - Source language file with English strings and file references +- **template.json** - Empty template for creating new translations +- **extract_translations.py** - Script to regenerate translation files + +## POEditor Format + +The JSON files follow POEditor's import format: + +```json +[ + { + "term": "string to translate", + "context": "file:line", + "reference": "Modules/Settings/AboutTab.qml:45", + "comment": "" + } +] +``` + +### Field Descriptions + +- **term**: The source string in English (from qsTr() calls) +- **context**: Primary location where the string appears (file:line) +- **reference**: All locations where this string is used (comma-separated) +- **comment**: Additional notes for translators (currently empty) + +## How to Create a New Translation + +1. Copy `template.json` to your language code (e.g., `es.json` for Spanish) +2. Fill in the `translation` field for each entry: + ```json + { + "term": "Settings", + "translation": "Configuración", + "context": "Modals/Settings/SettingsModal.qml:147", + "reference": "Modals/Settings/SettingsModal.qml:147", + "comment": "" + } + ``` +3. Import to POEditor or use directly in your translation workflow + +## Regenerating Translation Files + +To update the translation files after code changes: + +```bash +cd /home/brandon/.config/quickshell/DankMaterialShellGit/translations +./extract_translations.py +``` + +This will scan all QML files and regenerate `en.json` and `template.json`. + +## Notes + +- Strings are deduplicated - if the same string appears in multiple locations, references are merged +- File paths are relative to the project root +- Line numbers are preserved for accurate context +- Empty strings and comments are reserved for translator notes |