Move math tables from Liblouis to Liblouisutdml

[bertfrees]

see liblouis/liblouis#601

[egli]

Looks great! We might argue that

1. tables need to go into a separate directory and
2. we should mention this in the doc somewhere

[bertfrees]

Why put tables in a separate directory?

[egli]

Why put tables in a separate directory?

I though they are logically a separate thing from sem files, hence they should be in a separate directory. Maybe it is not so important.

[bertfrees]

I think it would just complicate things. sem and cfg files are also different kinds.

[egli]

OK, fine, we can put them in the same directory

[NSoiffer]

What the status of UEB math with this change? I don't see any UEB tables in this project. Are they the ukmaths files (in which case the comment line really should be modified) or is en-ueb-math.ctb an integral part of liblouis' UEB files and can't be moved? If the later, how is UEB math referenced when using liblouisutdml?

[bertfrees]

Hi Neil. No, to my knowledge no one has made a Liblouisutdml converter from MathML to UEB math yet. en-ueb-math.ctb was written by APH and it seems to me that this table is intended for translating formulas in a linear format, i.e. plain text. It is included in en-ueb-g1.ctb so it can't be moved. Any tables from Liblouis can be used with Liblouisutdml as long as Liblouisutdml knows where to find them. Liblouisutdml will just find the tables if Liblouis has been installed in a default location, and otherwise I believe there are some API functions to configure it. This is how it has always worked in the past and it still works this way, but with this PR I'm trying to reduce the dependencies to a miminum.

[NSoiffer]

Thanks for the feedback. I'm hoping to do a new MathPlayer build and there have been requests for UEB math, so I'd like so if I can make that happen. @egli (way back at the 3.1.0 release) said it contained improvements to UEB and Nemeth math, so I was hopeful this meant I could generate UEB math from MathML. Without a .sem file in Liblouisutdml, you are right that apparently no one has done this.

Does anyone know the formats for these files? I can probably write a .sem file for MathML->UEB, at least as far as mimicking nemeth.sem. However, the likelihood of my making mistakes in the other files that are needed is 100%.

[bertfrees]

I made the one for Dutch math so I kind of know the formats, yes. But of course I don't know UEB math (*). Maybe a good way to start is by writing a test suite. I made a test suite for Dutch braille here. The MathML files I generated from LibreOffice Math (hence the "StarMath" comments). There is also a testing framework in Liblouisutdml itself. If you want I could port my (DAISY Pipeline specific) test to Liblouisutdml. This way you would have an example for writing your own UEB tests.

(*) P.S. For my own reference: looked up some documentation:

• The Rules of Unified English Braille 2013, Section 11: Technical Material
• Unified English Braille Guidelines for Technical Material
• The Hitchhiker’s Guide to UEB Mathematics

[NSoiffer]

Always a good idea to have tests to know whether something works! It would be great if you would port your DAISY tests to Liblouisutdml -- it is much easier for me to write UEB tests if I can start with something that works and modify that. Thanks.

FYI: I don't think LibreOffice ever got past MathML 1.0, so it might not be a good way to generate MathML. You might want to try WIRIS (copy and paste into text editor will paste as MathML).