Add Italian translation

[Tnonis90]

Hello @NSoiffer ,
this is Tommaso from VisionDept SRL., the italian distributor for Vispero / JAWS. We are interested in tackling the Italian for MathCAT, and are ready to start translating.
Regarding speech, I kindly ask you to set up the environment with the automatic translations, so we can start out.
As for Braille, we'd need a discussion on what code to choose: in italy, almost everyone nowadays uses the LAMBDA Math Code (Italian version). Do you happen to have any familiarity with that?

Thanks a lot, and ook forward to getting started with this.

Tommaso

[NSoiffer]

I'm very glad to help out with the Italian translations.

I'll build an initial translation in the next day or two and let you know the details.

I know a little about the LAMBDA math code, but I need a specification as to how the MathML maps to its linear format (I didn't see anything at https://www.lambdaproject.org/). I just finished implementing the German LaTeX braille code. For that, I didn't translate directly to the braille dots, but instead to the ASCII chars for LaTeX and then let the current braille mapping table do the translation. I was told that was preferable because each country that might the LaTeX use this would have different 8-dot mappings, or might use a 6-dot mapping. I suspect something similar is desirable for the LAMBDA code. Is that true?

[Tnonis90]

Thanks for letting me know. At
www.veia.it
you can download Lambda 1.44, which does contain an XML specification with all Braille markup code. Do not use Lambda 2, as everything's embedded in the executable file in that specific version.

Thanks!

[NSoiffer]

I've created an "it" branch. Clone MathCAT and checkout that branch. There are instructions for translators here. Here's a short list:

1. Go to Rules/Languages/it
2. Open unicode.yaml and look through the translations. They are likely mostly good. If a translation is good, change the "t: ..." to "T: ...". This marks the translation as having been verified that it is good. There are some if tests for some things and those translations are more likely to be not as good. Hopefully the syntax is understandable.
3. Open SimpleSpeak_Rules.yaml and again look through the translations (search for "t: "). Again, there are tests here such as for Verbosity and for Blindness. English often uses "the square root of ..." in a verbose setting, but in a terse one, it might be shortened to "square root x" (dropping "the" and "of"). If Italian never uses those extra words, just use an empty string. In a second pass, we can talk about making the rules more natural for Italian.
4. Open all the files in SharedRules and do the same thing as for SimpleSpeak_Rules.yaml
5. Open definitions.yaml. This has words for cardinal numbers (one, two, three...) and ordinal numbers (first, second, third...). Also for words used in fractions ("half", ...). These translations are likely correct, but there might be some bad ones.

At any point, you can test these out in NVDA if you have the MathCAT addon. After installing the addon, to test, copy the 'it' directory to %AppData%\nvda\addons\MathCAT\globalPlugins\MathCAT\Rules\Languages. Start NVDA or if it is running, restart NVDA (or you can go to/click on NVDA:Tools:Reload Plugins). If you have an Italian voice, it should use the Italian speech rules. Go to any page with MathML (e.g, https://it.wikipedia.org/wiki/Equazione_di_secondo_grado) and the math should be spoken in Italian. If NVDA+MathPlayer works with LAMBDA, NVDA+MathCAT should also, so that would be another source of math. If NVDA says there is an error in speaking the math, open the NVDA log (NVDA+F1). The message is a little bit hard to understand, but it will hopefully guide you to a place where you have a typo (e.g, accidentally deleted a quote mark).

A similar process applies to MathCAT in JAWS. However, I haven't used JAWS much and not with MathCAT at all. I'm not sure where the MathCAT files are stored, but wherever that is, a similar process (copy the files to Rules/Languages/it) as with NVDA should be followed. I'm not sure if it picks up the Italian voice automatically. In NVDA, that's code that I wrote.

Good luck. If you want to do a teleconference call some time, I can walk you through the process and that might clear up some questions. In a few hours, you might have something that speaks ok for some expressions and in a few days, does ok for many common expressions. To get a really natural translation, you may want to add or delete some rules and I can talk you through those or write them for you with your input.

At some point, you should do some work on unicode-full.yaml. This is where less commonly used characters can be found. It is a huge file (~3,600 lines), so you may want scan through every now and then when you are feeling a little bored and translate characters you think are really poorly translated (anything marked with 'google translation' is more likely poorly translated).

And also we can talk about whether it makes sense to implement ClearSpeak or some other speech style.

[NSoiffer]

@Tnonis90

Thanks for letting me know. At www.veia.it you can download Lambda 1.44, which does contain an XML specification with all Braille markup code.

I only see options for LAMBDA 2, BM2021, and EBKey. I tried BM2021 in the hopes that was old version, but after downloading, I see the "BM" stands for "Braille Music", so that's not the right thing. The EBKey description also indicates that's right either. I didn't see anything else that I could download. Can you clarify what I should get?

[Tnonis90]

Hello, I’ll start working on this today. I won’t do Unicode and Unicode Full first, because Freedom will run those through a script which takes the translations directly from JAWS, which I’ve curated manually hence I don’t need to do the work twice. Tommaso

[Tnonis90]

Hello, my initial commit should be present in the dedicated fork, IT branch. I have taken care of all files, except Unicode and Unicode full, as I said, which will be handled via scripts that fetch the info from JAWS. So far all seems to play well and the math speaks very well in Italian. I should say that my testing has been on a limited subset of Wikipedia pages, and should continue in the next days. So far, I have found a problem with an untranslatable string, “out of” This string speaks when you up arrow out of an inner element (e.g. denominator). Could you please tell me where to fix this string so it speaks in correct Italian? As for the Braille, I’ve retrieved the correct link for lambda 1.44, which has been removed from thehomepage. The link is https://veia.it/it/scarica_lambda You should be able to get the program there. Let’s proceed and test further! Best regards Cordiali Saluti Tommaso Nonis Vision Dept S.r.l. Via G.B. Morgagni,6 20129 Milano T 02-29.53.48.62 Web: <http://www.visiondept.it/> VisionDept.it Iscriviti alla <http://www.visiondept.it/about.html#mc_embed_signup> NewsLetter <https://www.facebook.com/VisionDeptSrl/> <https://www.instagram.com/visiondept/> <https://twitter.com/visiondept1> <https://www.visiondept.it/cert_jaws_index.html>

[NSoiffer]

@Tnonis90 : I don't see your commit. Did you forget to do a "git push"?

Also, I think I answered this:

So far, I have found a problem with an untranslatable string, “out of” This string speaks when you up arrow out of an inner element (e.g. denominator). Could you please tell me where to fix this string so it speaks in correct Italian?

In case I didn't, you need to translate navigate.yaml -- I left that out of my shortened instructions by accident.

[Tnonis90]

I pushed it using Github desktop to the IT branch. The sha is: 21ebc2e And the commit name is Initial Italian Translation. Do you still have issues locating it? We can maybe look into seeing what was wrong there. Tommaso

[NSoiffer]

When I click on your SHA, the top of the page says "This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository."

I need to get some sleep now. If you don't beat me to it, I'll look into what's going on when I get up and see if I can correct it/bring it into the repo.

[NSoiffer]

I asked my git-savy son for help and the only thing we could come up with is to essentially clone things and copy files over. That's error-prone.

If you created a fork, and committed your changes there, I could do something, but I'd need to know what your fork is.

Maybe you can try and do a pull request from your repo or branch into the MathCAT repo. That would likely be the shortest path to getting this right. One place I saw says that the error sometimes comes from pushing a tag, not a branch.

[Tnonis90]

Before making more mistakes, I believe it’d be better to do a conference call. What time would suit you best? I’m six hours after eastern time Tommaso

[Tnonis90]

Ok, it looks like I created my own repo and that’s where the branch is. What’s the shortest path to bring the IT branch into the NSoiffer/MathCat? Tommaso

[NSoiffer]

Probably the best path is to do a "Pull Request" (on top, third item after "code" and "issues") on your repo's page. It will probably suggest what to do. If not click "New pull request" (on top right) and then choose the "...compare across forks" link.

[Tnonis90]

I hope I’ve done this correctly Tommaso

[NSoiffer]

As you probably saw, I merged your code into the 'it' branch. I know you want to use the JAWS character translations for the characters they have. However, if you think the current files are good enough to use until you do more work, let me know and I'll merge the 'it' branch into main.

[Tnonis90]

Hi, it’ll take two weeks I think for the JAWS guys to populate the Unicode chars file. So, let’s wait for them to do that and I’ll then revise that. Have you had the chance to have a look at the Lambda Braille code for IT? Best Tommaso

[NSoiffer]

At the end of March, I downloaded Lambda from your link and tried it out and ran into several issues. Between having to write/finish a paper for ICCHP and immersing myself in the update to Nemeth for chemistry, my memory is hazy on the problems I found :-{

I do remember that Lambda didn't work on many of the MathML examples I tried to import. I remember decompiling mathml2lambda.pyc to get a better sense of what Lambda supports, but I don't remember what I concluded (if anything). I don't think I found any documentation on the lambda code itself. Do you know where there is documentation on it?

[Tnonis90]

Hi, after further exploration, it looks like the situation is way harder to pull off than I had originally anticipated. There is no direct way to obtain a list of math symbols and their Braille representation: I think we need to actually install the program and test out each individual symbol, unless you have a better idea on how to proceed. We may use the publicly available Six Dot code from the Italian Braille association, but the reality on the ground is that nobody uses that any longer.

[NSoiffer]

I could take the list of more commonly used math symbols in MathCAT (in unicode.yaml) and pull out the symbols to a file that I could then copy and paste and see what lambda generates. Then copy then back and with the aid of a program, stick that result into proper spot in the MathCAT table. I'm travelling right now and don't have lambda on my laptop, but if you paste in something like ÷, λ, ←, does lambda show useful dots? If so, that would not be too much work.

[Tnonis90]

Lambda1 does not, however lambda 2 definitely does. So, it’d be: ÷=Dots 356 Λ = dots 1238, ← = dots 12345678 (full cell), I think this can be done

[NSoiffer]

I've attached a list of 360 characters, one character per line. If this isn't a good format, let me know what format you would like (e.g, all chars on a single line or 40 chars per line or ...).

I tried Lambda 2 myself, but I don't know settings I should use to get the proper braille chars. In JAWS, if I set the output table to Italian, I only see 6 dot and computer braille options. I think you need to do the conversion.

Note: there are four invisible chars in the list (U+2061 - U+2064). I don't know if lambda supports these. I suspect there might be some others that aren't supported. The list begins with a blank char (which probably translates to an empty braille cell).

List of characters: chars.txt

In order to know what braille char corresponds to what Unicode char (and hence create the list in MathCAT), don't delete any chars even if they don't translate. That way I can know that what is on line 137 corresponds to α. The alternative is for you send back something like
Λ = dots 1238
for each char.
What you send back can be the actual braille char (you need to let me know what the mapping is or use the Unicode braille chars) or something like 1238 and I can covert that to dots.

Hopefully this approach works.

[Tnonis90]

Hello, I hope this email finds you well. I wonder whether we can proceed with the Lambda Italian Braille implementation for MathCat. I seem to have put the discussion somewhere I cannot find, so was asking what the current state of affairs was regarding this. Best regards Tommaso Cordiali Saluti Tommaso Nonis Vision Dept S.r.l. Via G.B. Morgagni,6 20129 Milano T 02-29.53.48.62 Web: <http://www.visiondept.it/> VisionDept.it Iscriviti alla <http://www.visiondept.it/about.html#mc_embed_signup> NewsLetter <https://www.facebook.com/VisionDeptSrl/> <https://www.instagram.com/visiondept/> <https://twitter.com/visiondept1> <https://www.visiondept.it/cert_jaws_index.html>

[Tnonis90]

Hi Neil, I've recovered our discussion and was able to get a copy of Lambda 2 set up for use. However, it does a nasty thing that is unpreventable it seems: If I copy paste one or more chars from your file, Lambda interprets whatever I copy as being text, not math. So, it lets JAWS itself handle the Braille, rather than passing control to its internal Braille engine. I have no idea how to solve this. Tommaso Cordiali Saluti Tommaso Nonis Vision Dept S.r.l. Via G.B. Morgagni,6 20129 Milano T 02-29.53.48.62 Web: <http://www.visiondept.it/> VisionDept.it Iscriviti alla <http://www.visiondept.it/about.html#mc_embed_signup> NewsLetter <https://www.facebook.com/VisionDeptSrl/> <https://www.instagram.com/visiondept/> <https://twitter.com/visiondept1> <https://www.visiondept.it/cert_jaws_index.html>

[NSoiffer]

I almost accidentally included the unfinished Italian translation in the latest MathCAT release. That reminded me of unfinished work:

• the spoken translation (I think just the Unicode files)
• the lambda braille work

Do you know if Vispero is doing anything to move forward the spoken translation? I haven't seen any progress from them. If they aren't doing it, is it something you would be willing to do. Because the seeded Unicode translations borrowed from earlier translations, I think (maybe wishful thinking :-) that a lot of the translations are ok so it may be just a matter of reading them and mostly changing "t:" to "T:"... at least for those in uncode.yaml. The ones in unicode-full.yaml might be more iffy, but they are much less frequently used.

For the lambda translations, I'm not sure how to proceed. If JAWS is doing the translation, then that means it is either using a user default setting or lambda is changing the default table to use. If it is doing the latter, then if I knew which table it was using, I could grab that and use it.

In most of the braille codes I generate, I generate Unicode braille characters. However, for a few like ASCIIMath and LaTeX, I just pass through the characters (which should all be ASCII chars) and let JAWS/NVDA convert them using whatever table the user has set (6-dot or 8-dot). That means things like ∈ turn into "in" which is translated by JAWS/NVDA to 6 or 8 braille. I don't think that would work for lambda though.

I just tried to run Lambda again to refresh my memory, but my demo expired. Since I think we have reached a dead end, I think the next step if for me to contact them and see if they are willing to send me the tables they use or help in some other way. Does that seem like a good way to move forward? Do you think you would have better success dealing with them than I do (e.g., you have worked with them in the past)? If I contact them, can I mention your name as someone working with me on the translation?

[Tnonis90]

Neil, I’ve installed Lambda 1.44, the older version, which does expose the code in XML and in an HTML help file, which version 2.0 doesn’t. What they do, I’ve found, is they take the Unicode character whose braille representation they want to show, then pluck in the visual representation via a custom font. It’spretty bad, but that’s the way they do it. Here’s the Lambda 1.44 download Scarica Lambda | Veia progetti... <https://www.veia.it/it/scarica_lambda> If youlike, what I can do is translate the math code for you with all the Braillecombinations, then we can proceed from there, what do you think? Vispero itself does not do any Italian for its products, it’s us as Vision Dept who do. Tommaso Cordiali Saluti Tommaso Nonis Vision Dept S.r.l. Via G.B. Morgagni,6 20129 Milano T 02-29.53.48.62 Web: <http://www.visiondept.it/> VisionDept.it Iscriviti alla <http://www.visiondept.it/about.html#mc_embed_signup> NewsLetter <https://www.facebook.com/VisionDeptSrl/> <https://www.instagram.com/visiondept/> <https://twitter.com/visiondept1> <https://www.visiondept.it/cert_jaws_index.html>

[NSoiffer]

I had previously downloaded lambda 1.44, so the demo period for that is over and I can't run it. Before you translate the math code with all the Braille combinations, how about just translating 5 - 10 and sending those? That way I you won't be wasting much time if it turns out that isn't the info that I need or I need the info in a different format.

[Tnonis90]

Hi, let’s try this. Tell me whether this HTML file is any useful for you. If it is, I’ll do all the others. Tommaso Cordiali Saluti Tommaso Nonis Vision Dept S.r.l. Via G.B. Morgagni,6 20129 Milano T 02-29.53.48.62 Web: <http://www.visiondept.it/> VisionDept.it Iscriviti alla <http://www.visiondept.it/about.html#mc_embed_signup> NewsLetter <https://www.facebook.com/VisionDeptSrl/> <https://www.instagram.com/visiondept/> <https://twitter.com/visiondept1> <https://www.visiondept.it/cert_jaws_index.html> Da: NSoiffer ***@***.***> Inviato: martedì 12 novembre 2024 01:59 A: NSoiffer/MathCAT ***@***.***> Cc: Tnonis90 ***@***.***>; Mention ***@***.***> Oggetto: Re: [NSoiffer/MathCAT] Add Italian translation (Issue #257) I had previously downloaded lambda 1.44, so the demo period for that is over and I can't run it. Before you translate the math code with all the Braille combinations, how about just translating 5 - 10 and sending those? That way I you won't be wasting much time if it turns out that isn't the info that I need or I need the info in a different format. — Reply to this email directly, view it on GitHub <#257 (comment)> , or unsubscribe <https://github.com/notifications/unsubscribe-auth/BG7SQRNNFY5TUKAQT7DHWCD2AFHD5AVCNFSM6AAAAABE5W5O76VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDINRZGM3TGMBTGA> . You are receiving this because you were mentioned. <https://github.com/notifications/beacon/BG7SQRKQJLRJETVT5OY6JOT2AFHD5A5CNFSM6AAAAABE5W5O76WGG33NNVSW45C7OR4XAZNMJFZXG5LFINXW23LFNZ2KUY3PNVWWK3TUL5UWJTUTF6SGM.gif> Message ID: ***@***.*** ***@***.***> >

[NSoiffer]

There wasn't an HTML file attached. You may need to go to github directly and attach the files. Or send me email directly and not go through github.

[Tnonis90]

Will you please give me your direct email address so I can contact you there? Tommaso Cordiali Saluti Tommaso Nonis Vision Dept S.r.l. Via G.B. Morgagni,6 20129 Milano T 02-29.53.48.62 Web: <http://www.visiondept.it/> VisionDept.it Iscriviti alla <http://www.visiondept.it/about.html#mc_embed_signup> NewsLetter <https://www.facebook.com/VisionDeptSrl/> <https://www.instagram.com/visiondept/> <https://twitter.com/visiondept1> <https://www.visiondept.it/cert_jaws_index.html> Da: NSoiffer ***@***.***> Inviato: giovedì 21 novembre 2024 20:28 A: NSoiffer/MathCAT ***@***.***> Cc: Tnonis90 ***@***.***>; Mention ***@***.***> Oggetto: Re: [NSoiffer/MathCAT] Add Italian translation (Issue #257) There wasn't an HTML file attached. You may need to go to github directly and attach the files. Or send me email directly and not go through github. — Reply to this email directly, view it on GitHub <#257 (comment)> , or unsubscribe <https://github.com/notifications/unsubscribe-auth/BG7SQRILARXMMF3RWK6RMD32BYX5HAVCNFSM6AAAAABE5W5O76VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDIOJSGA4DINZXGI> . You are receiving this because you were mentioned. <https://github.com/notifications/beacon/BG7SQRNSLPFIQQOKJLDO4TT2BYX5HA5CNFSM6AAAAABE5W5O76WGG33NNVSW45C7OR4XAZNMJFZXG5LFINXW23LFNZ2KUY3PNVWWK3TUL5UWJTUURIZCI.gif> Message ID: ***@***.*** ***@***.***> >

[NSoiffer]

Sorry, I thought you had it already: ***@***.***

…

On Fri, Nov 22, 2024 at 12:06 AM Tnonis90 ***@***.***> wrote: Will you please give me your direct email address so I can contact you there? Tommaso Cordiali Saluti Tommaso Nonis Vision Dept S.r.l. Via G.B. Morgagni,6 20129 Milano T 02-29.53.48.62 Web: <http://www.visiondept.it/> VisionDept.it Iscriviti alla <http://www.visiondept.it/about.html#mc_embed_signup> NewsLetter <https://www.facebook.com/VisionDeptSrl/> < https://www.instagram.com/visiondept/> <https://twitter.com/visiondept1> <https://www.visiondept.it/cert_jaws_index.html> Da: NSoiffer ***@***.***> Inviato: giovedì 21 novembre 2024 20:28 A: NSoiffer/MathCAT ***@***.***> Cc: Tnonis90 ***@***.***>; Mention ***@***.***> Oggetto: Re: [NSoiffer/MathCAT] Add Italian translation (Issue #257) There wasn't an HTML file attached. You may need to go to github directly and attach the files. Or send me email directly and not go through github. — Reply to this email directly, view it on GitHub < #257 (comment)> , or unsubscribe < https://github.com/notifications/unsubscribe-auth/BG7SQRILARXMMF3RWK6RMD32BYX5HAVCNFSM6AAAAABE5W5O76VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDIOJSGA4DINZXGI> . You are receiving this because you were mentioned. < https://github.com/notifications/beacon/BG7SQRNSLPFIQQOKJLDO4TT2BYX5HA5CNFSM6AAAAABE5W5O76WGG33NNVSW45C7OR4XAZNMJFZXG5LFINXW23LFNZ2KUY3PNVWWK3TUL5UWJTUURIZCI.gif> Message ID: ***@***.*** ***@***.***> > — Reply to this email directly, view it on GitHub <#257 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AALZM3BKXOCWJZ6DUNLDYSL2B3QXPAVCNFSM6AAAAABE5W5O76VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDIOJTGEYTSNZSGU> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[Tnonis90]

Damit, it's grayed out. Mine is:tommaso at visiondept dot itPlease write thereInviato da iPhoneIl giorno 22 nov 2024, alle ore 09:11, NSoiffer ***@***.***> ha scritto: Sorry, I thought you had it already: ***@***.***

[Tnonis90]

I don't seem to be able to retrieve youremail in any way. It's grayed out every time. Could you write to me at
Tommaso at visiondept dot it
and share this so I can attach the HTML files?
Best
Tommaso

[NSoiffer]

@Tnonis90: I sent you email. If you don't see it, please check your spam folder as my email sometimes ends up in spam folders.