MathML:Documentation: Difference between revisions

no edit summary
(Mark "Status of each tag" and "Authoring" as done)
No edit summary
Line 1: Line 1:
See {{bug|553915}} and [http://groups.google.com/group/mozilla.dev.tech.mathml/browse_thread/thread/576075b9332b6bc4# the thread on mozilla.dev.tech.mathml]).
This page was initially written to migrate the MathML project pages to wiki pages. Most of the work has been done so far and the new home page is:


== Project page on mozilla.org ==
https://developer.mozilla.org/en/Mozilla_MathML_Project


At the moment, we are not able to use MathML inside wiki pages. Hence the MathML demos remain on mozilla.org for the moment...
The remaining work is essentially on MathML demos ({{bug|585142}}).
 
Documentation for Web developers is available here:
 
https://developer.mozilla.org/en/MathML
 
whereas 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 ==


*[http://www.mozilla.org/projects/mathml/ MathML in Mozilla] => ''move the project page to [https://developer.mozilla.org/en/Mozilla_MathML_Project MDC]''  
*[http://www.mozilla.org/projects/mathml/ MathML in Mozilla] => ''move the project page to [https://developer.mozilla.org/en/Mozilla_MathML_Project MDC]''  
**Updates '''[done]'''
**Updates
***"Mozilla Firefox 1.5 has been released..." => ''outdated''  
***"Mozilla Firefox 1.5 has been released..." => ''outdated''  
***"Markup of the Week (or two...)" => ''link broken''  
***"Markup of the Week (or two...)" => ''link broken''  
***Status of each tag  
***Status of each tag  
**Discussion Forum '''[done]'''
**Discussion Forum  
**Links '''[done]'''
**Links
***Add link to installation of fonts  
***Add link to installation of fonts  
***W3C Recommendation => ''add link to MathML 3''  
***W3C Recommendation => ''add link to MathML 3''  
Line 19: Line 27:
***Milestone builds  
***Milestone builds  
***Other platforms => ''Should we keep this page?''  
***Other platforms => ''Should we keep this page?''  
**Sample MathML Documents '''[done]'''
**Sample MathML Documents
***Tester... => ''This was simply used to display MathML from an input form, but it no longer works anyway.''  
***Tester... => ''This was simply used to display MathML from an input form, but it no longer works anyway.''  
***Screenshots  
***Screenshots  
Line 27: Line 35:
***Mathematics for Computer Scientists => ''link broken''  
***Mathematics for Computer Scientists => ''link broken''  
***More...  
***More...  
**Create MathML Documents '''[done]'''
**Create MathML Documents
***Guidelines for Authoring - Get the most out of the current Mozilla MathML renderer  
***Guidelines for Authoring - Get the most out of the current Mozilla MathML renderer  
***=> ''link to W3C's MathML software list''  
***=> ''link to W3C's MathML software list''  
***Fonts - Characters/Entities for scientific documents. => ''already mentioned above''  
***Fonts - Characters/Entities for scientific documents. => ''already mentioned above''  
**Note '''[done]'''
**Note
***JavaScripted MathML editor => ''outdated'', mention Firemath in wiki.mozilla.org
***JavaScripted MathML editor => ''outdated'', mention Firemath in wiki.mozilla.org
**The Big Picture '''[done]'''
**The Big Picture  
***The priority of the project will be to provide a compact and fast engine... => ''this has been achieved, now''  
***The priority of the project will be to provide a compact and fast engine... => ''this has been achieved, now''  
***WYSIWYG interface to MathML
***WYSIWYG interface to MathML
Line 39: Line 47:
****the support of an input field => ''mention on wiki.mozilla.org''
****the support of an input field => ''mention on wiki.mozilla.org''
***Transformation Services => ''tools are already mentioned above''  
***Transformation Services => ''tools are already mentioned above''  
**Implementation '''[done]'''
**Implementation  
***support for semantic/content tags => ''mention bug 276028 as well as DOM MathML on wiki.mozilla.org ''
***support for semantic/content tags => ''mention bug 276028 as well as DOM MathML on wiki.mozilla.org ''
*[http://www.mozilla.org/projects/mathml/update.html Status of each tag] => ''move to [https://developer.mozilla.org/en/Mozilla_MathML_Project/Mozilla_MathML_Status MDC]'' (new page and reference to the old one) '''[done]'''
*[http://www.mozilla.org/projects/mathml/update.html Status of each tag] => ''move to [https://developer.mozilla.org/en/Mozilla_MathML_Project/Mozilla_MathML_Status MDC]'' (new page and reference to the old one)
** Notes => ''move these notes elsewhere''
** Notes => ''move these notes elsewhere''
*** stylistic effects
*** stylistic effects
Line 55: Line 63:
*** maction, => ''I guess we can remove the Tips. The mml editor seems not to work anymore.''
*** 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''
** Extras (technology demonstration, non-portable) => ''already mentioned is the main page''
*[http://www.mozilla.org/projects/mathml/fonts/ Fonts] => ''move to [https://developer.mozilla.org/en/Mozilla_MathML_Project/Fonts MDC]''  '''[done]'''
*[http://www.mozilla.org/projects/mathml/fonts/ Fonts] => ''move to [https://developer.mozilla.org/en/Mozilla_MathML_Project/Fonts MDC]''   
** Mozilla is internally Unicode-based. => ''fix link''
** 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''
** 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''
Line 62: Line 70:
** => ''update screenshots and add more. It seems there is a regression with mathcolor/background BTW.''
** => ''update screenshots and add more. It seems there is a regression with mathcolor/background BTW.''
*[http://www.mozilla.org/projects/mathml/enable.html 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.''
*[http://www.mozilla.org/projects/mathml/enable.html 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.''
*[http://www.mozilla.org/projects/mathml/authoring.html Authoring] => move to [https://developer.mozilla.org/en/Mozilla_MathML_Project/Authoring_MathML MDC] (new page and reference to the old one) '''[done]'''
*[http://www.mozilla.org/projects/mathml/authoring.html Authoring] => move to [https://developer.mozilla.org/en/Mozilla_MathML_Project/Authoring_MathML 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."
** "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
** Essentials
Line 69: Line 77:
*** 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.''
*** 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''
*** "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''. '''[done]'''
* updates, conf2000 => ''Add an "archives" section has been added in MDC''.
Confirmed users
226

edits