Získávání softwaru CSTUG

Za účelem snadné archivace a získávání TeXovského softwaru vyvinula pracovní skupina TUGu tzv. Comprehensive TeX Archive Network (CTAN). Každý počítač zapojený v síti CTAN obsahuje stejný materiál a udržuje jeho aktuální verze. Tato data jsou dosti rozsáhlá. Především všechno, co je zmíněno v těchto otázkách, je většinou na CTANu archivováno.

Servery s CTANem jsou např. ctan.dante.de (Mainz, Nemecko), cam.ctan.org (Cambridge, VB) nebo tug.ctan.org (Colchester, Vermont, USA).

Struktura TeXových souborů je na všech těchto místech identická a začíná v tex-archive. Soubory, které nejsou volně k dispozici (definice tohoto pojmu je ovlivněna hlavně Debian Free Software Guidelines viz URL{http://www.debian.org/social_contract#guidelines}), jsou udržovány v separátním stromu nonfree. Uživatelé archivu by si měli být před použitím baliku stromu nonfree jisti, že jsou k tomu oprávněni.

Na každý uzel CTANu můžete přistupovat přes Web na URL{http://www.dante.de/tex-archive}, URL{http://www.tex.ac.uk/tex-archive} a URL{http://www.ctan.org/tex-archive}. Ne všechny zrcadla CTANu jsou přístupné přes Web. Pro snížení zatížení počítačové sítě používejte prosím vám nejbližší CTAN počítač nebo jeho kopii — „zrcadlo“ (viz Kde je nejbližší zrcadlo archívu CTAN). Kompletní aktuální seznam CTAN počítačů a zrcadel obdržíte příkazem finger ctan@<stroj>, kde <stroj> je adresa jednoho z výše jmenovaných počítačů. Tento seznam je také dostupný jako soubor CTANCTAN-sites

Pro hledání softwaru na CTANu lze použít anonymní ftp (viz Hledání TeXovských/LaTeXovských balíků maker).

E-mailové servery ftpmail@dante.ctan.org a ftpmail@tug.ctan.org nabízejí rozhraní, pomocí nehož můžete získávat soubory podobně jako přes ftp. Chcete-li znát detaily použití tohoto rozhraní, stačí poslat na jednu z výše uvedených adres zprávu obsahující řádek „help“

Konečně, uživatel TeXu, který nemá žádný přístup k síti, si samozřejmě může zakoupit kopii archívu na CDROM (viz TeX na CDROMoch).


Instalace nových balíčků

Chcete-li přidat nový balíček do vašeho LaTeXu, musíte ho nejprve najít (viz Otázku Hledání TeXovských/LaTeXovských balíků maker) a stáhnout (viz Otázku Hledání souborů v archívu CTAN). Běžně můžete stáhnout celý distribuovaný adresář; jediný případ, kdy není celý adresář nutný, je, pokud stahujete z LaTeXových adresářů na CTANu; tyto adresáře obsahují sadu jednotlivých souborů, které jsou samy o sobě kompletní. Malé balíčky mohou být obvykle samostatné soubory s příponou .sty (typickým příkladem je smallpack.sty) s návodem k použití obsaženém uvnitř nebo v samostatném manuálu nebo v souboru README. Typicky však balíček (pack) bývá nabízen jako dvojice souborů pack.inspack.dtx. Jejich kód musí být načten z těchto souborů. Pokud je součástí jejich distribuce též soubor README, použijte ho tak, jak název říká! Uživatelský manuál a dokumentovaný zdrojový kód balíčku je obsažen v souboru .dtx, zatímco soubor .ins obsahuje LaTeXové instrukce říkající, který kód má být ze souboru .dtx „vytažen“.

Balíček pack rozbalíte následovně:

  • Spusťte LaTeX na pack.ins. Tím se vygeneruje jeden nebo více souborů (běžně pack.sty, avšak, jedná-li se o zvláštní balíček, mohou zde být i jiné související soubory).
  • Spusťte LaTeX na soubor pack.dtx, čímž získáte uživatelský manuál a v některých případech i komentovanou verzi kódu.
  • Spusťte LaTeX ještě jednou na soubor pack.dtx, čímž můžete vyřešit některé odkazy a vygenerovat tabulku obsahů, pokud byly vyžádány.
  • LaTeX při této činnosti může zahlásit chybu „No file pack.ind“; to je pro index příkazů; pokud chcete tento index vytvořit, zpracujete tento materiál příkazem makeindex -s gind.ist pack a spustíte LaTeX znovu.
  • Vytiskněte a přečtěte si soubor pack.dvi.
Občas bývá uživatelský manuál nabízen odděleně v souboru .dtx. Téměř posledním krokem, který je nutný udělat, je překopírování souboru tam, kde ho LaTeX najde. Kde se nachází toto kouzelné místečko, záleží na LaTeXové verzi, kterou máte k dispozici, a na tom, jak je systém nastaven (viz Otázku Kam mám uložit nové soubory?). Nakonec ještě musíte říct LaTeXu, že jste mu přidali nový soubor nebo soubory a kde ho (je) má najít. Většina volně šiřitelných LaTeXů má jakousi databázi jmen a umístění souborů, které využívá ke své činnosti, pro rychlejší vyhledávání. V těchto případech pak ona databáze musí být pravidelně aktualizována pomocí skriptů, které bývají pro tento účel distribuovány.
  • teTeX, fpTeX — spusťte texhash
  • web2c — v běžných distribucích by měl fungovat texhash, pokud nefunguje, pak spouštějte mktexlsr
  • MikTeX — V MikTeXu verze nižší než 2.0 proveďte toto: Start → Programs → MikTeX → Maintenance → Refresh filename database nebo otevřete DOSové okno a spusťte inittexmf --update-fndb V MikTeXu verze 2.0 a vyšší proveďte start → Programs → MikTeX 2 → MikTeX Options a stiskněte tlačítko Update filename database.
PAMATUJTE, že příkaz \usepackage{pack} musí být v preambuli každého souboru, který balíček pack používá.


Kam mám uložit nové soubory?

Kam máte správně uložit soubory, které jste si stáhli, závisí na TeXové distribuci, kterou vlastníte. Nicméně předpokládejme, že vlastníte verzi, která vyhovuje TDS (např. teTeX, fpTeX nebo MikTeX). Zde platí následující pravidla, jimiž se musíte řídit:

  • (1) Vždy instalujte nové soubory do adresáře texmf nebo jeho podadresářů. Kořenový adresář bývá často pojmenován následovně:
    teTeX{}:    /usr/share/texmf.local/
    pfTeX{}:    c:\fptex\texmf.local\
    mikTeX{}:   c:\localtexmf\
    
    Dále používejme pro tento adresář zkratku $TEXMF

  • (2) Ve vašem lokálním adresáři texmf napodobte adresářovou strukturu z vašeho hlavního stromu. Zde jsou příklady toho, kam soubor s danou příponou uložit:
    .cty .cls nebo .fd     $TEXMF/tex/latex/package/
    .dvi .ps nebo .pdf     $TEXMF/doc/latex/package/
    .tfm                   $TEXMF/fonts/tfm/supplier/font/
    .vf                    $TEXMF/fonts/vf/supplier/font/
    .afm                   $TEXMF/fonts/afm/supplier/font/
    .pfb                   $TEXMF/fonts/type1/supplier/font/
    .ttf                   $TEXMF/fonts/truetype/supplier/font/
    
    Kde <font>, <package><supplier> závisí na každém souboru.


„Dočasné“ inštalácie súborov TeXu alebo LaTeXu

Operačné systémy a aplikácie potrebujú vedieť, kde hľadať súbory. Mnoho súborov, ktoré potrebujú, majú uvedené iba meno — používateľ nevie, kde sa nachádzajú, ale vie sa na ne spýtať. Najbežnejším prípadom sú príkazy, ktorých mená píšete do shellu (áno, aj vo Windows). Používajú shell na čítanie toho, čo napíšete. Mnoho príkazov zahŕňa nahranie a vykonanie súboru. Premenná PATH povie shellu, kde tieto súbory nájsť.

Moderné distribúcie TeXu obsahujú mnoho zabudovaných ciest na prehľadávanie (cesta=path). Vo väčšine prípadov sú tieto cesty správne, ale niekedy ich potrebujete rozšíriť, aby zachytili aj súbory na neobvyklých miestach (napríklad si môžeme chcieť vyskúšať balík pred jeho inštaláciou — viď Otázku Instalace nových balíčků). Musíme teda zmeniť relevantnú cestu tak, ako ju TeX vníma. Nechceme ale zahodiť zabudovanú cestu TeXu (TeX by si zrazu nevedel s ničím rady).

Pre rozšírenie TeXovskej cesty definujeme premennú prostredia operačného systému vo formáte cesty vynechajúc medzeru, ktorú TeX vyplní hodnotou jeho zabudovanej cesty. Najčastejšie chceme naše rozšírenie umiestniť pred cestu, aby boli nové veci preferované (takže „medzeru na zaplnenie“ vynecháme na konci premennej). Syntax je jednoduchá (aj keď závisí na tom, ktorý shell používate): na systémoch podobných Unixu, používajúcich bash shell, môžete postupovať nasledovne:

  export TEXINPUTS=/tmp:
kým na systéme Windows, v okne MSDOS, to bude:
  set TEXINPUTS=C:/temp;
V oboch prípadoch žiadame TeX, aby nahrával súbory z dočasného (temporary) adresára na koreňovom disku. V prípade Unixu je „prázdne miesto“ vyznačené oddeľovačom cesty ':' na konci riadku, pre Windows je postup rovnaký, ale oddeľovač je ';'.

Všimnite si, že pri oboch druhoch systémov zmena ovplyvní iba inštancie TeXu spustené zo shellu, v ktorom bola premenná nastavená. Ak spustíte TeX z iného okna, použije pôvodnú cestu. Pre zmenu platnú pre všetky okná nastavte premennú prostredia vo svojom prihlasovacom skripte alebo profile na systéme Unix, následne sa odhláste a opäť prihláste. V systéme Windows môžete premennú nastaviť v súbore autoexec.bat a reštartovať systém.

Zataiľ sme uviedli postupy pre TeX súbory makier, avšak postup je aplikovateľný na ľubovolný druh súboru, ktorý je čítaný ľubovolným TeXu príbuzným programom — existuje mnoho takýchto ciest a im príslušných premenných prostredia. V systéme založenom na web2c vám v tomto pomôžu bohaté poznámky v súbore texmf.cnf.


Inštalácia nového fontu

Fonty sú v skutočnosti iba ďalším balíkom, takže by mali byť inštalované rovnakým spôsobom ako balíky. Fonty však zvyknú byť komplikovanejšie než priemerné balíky, dôsledkom čoho je občas ťažké vidieť celkovú štruktúru.

Súbory fontov sa môžu objaviť vo veľkom počte formátov. Každý formát má v TeXovskom systéme odlišnú funkciu a každý je uložený v adresári svojho vlastného podstromu inštalačného stromu TDS. Všetky tieto podstromy majú ako svoj koreň adresár $TEXMF/fonts. Nasledujúce odpovede popisujú inštaláciu fontov v konkrétnych formátoch.


Inštalácia fontov v podobe zdrojových súborov METAFONTu

Metafontovské fonty sú (v porovnaní s inými druhami fontov) poťešujúco jednoduché. V súčasnosti sú väčšinou distribuované iba ako zdrojové súbory METAFONTu, kedže moderné distribúcie TeXu sú schopné vyprodukovať všetko potrebné „za behu“. Ak však distribúcia neobsahuje TFM súbory, nainštalujte ich tiež (šetria trochu času a zaberajú málo miesta). Nikdy neverte distribúciam bitmapových súborov PK fontov: neexistuje spôsob, ako z nich zistiť tlačiareň, pre ktorú boli generované, menné schémy pod rozličnými operačnými systémami sú ďalším zdrojom zmätku.


Inštalácia fontu postscriptovej tlačiarne

Existuje štandardná sada fontov, ktorá sa objavuje v každej postscriptovej tlačiarni od jeho druhej generácie. Tieto fonty (8 rodín štyroch textových fontov a tri fonty na špeciálne účely) sú samozrejme používané širokým okruhom ľudí, pretože sú jednoducho dostupné. Sada pozostáva z:

  • Times rodina (4 fonty)
  • Palatino rodina (4 fonty)
  • New Century Schoolbook rodina (4 fonty)
  • Bookman rodina (4 fonty)
  • Helvetica rodina (4 fonty)
  • Avant Garde (4 fonty)
  • Courier rodina (4 fonty)
  • Utopia rodina (4 fonty)
  • Zapf Chancery (1 font)
  • Zapf Dingbats (1 font)
  • Symbol (1 font)
Všetky tieto fonty sú podporované (pre používateľov LaTeXu) sadou metrík psnfss a podpornými súbormi zo súboru lw35nfss.zip na CTANe. Takmer každý aspoň vzdialene moderný TeXovský systém má nenainštalovanú nejakú verziu psnfss. Používatelia by si však mali pamätať, že posledné verzie majú podstatne lepšie pokrytie matematiky v rámci fontov TimesPalatino, ako aj spoľahlivejšiu sadu metrík.

Archív lw35nfss.zip je navrhnutý podľa TDS, takže inštalácia v princípe pozostáva iba z rozbalenia súboru do koreňového adresára texmf stromu.

Dokumentácia balíku psnfss je poskytovaná v súbore psnfss2e.pdf v distribúcii. Otázka Kam mám uložit nové soubory? udáva, kam sa majú súbory umiestniť. Neporiadok prinášajú rodiny fontov, ktorých autori navrhujú pravidlá pre automatické generovanie zdrojových súborov METAFONTu pre generovanie fontov konkrétnych veľkostí. Inštalácia musí o pravidlách vedieť, pretože inak nemôže generovať súbory fontov.
psnfss: CTANpsnfss


Jak umístit vlastní příspěvek do archívů

Použijte anonymní ftp na jakýkoliv CTAN počítač (viz Co je CTAN) a stáhněte si README.uploads v kořenovém adresáři. Obsahuje instrukce pro umísťování souborů a informování lidí, kteří mají místní archív na starosti.

Můžete jít taky cestou Webu: všechny hlavní servery CTANu poskytují stránku pro upload  — máte nasledující možnosti: URL{http://www.ctan.org/upload.html}, URL{http://www.dante.de/CTAN/upload.html} nebo URL{http://www.tex.ac.uk/upload.html}. Stránky vás samy provedou potřebným procesem.

Nemůžete-li použít anonymní ftp, pošlete svůj příspěvek e-mailem na ctan@dante.de. Všem ulehčíte život, jestliže vyberete pro svůj produkt trefné a jednoznačné jméno, takže by bylo dobré předem zkontrolovat, jestli se jméno vašeho .sty souboru již náhodou nepoužívá, což lze prostřednictvím příkazu „site index“ (viz Co je CTAN). Mějte na paměti, že veřejně lze vystavovat pouze software, jehož autoři proti tomu nemají námitek.


Hledání nových fontů

Podrobný seznam METAFONT fontů posílá do usenetových skupin comp.fontscomp.text.tex zhruba každých šest týdnů Lee Quin (lee@sq.sq.com). Je též dostupný jako CTANmf-list

Většina nových fontů jsou ve formě zvětšovatelných obrysových fontů nebo jiné (viz Otázku Výběr zvětšovatelných obrysových fontů) a jsou téměř všechny distribuovány v rámci komerčných podmínek.


TeX na CDROMoch

Ak nemáte prístup k Internetu, určite vás zaujíma kolekcia TeXu na CDROMoch. Dokonca aj tí, čo prístup k Internetu majú, môžu zistiť, že mať veľké množstvo s TeXom spojených súborov poruke je veľmi príjemné.

Na TeX Live CDROMe je systém pripravený na okamžité spustenie. Jeho ôsma edícia bola vydaná v roku 2003. CDROM bol pôvodne vyvíjaný pod záštitou konzorcia použivateľských skupín (hlavne TUG, UK TUG a GUTenberg). Všetci členovia rozličných použivateľských skupín dostávajú kópie zadarmo. Niektoré skupiny taktiež predávajú dodatočné kópie: kontaktujte vašu miestnu skupinu alebo viď Co je to TUG a TUGboat .

Detaily týkajúce sa TeX Livu sú dostupné z vlastnej stránky na serveri TUG: URL{http://www.tug.org/texlive.html}.

Alternatívou k systému pripravenému na okamžité spustenie je „snapshot“ archívu CTANu. Čakalo by sa, že takýto systém sa zložitejšie používa, ale množstvo zdrojov túto nepríjemnosť vyvažuje. Kedysi existovali na tomto poli komerčné ponuky, ale dnes je poskytovaný „snapshot“ (dodávaný raz ročne) jediným zdrojom svojho typu.


CSTUG
(c) 1997, 1998, 2003 Tomáš Hudec, Libor Škarvada
Poslední aktualizace: 13.11.2004 23:15