{"id":20079530,"url":"https://github.com/transpect/mathtype-extension","last_synced_at":"2025-05-05T23:30:34.924Z","repository":{"id":56637085,"uuid":"85953939","full_name":"transpect/mathtype-extension","owner":"transpect","description":"Calabash extension step to convert MathType OLE objects to MathML","archived":false,"fork":false,"pushed_at":"2024-11-12T08:06:27.000Z","size":78321,"stargazers_count":19,"open_issues_count":5,"forks_count":7,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-11-12T09:19:26.635Z","etag":null,"topics":["calabash","docx","mathml","mathtype","mtef","xml"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/transpect.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-03-23T13:38:09.000Z","updated_at":"2024-11-12T08:06:32.000Z","dependencies_parsed_at":"2024-11-12T09:29:15.750Z","dependency_job_id":null,"html_url":"https://github.com/transpect/mathtype-extension","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/transpect%2Fmathtype-extension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/transpect%2Fmathtype-extension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/transpect%2Fmathtype-extension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/transpect%2Fmathtype-extension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/transpect","download_url":"https://codeload.github.com/transpect/mathtype-extension/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224472376,"owners_count":17316977,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["calabash","docx","mathml","mathtype","mtef","xml"],"created_at":"2024-11-13T15:23:16.713Z","updated_at":"2024-11-13T15:23:17.682Z","avatar_url":"https://github.com/transpect.png","language":"Ruby","readme":"# mathtype-extension\n\nAn extension step for XML Calabash that converts a Mathtype Equation (MTEF) to MathML.\n\nIncorporates (J)Ruby mathtype gem: https://github.com/sbulka/mathtype (forked from [Jure Triglav](https://github.com/jure)'s gem)\n\nXSLT adapted from: https://github.com/jure/mathtype_to_mathml/tree/master/lib/xsl\n\nWritten by Sebastian Bulka, le-tex publishing services GmbH\n\nDevelopment was sponsored by \n\n* [Carl Hanser Verlag](http://www.hanser-fachbuch.de/)\n* [VDE Verband der Elektrotechnik Elektronik Informationstechnik e.V.](https://www.vde.com/)\n* [STM Document Engineering Private Limited](http://www.stmdocs.in/)\n\nIf you or your organization benefit from this tool, if you are interested in supporting the continuous maintenance, or if you have a feature request: All development costs have not been covered yet; we do welcome more sponsors. If you are interested, please get in touch with @sbulka, @mkraetke, or @gimsieke.\n\n# Usage\n  There are different ways to call the xproc-step.\n## Standalone\n1. Call pipeline for one file.  \n   For setting the MATHTYPE_CP variable, see section 'Java classpath' below.  \n\t```java -cp $MATHTYPE_CP com.xmlcalabash.drivers.Main -c file:///uri/of/transpect-config.xml mathtype-example.xpl file=file:///uri/of/bin-file.bin```\n\t\n## XProc extension\n1. Call \u0026lt;tr:mathtype2mml\u0026gt; from your pipeline.  \n\tThis requires you to have xproc-util available in calabash, to store debug-files.  \n\t\u003cp:import href=\"mathtype2mml-declaration-internal.xpl\"/\u003e\n\n2. Call \u0026lt;tr:mathtype2mml-internal\u0026gt; from your pipeline.  \n\tNo xproc-util needed, but no debug-files stored therefore.  \n\tThe debug is still available on xproc-ports, if you want to use them yourself.\n\n## From other front-end pipelines such as docx2tex\n\nSee https://github.com/transpect/docx2tex (note the MathType extension submodule might not be up to date)\n\n# Options\nConfigure tr:mathtype2mml step by passing options to it:\n\n * href (required):      file name (not URI) of one file containing a Mathtype Equation  \n   supported filetypes:  \n   * .bin (OLE object)  \n   * .wmf\n * debug:\t\t\t\t\t Output debug messages (xsl:message) if set to 'yes'. Default is 'no'.\n * debug-dir:\t\t\t\t If debug is set, also output intermediate results for each internal xsl-step.\n * mml-space-handling:\t How to handle Mathtype-spacing in Mathml. Possible: 'char', 'mspace'. Default: mspace  \n\n # Spaces\n  MathML states that whitespace-characters should be normalized before rendering.  \n  Problems arise because in Mathtype, whitespace is sometimes also used for indentation.  \n  The option for mml-space-handling was introduced so spaces can be converted to will not be normalized.  \n  If 'char' is chosen, the Unicode-characters for spaces are used, wrapped in \u0026lt;mtext\u0026gt;.  \n  Opening the MathML in e.g. your browser, spaces will likely get normalized.\n  If 'mspace' is chosen, every Mathtype-space will be represented by \u0026lt;mspace\u0026gt;.  \n  You can define your preferred width for each different Mathtype-Space.  \n  Insert what you want to see on the mspace/@width, including unit. (e.g. '1pt' for what is called 1pt-space in Mathtype)  \n  Every option has a default width:\n   * em-width\tDefault: '1em'\n   * en-width\tDefault: '0.33em'\n   * standard-width\tDefault: '0.16em'\n   * thin-width\tDefault: '0.08em'\n   * hair-width\tDefault: '0.08em'\n   * zero-width\tDefault: '0em'\n\n# Having issues?\nYou can file an issue on github for inconveniences with your conversion.  \nThis may be asking for help, reporting bugs or requesting features.\n\nIts sufficient to describe your Problem in natural language, e.g:  \n\"In MathML output, the last parenthese is missing.\"  \nIf possible, please attach the file which contains your formula, so we can investigate what went wrong.  \n\n# Java classpath\nThe extension is shipped with a copy of jruby and some ruby gems.  \nThese need to be on your classpath, or java wont find the files.  \nIn addition, calabash and saxon should be included too, to be able to process XProc and XSLT.\n\nExample (from https://github.com/transpect/calabash-frontend/blob/master/calabash.sh):   \n```MATHTYPE_CP= \"/path/to/calabash/distro/xmlcalabash-1.1.15-97.jar:/path/to/calabash/saxon/saxon9he.jar:/path/to/calabash/extensions/transpect/mathtype-extension/:/path/to/calabash/extensions/transpect/mathtype-extension/lib/jruby-complete-9.1.8.0.jar:/path/to/calabash/extensions/transpect/mathtype-extension/ruby/stdlib:/path/to/calabash/extensions/transpect/mathtype-extension/ruby/ruby-ole-1.2.12.1/lib:/path/to/calabash/extensions/transpect/mathtype-extension/ruby/nokogiri-1.7.0.1-java/lib:/path/to/calabash/extensions/transpect/mathtype-extension/ruby/bindata-2.3.5/lib:/path/to/calabash/extensions/transpect/mathtype-extension/ruby/mathtype-0.0.7.5/lib\"```\n\n\n# Compilation\n\nIf you happen to change java sources, you need to set the classpath as describe above for compilation too.  \n    ```javac -target 1.7 -source 1.7 -cp $MATHTYPE_CP Ole2Xml.java Ole2XmlConverter.java```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftranspect%2Fmathtype-extension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftranspect%2Fmathtype-extension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftranspect%2Fmathtype-extension/lists"}