summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/docbytex/docby.d
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/docbytex/docby.d')
-rw-r--r--Master/texmf-dist/doc/generic/docbytex/docby.d64
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{}