"Hello World!" in LaTeX

Atentie! Site in lucru.

In acest tutorial vom incepe prin a prezenta sintaxa LaTeX si vom scrie cel mai simplu document posibil. Apoi vom compila sursa si vom genera rezultatul mai intai in fisiere .dvi (iesirea standard a compilatorului TeX) iar dupa aceea vom transforma fisierul obtinut in format Postscript (.ps) si in format PDF (.pdf). Fisierul .pdf se poate vizualiza folosind orice program de afisare a documentelor PDF: Acrobat Reader, Xpdf, Evince, KPdf, etc.

Sursa LaTeX

Primul lucru care trebuie cunoscut cand lucram cu LaTeX este ca foloseste un limbaj de marcare (markup language) pentru a descrie structura si infatisarea documentului. Procedeul este similar cu cel folosit de tehnoredactori pentru a comunica tipografilor cum sa aranjeze matritele de plumb pentru a dispune textul in pagina. Putem sa ne imaginam, deci, ca prin instructiunile LaTeX transmitem unui tipograf profesionist diferite aspecte ale documentului cum ar fi: marimea titlului, delimitarea paragrafelor si a capitolelor, numerotarea paginilor, etc. Si, cum tipograful este profesionist, vom observa ca nu este nevoie sa ii dam specificatii foarte detaliate pentru ca va sti sa se descurce singur, in cele mai multe situatii.

Dupa ce primeste fisierul sursa spre compilare, LaTeX incepe sa interpreteze fiecare instructiune de marcare si sa transforme textul intr-un document bun de a fi imprimat (sistemul in pricipiu este asemanator cu transformarea unui fisier HTML intr-o pagina web de catre browser).

Acestea fiind zise, putem sa trecem la scrierea efectiva a documentului:

    %hello.tex - primul nostru exemplu
    \documentclass{article}

    \begin{document}
    Hello World!
    \end{document}

Analiza sursei

Un fisier LaTeX poate fi impartit in doua sectiuni principale: prima este antetul (preambulul), in care se fac diverse declaratii ce specifica atributele globale ale documentului printre care tipul documentului, tipul paginii, fonturile si pachetele LaTeX folosite, stilul paginii, indentarea paragrafelor, etc., cea dea doua este partea unde se introduce corpul documentului (textul util ce va aparea printat).

In cazul nostru am facut delimitarea vizuala a celor doua parti print-un rand liber (care insa nu are nici un efect la iesire).

Interpretarea instructiunilor

    %hello.tex - primul nostru exemplu

Acesta este un comentariu. In LaTeX tot ce urmeaza dupa caracterul procent (%) si pana la sfarsitul liniei este considerat comentariu. Comentariile nu influenteaza in niciun fel documentul, sunt folosite doar ca notite ale autorului si sunt complet ignorate de compilator.

    \documentclass{article}

Aceasta linie spune compilatorului ca documentul este de tipul article (articol). In LaTeX, instructiunile incep cu caracterul "\", urmat de numele instructiunii si optional o serie de argumente cuprinse intre acolade. Instructiunea \documentclass{ } specifica clasa documentului. Ca urmare, LaTeX va sti cum sa formateze textul pentru a corespunde tipului dintre acolade. Partea interesanta este ca daca vrem sa scriem o carte, sau un raport, in loc de un articol, nu trebuie sa facem altceva decat sa schimbam tipul documentului si LaTeX se va ocupa de aranjarea formatului.

    \begin{document}

Dar, sa ne amintim filozofia LaTeX, care spune sa nu ne concentram prea mult pe aspect, ci mai degraba pe continut. Urmatoarea instructiune nu e greu de ghicit la ce se refera. \begin{document} marcheaza inceputul editarii documentului, deci a informatiei utile.

    Hello World!

Singura linie din text care se va reflecta (direct) in documentul nostru.

    \end{document}

Daca am deschis ceva trebuie sa il si inchidem. \end{document} marcheaza sfarsitul editarii documentului.

Generarea documentului

Este clar ca nu va fi cel mai interesant document posibil, dar totusi suntem curiosi sa vedem rezultatul.

1. Deschideti un terminal si tastati comanda: latex hello (extensia .tex nu este necesara, dar putem s-o includem daca vrem)
2. In terminal se vor afisa o diversitate de informatii despre LaTeX si progresul compilarii. Nu intrati in panica, daca totul a mers ok, la sfarsit se va afisa:

	Output written on hello.dvi (1 page, 232 bytes).	
	Transcript written on hello.log.

Vizualizarea documentului

LaTeX si-a terminat treaba, deci putem sa vizualizam documentul. Formatul standard de iesire al TeX este DVI (DeVice Independent) pentru care exista programe de vizualizare pe multe platforme (xdvi - de exemplu, in Linux). Totusi pentru mai multa portabilitate am vrea sa il transformam intr-un fisier Postscript (.ps) sau PDF (.pdf). Din fericire exista unelte care fac acest lucru.

Convertirea in format Postscript

Introduceti in terminal comanda: dvips hello.dvi -o hello.ps

Interpretare: dvips este utilitarul care efectueaza transformarea, hello.dvi este fisierul sursa, -o este o optiune care determina ca iesirea (output) sa fie salvata ca fisier, hello.ps - numele fisierului de iesire in format Postscript.

Convertirea in format PDF

Exista doua metode:

1. dvipdf hello.tex hello.pdf (a se nota ca nu se mai pune -o pentru a specifica iesirea).
2. ps2pdf hello.ps hello.pdf (foloseste fisierul Postscript obtinut cu comanda de mai sus).

Mai exista si o a treia metoda: pdflatex hello.tex hello.pdf care foloseste direct fisierul sursa. Pentru a face o alegere totusi putem sa ne ghidam dupa urmatoarea idee: in general varianta cu mai multe etape produce rezultatul mai apropiat de standardul DVI. Totusi, pentru documentele simple, pdflatex se pare ca este satisfacator. Principala diferenta apare insa la documentele ce contin imagini, in care daca folosim pdflatex imaginile trebuie transformate mai intai in fisiere .pdf.

Vizualizarea efectiva

xpdf hello.pdf