LaTeX/Instalacija dodatnih paketa

Dodatne funkcije za LaTeX se nazivaju paketi. Desetine njih su unapred instalirani sa LaTeX-om i mogu se koristiti u vašim dokumentima odmah. Svi bi trebalo da su sačuvani u podirektorijumima texmf/tex/latex nazvanim po svakom paketu. Naziv direktorijuma "texmf" znači “TEX i METAFONT”. Da bi saznali koji drugi paketi su dostupni i šta oni rade, trebalo bi da koristite CTAN stranicu pretraživanja koja sadrži link do sveobuhvatnog kataloga Grejhema Viliamsa za pakete.

Paket je datoteka ili kolekcija datoteka koji sadrže dodatne LaTeX komande i programiranje koje dodaju nove funkcije stilizovanja ili modifikuju one koje već postoje. Postoje dva osnovna tipa datoteki: klasne datoteke sa .cls ekstenzijom, i datoteke stila sa .sty ekstenzijom. Mogu postojati i pomoćne datoteke. Kada pokušate da slažete tekst dokumenta kome je potreban paket koji nije instaliran na vašem sistemu, LaTeX će vas upozoriti sa porukom greške da taj paket nedostaje. Možete preuzimati ažuriranja paketa koje već posedujete (one koji su instalirani sa vašom verzijom LaTeX-a kao i one koje ste vi dodali). Ne postoji ograničenje broja paketa koje možete imati instalirane na vašem računaru (ako imate dovoljno prostora na disku!), ali postoji konfiguracijsko ograničenje broja koji može biti korišćen unutar bilo kog jednog LaTeX dokumenta istovremeno, mada to zavisi od toga koliki su paketi ponaosob. U praksi nema nikakvih problema da imate i nekoliko desetina aktivnih paketa.

Većina LaTeX instalacija dolazi sa velikim skupom pre-instaliranih paketa stila, tako da možete da koristite menadžer paketa TeX distribucije ili možete da koristite ovaj koji je već na vašem sistemu, da upravljate paketima. Pogledajte automatsku instalaciju. Veliki broj paketa stilova je dostupan na internetu. Glavno mesto gde možete da gledate pakete stilova na internetu je CTAN. Kada ste identifikovali paket koji vam je potreban i koji nije u vašoj distribuciji, koristite indekse na bilo kom CTAN serveru da nađete paket koji vam je potreban i direktorijum sa kog on može biti preuzet. Pogledajte ručnu instalaciju.

Automatska instalacija

Ako na operativnom sistemu sa menadžerom paketa ili granama prevoženja, možete često naći pakete u skladištima.

Sa MikTeX-om postoji paket menadžer koji vam dozvoljava da pojedinačno izaberete paket koji želite. Kao prikladna opcija, pri kompilaciji datoteke koja zahteva ne-instalirane datoteke, MikTeX će automatski izazvati instalaciju onih koji nedostaju.

Sa TeX Live, česta je pojava da imate distribuciju upakovanu u malo velikih paketa. Na primer, za instalaciju nečega vezonog sa internacionalizacijom, možda ćete morati da instalirate paket poput texlive-lang. Sa ručno instaliranim TeX Live, koristite tlmgr da bi upravljali paketima pojedinačno.

tlmgr install <пакет1> <пакетe2> ...
tlmgr remove <пакет1> <пакет2> ...

Upotreba tlmgr je pokrivena u poglavlju o instalaciji.

Ako ne možete da pronađete željeni paket sa bilo kojom od prethodno pomenutih metoda, pogledajte ručnu instalaciju.

Ručna instalacija

Preuzimanje paketa

Šta obično trebate da tražite su dve datoteke, jedna se završava sa .dtx a druga sa .ins. Prva predstavlja DOCTeX datoteku, koja kombinuje program paketa i svoju dokumentaciju u jednu datoteku. Druga predstavlja instalacijsku rutinu (mnogo manja). Uvek morate preuzeti obe datoteke. Ako dve datoteke nisu tamo, to znači jednu od dve stvari:

• Ili je paket deo mnogo većeg snopa koji po normali nebi trebalo da ažurirate ako ne promenite LaTeXverziju LaTeX-a;
• ili je stariji ili relativno prosti paket napisan od strane autora koji nije koristio .dtx datoteku.

Preuzmite datoteke paketa na privremeni direktorijum. Često će postojati readme.txt sa kratkim opisom paketa. Naravno pročitajte ovu datoteku prvo.

Instalacija paketa

Postoje pet koraka u instalaciji LaTeX paketa. (Ovi koraci se takođe mogu koristiti na delovima komplikovanog paketa koji ste sami napisali; u ovom slučaju, pređite odmah na korak 3.)

1. Izvucite datoteke Pokrenite LaTeX na .ins datoteci. Ovo znači da, otvorite datoteku u vašem editoru i procesuirajte je kao da je ona LaTeX dokument (koji ona jeste), ili ako preferirate, napišite latex a zatim .ins imedatoteke, u komandnom prozoru u vašem privremenom direktorijumu. Ovo će izvući sve datoteke potrebne iz .dtx datoteke (ovo je razlog zbog kojeg morate da imate obe datoteke prisutne u privremenom direktorijumu). Zapišite ili odštampajte imena napravljenih datoteka ako ih ima mnogo (pročitajte log fajl ako želite ponovo da vidite njihova imena).

2. Stvorite dokumentaciju Pokrenite LaTeX na .dtx datoteci. Možda ćete morati da je pokrenete dva ili više puta, da bi dobili tačno upućivanje (kao i kod bilo kog drugog LaTeX dokumenta). Ovo će stvoriti .dvi datoteku dokumentacije objašnjavajući za šta je paket stvoren i kako ga koristiti. Ako više volite da napravite PDF onda pokrenite pdfLaTeX. Ako ste takođe stvorili i .idx, to znači da dokument takođe sadrži i indeks. ako želite da se indeks pravilno napravi, pratite korake u odeljku indeksiranja. Ponekad ćete videti da je .glo (rečnik) datoteka proizvedena. Umesto toga pokrenite sledeću komandu:

makeindex -s gglo.ist -o name.gls name.glo

3. Instalirajte datoteke Dok se dokumentacija štampa, pomeri ili kopiraj datoteke paketa iz vašeg privremenog direktorijuma na prava mesta u vašoj lokalnoj TeX instalacionoj grani direktorijuma. Paketi instalirani ručno bi trebalo uvek biti postavljeni u vašu "lokalnu" direktorijsku granu, ane u direktorijsku granu koja sadrži sve ranije instalirane pakete. Ovo se radi a)da se spreči vaš paket od slučajnog prepisivanja datoteka unutar glavnih TeX direktorijuma; i b) da bi se izbeglo prepisivanje vaših novonastalih datoteka kada sledeći put ažurirate vašu verziju TeX-a.

Za TDS(TeX struktura direktorijuma)-sistem pravilnika, vaša "lokalna instalaciona grana direktorijuma" je fascikla zajedno sa njenim pod fasciklama. Krajnja fascikla bi verovatno trebalo da se zove texmf-local/ ili texmf/. Njena lokacija zavisi od vašeg sistema:

• MacTeX: Users/username/Library/texmf/.
• Sistemi nalik na juniks: Obično ~/texmf/.
• MikTeX: vaša lokalna direktorijumska grana može biti bilo koja fascikla koju želite, dokle god je registrujete kao korisničko upravljan texmf direktorijum (pogledajte http://docs.miktex.org/manual/localadditions.html#id573803)

"Pravo mesto" ponekad izaziva konfuziju, posebno ako je vaša TeX instalacija strara i nije u skladu sa TeX strukturom direktorijuma(TDS). za pravilne TDS sisteme, "pravo mesto" za LaTeX .sty datoteku je odgovarajuće nazvan poddirektorijum od texmf/tex/latex/. "Odgovarajuće nazvan" znači nazvan sa smislom i značenjem (i kratkim nazivom). Za paket kao paralist, na primer, ja bih direktorijum nazvao texmf/tex/latex/paralist.

Često postoji samo .sty datoteka za pomeranje, ali u slučaju kompleksnih paketa može ih biti više, i one možda pripadaju različitim lokacijama. Na primer, novi BibTeX paketi ili paketi slova će tipično imati nekoliko paketa za instalaciju. Ovo je razlog zbog kojeg je dobra ideja kreirati poddirektorijum za za pakete a ne natrpati datoteke na gomilu zajedno sa drugim nevezanim stvarima. Ako postoje konfiguracijske ili druge datoteke, pročitajte dokumentaciju da otkrijete da li postoji specijalna ili prioritetna lokacija da ih pomerite.

Gde staviti datoteke iz paketa

Tip	Direktorijum (pod texmf/ ili texmf-local/)	Opis
.afm	fonts/afm/foundry/typeface	Adobi metrika slova za Type 1 slova
.bib	bibtex/bib/bibliography	BibTeX bibliografija
.bst	bibtex/bst/packagename	BibTeX stil
.cls	tex/latex/base	datoteka klase dokument
.dvi	doc	dokumentacija paketa
.enc	fonts/enc	Kodiranje slova
.fd	tex/latex/mfnfss	Datoteke definicije slova za METAFONT slova
.fd	tex/latex/psnfss	Datoteke definicije slova za PostScript Type 1 slova
.map	fonts/map	Datoteke mapiranja slova
.mf	fonts/source/public/typeface	METAFONT kontura
.pdf	doc	dokumentacija paketa
.pfb	fonts/type1/foundry/typeface	PostScript Type 1 kontura
.sty	tex/latex/packagename	Datoteka stila: normalni sadržaj paketa
.tex	doc	TeX izvor za dokumentaciju paketa
.tex	tex/plain/packagename	Obične TeX makro datoteke
.tfm	fonts/tfm/foundry/typeface	TeX metrika slova za METAFONT i Type 1 slova
.ttf	fonts/truetype/foundry/typeface	TrueType slova
.vf	fonts/vf/foundry/typeface	TeX virtuelna slova
others	tex/latex/packagename	drugi tipovi datoteka sem ako nisu instrukovane drugačije

Za vićinu slova na CTAN-u, foundry je public.

4. Ažirirajte vaš indeks Konačno, pokrenite vaš TeX program indeksiranja da bi ažurirali bazu podataka paketa. Ovaj program dolazi zajedno sa svakom modernom verzijom TeX-a i ima razna imena u zavisnosti od LaTeX distribucije koju koristite. (Pročitajte dokumentaciju koja dolazi sa vašom instalacijom da bi saznali koje je to ime, ili konsultujte http://www.tug.org/fonts/fontinstall.html#fndb):

• teTeX, TeX Live, fpTeX: texhash
• web2c: mktexlsr
• MacTeX: MacTeX sam ovo radi za vas.
• MikTeX: initexmf --update-fndb (ili koristite GUI)
• MiKTeX 2.7 ili kasnije verzije, instalirane na vindous XP i vindous 7: Start -> All Programs -> MikTex -> Settings. U vindous 8 koristite ključnu reč Settings i izaberite opciju Settings sa MiKTex logom. U Settings meniju izaberite prvi umetak i kliknite na Refresh FNDB-dugme (MikTex će onda proveriti direktorijum programskih datoteka i onda će ažurirati listu baze podataka imena datoteki). Nakon toga samo potvrdite klikom na 'OK'.

5. Ažurirajte mape slova Ako je vaš paket instalirao bilo koja TrueType ili Type 1 slova, morate da ažurirate datoteke za mapiranje slova kao dopunu ažuriranju indeksa. Autor vag paketa bi trebalo da je uključio .map datoteku za slova. Program ažuriranja mape je često neka varijanta updmap, u zavisnosti od vaše distribucije:

• TeX Live i MacTeX: updmap --enable Map=mapfile.map (ako ste instalirali datoteke na ličnoj grani) ili updmap-sys --enable Map=mapfile.map (ako ste instalirali datoteke u direktorijumu sistema).
• MikTeX: Pokrenite initexmf --edit-config-file updmap, dodajte red "Map mapfile.map datoteci koja se otvori, zatim pokrenite initexmf --mkmaps.

Pogledajte http://www.tug.org/fonts/fontinstall.html.

Razlog zašto ovaj proces nije bio široko automatizovan je da idalje postoje hiljade instalacija koje ne odgovaraju TDS-u, kao što su neki stariji deljeni juniksovi sistemi i neki majkrosoft vindous sistemi, tako da nema načina za instalacioni program da zna gde da stavi datoteke: vi morate ovo da znate. Takođe postoje ssitemi gde su vlasnik, korisnik, ili instaler odabrali da ne prate preporučenu TDS strukturu direktorijuma, ili ovo nije izvodljivo iz političkih ili bezbedonosnih razloga (kao što je sistem deljenja gde korisnik ne može da piše zaštićenom direktorijumu). Razlog zašto postoji texmf-local direktorijum (koji se naziva texmf.local na nekim sistemima) je da obezbedi mesto za lokalne modifikacije ili lična ažuriranja, posebno ako ste korisnik na deljenom ili upravljanom sistemu (juniks, linuks, VMS, vindous NT/2000/XP, itd.) gde možda nećete imati mogučnost pisanja glavnoj TeX instalacijskoj grani direktorijuma. Takođe možete imati ličan texmf poddirektorijum u vašem sopstvenom direktorijumu prijavljivanja. Vaša instalacija mora biti konfigurisana da prvo gleda u ove direktorijume, tako, da bi bilo koje ažuriranje standardnih paketa bilo pronađeno tu pre nego u zamenjenim kopijama u glavnoj texmf grani. Sve moderne TeX instalacije bi trebalo ovo da rade u svakom slučaju, ako one to ne rade, možete da uredite texmf/web2c/texmf.cnf sami.

Provera statusa paketa

Univerzalan način da se proveri da lije datoteka dostupna TeX kompajlerima je alatka komandne linije kpsewhich.

$ kpsewhich tikz
/usr/local/texlive/2012/texmf-dist/tex/plain/pgf/frontendlayer/tikz.tex

kpsewhich će samo tražiti datoteke, pakete neće tražitit. Ona će vam vratiti put do datoteke. Za više detalja o specifičnom paketu koristite alatku komandne linije tlmgr (samo za TeX Live):

tlmgr info <пакет>

Tlmgr ima mnogo više opcija. Da se konsultujete sa dokumentacijom:

tlmgr help

Dokumentacija paketa

Da biste saznali koje komande paket pruža (i samim tim kako ga koristiti), potrebno je da pročitate dokumentaciju. U poddirektorijumu texmf/doc od vaše instalacije trebalo bi da postoji direktorijum pun .dvi fajlova, jedan za svaki paket instaliran. Ova lokacija je specifična za svaku distribuciju, ali je se obično nalazi u:

Distribucija	Put
MacTeX	/Library/TeX/Documentation/texmf-doc/latex
MiKTeX	%MIKTEX_DIR%\doc\latex
TeX Live	$TEXMFDIST/doc/latex

Generalno, većina ovih paketa se nalazi u latex poddirektorijumu, iako se drugi paketi (kao što su BibTeX i paketi slova) u drugim poddirektorijumima u obliku doc. Direktorijumi dokumentacije imaju isto ime kao i paket (npr. amsmath), koji generalno sadrže jedan ili više bitnih dokumenata u raznim formatima (dvi, txt, pdf, etc.). Dokumenti generalno imaju isto ime kao i paket, ali postoje i izuzeci (na primer, dokumentacija za amsmath se nalazi na latex/amsmath/amsdoc.dvi). ako vaša instalaciona procedura nije instalirala dokumentaciju, DVI datoteke se mogu preuzeti sa CTAN-a. Pre korišćenja dokumenta, trebalo bi da pažljivo pročitate dokumentaciju, posebno pododeljak koji se obično naziva "User Interface", koji opisuje komande koje koje paket čini dostupnim. Ne možete samo da pogađate i da se nadate da će raditi: morate da pročitate i da saznate.

Obično možete automatski otvoriti bilo koju dokumentaciju instaliranog paketa sa texdoc komandom:

texdoc <package-name>

Spoljni resursi

Najbolji način da se traže LaTeX paketi je već pomenut CTAN: pretraga. Dodatni resursi sa TeX katalog onlajn:

• Alfabetski katalog
• Sa kratkim opisima
• Tematski katalog sa sistematski sortiranim paketima
• Hijerarhijski ugledan na CTAN hijerarhiju fascikli

Vidi još

• LaTeX/Oznake paketa