Dokumentace a nápověda |
| Vyhledávání podle slov v CS-FAQ Hledaný řetězec: ### Knihy o TeXu a příbuzná literatura 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) 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é) 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) 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) 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) Math into TeX: A Simplified Introduction using AMSLaTeX od George Grätzera (Birkhäuser, 1993, ISBN 0-817-63637-4) 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 by Donald Knuth (Addison Wesley, 1986, ISBN 0-201-13445-4) Kniha pokrývající široké spektrum témat (včetně instalace a udržování) je: Making TeX Work by Norman Walsh (O'Reilly and Associates, Inc, 1994, ISBN 1-56592-051-1) ### Kde lze najít tento dokument Tento dokument vychází z jiného dokumentu, který byl pravidelně zasílán do usenetových skupiny `comp.text.tex`, `news.answers` a `comp.answers`. Jeho poslední (poměrně zastaralá) verze je na CTANu v CTAN: obshelp. Je též archivován na všech místech, která archivují `news.answers`, jako např. `rtfm.mit.edu` (18.181.0.24). Zde je dostupný anonymním `ftp` (v adresáři `pub/usenet/news.answers/tex-faq`). Ti, kteří nemají přístup k `ftp`, ale jen k emailu, mohou poslat zprávu obsahující text ,,`SENDME FAQ``` na adresu fileserv@shsu.edu. Jako odpověď jim přijde aktuální anglická verze tohoto dokumentu. Aktuální verze tohoto dokumentu je dostupná přes World-Wide Web na adrese `http://www.fi.muni.cz/cstug/csfaq/`, anglickou verzi pak naleznete na URL `http://www.tex.ac.uk/cgi-bin/texfaq2html`. Zdrojový text je dostupný na CTAN: uktugfaq. ### 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 CTAN: teencontrex. 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. 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 zprávou ,,`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 CTAN: bibtex-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 BibTeXing a Designing 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 CTAN: gentle.pdf. Zevrubnější je tutoriál (Not so) Short Introduction to LaTeX 2e který je pravidelně aktulizován na podněty čtenářů. Informace jsou v souboru CTAN: lshort.pdf. 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 CTAN: latex.ps. ### 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` a `\(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 CTAN: source2e.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 CTAN: classes.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 CTAN: ltxguide.cls. Zatím, bohužel, nevyšly žádné tutoriály, které by se zabývaly používáním těchto programů, s výjimkou informací, které poskytli jejich autoři. 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 CTAN: mf-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 CTAN: metafp.ps (postscriptová verze) nebo CTAN: metafp.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. ### 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 CTAN: pictex. 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, jehož autorem je Graham Williams (CTAN: GWkatalog). Tento katalog můžete prohledat přes CTANfile{catalogue}{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 CTAN: swmakefile. 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ě `doc`u 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ř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ě. ### 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 CTAN: compan-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.
| (c) 29.04.2002 16:18 Libor Škarvada, Tomáš Hudec, Aleš Vítek Připomínky, opravy a zejména odpovědi na další časté otázky posílejte na adresu cstug-faq@cstug.cz Připomínky k HTML verzi posílejte na adresu libor@fi.muni.cz nebo hudec@fi.muni.cz.