Improve Italian translation

[CristianCantoro]

I am working on the Italian translation. The only file that still needs to be translated (completely) is unicode-full.yaml. This PR does the following:

• Translate ClearSpeak_Rules.yaml, unicode.yaml
• Revise navigate.yaml, definitions.yaml, SimpleSpeak_Rules.yaml
• Revise SharedRules for Italian

I have read the "Translator and Rule Developer Guide" and I am going to implement some tests in Rust. I would also like to try out the translations, but I am not an NVDA user, how can I try them out in another way? FYI, I am working on an Ubuntu Linux machine.

Also, I was wondering if the current files that I have translated are up to date. For example, I have compared the file in it/SharedRules/calculus.yaml with the latest version of en/SharedRules/calculus.yaml and they are different.

[NSoiffer]

Wow, you're make great progress!

I don't know when the Italian branch was created. I just looked and sadly, it is pretty far behind. I've been working on moving the "simple" rules to be declarative and listed in definitions.yaml. You can try, when you are in the "it" branch, "git merge main". You should update your fork first before doing the merge. Hopefully there aren't too many merge conflicts. If there aren't many conflicts and you can resolve them (basically accept everything that is incoming except things in the "it" branch), then update with that. After doing that, compare en/definitions.yaml with your version and bring in the new stuff. Lot's of things about units but also IntentMappings and NavigationParts definitions among other things. You'll be able to delete any of the rules listed in IntentMappings. You don't need to do this now if you don't want to, but at some point you'll need to do it to be up to date.

I'm hopeful I'll get help from some other people with a tool that makes is easier to keep the non-English versions synced with the English versions. Right now, it is time consuming.

As for testing the speech, running the tests is the easiest way to see if the speech is correct. Once you have something that you think is good enough, I can build a new https://nsoiffer.github.io/MathCATDemo/ that includes Italian and that's an easy way to try some things out. It's not hard to learn a few basic commands for NVDA (but it does require windows). That allows you to visit websites, etc., and listen to the math in context.

Are you a JAWS user? There might be a way to hack JAWS to use the Italian translation. I can take a look to see if it is possible (maybe by claiming the Italian is English).

[CristianCantoro]

@NSoiffer wrote:

I don't know when the Italian branch was created. I just looked and sadly, it is pretty far behind. I've been working on moving the "simple" rules to be declarative and listed in definitions.yaml. You can try, when you are in the "it" branch, "git merge main". You should update your fork first before doing the merge. Hopefully there aren't too many merge conflicts. If there aren't many conflicts and you can resolve them (basically accept everything that is incoming except things in the "it" branch), then update with that. After doing that, compare en/definitions.yaml with your version and bring in the new stuff. Lot's of things about units but also IntentMappings and NavigationParts definitions among other things. You'll be able to delete any of the rules listed in IntentMappings. You don't need to do this now if you don't want to, but at some point you'll need to do it to be up to date.

I will merge the latest version, solve the conflicts and submit a new PR.

As for testing the speech, running the tests is the easiest way to see if the speech is correct. Once you have something that you think is good enough, I can build a new https://nsoiffer.github.io/MathCATDemo/ that includes Italian and that's an easy way to try some things out. It's not hard to learn a few basic commands for NVDA (but it does require windows). That allows you to visit websites, etc., and listen to the math in context.

Are you a JAWS user? There might be a way to hack JAWS to use the Italian translation. I can take a look to see if it is possible (maybe by claiming the Italian is English).

No, I’m not using NVDA or JAWS. From what I understand, both NVDA (website) and JAWS (website) are Windows-only programs. I can run Windows if needed, but it takes me a bit more time to set up.

[NSoiffer]

Yes, both windows only. There is ORCA on Linux (see #128). Any interest in working on that?

[CristianCantoro]

@NSoiffer wrote:

Yes, both windows only. There is ORCA on Linux (see #128). Any interest in working on that?

In principle, yes, but I want to close the Italian translation first. One thing at a time. :-)