Tytu�y

Do dyspozycji mamy predefiniowane polecenia do tworzenia tytu��w (numerowanych i nienumerowanych):
Tytu�y numerowane

\part[ref]{tekst}

ref okre�la nazw� (etykiet�) na kt�r� mo�na si� powo�a�. Nazw (etykiet) mo�e by� kilka, powinny by� one oddzielone przecinkiem -- wszystkie mog� s�u�y� do powo�ania si� na ten tytu� (warto�ci� etykiety jest numer nag��wka). tekst stanowi tre�� tytu�u; domy�lnie, polecenie \part nie wyprowadza tre�ci tytu�u (parametr placehead=no; p. poni�ej o definiowaniu w�asno�ci nag��wk�w), ale nast�puje przej�cie do nowej strony (nieparzystej), strony dokumentu s� numerowane w obr�bie danej cz�ci jako: numer cz�ci-numer strony).

Wszystkie poni�ej wymienione polecenia maj� analogiczn� sk�adni�.

\chapter[ref]{tekst}domy�lnie, polecenie powoduje przej�cie do nowej strony
\section[ref]{tekst}
\subsection[ref]{tekst}
\subsubsection[ref]{tekst}
Tytu�y nienumerowane
\title[ref]{tekst}
\subject[ref]{tekst}
\subsubject[ref]{tekst}
\subsubject[ref]{tekst}
\subsubsubject[ref]{tekst}

U�ycie polece� nag��wkowych

Sk�adnia polece� do tworzenia tytu��w wygl�da nast�puj�co:
\nazwa[etykiety]{warto�� licznika}{tre��}
\nazwa{tre��}
\nazwa{warto�� licznika}{tre��}
gdzie:
etykiety -- nazwy, na kt�re mo�na powo�a� si� (mo�e by� ich kilka, musz� by� oddzielone przecinkiem),
tre�� -- tre�� tytu�u,
warto�� licznika -- a �ci�lej tekst, kt�ry b�dzie podany zamiast w�a�ciwego numeru dla danego nag��wka -- nie ma nic wsp�lnego z warto�ci� licznika (ale licznik tego poziomu zostanie zwi�kszony), parametr ten jest interpretowany w powy�szy spos�b tylko wtedy, gdy warto�� atrybutu ownnumber wynosi yes; w przeciwnym razie parametr jest traktowany jako tekst nag��wka,
w tre�ci tytu�u mo�emy u�y� polecenia \nomarking{tekst}, kt�re spowoduje, �e w nag��wku lub stopce tekst zostanie zast�piony przez ... (trzy kropki).

W ConTeXt-cie nie ma obowi�zku zachowania kolejno�ci poziom�w; numer nag��wka danego poziomu b�dzie zawiera� jedynie wcze�niej u�yte poziomy.

Nale�y pami�ta�, �e wygl�d nag��wka mo�e zale�e� od kontekstu w kt�rym si� znajduje (np.: spos�b numeracji: cyframi, kolejnymi literami, numeracja rzymska; dodatkowy tekst np.: Rozdzia� lub Dodatek itp.) -- p. definiowanie w�asnych nag��wk�w.

Tworzenie w�asnych tytu��w na podstawie ju� istniej�cych

Do tworzenia w�asnych nag��wk�w s�u�y polecenie:
\definehead[nazwa][przodek]
nazwa jest nazw� nowego polecenia; w momencie tworzenia dziedziczone s� wszystkie cechy (r�wnie� licznik) obiektu okre�lonego jako przodek.

Tworzenie w�asnych nag��wk�w

Posta� polecenie \definehead mo�e mie� bardziej skomplikowan� posta�:
\definehead[nazwa][definicje w�asno�ci]
nazwa jest nazw� nowo tworzonego polecenia nag��wkowego
definicje w�asno�ci maj� nast�puj�c� budow�: nazwa w�asno�ci=warto��
mo�na definiowa� jednocze�nie kilka w�asno�ci, poszczeg�lne elementy musz� by� oddzielone przecinkiem (,)
nazwa w�asno�cidopuszczalne warto�ci
section nazwa jest nazw� obiektu utworzonego poleceniem \definesection -- okre�la po�o�enie numeracji danego nag��wka, a tym samym jego poziom w hierarchii
default nazwa jest nazw� obiektu utworzonego poleceniem \definehead (lub predefiniowanego) -- okre�la z jakiego nag��wka maj� by� przej�te cechy (wydaje si�, �e zdefiniowanie tej w�asno�ci jest obowi�zkowe)

Zmiana w�asno�ci nag��wk�w

Do zmiany w�asno�ci nag��wk�w s�u�y polecenie:
\setuphead[nazwy][definicje w�asno�ci]
gdzie:
nazwy s� list� nazw nag��wk�w (predefiniowanych lub utworzonych poleceniem \definehead) (elementy listy musz� by� oddzielone przecinkiem),
natomiast definicje w�asno�ci jest list� ni�ej podanych atrybut�w i ich warto�ci (domy�lne warto�ci s� zaznaczone podkre�leniem).

Zmian� w�asno�ci wszystkich nag��wk�w mo�na zrealizowa� za pomoc� polecenia (nie wszystkie w�asno�ci mog� wyst�pi� na li�cie polecenie \setupheads???):
\setupheads[definicje w�asno�ci]
nazwa atrybutudopuszczalne warto�ci
style atrybut definiuje font u�yty do sk�adu nag��wka np.:
normal -- antykwa,
bold -- wyt�uszczenie,
slanted -- pochylenie,
boldslanted -- wyt�uszczenie i pochylenie,
sc -- ,,smallcaps'',
type -- czcionka ,,maszynowa'',
cap -- wersaliki,
small -- zmniejszenie wielko�ci
lub dowolne inne okre�lenia zwi�zane ze zmian� rodzaju czcionki lub jej wielko�ci
textstyle j.w. -- definicja okre�la font u�yty do sk�adu tekstu nag��wka (,,przykrywa'' definicj� okre�lon� atrybutem style)
numberstyle j.w. -- definicja okre�la font u�yty do sk�adu numeru nag��wka (,,przykrywa'' definicj� okre�lon� atrybutem style)
number
yes -- w��cza numerowanie nag��wk�w,
no -- wy��cza numerowanie nag��wk�w
ownnumber
yes -- pozwala na wstawienie w�asnego tekstu w polu numeracji nag��wk�w, czyli na oznaczanie nag��wk�w w nietypowy spos�b (niezale�ny od innych poziom�w) (p. u�ywanie polece� do tworzenia nag��wk�w),
no -- wy��czenie wy�ej opisanej mo�liwo�ci
page
left -- powoduje zmian� strony przed nag��wkiem, b�dzie on wyprowadzony na najbli�sz� stron� parzyst� (tylko przy zadeklarowaniu druku dwustronnego),
right -- powoduje zmian� strony przed nag��wkiem, b�dzie on wyprowadzony na najbli�sz� stron� nieparzyst� (tylko przy zadeklarowaniu druku dwustronnego),
yes -- powoduje zmian� strony przed nag��wkiem,
je�eli atrybut nie ma nadanej warto�ci (domy�lnie) nie jest zmieniana strona przed nag��wkiem (patrz te� opis nast�pnego atrybutu)
continue
yes -- je�eli jest w��czona zmiana strony przed nag��wkiem (poprzedni atrybut) i na danej stronie znajduje si� nag��wkiem wy�szego poziomu, zmiana strony jest blokowana,
no -- je�eli jest w��czona zmiana strony przed nag��wkiem (poprzedni atrybut) i na danej stronie znajduje si� tytu� wy�szego poziomu, to mimo to zmiana strony zstanie wykonana
header
none --nag��wek strony nie pojawi si�,
empty --nag��wek strony b�dzie pusty,
high -- ,
nomarking-- w nag��wku strony nie pojawi si� tre�� tytu�u
before \command -- polecenie (bezparametrowe) jest wywo�ywane (o ile zosta�o zdefiniowane) bezpo�rednio przed wyprowadzeniem ca�ego nag��wka (obecno�� polecenia mo�e mie� wp�yw na to, �e zmiany warto�ci atrybutu alternative zostan� zignorowane)
after\command -- polecenie (bezparametrowe) jest wywo�ywane (o ile zosta�o zdefiniowane) bezpo�rednio po wyprowadzeniem ca�ego nag��wka. Przyk�ad:
\setuphead[section][
before={\blank[3*big]},
after=\nowhitespace\hairline]

spowoduje dodanie dodatkowego odst�pu przed tytu�em rozdzia�u oraz poziomej linii oddzielaj�cej pod tytu�em. Jako polece� \command mo�na u�ywa� w�asnych konstrukcji, nale�y jednak podkre�li�, �e mog� one wp�ywa� na dzia�anie innych atrybut�w zmieniaj�cych spos�b formatowania nag��wka (np. alternative)
inbetween\command -- polecenie (bezparametrowe) jest wywo�ywane (o ile zosta�o zdefiniowane) bezpo�rednio przed wyprowadzeniem ca�ego nag��wka, a po poleceniu okre�lonym przez atrybut before
alternative
normal -- o sk�adzie nag��wka decyduj� inne atrybuty,
margin -- i
inmargin -- akceptowane tylko w przypadku kiedy warto�� atrybutu align jest r�na od left, a powoduj�, �e numer nag��wka jest prezentowany na marginesie strony,
middle -- tekst nag��wka jest centrowany (numer jest prezentowany w osobnej linii),
paragraph -- numer nag��wka nie jest wyr�niany; stanowi on normalny akapit z tekstem nag��wka,
text -- nag��wek jest sk�adany ,,w ci�gu'' ��czy si� z tekstem przed i po, na og�lnych zasadach; zmiana warto�ci atrybutu align jest ignorowana
command\command#1#2 -- je�eli polecenie jest zdefiniowane, to jest ono wywo�ywane ka�dorazowo przy wyprowadzaniu nag��wka; za #1 jest podstawiany numer, a za #2 tre�� nag��wka. Dzi�ki temu mamy nieograniczon� mo�liwo�� wp�ywu na sk�ad nag��wk�w.
numbercommand\command#1 -- je�eli polecenie jest zdefiniowane, to jest ono wywo�ywane ka�dorazowo przy wyprowadzaniu nag��wka; za #1 jest podstawiany numer nag��wka. Za pomoc� tej w�asno�ci mo�emy w �atwy spos�b spowodowa�, aby po numerze by�a dostawiana kropka np.: \def\kropka#1{#1.}
\setupheads[numbercommand={\kropka}]
textcommand\command#1 -- j.w. ale za parametr podstawiany jest tekst nag��wka
prefix
- -- ,
+ -- ,
text --
placehead
yes -- tekst ca�ego nag��wka zostanie wyprowadzony na wyj�cie,
no -- tekst nag��wka nie zostanie wyprowadzony na wyj�cie
incrementnumber
yes -- numery nag��wk�w s� wyprowadzane na wyj�cie,
no -- numery nag��wk�w nie s� wyprowadzane na wyj�cie,
file --
align
normal -- nag��wek jest sk�adany w ,,pude�ko'' (z wyr�wnaniem do obu margines�w), chyba �e warto�ci� atrybutu alternative jest middle,
left -- tekst nag��wka jest wyr�wnywany do prawego marginesu,
right -- tekst nag��wka jest wyr�wnywany do lewego marginesu,
broad--
tolerance warto�� parametru ma wp�yw na jako�� sk�adu nag��wk�w i jest przek�adana na warto�� rejestru \tolerance oraz ma bli�ej nieokre�lony wp�yw na sk�ad w przypadku sk�adu wielokolumnowego
verystrict -- ,
strict -- ,
tolerant -- ,
verytolerant -- ,
stretch--
indentnext
yes -- powoduje, �e pierwszy akapit po nag��wku b�dzie ,,wci�ty'' (o ile warto�� wci�cia jest wi�ksza od zera i zosta�o ono ustalone poleceniem \indenting na warto�� first),
no -- pierwszy akapit nie b�dzie mia� ,,wci�cia'' bez wzgl�du na inne ustawienia
file nazwa -- w�asno�� pozwala na tworzenie r�nych wersji nag��wka; w zale�no�ci od wcze�niej zadeklarowanego skojarzenia (polecenie \coupledocument)
expansion
command--
yes -- ,
no --
separator tekst -- tekst (znak) staje si� separatorem liczb wchodz�cych w sk�ad numeru nag��wka (w�asno�� mo�e by� zmieniona tylko poleceniem \setupheads)
bodypartlabel nazwa -- u�ycie atrybutu spowoduje, �e numer nag��wka b�dzie poprzedzony tekstem (mo�e by� pusty) przyporz�dkowanego obiektowi nazwa, powo�anemu poleceniem \setuplabeltext. Przyk�ad:
\setuplabeltext[
tytulrozdzialu=Rozdzia�~]
\setuphead[chapter]
bodypartlabel=tytulrozdzialu]
appendixlabel nazwa -- u�ycie atrybutu spowoduje, �e numer nag��wka b�dzie poprzedzony tekstem (mo�e by� pusty) przyporz�dkowanego obiektowi nazwa, powo�anemu poleceniem \setuplabeltext. Przyk�ad:
\setuplabeltext[
tytulrozdzialu=Dodatek~]
\setuphead[chapter]
bodypartlabel=tytulrozdzialu]


W�odzimierz Macewicz z pomoc� i udzia�em Grzegorza Sapijaszko