diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/docbytex/docby.d')
-rw-r--r-- | Master/texmf-dist/doc/generic/docbytex/docby.d | 64 |
1 files changed, 28 insertions, 36 deletions
diff --git a/Master/texmf-dist/doc/generic/docbytex/docby.d b/Master/texmf-dist/doc/generic/docbytex/docby.d index 9ae289c94da..4404875f3aa 100644 --- a/Master/texmf-dist/doc/generic/docbytex/docby.d +++ b/Master/texmf-dist/doc/generic/docbytex/docby.d @@ -6,6 +6,7 @@ \showboxbreadth=1500 \showboxdepth=2 +\chyph \input docby.tex \title DocBy.\TeX{} -- nástroj na dokumentování zdrojových kódů @@ -270,21 +271,19 @@ slovo dokumentováno, i na stránky se všemi výskyty slova. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Aby fungovaly všechny výše uvedené vlastnosti, je potřeba použít -pdf\TeX{} rozšířený o enc\TeX{}. Formát může být "plain" nebo -"csplain". V takovém případě se \docbytex{} ohlásí na terminálu -těmito slovy: +pdf\TeX{} rozšířený o enc\TeX{}. Dále je dle "\language" detekován +jazyk, který se použije v automaticky generovaných slovech. +\docbytex{} se ohlásí na terminálu například těmito slovy: \def\begtthook{\catcode`\!=0} \begtt -This is DocBy.TeX, version !dbtversion, modes: enc+PDF+plain -nebo: -This is DocBy.TeX, version !dbtversion, modes: enc+PDF+csplain +This is DocBy.TeX, version !dbtversion, modes: enc+PDF+ENG \endtt \def\begtthook{} \docbytex{} rozlišuje tři módy, každý může nabývat dvou stavů: -mód "enc/NOenc", dále mód "PDF/DVI" a konečně mód "plain/csplain". +mód "enc/NOenc", dále mód "PDF/DVI" a konečně mód jazyka "ENG/CS". Mód "enc"\api{enc} se zapne, je-li detekována přítomnost enc\TeX{}u. Pokud enc\TeX{} není dostupný, vypíše o~tom \docbytex{} varování a @@ -295,38 +294,24 @@ výskyty slova, ale jen místo, kde je slovo dokumentováno. V~tomto případě tedy je deaktivována nejdůležitější vlastnost \docbytex{}u, takže je žádoucí vynaložit jisté úsilí a enc\TeX{} zprovoznit. V současných distribucích \TeX{}u bývá enc\TeX{} -zahrnut. Poznáte to podle možnosti použít přepínač "-enc" v případě -generování formátu. Zajistěte ve své \TeX{}ové distribuci, aby byl v době -generování formátu tento přepínač použit. Jak to udělat závisí na -distribuci. Univerzální, ale ne příliš elegantní postup, může vypadat -takto: - -\begtt -generování formátu: -pdfetex -enc -ini -jobname pdfcsplain csplain.ini -zpracování dokumentu: -pdfetex -fmt pdfcsplain dokument.tex -\endtt - -Formát samozřejmě můžete generovat jen jednou a příkaz na zpracování -dokumentu pak můžete opakovat. Pokud postupujete podle výše uvedené -ukázky, uloží se formát "pdfcsplain.fmt" s podporou enc\TeX{}u do -aktuálního adresáře, odkud jej příkaz "pdfetex -fmt pdfcsplain" čte. -Elegantnější asi je uložit formát někam do \TeX{}ové distribuce, ovšem -to je závislé na použité distribuci. +v pdf\TeX{}u zahrnut a je aktivován například ve formátu "pdfcsplain". Mód "PDF"\api{PDF} je detekován, pokud je použit pdf\TeX{}, jinak \docbytex{} přejde do módu "DVI"\api{DVI} a napíše o tom varování na terminál. V módu "DVI" nefungují barvy ani klikací odkazy. Ovšem seznam stránek s~použitím dokumentovaného slova se generuje, je-li přítomen enc\TeX. -\docbytex{} detekuje mód "csplain"\api{csplain}, je-li použit tento -formát. V takovém případě se zapne české dělení slov a některé názvy -(např. \uv{Rejstřík}) jsou vypisovány v češtině. Slováci mohou po -načtení "docby.tex" přepnout do slovenštiny pomocí "\shyph" a mohou si -tyto názvy předefinovat (viz sekci~\cite[nazvy]). -Pokud je použit formát "plain",\api{plain} \docbytex{} zůstane u vzorů dělení -pro angličtinu a názvy (např. \uv{Index}) zůstávají anglické. +\docbytex{} detekuje mód jazyka "ENG" (angličtina), je-li +"\language=0". To je implicitní chování. +Pokud například v "csplainu" nastavíte "\chyph" před +"\input docby.tex", \docbytex{} +to vyhodnotí jako dokument v češtině ("CS"). +Jiné jazyky nejsou zatím podporovány. +V módu "ENG" jsou automaticky generované názvy +\uv{Contents}, \uv{Index} anglické, +v módu "CS" jsou tyto názvy \uv{Obsah}, \uv{Rejstřík} české. +V~sekci~\cite[nazvy] je řečeno, jak jsou tato slova generována +a co tedy udělat, když chcete mít dokument v jiném jazyce. \subsec Vyhledávání slov enc\TeX{}em %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -1582,13 +1567,20 @@ pokud přejde na novou verzi. \inssdef dbtversion -Inicializujeme csplain mód: +Je-li použit "csplain", je aktivován UTF-8 vstup pomocí enc\TeX{}u. To +ale bohužel není kompatibilní s použitím enc\TeX{}u \docbytex{}em. +Je tedy potřeba deaktivovat UTF-8 vstup a české texty napsat například +v ISO-8859-2. + +\inext {utf8off}{\empty}{+-} -\inext {^^B\nb ifx\nb chyph\nb undefined \nb else}{\empty}{+-} +%Inicializujeme csplain mód: +% +%\inext {ifx\nb chyph\nb undefined \nb else}{\empty}{+-} Inicializujeme enc\TeX{}ový mód: -\inext {ifx\nb mubyte}{\empty}{+-} +\inext {encTeX ??}{\empty}{+-} Makro \db enctextable "{<slovo>}{<tělo makra>}" vloží do enc\TeX{}ové tabulky vzor "<slovo>". Jakmile takový vzor enc\TeX{} |