Dokumentace a nápověda CSTUG

Knuthova kniha je vyčerpávající referenční příručkou pro TeX, ale existují i jiné knihy pokrývající TeX:

  • The TeXbook od Donalda Knutha (Addison-Wesley, 1984, ISBN 0-201-13447-0, brožované ISBN 0-201-13448-9)
  • A Beginner's Book of TeX od Raymonda Seroula and Silvia Levyho, (Springer Verlag, 1992, ISBN 0-387-97562-4)
  • TeX by Example: A Beginner's Guide od Arvinda Bordeho (Academic Press, 1992, ISBN 0-12-117650-9)
  • Introduction to TeX od Norberta Schwarze (Addison-Wesley, 1989, ISBN 0-201-51141-X)
  • A PlainTeX Primer od Malcolma Clarka (Oxford University Press, 1993, ISBNs 0-198-53724-7 tvrdá vazba, a 0-198-53784-0 brožované)
  • A TeX Primer for Scientists od Stanleyho Sawyera a Stevena Krantze (CRC Press, 1994, ISBN 0-849-37159-7)
  • TeX by Topic od Victora Eijkhouta (Addison-Wesley, 1992, ISBN 0-201-56882-9)
  • TeX for the Beginner od Wyntera Snowa (Addison-Wesley, 1992, ISBN 0-201-54799-6)
  • TeX for the Impatient od Paula W. Abrahamse, Karla Berryho a Kathryn A. Hargreavesové (Addison-Wesley, 1990, ISBN 0-201-51375-7)
  • TeX in Practice od Stephana von Bechtolsheima (Springer Verlag, 1993, 4 svazky, ISBN 3-540-97296-X celek, nebo Vol. 1: 0-387-97595-0, Vol. 2: 0-387-97596-9, Vol. 3: 0-387-97597-7, a  Vol. 4: 0-387-97598-5). jednotlivě.
  • TeX: Starting from Square One od Michaela Dooba (Springer Verlag, 1993, ISBN 3-540-56441-1)
  • The Joy of TeX od Michaela D. Spivaka (druhá edice, AMS, 1990, ISBN 0-821-82997-1)
  • The Advanced TeXbook od Davida Salomona (Springer Verlag, 1995, ISBN 0-387-94556-3)

K dispozici je také kolekce Knuthových publikací týkajících se typografie:

  • Digital Typography od Donalda Knutha (CSLI and Cambridge University Press, 1999, ISBN 1-57586-011-2, paperback ISBN 1-57586-010-4).
a koncem roku 2000 byla vydavatelstvem Addison Wesley publikována „Millennium Boxed Set“ sada 5 dílů Knuthovy knižní série „Computers and Typesetting“ (o TeXu a METAFONTu):
  • Computers & Typesetting, Volumes A–E Boxed Set od Donalda Knutha (Addison-Wesley, 2001, ISBN 0-201-73416-8).

K LaTeXu viz:

  • LaTeX, a Document Preparation System od Leslieho Lamporta (druhé vydání, Addison Wesley, 1994, ISBN 0-201-15790-X)
  • A guide to LaTeX od Helmuta Kopky a Patricka W. Dalyho (Addison Wesley, ISBN 0-201-56889-6)
  • The LaTeX Companion od Michela Goossense, Franka Mittelbacha, a Alexandera Samarina (Addison Wesley, 1993, ISBN 0-201-54199-8)
  • The LaTeX Graphics Companion: Illustrating documents with TeX and PostScript od Michela Goossense, Sebastiana Rahtze a Franka Mittelbacha (Addison-Wesley, 1997, ISBN 0-201-85469-4)
  • The LaTeX Web Companion: Integrating TeX, HTML and XML od Michela Goossense a Sebastiana Rahtze (Addison-Wesley, 1999, ISBN 0-201-43311-7)
  • TeX Unbound: LaTeX and TeX strategies for fonts, graphics, and more od Alana Hoeniga (Oxford University Press, 1998, ISBN 0-19-509685-1 hardback, ISBN 0-19-509686-X paperback)
  • Math into LaTeX: An Introduction to LaTeX and AMSLaTeX od George Gr"atzera (třetí edice Birkh"auser and Springer Verlag, 2000, ISBN 0-8176-4431-9, ISBN 3-7643-4131-9)

    K dispozici je errata pro první vydání: URL{http://www.springer-ny.com/catalog/np/jan99np/0-387-98708-8.html}

  • First Steps in LaTeX od George Gr"atzera (Birkh"auser, 1999, ISBN 0-8176-4132-7)
  • LaTeX Notes: Practical Tips for Preparing Technical Documents od J. Kennetha Shultise (Prentice Hall, 1994, ISBN 0-131-20973-6)
  • LaTeX Line by Line od Antoniho Dillera (John Wiley & Sons, 1993, ISBN 0-471-93471-2)
  • LaTeX for Scientists and Engineers od Davida J. Buergera (McGraw-Hill, 1990, ISBN 0-070-08845-4)
  • LaTeX for Linux: A Vade Mecum od Bernice Sackse Lipkina (Springer-Verlag, 1999, ISBN 0-387-98708-8, dotisk)
  • Math into TeX: A Simplified Introduction using AMSLaTeX od George Grätzera (Birkhäuser, 1993, ISBN 0-817-63637-4)
  • LaTeX pro začátečníky od Jiřího Rybičky (třetí vydání, KONVOJ, 2003, ISBN 80-7302-049-1)
Z tohoto seznamu pouze Lamport a Goosens s Mittelbachem a Samarinem pokrývají LaTeX 2e, nicméně jsou zprávy o tom, že se připravují aspoň některá nová vydání.

Seznam pro METAFONT je o dost kratší:

  • The METAFONTbook od Donalda Knutha (Addison Wesley, 1986, ISBN 0-201-13445-4)
TeX Unbound Alana Hoeniga obsahuje přiklady použití METAFONTu.

Kniha pokrývající široké spektrum témat (včetně instalace a udržování) je:

  • Making TeX Work od Normana Walshe (O'Reilly and Associates, Inc, 1994, ISBN 1-56592-051-1)

Kniha je citelně zastaralá a momentálně je rozebraná. Kopie je však dostupná prosřednictvým sourceforge a na CTANu v sekci „tutoriály“ (viz. Otázku Tutoriály k TeXu nebo LaTeXu).


Knihy o písme

Nasleduje neúplný zoznam kníh venujúcich sa typografii obecne, Bringhurstova kniha je najčastejšie odporúčaná.

  • The Elements of Typographic Style od Roberta Bringhursta (Hartley & Marks, 1992, ISBN 0-88179-033-8)
  • Finer Points in the Spacing & Arrangement of Type od Geoffreyho Dowdinga (Hartley & Marks, 1996, ISBN 0-88179-119-9)
  • The Thames & Hudson Manual of Typography od Ruariho McLeana (Thames & Hudson, 1980, ISBN 0-500-68022-1)
  • The Form of the Book od Jana Tschicholda (Lund Humphries, 1991, ISBN 0-85331-623-6)
  • Type & Layout od Colina Wheildona (Strathmore Press, 1995, ISBN 0-9624891-5-8)
  • The Design of Books od Adriana Wilsona (Chronicle Books, 1993, ISBN 0-8118-0304-X)
  • Typografický manuál od Vladimíra Berana a kolektívu (tretie vydanie, Kafka design, 2003)

Existuje mnoho vzorníkov písiem, ale nasledujúce knihy poskytujú zaujímavejší pohľad na písma a ich históriu všeobecne.

  • Alphabets Old & New od Lewisa F. Daya (Senate, 1995, ISBN 1-85958-160-9)
  • An Introduction to the History of Printing Types od Geoffreyho Dowdinga (British Library, 1998, UK ISBN 0-7123-4563-9; USA ISBN 1-884718-44-2)
  • The Alphabet Abecedarium od Richara A. Firmagea (David R. Godine, 1993, ISBN 0-87923-998-0)
  • The Alphabet and Elements of Lettering od Fredericka Goudyho (Dover, 1963, ISBN 0-486-20792-7)
  • Anatomy of a Typeface od Alexandra Lawsona (David R. Godine, 1990, ISBN 0-87923-338-8)
  • A Tally of Types od Stanleyho Morisona (David R. Godine, 1999, ISBN 1-56792-004-7)
  • Counterpunch od Freda Smeijersa (Hyphen, 1996, ISBN 0-907259-06-5)
  • Treasury of Alphabets and Lettering od Jana Tschicholda (W. W. Norton, 1992, ISBN 0-393-70197-2)
  • A Short History of the Printed Word od Warrena Chappella a Roberta Bringhursta (Hartley & Marks, 1999, ISBN 0-88179-154-7)


Kde nájdem FAQ?

Článok Bobbyho Bodenheimera, z ktorého vznikla anglická verzia FAQ, bol mesačne uverejňovaný v usenetových skupinách comp.text.tex, news.answers a comp.answers. Jeho posledná (pomerne zastaralá) kópia je na CTANe a naďalej nie je udržovaná v archíve skupiny news.answers.

Aktuálna verzia anglického FAQ je prístupná cez World-Wide Web na URL URL{http://www.tex.ac.uk/faq}. Zdrojové súbory aktuálneho anglického FAQ sú prístupné cez CTAN.

Ďalším skvelým anglickým zdrojom informácií je TeX/LaTeX navigator: http://tex.loria.fr.

Frankofónna skupina používateľov TeXu Gutenberg a Československé združenie používateľov TeXu CSTUG publikovali vlastné preklady anglickej verzie FAQ (práve čítate preklad CSTUGu) spolu s rozšírením o informácie relevantné pre ich jazyk.

Skvelý dokument je LaTeX tips and tricks (http://www.educat.hu-berlin.de/~voss/LaTeX/) od Herberta Voss{}a. Poskytuje vynikajúce rady vo väčšine oblastí (aj keď sa nedá striktne označiť ako FAQ) a je veľmi odporúčaný pre použitie bežnými smrteľníkmi.

Open Directory Project (ODP) udržuje zoznam zdrojov podpory pre TeX/LaTeX, vrátane mnohých FAQ (viď URL{http://dmoz.org/Computers/Software/Typesetting/TeX/}).

Neanglické FAQ:

  • nemecké Pravidelne publikované v diskusnej skupine de.comp.tex a archivované na CTANe (súbor CTANdante-faq). FAQ sa objavuje taktiež na URL{http://www.dante.de/faq/de-tex-faq/}.
  • francúzske Pravidelne publikované v skupine fr.comp.text.tex a archivované samozrejme na CTANe (CTANfrench-faq).
  • španielske Viď URL{http://apolo.us.es/CervanTeX/FAQ/}
  • české a slovenské Viď URL{http://www.fi.muni.cz/cstug/csfaq/}


Kde najdu pomoc?

Nejprve si přečtěte tyto FAQ. Ambiciózní projekt podobný FAQ, který sbírá veškeré informace o TeXu, existuje na URL http://ctv.es/USERS/irmina/TeEncontreX.html. Podobně jako každé FAQ, i tento projekt potřebuje podporu a pomoc všech uživatelů – doposud nabízí nekompletní sadu odpovědí na potenciální otázky. Zdrojové kódy této aplikace (včetně sady HTML souborů) jsou dostupné v CTANteencontrex. Tutoriál a další on-line dokumentaci (viz Otázku Tutoriály k TeXu nebo LaTeXu) můžete použít, pokud s TeXem začínáte. Pro hlubší porozumnění je lepší získat a přečíst přinejmenším jednu z mnoha dobrých knih s touto tématikou (viz Otázku Knihy o TeXu a příbuzná literatura).

Pokud sháníte jednotlivý program nebo balík, podívejte se nejprve ve svém systému, můžete ho tam klidně mít – lepší verze LaTeXu totiž nabízejí navíc širokou škálu souvisejících materiálů.

Jestliže máte přístup k Internetu a jednotlivým diskusním skupinám, pak můžete diskuse o LaTeXu, METAFONTu a METAPOSTu sledovat v diskusní skupině comp.text.tex. Nejlepší je si důkladně pročíst všechna vlákna, než se na něco zeptáte. Reakce v této skupině jsou běžně poměrně rychlé, ale její čtenáři nejsou příliš nadšeni, když se někdo ptá na otázku, která byla zodpovězena před pár dny. Na adrese http://www.deja.com/usenet se nachází systém pro archivaci usenetových skupin, kde můžete najít i comp.text.tex. Archív je stále příležitostně nápomocný, zvláště při prohlížení novějších vláken.

Archiv usenetových skupin můžete najít na URL{http://groups.google.com/} (najdete tady i comp.text.tex). Archiv Google obsahuje taky informace týkající se dávné minulosti (z dob před vznikem comp.text.tex) a často je nenahraditelným pomocníkem při hledání odpovědi, na kterou si už nikto nemůže spomenout. Taktéž umožňuje položiť vlastní otázku, případne odpověď.

Pokud váš přístup na Internet nezahrnuje přímý přístup  diskusním skupinám, můžete se účastnit diskuse na Deja nebo podobných službách. Lidé, kteří nemají přístup k webovému rozhraní ani k diskusním skupinám, avšak mohou používat elektronickou poštu, si pomáhají pomocí mailing-listů. Mezi takovéto služby patří TeXhax, což je moderovaná elektronická diskuse. K němu se připojíte zasláním zprávy „subscribe texhax“ na adresu texhax-request@tex.ac.uk. Jeho odezva není příliš rychlá, ale předložené otázky se většinou dočkají odpovědí. Dalším mailing-listem je info-tex, do něhož se přihlásíte zasláním zprávy „subscribe info-tex <vaše jméno>“ na listserv@shsu.edu. Mnoho mailing-listů pokrývá některé malé části TeXové problematiky. Dobrý zdroj odkazů lze nalézt na http://www.tug.org.

Oznámení o TeXu příbuzných instalacích umístěných v archívu CTAN jsou posílány do mailing listu ctan-ann. Do něho se přihlásíte posláním zprávy „subscribe ctan-ann <vaše jméno>“ na adresu listserv@urz.Uni-heidelberg.de. Problémy METAFONTu (a stále více i METAPOSTu) jsou diskutovány na mailing listu metafont, do něhož se přihlásíte překvapivě zprávou s testem „subscribe metafont <vaše jméno>“ poslanou na adresu listserv@ens.fr. Několik dalších mailing listů o TeXu je přístupných přes mail listserv@urz.uni.heidelberg.de. Stačí poslat pouze mail obsahující řádek „help“ v těle zprávy na tuto adresu.

Usenetová skupina pro Co je dokumentované programování comp.programming.literate je zrcadlena do elektronické konference litprog. Přihlášení se provede zasláním zprávy „subscribe litprog <vaše jméno>“ na listserv@shsu.edu.


Dokumentace k BibTeXu

BibTeX je program původně určený k produkci bibliografií ve spojení s LaTeXem. Je popsán v oddíle 4.3 a příloze B v příručce o LaTeXu od Leslieho Lamporta (viz Knihy o TeXu a příbuzná literatura). Úplnější popis podává dokument BibTeXing obsažený v souboru btxdoc.tex. The LaTeX Companion (viz Knihy o TeXu a příbuzná literatura) rovněž obsahuje informace o BibTeXu a psaní BibTeXových stylů.

Dokument Designing BibTeX Styles je v souboru btxhak.tex a popisuje postfixový zásobníkový jazyk, který se používá pro psaní BibTeXovských stylů (soubory .bst). Soubor btxbst.doc je předlohou pro čtyři standardní styly (plain, abbrv, alpha, unsrt). Obsahuje též jejich dokumentaci. Úplná kolekce dokumentace k BibTeXu (zahrnující i zmíněné soubory) je v CTANbibtex-doc

Existuje též unixová manuálová stránka BibTeX v balíku web2c (viz TeX/LaTeX pro různé počítače). Nepoužívejte kopie zastaralých manuálových stránek, napsaných v roce 1985, dříve než se objevily dokumenty BibTeXingDesigning BibTeX Styles.


Tutoriály k TeXu nebo LaTeXu

Některé dobré tutoriály byly napsány až několik let po vydání TeXu. Dlouhou dobu je přístupný stabilní tutoriál Gentle Introduction to PlainTeX Michaela Dooba. Podívejte se na CTANgentle. Zevrubnější je tutoriál (Not so) Short Introduction to LaTeX 2e který je pravidelně aktulizován na podněty čtenářů (CTANlshort).

Nejmodernější tutoriál je Simplified Introduction to LaTeX od Harveye Greenberga. Ten byl napsán pro přednáškový cyklus a je dostupný (pouze v postscriptu, bohužel) na adrese CTANsimpl-latex.

Příjemným čtením je také Beginner's LaTeX Petera Flynna (také vznikl jako studijní materiál). Jeho kopie existuje na CTANu (CTANbeginlatex-pdf), je možné jej také najít na (URL{http://www.tex.ac.uk/tex-archive/info/beginlatex/html/}).

TUG India pracuje na sérii LaTeXovských tutoriálů, které je možno jen doporučit. Vybírejte si po kapitolách z URL{http://www.tug.org.in/tutorials.html}. Zatím se skládá jenom ze dvou částí: Text a Grafika.

Další skvělý dokument, který není ani FAQ, ani tutoriálem, je LaTeX tips and tricks (http://www.educat.hu-berlin.de/~voss/LaTeX/) Herberta Voss{}e.

Zajímavý (a velice praktický) je tutoriál l2tabu nebo A list of sins of LaTeX 2e users typu „jak ne“ Marka Trettina (přeložený do angličtiny J"urgenem Fennem). Tutoriál je dostupný skrze CTAN (CTANl2tabuen, nebo jej můžete také získat v podobě zdrojového souboru CTANl2tabuen.src).

AMS publikuje Short Math Guide for LaTeX (dostupné v různých formátech na URL{http://www.ams.org/tex/short-math-guide.html}).

Herbert Voss{} pracuje na dalším užitečným dokumentu, jež je částí jeho výše uvedených tipů a triků (URL{http://www.perce.de/LaTeX/math/Mathmode-TeX.pdf}).

Keith Reckdahl přispívá dokumentem Using Imported Graphics in LaTeX 2e sloužícím jako výborný úvod do používání grafiky (ikdyž je mírně zastaralý a zmiňuje jenom cestu dvips). Je dostupný na CTANu (CTANepslatex, CTANepslatex_ps), leč bohužel bez zdrojových souborů.

Nedocenitelnou příručkou typu krok za krokem na vytvoření „work flow“ prostřednistvým vašeho TeXovského systému, aby se výstup objevil ve správné velikosti a pozici na papíru standardních rozměrů a aby byla kvalita postačující, je testflow od Mike Shella. Tutoriál je sestaven z velkého plaintextového dokumentu, dodáván je taky podpůrný LaTeXovský soubor spolu se správným výstupem v PostScript i PDF (pro A4 i „letter“ formáty papíru). Kompletní sada je dostupna na CTANu (distribuována s makrami autora pro dokumenty pro IEEE publikace).

Pro plain TeXovské příkazy existuje hezká rychlá referenční minipříručka od Johna W. Shipmana (http://www.nmt.edu/tcc/help/pubs/texcrib.pdf).

Některé sekce univerzit uvolňují svou dokumentaci na webu. Je to většinou překlad existující dokumentace do HTML (např. INFO dokumentace TeXovské/LaTeXovské instalace na URL{http://www.tac.dk/cgi-bin/info2www?(latex)})

Některé navíc mají nadšené lidi zabývající se dokumentací na podporu TeXu. Kupříkladu Tim Love udržuje stránky Cambridge University Engineering Department na URL{http://www-h.eng.cam.ac.uk/help/tpl/textprocessing/} a Mimi Burbank stránky School of Computer Science & Information Technology at the University of Florida na URL{http://www.csit.fsu.edu/ mimi/tex/}.

Mnozí se dlouze přeli o dostupnost TeXovských knížek na webu. Kniha TeX by Topic Victore Eijkhouta (publikována vydavatelstvem Addison-Wesley, již delší dobu ale rozebrána) byla tímto spůsobem poskytnuta o Vánocích 2001. Aktuálně k dispozici na URL{http://www.eijkhout.net/tbt/} (není vhodná pro začátečníky, ale je to dobrá příručka; přispěvatelé do knihy jsou vítáni).

Addison-Wesley taktéž uvolnila copyright TeX for the Impatient Paula W. Abrahamse, Karla Berryho and Kathryn A. Hargreavesové, další knihy, jejíž nedostupnost byla mnohými oplakána. Autoři knihu znovu vydali pod GNU general documentation licence, je dostupná na CTANu (CTANTftI).

Kniha Norma Walshe Making TeX Work je také zdarma k dispozici na URL{http://makingtexwork.sourceforge.net/mtw/}; zdrojové soubory webových stránek jsou jako vždy dostupné na CTANu (CTANmtw).

Svého času byla skvělým zdrojem informací, ale teď je již mírně zastaralá. Každopádně však má ještě své využití a je vítaným přírůstkem do seznemu online zdrojů. Projekt na její aktualizaci je zřejmě na cestě.


Dokumentácia k balíkom

Dokument ako tento často odporúčajú na riešenie konkrétnych problémov pre konkrétne balíky. Odpoveď však často neposkytuje presný postup. Ako má ale užívateľ získať presný postup na riešenie problému?

V lepšom prípade je potrebný balík obsiahnutý už vo vašej inštalácii TeXu. V ešte lepšom prípade používate distribúciu poskytujúcu dokumentáciu k balíkom v dobre prezerateľnej forme. V systéme založenom na teTeXu je napríklad veľmi užitočný príkaz texdoc:

  texdoc footmisc
je príkaz, ktorý otvorí dokumentáciu k balíku footmisc v okne xdvi. texdoc podľa prípony vyhľadá a spustí program xdvi, ghostscript alebo PDF prehliadač. Ak dokumentáciu nenájde, môže spustiť internetový prehliadač na prezretie vlastnej kópie katalógu CTANu.

V horšom prípade musíte nájsť dokumentáciu inými prostriedkami. V tomto prípade si precvičíte svoj dôvtip, pretože si dokumentáciu musíte nájsť sami. Nasledujúci text ponúka niekoľko možných spôsobov ako uspieť.

Najobvyklejšia forma dokumentácie k doplnkom LaTeXu je .dtx súbor, v ktorom je distribuovaný zdrojový kód (viď Otázku Dokumentované LaTeXovské zdroje (.dtx soubory)). Tieto súbory by mali byť spracovateľné samotným LaTeXom, avšak na ceste k čitateľnej dokumenácii sa môžu vyskytnúť občasné zádrhele. Častým problémom je potreba samotného balíku na spracovanie jeho dokumentácie (balík musí byť pred spracovaním rozbalený) alebo nemožnosť spracovania .dtx súboru LaTeXom. V druhom prípade .ins súbor zvyčajne vyprodukuje .drv (alebo podobne pomenovaný) súbor. Tento súbor následne necháte spracovať LaTeXom (občas spomenie autor tento fakt v súbore README daného balíku).

Osobitný súbor s dokumentáciou je ďalšou často sa vyskytujúcou formou. Ak je totiž balík rozsiahly (potrebuje teda rozsiahlu dokumentáciu), bola by táto zbytočnou záťažou pre .dtx súbor. Príkladom môže byť trieda memoir, ktorej dokumentácia (memman) je vychvaľovaná ako úvod do zvyklostí sadzby, sada KOMA-script, ktorej vývojári vytvárajú dokumentáciu v angličtine aj nemčine alebo balík fancyhdr, ktorého dokumentácia je odvodená z tutoriálu v matematickom žurnáli. Aj keď nie je existencia oddelenej dokumentácie spomenutá v README súbore, mala by byť ľahko identifikovatelná.

Treťou častou formou je dokumentácia v balíku samotnom. Bežne sa vyskytuje v komentároch na začiatku súboru, aj keď ju aspoň jeden autor umiestňuje za príkaz \endinput. Kedže \endinput je logickým koncom súboru, je takéto správanie prijateľné (TeX/LaTeX sa totiž ďalej nepozerá, takže nás dokumentácia nestojí zvýšenie času potrebného na nahratie balíku).

Ak napriek uvedeným radám nemôžete dokumentáciu nájsť, je možné, že autor sa s dokumentáciou neobťažoval (podľa filozofie „ťažko sa to písalo, malo by sa to ťažko používať“). Väčšina bežných smrteľníkov v takomto prípade hladá pomoc u skúšenejších používateľov, je však možné uspieť čítaním zdrojového kódu (takto to zrejme autor zamýšľal).


Jak psát nové LaTeXové třídy a balíčky

V příkazech používaných při psaní balíčků není žádná magie, jednoduše můžete vložit LaTeXové příkazy \(re)newcommand\(re)newenvironment do souboru package.sty a máte balík hotový.

Nicméně složitější balíčky vyžadují více důvtipu. Některé detaily o této problematice lze nalézt v materiálu LaTeX 2e for class and package writers umístěném na adrese http://www.ubi.pt/~dfis-wg/sgml/tex/lc4/clsguide.html (LaTeXový zdroj tohoto dokumentu je obsažen v LaTeXové distribuci). Mimoto se hodí i dobrá znalost samotného TeXu. S touto znalostí pak můžete používat dokumentované LaTeXové zdroje jako refenční materiály (nadšení autoři se samozřejmě se zdroji seznámí). Kompletní sada dokumentovaných zdrojů LaTeXu je dostupná v souboru CTANsource2e.tex v LaTeXové distribuci.

Vytváření nových tříd není nic jednoduchého; užitečné je nejprve si projít některé již existující třídy (např. některé standardní, třeba CTANclasses.dtx). Třídy, které nejsou součástí distribuce, jsou běžně postaveny na těch, které jsou, a spouští se nahráním standardní knihovny \LoadClass – příklad této techniky můžete vidět v CTANltxguide.


Tutoriály k METAFONTu a METAPOSTu

Kromě Knuthovy knihy je zatím veřejně k dispozici jenom jeden tutoriál pro METAFONT (URL{http://metafont.tutorial.free.fr/}) od Christophea Grandsirea (ke stažení je kopie v PDF). Existuje však pár článků zabývajících se během programu. Goeffrey Tobin poskytl METAFONT for Beginners, který je dostupný v souboru CTANmf-beginners (viz Otázku Jak dostat z METAFONTu to, co chcete). Ten popisuje, jak METAFONT funguje a jak se vyhnout častým chybám. Další článek, jehož autorem je tentokrát Peter Wilson, a který se jmenuje Some Experiences in Running METAFONT and METAPOST, je dostupný v souboru CTANmetafp-ps (postscriptová verze) nebo CTANmetafp-pdf (PDF verze). Tento článek se, co se týče METAFONTu, se zaměřuje spíše na instalaci a testování nových fontů než na systém jako celek. Mimo jiné popisuje použití METAPOSTových ilustrací v LaTeXových a PDFLaTeXových souborech s důrazem na používání příslušných fontů pro libovolný text či matematiku.

Hans Hagen (známý z CONTeXtu) poskytuje METAPOSTový tutoriál MetaFun, který se soustředí na použití METAPOSTu v CONTeXtu. Můžete jej nelézt na METAPOSTových stránkách jeho společnosti (http://www.pragma-ade.com/metapost.htm).

Jiné METAPOSTové tutoriály jsou anglický tutoriál Andr'eho Hecka (http://remote.science.uva.nl/~heck/Courses/mptut.pdf), a francouzský (je zde uveden jenom proto, že je napsán dostatečně srozumitelně, aby jej pochopil autor původní verze FAQ) Laurenta Ch'enoa (http://pauillac.inria.fr/~cheno/metapost/metapost.pdf).

Obrovská množina vzorových METAPOSTovských souborů od Vincenta Zoonekynda je dostupná na CTANu (CTANzoon-mp-eg). Zahrnuty jsou perlovské skripty pro konverzi do html, soubory si můžete také prohlídnout na webu (http://zoonek.free.fr/LaTeX/Metapost/metapost.html). Ikdyž tyhle soubory nejsou tutoriálem, jsou jistě hodnotným učebným materiálem. Urs Oswald poskytuje PDF soubor (http://www.ursoswald.ch/metapost/tutorial.pdf) psaný více formou dokumentu.


Kde nájdem symbol pre...

V TeXu existuje veľa symbolov, ktoré môžete použiť, ale mnoho z nich nie je v knihách o TeXu/LaTeXu zobrazených (dokonca ani spomenutých). The Comprehensive LaTeX Symbol List (Vyčerpávajúci zoznam symbolov LaTeXu) od Scotta Pakina a kol. ilustruje viac ako 2000 symbolov a popisuje potrebné príkazy a balíky. Dostupný je na CTANe (CTANsymbols).

Iné otázky v tomto FAQ poskytujú pomoc pri špecifických symboloch:


Manuál k programu PiCTeX

PiCTeX je soubor maker pro kreslení diagramů a obrázků. Vytvořil ho Michael Wichura. Tato makra jsou volně dostupná v CTANpictex. Nicméně manuál k PiCTeXu není volně šiřitelný. Bohužel, TUG již není oprávněn ho šířit. Je k dostání za 30 $ (35 $ i s disketou) u TeX Users Group (viz Co je to TUG a TUGboat). Zisky z prodeje jdou autorovi PiCTeXu.


Hledání TeXovských/LaTeXovských balíků maker

Před tím, než začnete hledat TeXová makra nebo LaTeXové třídy nebo soubory, abyste zprovoznili „to a to“, zkuste prohledat katalog Grahama Williamse (CTANGWkatalog). Katalog můžete prohledat přes CTANcatalogue{help/Catalogue/catalogue.html} web, nachází se na adrese http://www.tex.ac.uk/cgi-bin/texfaq2html?question=50.

Pokud jste se dozvěděli o souboru, který vypadá zajímavě, zkuste ho vyhledat v archívu CTAN (viz Otázku Hledání souborů v archívu CTAN). Balíky zmiňované v The LaTeX Companion vyhledáte jednoduše, protože zde je uvedena i cesta.


Hledání souborů v archívu CTAN

K hledání softwaru na stránkách CTAN můžete použít anonymní ftp příkazem
quote site index <term>
nebo vyhledávacím skriptem na adrese http://www.dante.de/cgi-bin/ctan-index. Pro snadnější použití tohoto ftp si stačí zapamatovat, že <term> je regulární výraz, nikoliv pevně daný řetězec, a že některé soubory jsou distribuovány v podobě zdrojového kódu s příponou, která se liší od přípony finálního souboru (např. LaTeXové balíčky jsou častěji distribuovány v podobě zdrojového kódu s příponou .dtx než v hotovém tvaru s příponou .sty).

Člověk by měl napsat natolik všeobecný výraz, aby byl vyhledán soubor, který opravdu hledá, ale ne příliš všeobecný, protože ftp rozhraní vrací pouze prvních 20 položek. Následující příklad krásně ilustruje tyto případy. K nalezení LaTeXového balíku caption můžete použít příkaz:
quote site index caption.sty
ale ten nevyhledá žádaný soubor (který je distribuován jako caption.dtx) avšak vrátí nechtěné soubory (jako třeba hangcaption.sty). Ačkoliv to tento případ neukazuje, tečka v názvu souboru je brána jako součást regulárního výrazu – to je náhrada za libovolný znak, proto např.
quote site index doc.sty
vrátí nechtěné soubory typu CTANswmakefile.

Jistě, pokud víte, že daný balík je uložen v podobě .dtx, můžete hledat jeho jméno, avšak nemůžete to použít, pokud nevíte, v jaké podobě je v archívu uložen. Řešením tohoto problému je přidání „/“ před název balíku a „\\.“ na jeho konec. To pak vyhledá pouze soubory, které obsahují dané jméno souboru mezi oddělovačem adresářů a příponou. Tyto dva příkazy
quote site index /caption\\.
quote site index /doc\\.
provedou dostatečně úzké vyhledávání. V případě docu je nalezeno několik dalších souborů, ale přesto tento příkaz vrátí na výstup natolik malý seznam, že je jednoduché se v něm orientovat.

Pokud je vyhledávací řetězec příliš obecný a je nalezeno příliš mnoho souborů splňujících danou podmínku, pak je výstupem pouze prvních 20 nalezených položek. Pokud znáte důkladně adresářový strom CTANu, pak můžete výběr dostatečně zúžit. Např. předpokládejme, že chcete najít kopii driveru dvips pro MSDOS. Můžete použít příkaz
quote site index dvips
výsledkem však bude zkrácený seznam, který nebude obsahovat soubor, který vy hledáte (kdyby tento seznam nebyl zkrácen, pak by obsahoval 412 položek!). Nicméně však příkazem
quote site index msdos.*dvips
můžeme tento dotaz zúžit na hledání driverů pod MSDOS. Příkaz vrátí jenom relevantní řádky jako systems/msdos/dviware/dvips/dvips5528.zip.

Při vyhledávání mají některé znaky svůj zvláštní význam:

  • většina znaků nahrazuje sama sebe, např. „a“ se vyhodnotí jako „a“.
  • „.“ nahrazuje libovolný znak
  • „[abcD-F]“ nahrazuje jeden z množiny znaků {„a“, „b“, „c“, „D“, „E“, „F“}
  • „*“ za výrazem nahrazuje jeho žádný nebo více výskytů, např „a*“ značí „a“ nebo „aaaaa“ a „[A-Za-z]*“ značí libovolné slovo
  • \“ před speciálním znakem ruší jeho funkci, např. „\.“ se nahradí „.“
  • ^“ značí začátek řádku
  • $“ značí konec řádku.
Z technických důvodů tedy musí být ve výše zmíněném případě příkazu quote site index opravdu dvě zpětná lomítka „\\.“. Hledání výrazu „caption“ nebo „CAPTION“ dá stejný výsledek.


Vyhledávání balíků přes webové rozhraní

Servery CTAN nabízejí dva webové vyhledávače: http://www.tex.ac.uk/search a http://www.ctan.org/search; s jejich pomocí však můžete vyhledávat pouze soubory, jejichž jména již znáte (podobně jako příkazem quote site index, viz Otázku Hledání souborů v archívu CTAN), nebo můžete na základě klíčového slova prohledávat aktuální katalog.

Tyto vyhledávací skripty dávají na výstup URL souborů, které splňují námi zadaná kritéria. Daná URL směřují do archívu CTAN nebo do jejich zrcadel, která si vyberete; když poprvé spustíte tento skript, nejprve se vás zeptá na server, v němž má vyhledávat, a detaily uloží na vašem počítači. Vyberte server, který je vám nejbližší, abyste redukovali zátěž sítě.

Katalog, který je používán vyhledávacím skriptem, můžete procházet nezávisle na vyhledávání. Neleznete jej v archivu samotném na URL{http://www.ctan.org/tex-archive/help/Catalogue/}, URL{http://www.dante.de/tex-archive/help/Catalogue/} a URL{http://www.tex.ac.uk/tex-archive/help/Catalogue/}.


Hledání balíků LaTeX 2e

Uživatel může být zmaten tím, že nenajde na CTANu žádné .sty nebo .cls soubory příslušející k balíku nebo třídě, která mu byla doporučena. Například existuje mnoho balíků, které jsou uvedeny v knize viz Knihy o TeXu a příbuzná literatura bez podrobností o jejich umístění na CTANu. Soubor CTANcompan-ctan by mohl pomoci při hledání takových souborů, ale není to univerzální řešení.

Balíky a třídy LaTeX 2e se kanonicky distribuují jako .dtx soubory (viz Otázku Dokumentované LaTeXovské zdroje (.dtx soubory)). Pokud zadáte příkaz „site index“ s parametrem „package.sty“, nic nenajdete — musíte prostě hledat „package“ (zadaný řetězec se bere jako podřetězec vyhledávaných jmen).

V případě, že to, co hledáte, je opravdu tímto způsobem distribuováno, měli byste si přenést celý adresář obsahující hledaný .dtx soubor, čímž získáte všechny doprovodné soubory, především jeden nebo více .ins souborů (installation). Zpracováním „vhodného“ .ins souboru pomocí LaTeX 2e se vygenerují všechny soubory, které potřebujete.


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