13.2.13. Wstawianie formu� matematycznych

Do dokumentacji, wewn�trz komentarza, mo�na wstawi� formu�� matematyczn� zapisan� w formacie LaTeX. Zostanie ona przetworzona na obrazek w formacie PNG. Pocz�tek formu�y zaznaczamy dyrektyw�:

<!-- formula - start(nazwa) -->

Podana nazwa b�dzie u�ywana jako podstawa nazwy pliku z utworzonym obrazkiem - sam obrazek b�dzie umieszczony w pliku nazwa.png. Formu�� ko�czymy dyrektyw�:

<!-- formula - stop -->

Je�li chcemy mie� wp�yw na wielko�� obrazka ko�cowego, mo�emy do dyrektywy ko�cowej do��czy� opcjonalny parametr oznaczaj�cy rozdzielczo�� (ang. density) wynikowego pliku PNG. Wtedy dyrektywa ko�cz�ca wygl�da nast�puj�co:

<!-- formula - stop(density) -->
                        

Pomi�dzy dyrektywy pocz�tkow� i ko�cow� mo�emy wstawi� dowolne wyra�enie LaTeX (szerszy opis tworzenia wzor�w z wykorzystaniem j�zyka LaTeX znale�� mo�na tu: Rozdział 14), bez pustych linii (!). Przyk�ad:

<!-- formula - start(test) -->
I(z) = \sin( \frac{\pi}{2} z^2 ) \sum_{n=0}^\infty
 \frac{ (-1)^n \pi^{2n} }{1 \cdot 3
 \cdots (4n + 1) } z^{4n + 1}
 -\cos( \frac{\pi}{2} z^2 ) \sum_{n=0}^\infty
 \frac{ (-1)^n \pi^{2n + 1} }{1 \cdot 3
 \cdots (4n + 3) } z^{4n + 3}
<!-- formula - stop -->

Przy wpisywaniu formu� przydatne jest r�wnie� ich numerowanie, dzi�ki kt�remu mo�na si� p�niej w tek�cie komentarza odwo�a� do danej formu�y po jej numerze. Aby nada� formule numer (b�dzie on wy�wietlany obok formu�y, przy prawej kraw�dzi strony), nale�y dyrektyw� pocz�tku formu�y zapisa� nast�puj�co:

<!-- formula - start(nazwa, numer) -->
                        

Prostsze formu�y matematyczne warto jest zapisywa� bezpo�rednio w formacie HTML, aby nie generowa� zb�dnych grafik. Jednak i tutaj przydatna jest mo�liwo�� numerowania takich formu� - mo�na to uzyska� dzi�ki dyrektywie przypisuj�cej danemu blokowi tekstu podany numer. Jej pocz�tek wygl�da nast�puj�co:

<!-- numbered - start(numer) -->
                    

Koniec tej dyrektywy wygl�da nast�puj�co:

<!-- numbered - stop -->
                    

Pomi�dzy mo�na wpisa� dowolny tekst (np. wz�r formu�y), kt�ry ma zosta� oznaczony podanym numerem.