LaTeX pod GNU/Linuxom - prvé kroky
Úlohou tohto stručného návodu je doviesť TUKE študenta k funkčnému LaTeX-u pod GNU/Linux-om pre písanie záverečnej práce v univerzitnej šablóne.
Nasledujúci postup predpokladá operačný systém Ubuntu 10.04.
Inštalácia LaTeX-u
Samotná inštalácia je veľmi jednoduchá. Pomocou nasledujúceho príkazu budú z distribúcie TeXlive nainštalované: základ LaTeX-u, podpora slovenčiny, doporučené sady fontov a ďalšie rozšírenia (grécke znaky):
apt-get install texlive-base texlive-lang-czechslovak texlive-fonts-recommended texlive-latex-extra

Balík
texlive-latex-extra zaberá 534MB čo môže znamenať problém. Je potrebný iba, kvôli LaTeX balíku
upgreek.sty. Z CTAN sú stiahnuteľné jeho inštalačné súbory
http://tug.ctan.org/tex-archive/macros/latex/contrib/was/ a inštalácia sa vykoná príkazom
latex upgreek.ins. Výsledný súbor
upgreek.sty stačí jednoducho nakopírovať do priečinka šablóny. Viac informácií o inštalácii do systému obsahuje tento
návod.
Stiahnutie univerzitnej šablóny pre záverečné práce
Nasledujúce príkazy stiahnu a rozbalia zip súbor obsahujúci šablónu záverečnej práce:
wget -O /tmp/tukedip_il2.zip https://etd.lib.tuke.sk/documents/sablony/tukedip_il2.zip
unzip /tmp/tukedip_il2.zip
Po úspešnom vykonaní je v pracovnom priečinku priečinok s názvom
tukedip_il2.
Prvý preklad
Najprv je potrebné vstúpiť do priečinka šablóny:
Funkčnosť prekladu prekladu možno najlepšie vyskúšať nad zatiaľ neupravovaným dokumentom:
Úspešne ukončený preklad končí nasledujúcim výpisom (po druhom prechode prekladača):
...
Output written on tukedip.pdf (28 pages, 182412 bytes).
Transcript written on tukedip.log.
Upravovanie dokumentu
Všetky súbory v šablóne v kódovaní
ISO-8859-2 (latin2). Editor musí byť nastavený tak, aby s týmto kódovním súbory otváral aj ukladal.
Riešenie problémov
Chýbajúci LaTeX balík
Ak LaTeX-u chýba balík používaný v dokumente, tak sa preklad zastaví a objavia sa informácie o chybe. Niekde tam bude uvedené aj meno chýbajúceho balíka (prípadne iného súboru napr. font). Táto situácia má nasledujúce riešenia:
Inštalácia chýbajúceho balíka z repozitára OS
Ak sa ukáže, že systém neobsahuje potrebný LaTeX balík (alebo iný súbor), tak je možnosť vyhľadať ho v repozitári distribúcie operačného systému.
Ubuntu má vyhľadávač v deb balíkoch dostupný na stránke
http://packages.ubuntu.com. V tomto prípade je treba použiť vyhľadávanie v obsahu balíkov
Search the contents of packages. Po nájdení správneho deb balíka, je už jeho inštalácia jednoduchá:
apt-get install <deb-package>
Druhou možnosťou je na vyhľadanie deb balíka použiť príkaz:
apt-file update
apt-file search <pattern>
Kde
<pattern> predstavuje názov súboru alebo len jeho časť.
Manuálna inštalácia chýbajúceho balíka
Manuálnu inštaláciu chýbajúceho balíka možno vykonať podľa návodu priamo od Ubuntu:
Ubuntu community LaTeX documentation
Získanie a uloženie balíka k dokumentu
Ak LaTeX nenájde balík v systémových priečinkoch, tak ho hľadá v pracovnom priečinku dokumentu. Ak sa podarí získať (od niekoho) hotový balík (má príponu
.sty), tak je možné ho uložiť do pracovného priečinka dokumentu (tam kde sú
.tex súbory) a mal by fungovať.
Vynechanie problémového balíka
V prípade, že sa problémový balík nepodarilo žiadnym z predchádzajúcich spôsobov získať a nie je nevyhnutný pre dobrý vzhľad výsledného dokumentu (PDF), tak je možné ho odstrániť. Najprv treba v zdrojovom dokumente (TeX) vyhľadať riadok, na ktorom je príkaz vkladajúci problémový balík:
\usepackage{package-name}[optional-options]
Tento príkaz je možné odstrániť, ale vačšinou je lepšie zakomentovať ho pomocou znaku
% na začiatku riadku a odôvodniť to stručným no výstižným komentárom.
TODO alebo čo ešte treba zdokumentovať
- prekódovanie šablóny do kódovania UTF-8
- info o editoroch
- doladenie šablóny
- SVN, Git pre verzionovanie a zálohovanie
- doplniť upravovanie dokumnetu o informáciu o jeho štruktúre
-- Main.eqo - 11 Apr 2010