% Translation: 2006-08-24 Martina Plach�
% Checking:    2006-11-13 zyka
\startcomponent ma-cb-cz-tablesofcontent
\project ma-cb
\product ma-cb-cz
\environment ma-cb-env-cz

%\chapter{Table of contents (lists)}
\chapter{Obsah (seznamy)}

%\index{table of contents}
%\index{list}
\index{obsah}
\index{seznamy}

\Command{\tex{completecontent}}
\Command{\tex{placecontent}}
\Command{\tex{definelist}}
\Command{\tex{setuplist}}
\Command{\tex{writetolist}}
\Command{\tex{writebetweenlist}}
\Command{\tex{definecombinedlist}}
\Command{\tex{setupcombinedlist}}

%A table of contents contains chapter numbers, chapter titles
%and page numbers and can be extended with sections,
%sub sections, etc. A table of contents is generated
%automatically by typing:
Obsah zahrnuje ��sla kapitol, n�zvy kapitol a~��sla str�nek;
m��e b�t roz���en o~sekce, podsekce atd. Obsah se
generuje automaticky naps�n�m:

\starttyping
\placecontent
\stoptyping

%Which table of contents is produced depends on the location
%of this command in your document. At the start of the
%document it will generate a list of chapters, sections etc.
%But at the top of a chapter:

Jak� obsah se vytvo��, z�le�� na um�st�n� tohoto p��kazu
v~dokumentu. Na za��tku dokumentu se vygeneruje seznam {\em v�ech\/}
kapitol, sekc� atd. Ale um�st�n�m na za��tku jednotliv�ch kapitol, tj.:

%\startbuffer
%\chapter{Hasselt in Summer}
%
%\placecontent
%
%\section{Hasselt in July}
%
%\section{Hasselt in August}
%
%\stopbuffer
%
%\typebuffer

\startbuffer
\chapter{Hasselt v l�t�}

\placecontent

\section{Hasselt v �ervenci}

\section{Hasselt v srpnu}

\stopbuffer

\typebuffer

%it will only produce a list of (sub) section titles with the
%corresponding section numbers and page numbers.
se pouze vytvo�� seznam n�zv� sekc� s~odpov�daj�c�m
o��slov�n�m a s~��sly str�nek.

%The command \type{\placecontent} is available after
%definition with:
P��kaz \type{\placecontent} m��eme pou��t pot�, co nadefinujeme nov�
seznam pomoc�:

\shortsetup{definecombinedlist}

%This command and \type{\definelist} allows you to define
%your own lists necessary for structuring your documents.
Tento p��kaz spolu s~\type{\definelist} n�m dovol� nadefinovat vlastn�
seznam, pot�ebn� ke strukturov�n� cel�ho dokumentu.

%The use of this command and its related commands is
%illustrated for the table of contents.
Pou�it� tohoto a~dal��ch p��buzn�ch p��kaz� je uk�z�no na
n�sleduj�c�m p��kladu:

%\startbuffer
%\definelist[chapter]
%\setuplist
%   [chapter]
%   [before=\blank,
%    after=\blank,
%    style=bold]
%
%\definelist[section]
%\setuplist
%   [section]
%   [alternative=d]
%\stopbuffer
%
%\typebuffer

\startbuffer
\definelist[kapitola]
\setuplist
   [kapitola]
   [before=\blank,
    after=\blank,
    style=bold]

\definelist[podkapitola]
\setuplist
   [podkapitola]
   [alternative=d]
\stopbuffer

\typebuffer


%Now there are two lists of chapters and sections and these
%will be combined in a table of contents with the command
%\type{\definecombinedlist}.
Nyn� m�me dva seznamy: seznam kapitol a~seznam podkapitol. Oba budou
slou�eny do jedin�ho obsahu p��kazem \type{\definecombinedlist}. 

%\startbuffer
%\definecombinedlist
%   [content]
%   [chapter,section]
%   [level=subsection]
%\stopbuffer
%
%\typebuffer

\startbuffer
\definecombinedlist
   [obsah]
   [kapitola,podkapitola]
   [level=subsection]
\stopbuffer

\typebuffer

%Now two commands are available: \type{\placecontent} and
%\type{\completecontent}. With the second command the title
%of the table of contents will be added to the table of
%contents.
Po tomto �konu m�me k~dispozici dva dal�� p��kazy: \type{\placeobsah}
a~\type{\completeobsah}. Oba zp�sob� vys�zen� obsahu, ten druh� je�t�
p�id� nadpis \quote{Obsah}.

%The layout of lists can be varied with the parameter
%\type{alternative}.

Vzhled seznamu lze nastavit parametrem
\type{alternative}.

%\placetable
%  [here,force]
%  [tab:alternatives]
%  {Alternatives for displaying lists.}
%\starttable[|c|l|]
%\HL
%\NC \bf Alternative \NC \bf Display \NC\SR
%\HL
%\NC \type{a} \NC number -- title -- page number              \NC\FR
%\NC \type{b} \NC number -- title -- spaces -- page number    \NC\MR
%\NC \type{c} \NC number -- title -- dots -- page number      \NC\MR
%\NC \type{d} \NC number -- title -- page number (continuing) \NC\MR
%\NC \type{e} \NC reserved for interactive purposes           \NC\MR
%\NC \type{f} \NC reserved for interactive purposes           \NC\LR
%\HL
%\stoptable

\placetable
  [here,force]
  [tab:alternatives]
  {Nastaven� form�tov�n� seznam�.}
\starttable[|c|l|]
\HL
\NC \bf Nastaven� \NC \bf Form�tov�n� \NC\SR
\HL
\NC \type{a} \NC ��slo -- n�zev -- ��slo str�nky               \NC\FR
\NC \type{b} \NC ��slo -- n�zev -- mezery -- ��slo str�nky     \NC\MR
\NC \type{c} \NC ��slo -- n�zev -- te�ky -- ��slo str�nky      \NC\MR
\NC \type{d} \NC ��slo -- n�zev -- ��slo str�nky (v~odstavci)  \NC\MR
\NC \type{e} \NC rezervov�no pro interaktivn� ��ely            \NC\MR
\NC \type{f} \NC rezervov�no pro interaktivn� ��ely            \NC\LR
\HL
\stoptable

%Lists are set up with:
Seznamy se nastavuj� pomoc�:

\shortsetup{setuplist}
\shortsetup{setupcombinedlist}

%If you want to change the layout of the generated table of
%contents you'll have to remember that it is a list.
Pokud chceme zm�nit vzhled generovan�ho obsahu, mus�me pamatovat
na to, �e je to seznam.

%\startbuffer
%\setupcombinedlist
%  [content]
%  [alternative=c,
%   aligntitle=no,
%   width=2.5cm]
%\stopbuffer
%
%\typebuffer
\startbuffer
\setupcombinedlist
  [obsah]
  [alternative=c,
   aligntitle=no,
   width=2.5cm]
\stopbuffer

\typebuffer

% This Will Result In A Somewhat Different Layout Than The
% Default One.
Od t�to chv�le se bude form�tov�n� obsahu li�it od jeho standardn�ho
nastaven�.

%Lists Are Called Up And Placed With:
Seznamy se vyvol�vaj� a~um�s�uj� pomoc�:

\shortsetup{placelist}

%So if you want a table of content you type:
Chceme-li tedy pouze ��st obsahu, nap��eme:

\starttyping
\placecontent[level=section]
\stoptyping

% or
nebo

\starttyping
\completecontent[level=section]
\stoptyping

% only the sections will be displayed. You may need this
% option when you have a well structured document that has sub
% sub sub sub sub sections and you don't want those in the
% table of contents.
a zobraz� se pouze kapitoly a sekce. To se m��e hodit,
pokud m�me slo�it� a~strukturovan� obsah, kter� m� spoustu pod pod
a~pod odstavc�, kter� v~celkov�m obsahu nechceme vypisovat.

% A long list or a long table of contents will use up more
% than one page. To be able to force page breaking you can
% type:
Dlouh� seznam nebo obsah se nevejde na jednu str�nku. Pot�ebujeme-li
ve vhodn�m m�st� vynutit p�echod na novou str�nku, nap��eme: 

\starttyping
\completecontent[2.2,8.5,12.3.3]
\stoptyping

%A page break will occur after section 2.2 and 8.5 and
%sub section~12.3.3.
Zalomen� str�nky se objev� po sekci 2.2 a 8.5 a~podsekci 12.3.3.

% In some cases you want to be able to write your own text in
% an automatically generated list. This is done with:

% \shortsetup{writetolist}
% \shortsetup{writebetweenlist}

V~n�kter�ch p��padech chceme v~automaticky
generovan�m seznamu napsat vlastn� text.
Toho dos�hneme pomoc�:

\shortsetup{writetolist}
\shortsetup{writebetweenlist}

% For Example If You Want To Make A Remark In Your Table Of
% Contents After A Section Titled {\Em Hotels In Hasselt}
% You Can Type:

Nap��klad, chceme-li ud�lat pozn�mku v~obsahu po sekci nazvan� 
{\em  Hotely v~Hasseltu}, nap��eme:

% \startbuffer
% \section{Hotels in Hasselt}
% \writebetweenlist[section]{\blank}
% \writetolist[section]{}{---under construction---}
% \writebetweenlist[section]{\blank}
% \stopbuffer

% \typebuffer

\startbuffer
\section{Hotely v Hasseltu}
\writebetweenlist[section]{\blank}
\writetolist[section]{}{---ve v�stavb�---}
\writebetweenlist[section]{\blank}
\stopbuffer

\typebuffer

\stopcomponent
