LaTeX/Инсталација додатних пакета

Додатне функције за LaTeX се називају пакети. Десетине њих су унапред инсталирани са LaTeX-ом и могу се користити у вашим документима одмах. Сви би требало да су сачувани у подиректоријумима texmf/tex/latex названим по сваком пакету. Назив директоријума "texmf" значи “TEX и METAFONT”. Да би сазнали који други пакети су доступни и шта они раде, требало би да користите CTAN страницу претраживања која садржи линк до свеобухватног каталога Грејхема Вилиамса за пакете.

Пакет је датотека или колекција датотека који садрже додатне LaTeX команде и програмирање које додају нове функције стилизовања или модификују оне које већ постоје. Постоје два основна типа датотеки: класне датотеке са .cls екстензијом, и датотеке стила са .sty екстензијом. Могу постојати и помоћне датотеке. Када покушате да слажете текст документа коме је потребан пакет који није инсталиран на вашем систему, LaTeX ће вас упозорити са поруком грешке да тај пакет недостаје. Можете преузимати ажурирања пакета које већ поседујете (оне који су инсталирани са вашом верзијом LaTeX-а као и оне које сте ви додали). Не постоји ограничење броја пакета које можете имати инсталиране на вашем рачунару (ако имате довољно простора на диску!), али постоји конфигурацијско ограничење броја који може бити коришћен унутар било ког једног LaTeX документа истовремено, мада то зависи од тога колики су пакети понаособ. У пракси нема никаквих проблема да имате и неколико десетина активних пакета.

Већина LaTeX инсталација долази са великим скупом пре-инсталираних пакета стила, тако да можете да користите менаџер пакета TeX дистрибуције или можете да користите овај који је већ на вашем систему, да управљате пакетима. Погледајте аутоматску инсталацију. Велики број пакета стилова је доступан на интернету. Главно место где можете да гледате пакете стилова на интернету је CTAN. Када сте идентификовали пакет који вам је потребан и који није у вашој дистрибуцији, користите индексе на било ком CTAN серверу да нађете пакет који вам је потребан и директоријум са ког он може бити преузет. Погледајте ручну инсталацију.

Аутоматска инсталација

Ако на оперативном систему са менаџером пакета или гранама превожења, можете често наћи пакете у складиштима.

Са MikTeX-ом постоји пакет менаџер који вам дозвољава да појединачно изаберете пакет који желите. Као прикладна опција, при компилацији датотеке која захтева не-инсталиране датотеке, MikTeX ће аутоматски изазвати инсталацију оних који недостају.

Са TeX Live, честа је појава да имате дистрибуцију упаковану у мало великих пакета. На пример, за инсталацију нечега везоног са интернационализацијом, можда ћете морати да инсталирате пакет попут texlive-lang. Са ручно инсталираним TeX Live, користите tlmgr да би управљали пакетима појединачно.

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

Употреба tlmgr је покривена у поглављу о инсталацији.

Ако не можете да пронађете жељени пакет са било којом од претходно поменутих метода, погледајте ручну инсталацију.

Ручна инсталација

Преузимање пакета

Шта обично требате да тражите су две датотеке, једна се завршава са .dtx а друга са .ins. Прва представља DOCTeX датотеку, која комбинује програм пакета и своју документацију у једну датотеку. Друга представља инсталацијску рутину (много мања). Увек морате преузети обе датотеке. Ако две датотеке нису тамо, то значи једну од две ствари:

• Или је пакет део много већег снопа који по нормали неби требало да ажурирате ако не промените LaTeXверзију LaTeX-а;
• или је старији или релативно прости пакет написан од стране аутора који није користио .dtx датотеку.

Преузмите датотеке пакета на привремени директоријум. Често ће постојати readme.txt са кратким описом пакета. Наравно прочитајте ову датотеку прво.

Инсталација пакета

Постоје пет корака у инсталацији LaTeX пакета. (Ови кораци се такође могу користити на деловима компликованог пакета који сте сами написали; у овом случају, пређите одмах на корак 3.)

1. Извуците датотеке Покрените LaTeX на .ins датотеци. Ово значи да, отворите датотеку у вашем едитору и процесуирајте је као да је она LaTeX документ (који она јесте), или ако преферирате, напишите latex а затим .ins имедатотеке, у командном прозору у вашем привременом директоријуму. Ово ће извући све датотеке потребне из .dtx датотеке (ово је разлог због којег морате да имате обе датотеке присутне у привременом директоријуму). Запишите или одштампајте имена направљених датотека ако их има много (прочитајте лог фајл ако желите поново да видите њихова имена).

2. Створите документацију Покрените LaTeX на .dtx датотеци. Можда ћете морати да је покренете два или више пута, да би добили тачно упућивање (као и код било ког другог LaTeX документа). Ово ће створити .dvi датотеку документације објашњавајући за шта је пакет створен и како га користити. Ако више волите да направите PDF онда покрените pdfLaTeX. Ако сте такође створили и .idx, то значи да документ такође садржи и индекс. ако желите да се индекс правилно направи, пратите кораке у одељку индексирања. Понекад ћете видети да је .glo (речник) датотека произведена. Уместо тога покрените следећу команду:

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

3. Инсталирајте датотеке Док се документација штампа, помери или копирај датотеке пакета из вашег привременог директоријума на права места у вашој локалној TeX инсталационој грани директоријума. Пакети инсталирани ручно би требало увек бити постављени у вашу "локалну" директоријску грану, ане у директоријску грану која садржи све раније инсталиране пакете. Ово се ради а)да се спречи ваш пакет од случајног преписивања датотека унутар главних TeX директоријума; и б) да би се избегло преписивање ваших новонасталих датотека када следећи пут ажурирате вашу верзију TeX-а.

За TDS(TeX структура директоријума)-систем правилника, ваша "локална инсталациона грана директоријума" је фасцикла заједно са њеним под фасциклама. Крајња фасцикла би вероватно требало да се зове texmf-local/ или texmf/. Њена локација зависи од вашег система:

• MacTeX: Users/username/Library/texmf/.
• Системи налик на јуникс: Обично ~/texmf/.
• MikTeX: ваша локална директоријумска грана може бити било која фасцикла коју желите, докле год је региструјете као корисничко управљан texmf директоријум (погледајте http://docs.miktex.org/manual/localadditions.html#id573803)

"Право место" понекад изазива конфузију, посебно ако је ваша TeX инсталација страра и није у складу са TeX структуром директоријума(TDS). за правилне TDS системе, "право место" за LaTeX .sty датотеку је одговарајуће назван поддиректоријум од texmf/tex/latex/. "Одговарајуће назван" значи назван са смислом и значењем (и кратким називом). За пакет као paralist, на пример, ја бих директоријум назвао texmf/tex/latex/paralist.

Често постоји само .sty датотека за померање, али у случају комплексних пакета може их бити више, и оне можда припадају различитим локацијама. На пример, нови BibTeX пакети или пакети слова ће типично имати неколико пакета за инсталацију. Ово је разлог због којег је добра идеја креирати поддиректоријум за за пакете а не натрпати датотеке на гомилу заједно са другим невезаним стварима. Ако постоје конфигурацијске или друге датотеке, прочитајте документацију да откријете да ли постоји специјална или приоритетна локација да их померите.

Где ставити датотеке из пакета

Тип	Директоријум (под texmf/ или texmf-local/)	Опис
.afm	fonts/afm/foundry/typeface	Адоби метрика слова за Type 1 слова
.bib	bibtex/bib/bibliography	BibTeX библиографија
.bst	bibtex/bst/packagename	BibTeX стил
.cls	tex/latex/base	датотека класе документ
.dvi	doc	документација пакета
.enc	fonts/enc	Кодирање слова
.fd	tex/latex/mfnfss	Датотеке дефиниције слова за METAFONT слова
.fd	tex/latex/psnfss	Датотеке дефиниције слова за PostScript Type 1 слова
.map	fonts/map	Датотеке мапирања слова
.mf	fonts/source/public/typeface	METAFONT контура
.pdf	doc	документација пакета
.pfb	fonts/type1/foundry/typeface	PostScript Type 1 контура
.sty	tex/latex/packagename	Датотека стила: нормални садржај пакета
.tex	doc	TeX извор за документацију пакета
.tex	tex/plain/packagename	Обичне TeX макро датотеке
.tfm	fonts/tfm/foundry/typeface	TeX метрика слова за METAFONT и Type 1 слова
.ttf	fonts/truetype/foundry/typeface	TrueType слова
.vf	fonts/vf/foundry/typeface	TeX виртуелна слова
others	tex/latex/packagename	други типови датотека сем ако нису инструковане другачије

За вићину слова на CTAN-у, foundry је public.

4. Ажирирајте ваш индекс Коначно, покрените ваш TeX програм индексирања да би ажурирали базу података пакета. Овај програм долази заједно са сваком модерном верзијом TeX-а и има разна имена у зависности од LaTeX дистрибуције коју користите. (Прочитајте документацију која долази са вашом инсталацијом да би сазнали које је то име, или консултујте http://www.tug.org/fonts/fontinstall.html#fndb):

• teTeX, TeX Live, fpTeX: texhash
• web2c: mktexlsr
• MacTeX: MacTeX сам ово ради за вас.
• MikTeX: initexmf --update-fndb (или користите GUI)
• MiKTeX 2.7 или касније верзије, инсталиране на виндоус XP и виндоус 7: Start -> All Programs -> MikTex -> Settings. У виндоус 8 користите кључну реч Settings и изаберите опцију Settings са MiKTex логом. У Settings менију изаберите први уметак и кликните на Refresh FNDB-дугме (MikTex ће онда проверити директоријум програмских датотека и онда ће ажурирати листу базе података имена датотеки). Након тога само потврдите кликом на 'OK'.

5. Ажурирајте мапе слова Ако је ваш пакет инсталирао било која TrueType или Type 1 слова, морате да ажурирате датотеке за мапирање слова као допуну ажурирању индекса. Аутор ваг пакета би требало да је укључио .map датотеку за слова. Програм ажурирања мапе је често нека варијанта updmap, у зависности од ваше дистрибуције:

• TeX Live и MacTeX: updmap --enable Map=mapfile.map (ако сте инсталирали датотеке на личној грани) или updmap-sys --enable Map=mapfile.map (ако сте инсталирали датотеке у директоријуму система).
• MikTeX: Покрените initexmf --edit-config-file updmap, додајте ред "Map mapfile.map датотеци која се отвори, затим покрените initexmf --mkmaps.

Погледајте http://www.tug.org/fonts/fontinstall.html.

Разлог зашто овај процес није био широко аутоматизован је да идаље постоје хиљаде инсталација које не одговарају TDS-у, као што су неки старији дељени јуниксови системи и неки мајкрософт виндоус системи, тако да нема начина за инсталациони програм да зна где да стави датотеке: ви морате ово да знате. Такође постоје сситеми где су власник, корисник, или инсталер одабрали да не прате препоручену TDS структуру директоријума, или ово није изводљиво из политичких или безбедоносних разлога (као што је систем дељења где корисник не може да пише заштићеном директоријуму). Разлог зашто постоји texmf-local директоријум (који се назива texmf.local на неким системима) је да обезбеди место за локалне модификације или лична ажурирања, посебно ако сте корисник на дељеном или управљаном систему (јуникс, линукс, ВМС, виндоус НТ/2000/XP, итд.) где можда нећете имати могучност писања главној TeX инсталацијској грани директоријума. Такође можете имати личан texmf поддиректоријум у вашем сопственом директоријуму пријављивања. Ваша инсталација мора бити конфигурисана да прво гледа у ове директоријуме, тако, да би било које ажурирање стандардних пакета било пронађено ту пре него у замењеним копијама у главној texmf грани. Све модерне TeX инсталације би требало ово да раде у сваком случају, ако оне то не раде, можете да уредите texmf/web2c/texmf.cnf сами.

Провера статуса пакета

Универзалан начин да се провери да лије датотека доступна TeX компајлерима је алатка командне линије kpsewhich.

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

kpsewhich ће само тражити датотеке, пакете неће тражитит. Она ће вам вратити пут до датотеке. За више детаља о специфичном пакету користите алатку командне линије tlmgr (само за TeX Live):

tlmgr info <пакет>

Tlmgr има много више опција. Да се консултујете са документацијом:

tlmgr help

Документација пакета

Да бисте сазнали које команде пакет пружа (и самим тим како га користити), потребно је да прочитате документацију. У поддиректоријуму texmf/doc од ваше инсталације требало би да постоји директоријум пун .dvi фајлова, један за сваки пакет инсталиран. Ова локација је специфична за сваку дистрибуцију, али је се обично налази у:

Дистрибуција	Пут
MacTeX	/Library/TeX/Documentation/texmf-doc/latex
MiKTeX	%MIKTEX_DIR%\doc\latex
TeX Live	$TEXMFDIST/doc/latex

Генерално, већина ових пакета се налази у latex поддиректоријуму, иако се други пакети (као што су BibTeX и пакети слова) у другим поддиректоријумима у облику doc. Директоријуми документације имају исто име као и пакет (нпр. amsmath), који генерално садрже један или више битних докумената у разним форматима (dvi, txt, pdf, etc.). Документи генерално имају исто име као и пакет, али постоје и изузеци (на пример, документација за amsmath се налази на latex/amsmath/amsdoc.dvi). ако ваша инсталациона процедура није инсталирала документацију, DVI датотеке се могу преузети са CTAN-а. Пре коришћења документа, требало би да пажљиво прочитате документацију, посебно пододељак који се обично назива "User Interface", који описује команде које које пакет чини доступним. Не можете само да погађате и да се надате да ће радити: морате да прочитате и да сазнате.

Обично можете аутоматски отворити било коју документацију инсталираног пакета са texdoc командом:

texdoc <package-name>

Спољни ресурси

Најбољи начин да се траже LaTeX пакети је већ поменут CTAN: претрага. Додатни ресурси са TeX каталог онлајн:

• Алфабетски каталог
• Са кратким описима
• Тематски каталог са систематски сортираним пакетима
• Хијерархијски угледан на CTAN хијерархију фасцикли

Види још

• LaTeX/Ознаке пакета