MathML:Documentation

From MozillaWiki
Jump to: navigation, search

This page was initially written to migrate the MathML project pages to wiki pages. Most of the work is now done and the new home page is https://developer.mozilla.org/en/Mozilla_MathML_Project. If you want to help, the remaining work is essentially on MathML demos (bug 585142).

Documentation for Web developers is available here: https://developer.mozilla.org/en/MathML. Documentation for project contributors is on the present Wiki. If you want to help improving MathML documentation, feel free to edit all these wiki pages :-)

Initial notes on the MathML Project Page at mozilla.org

  • MathML in Mozilla => move the project page to MDC
    • Updates
      • "Mozilla Firefox 1.5 has been released..." => outdated
      • "Markup of the Week (or two...)" => link broken
      • Status of each tag
    • Discussion Forum
    • Links
      • Add link to installation of fonts
      • W3C Recommendation => add link to MathML 3
      • Testsuite
    • Fonts and MathML-enabled Binaries of Mozilla
      • Nightly builds
      • Milestone builds
      • Other platforms => Should we keep this page?
    • Sample MathML Documents
      • Tester... => This was simply used to display MathML from an input form, but it no longer works anyway.
      • Screenshots
      • MathML Start Page (also in Hebrew and Thai)
      • MathML Torture Test
      • World of Chaos => link broken, can not find a new uri for mathzilla
      • Mathematics for Computer Scientists => link broken
      • More...
    • Create MathML Documents
      • Guidelines for Authoring - Get the most out of the current Mozilla MathML renderer
      • => link to W3C's MathML software list
      • Fonts - Characters/Entities for scientific documents. => already mentioned above
    • Note
      • JavaScripted MathML editor => outdated, mention Firemath in wiki.mozilla.org
    • The Big Picture
      • The priority of the project will be to provide a compact and fast engine... => this has been achieved, now
      • WYSIWYG interface to MathML
        • an equation editor button on Composer => mention on wiki.mozilla.org
        • the support of an input field => mention on wiki.mozilla.org
      • Transformation Services => tools are already mentioned above
    • Implementation
      • support for semantic/content tags => mention bug 276028 as well as DOM MathML on wiki.mozilla.org
  • Status of each tag => move to MDC (new page and reference to the old one)
    • Notes => move these notes elsewhere
      • stylistic effects
      • script
    • working demos so far => already mentioned is the main page
    • issues
      • Some limitations exist due to the specifities of MathML. => well, we should really detail the limitations
      • top-level element, mrow => mention the issue of linebreaking elsewhere
      • mglyph, Can have portability problems... => in MathML 3, is only used to insert an image
      • mstyle, The scriptsizemultiplier attribute as well as... => give details of unsupported attributes
      • menclose, Not yet implemented in Mozilla => is now implemented
      • mtd, The interpretation of rowspan and columnspan... => is this comment still needed or is our interpretation obvious?
      • maction, => I guess we can remove the Tips. The mml editor seems not to work anymore.
    • Extras (technology demonstration, non-portable) => already mentioned is the main page
  • Fonts => move to MDC
    • Mozilla is internally Unicode-based. => fix link
    • Please read section Mozilla 1.8 (for Firefox 2.0) or Mozilla 1.9 (for Firefox 3.0) as appropriate. => I think we can move only the information regarding Mozilla 1.9 (Firefox 2.0 is no longer supported). The old doc is to move on a separate page
    • move STIX fonts to MDC and link to www-archive for the old fonts
  • Screenshots => move to MDC
    • => update screenshots and add more. It seems there is a regression with mathcolor/background BTW.
  • Enable => this page looks outdated. For example we probably want to get rid of GetBoundingMetrics. It may also be the case with other pages of the fonts/ directory that are referenced here. We should try to collect and update the relevant information. To move to wiki.mozilla.org since it is really for code contributors.
  • Authoring => move to MDC (new page and reference to the old one)
    • "The definitive reference for MathML is the MathML specification... and/or picking up an item in the ToDo list." => this introduction is a bit outdated and sometimes off-topic, I think we can remove it."
    • Essentials
      • "Since MathML is an application of... content in Mozilla "out-of-the-box" => what this paragraph is essentially saying is that MathML can only be used in well-formed XML documents. This is what I've reformulated in Essentials of MDC. I've also mentioned workarounds for HTML4 and the future possibility of MathML-in-HTML5
      • XHTML Conformance => XHTML is well known now. Some tutorials may already exist in MDC or elsewhere, no need to keep this
      • Authoring for Mozilla => I've given a basic example on MDC. I don't know if it is worth keeping the tip of declaring a mathml entity.
      • "MathML Tips" => I prefer to give some suggestions of authoring tools for MathML, which is really the way people write it (and make MathML more attractive than having to learn a verbose XML syntax). However, these tips can still be useful for people writing testcases, developing authoring tools or willing to optimize their MathML markups. Hence I've given a link to the old page. I don't know if it is worth moving these tips to MDC
  • updates, conf2000 => Add an "archives" section has been added in MDC.