Punand matematica pe Web cu MathML

(traduceri ale acestui document sunt disponibile)

Aceasta nota explica cum sa se includa MathML in paginile Web intr-un mod care face posibila sa fie vizibila intr-un numar mare de browsere. Se arata deasemenea cum sa se configureze browserele pentru a le face capabile sa afiseze MathML. La momentul curent browserele care interpreteaza paginile utilizand conventiile de mai jos sunt (un semn '+' indica ca si versiunile ulterioare functioneaza deasemenea):

Windows:
- IE 5.0 cu modulul Techexplorer
- IE 5.5 cu unul din modulele MathPlayer sau Techexplorer
- IE 6.0+, optional cu modulele MathPlayer sau Techexplorer
- Netscape 6.1 cu modulul Techexplorer
- Netscape 7.0+
- Amaya, toate versiunile (numai Prezentare MathML)
- Mozilla 0.9.9+
Macintosh:
- IE 5.0+ cu modulul Techexplorer
- Mozilla 0.9.9+
Linux/Unix:
- Netscape 6.1 cu modulul Techexplorer
- Netscape 7.0+
- Mozilla 0.9.9+
- Amaya, toate versiunile (numai Prezentare MathML)

Puteti testa browserul dumneavoastra prin vizualizarea acestui exemplu simplu de Prezentare MathML, sau aceasta pagina cu continut MathML mai complex (care ar putea sa ia ceva timp pentru interpretare).

Nota este destinata autorilor de continut Web care doresc sa includa formule matematice in pagini Web, precum si oamenilor care doresc sa citeasca acest continut.

Mai multe detalii tehnice despre "de ce-uri" si "cum-uri" pot fi gasite la foile de stil XSLT pentru MathML. Consultati deasemenea slide-urile din prezentarea lui David Carlisle de la conferinta MathML.

Includerea MathML in paginile Web

Pentru a maximiza numarul de platforme pe care va putea fi vizibil, un document ar trebui sa fie scris utilizand regulile de mai jos. De notat ca daca utilizati un editor conform cu standardele W3C cum ar fi amaya, toate acestea sunt executate automat.

1. Creati pagina utilizand XHTML cu MathML inline

Pagina Web ar trebui sa fie scrisa utilizand XHTML cu marcaj MathML inline, ca in exemplul urmator:

<?xml version="1.0"?>
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>...</head>
  <body>
    <h1>Exemplu</h1>
    ....
    <math xmlns="http://www.w3.org/1998/Math/MathML">
      <mi>x</mi><mo>+</mo><mn>3</mn>
    </math>
  </body>
</html>

Marcajul MathML ar trebui sa nu fie intr-o eticheta <object>, sau intr-un fisier separat la care se face o legatura dintr-o eticheta <embed>.

2. Adaugati o instructiune de procesare a foii de stil

Urmatoarea linie (cu caractere aldine) ar trebui sa fie inserata la inceputul paginii XHTML, inainte de eticheta de deschidere <html> dar dupa declaratia XML <?xml...?> daca aceasta exista:

<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="../XSL/mathml.xsl"?>
<html xmlns="http://www.w3.org/1999/xhtml">
...

Aceasta va functiona in cele mai multe cazuri (dar nu pentru Internet Explorer: pentru motive de securitate IE nu va executa o foaie de stil XSLT care nu este localizata pe acelasi server ca si documentul XHTML+MathML. In acel caz urmati intructiunile 'off-line' de mai jos. Consultati deasemenea partea de jos a acestui document pentru mai multe informatii despre securitatea IE). Totusi, exista alternative:

Off-line: Daca documentul continand matematica este destinat sa fie vazul local, fara o conexiune internet, declaratia ar trebui sa fie:
```
<?xml-stylesheet type="text/xsl" href="mathml.xsl"?>
```
si o copie a urmatoarelor fisiere ar trebui sa existe pe calculatorul local, impreuna cu documentul principal: mathml.xsl, pmathml.xsl, ctop.xsl si pmathmlcss.xsl.
Prezentare MathML: daca documentul contine numai Prezentare MathML, numai fisierele pmathml.xsl si pmathmlcss.xsl sunt necesare. Afisarea va fi mai rapida daca numai aceste doua fisiere sunt utilizate.

Si asta ar fi tot. Cititi mai departe pentru mai multe informatii

Specificarea preferintelor

Deoarece se poate intampla ca un browser sa aiba mai multe moduri de interpretare a marcajului MathML (de exemplu, IE cu modulul techexplorer poate interpreta ecuatii utilizand interpretarea CSS), se furnizeaza un mod de speficare a metodei preferate. Aceasta se obtine prin utilizarea unui atribut numit renderer apartinand unui spatiu de nume special. De exemplu:

<?xml-stylesheet type="text/xsl" href="pmathml.xsl"?>

<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:pref="http://www.w3.org/2002/Math/preference"
      pref:renderer="css">
<head>...</head>
<body>...</body>
</html>

specifica ca metoda de interpretate CSS este preferata pentru interpretarea acestei pagini. Valori pentru atributele renderer sunt:

css: interpreteaza ecuatia prin utilizarea CSS (nu este necesar un modul)
mathplayer-dl: cere instalarea MathPlayer daca este necesar.
mathplayer: utilizeaza comportament MathPlayer.
techexplorer-plugin: utilizeaza modulul Techexplorer.
techexplorer: interpretarea Techexplorer este preferata.

Securitatea Microsoft Internet Explorer

Implicit, Internet Explorer nu permite foilor de stil XSLT sa fie aplicate unui documet daca nu sunt localizate pe acelasi server ca si documentul. De aceea, utilizand

<?xml-stylesheet type="text/xsl" href="../XSL/mathml.xsl"?>

nu va functiona. In schimb este necesar sa se copie foile de stil pe acelasi server ca documentul (dupa cum este descris mai sus). In mod alternativ este posibil sa se schimbe optiunile de securitate in Internet Explorer, dar noi nu recomandam aceasta pentru ca va afecta navigarea pentru toate siteurile, nu doar utilizarea acestei foi de stil.

Prezentarea la Conferinta MathML

Aceasta foaie de stil a fost prezentata la a-2-a Conferinta Internationala MathML. Prezentarea este o serie de exemple a foii de stil destinate sa fie vazuta in browser in modul "intreg ecranul". In timpul prezentarii browserele IE6, Mozilla 1.0, Amaya 6.1 si Netscape 7.0PR1 au fost utilizate pentru afisarea exemplelor.

In plus fata de MathML, un mic exemplu privind extinderea acestei foi de stil la SVG este deasemenea demonstrat.

Grupul de lucru Math W3C. Trimiteti (in engleza) comentarii, intrebari si corectii la www-math@w3.org

$Id: Overview.html,v 1.21 2003/11/26 00:43:24 mf Exp $

Aceasta este o traducere din limba engleza; versiunea originala: http://www.w3.org/Math/XSL/ Versiunea in limba romana poate contine erori. Versiunea engleza este singura versiune normativa.

Traducator

Leontin Stelea