Localizing Mac Mouse Fix #731
Replies: 6 comments 9 replies
-
|
Hi Noah, I can help you in translating to 🇻🇳 Vietnamese |
Beta Was this translation helpful? Give feedback.
-
|
Hi @nghlt, that would be great, thank you very much! I just updated the Guide if you want to take another look. I hope it serves as a good starting point for translating the app. If you have any more questions or concerns, let me know. |
Beta Was this translation helpful? Give feedback.
This comment has been hidden.
This comment has been hidden.
-
|
Hi @noah-nuebling , I can help you in translating to Brazilian Portuguese 🇧🇷 ? |
Beta Was this translation helpful? Give feedback.
-
|
Hey @denini08, thanks for the offer! And I'm sorry for the late reply. The localization system is currently being reworked and so it's not the best time to contribute localizations. But in case you're still interested, I can let you know when the app is ready to take new contributions. |
Beta Was this translation helpful? Give feedback.
-
please let me know |
Beta Was this translation helpful? Give feedback.
-
|
Hey guys! The new localization system is finally ready. It's much better and easier now to add really high-quality translations I think. There are already Brazilian Portuguese translations, but a lot is still missing or 'needs review' as well, so your input would be very helpful! |
Beta Was this translation helpful? Give feedback.
-
|
@noah-nuebling working on that. |
Beta Was this translation helpful? Give feedback.
-
|
Hello @noah-nuebling, I'd like to contribute to Mac Mouse Fix by translating it into some languages: 🇦🇩 Catalan I understand localization isn't supported right now, but please feel free to contact me when it's ready again. Many thanks for creating such an invaluable tool for macOS users. Kind regards, |
Beta Was this translation helpful? Give feedback.
-
|
Dear Noah, first off, amazing name. Secondly, thank you for the offer! The localization system is finally done now, and having your input on 🇦🇩 Catalan, 🇫🇷 French, and 🇪🇸 Spanish would be awesome. I made a very short guide that should let you start translating in under a minute.
|
Beta Was this translation helpful? Give feedback.
-
|
Hi Noah, I'd like to contribute to translations and help with Indonesia Translations. Could you please let me know when I can support with the translations? Thanks! |
Beta Was this translation helpful? Give feedback.
-
|
Hello there @sipamungkas, The dayyy has come! The new localization system is finally done now. And you can get started here. I'd love to have 🇮🇩 Indonesian support in the app. So thank you for your offer :) |
Beta Was this translation helpful? Give feedback.
-
|
sure!! let me start this |
Beta Was this translation helpful? Give feedback.
-
|
Hello @noah-nuebling, I'd like to contribute to Mac Mouse Fix by translating it into Russian (ru-RU). Thank you for creating such a helpful tool for macOS users! Kind regards, |
Beta Was this translation helpful? Give feedback.
-
|
Dear Artur, Thank you very much for your compliment, and your translation offer! A fellow by the name of ETMH has already done all of the translations into Russian. I hope that's not a disappointment! You're very welcome to do a review and improve anything you find. (With so much text there are always going to be little things to improve.) Or in the future when there are new features to translate, I can also inform you if you'd like. You can inspect / edit the current Russian translations here. Thanks again! |
Beta Was this translation helpful? Give feedback.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
-
Warning
The translation system has been overhauled - Do not follow the instructions in this document.
Instructions for the new translation system can be found here.
Mac Mouse Fix 3 and later can be translated into different languages.
I already translated Mac Mouse Fix into German, my native language, and now you can translate it into your language, too!
In this Guide, you will learn how to add a language to Mac Mouse Fix and how to help keep Mac Mouse Fix's translations up-to-date.
Adding New Languages
To add a new language to the project, follow these steps:
Adding a Language to the App
noah-nuebling/mac-mouse-fixrepository on GitHub, then clone the fork to your computer.mac-mouse-fix) and open the Xcode project..stringsand.stringsdictfiles throughout the project.Tip: Open the
mac-mouse-fixfolder in Finder, then search for folders ending with.lproj, to find all the.stringsand.stringsdictfiles.Adding a Language to the Website
noah-nuebling/mac-mouse-fix-websiterepository on GitHub, then clone the fork to your computer.mac-mouse-fix-website) and opennuxt.config.tsnuxt.config.ts > i18n > locales.mac-mouse-fix-website > localesfolder and create a copy ofen-US.js, then rename it to<Your language ID>.jsand put your translations inside it.mac-mouse-fix-website > Readme.mdAdding a Language to the GitHub
noah-nuebling/mac-mouse-fixrepository on GitHub, then clone the fork to your computer.mac-mouse-fix) and openMarkdown > Code > markdown_generator.py.markdown_generator.py > languages = { ....mac-mouse-fix > Markdown > Templatesand create a copy of theen-USfolder. Rename it to<Your language ID>. This folder contains templates for different markdown documents, such asreadme_template.mdandacknowledgements_template.md. Translate each of these templates and then compile the documents.mac-mouse-fix > Markdown > MarkdownReadme.md.The steps here are very high-level and it's totally normal if you're confused about something! Especially if you're not familiar with Xcode and git. If you have any questions, just ask down below and I'll do my best to help.
If you only want to translate part of the project, for example only the app, but not the GitHub Readme, that's also totally fine.
For the translations, I highly recommend using ChatGPT and then refining its results. It's been a huge boost to the quality and efficiency of my German translations.
And that's it! If your translation is added to the project, of course you'll be credited as a contributor in the Acknowledgements.
Updating Translation Files
As I keep changing and adding to the text in Mac Mouse Fix, existing translations might become outdated.
The localization system attempts to automatically detect any such problems and list them in the "🌏 State of Localization 🌎" comment below.
Tip
To help resolve localization problems:
Find a file to update
Go to the "🌏 State of Localization 🌎" comment below, then go to the section of a file with problems that you want to resolve.
Start editing the file
Click the link for the translation of the file you want to update. This will open the GitHub page of the file.
Now click the edit button in the top right. (The little pen icon) Finally click on 'Fork this repository'.
Now you can make changes to the file!
Fix any problems with your file
Go through the potential problems for your file that are listed in the "🌏 State of Localization 🌎" comment, and fix them.
Note on
!IS_OKflagIf you decide that a key-value-pair which is listed in the "🌏 State of Localization 🌎" is okay as it is and the value doesn't need to be updated, you can tell the localization system about this by adding a comment saying
!IS_OKafter the key-value pair. This will make it so the key-value-pair will not show up as a problem in the "🌏 State of Localization 🌎" anymore even if the value wasn't updated.For example, if the key-value pair is
"some.key" = "Some Translated UI Text";you can update it to
"some.key" = "Some Translated UI Text"; // !IS_OKTo mark it as currently ok.
If you find that there's already a comment saying
!IS_OK, you can tell the localization system that the key-value-pair is currently still ok, by adding another!.For example, if the key-value pair is
'some.key': 'Some Translated UI Text', // !IS_OKyou can update it to
'some.key': 'Some Translated UI Text', // !!IS_OKTo mark it as still ok
For translation files that don't contain key-value-pairs (Such a the
.mdand.stringsdictfiles), there is currently no way to mark them as ok to the localization system. But their entries shouldn't take up much space in the "🌏 State of Localization 🌎".Share your work
When you're done with your updates to the file, click 'Commit changes...' in the top-right. Then click 'Propose changes' and then click 'Create pull request'.
And that's it! Now your updates will be visible to me and I can accept them as changes into Mac Mouse Fix.
If your changes are accepted, you will be listed as a contributor of Mac Mouse Fix on GitHub, and I will shout you out in the next update notes.
Note that these instructions are for making your updates right in the browser on GitHub.com. If you are familiar with programming and git, or if you want to make more complex changes, you might want to make the changes locally on your computer. This requires some familiarity with git. The basic steps are: 1. Fork 2. Clone 3. Make your updates locally in Xcode 4. Build the app to test your translations in action 5. Commit 6. Push 7. Create a Pull Request.
If you have any questions, let me know, in a comment below.
Beta Was this translation helpful? Give feedback.
All reactions