1\startcomponent macbenitemizations
2
3\enablemode[**enus]
4
5\project macb
6
7\startchapter[reference=itemize,title=Itemize]
8
9\index{itemize}
10\index{columns in itemize}
11
12\Command{\tex{startitemize}}
13\Command{\tex{setupitemize}}
14\Command{\tex{definesymbol}}
15\Command{\tex{item}}
16\Command{\tex{head}}
17
18One way of structuring your information is by way of enumeration or summing up
19items. The itemize command looks like this:
20
21\shortsetup{startitemize}
22
23For example:
24
25\startbuffer
26\startitemize[R,packed,broad]
27\item Hasselt was founded in the 14th century.
28\item Hasselt is known as a so called Hanze town.
29\item Hasselts name stems from a tree.
30\stopitemize
31\stopbuffer
32
33\typebuffer
34
35Within the \type{\start ... \stopitemize} pair you start a new item with
36\type{\item}. The space after \type{\item} is required. In the example above
37\type{R} specifies Roman numbering and \type{packed} keeps line spacing to a
38minimum. The parameter \type{broad} takes care of the spacing between item
39separator and item. The example would produce:
40
41\getbuffer
42
43Items can be defined in a more structured way:
44
45\startbuffer
46\startitemize[R,packed,broad]
47\startitem Hasselt was founded in the 14th century. \stopitem
48\startitem Hasselt is known as a so called Hanze town. \stopitem
49\startitem Hasselts name stems from a tree. \stopitem
50\stopitemize
51\stopbuffer
52
53\typebuffer
54
55The bracket pair contains information on item separators and local set up
56variables.
57
58\placetable
59 [here]
60 [tab:itemsetup]
61 {Item separators in itemize.}
62 {\starttable[ll]
63 \HL
64 \NC \bf Argument \NC \bf Item separator symbol \NC\SR
65 \HL
66 \NC 1 \NC $\bullet$ \NC\FR
67 \NC 2 \NC $$ \NC\MR
68 \NC 3 \NC $\star$ \NC\MR
69 \NC $\vdots$ \NC $\vdots$ \NC\MR
70 \NC n \NC 1 2 3 4 $\cdots$ \NC\MR
71 \NC a \NC a b c d $\cdots$ \NC\MR
72 \NC A \NC A B C D $\cdots$ \NC\MR
73 \NC r \NC i ii iii iv $\cdots$ \NC\MR
74 \NC R \NC I II III IV $\cdots$ \NC\LR
75 \HL
76 \stoptable}
77
78You can also define your own item separator by means of \type{\definesymbol}. For
79example if you try this:
80
81\startbuffer
82\definesymbol[5][$\clubsuit$]
83
84\startitemize[5,packed]
85\item Hasselt was built on a riverdune.
86\item Hasselt lies at the crossing of two rivers.
87\stopitemize
88\stopbuffer
89
90\typebuffer
91
92You will get:
93
94\getbuffer
95
96If you want to have a sort of head within an enumeration you should use
97\type{\head} instead of \type{\item}.
98
99\startbuffer
100Hasselt lies in the province of Overijssel and there are a number
101of customs that are typical of this province.
102
103\startitemize
104
105\head kraamschudden \hfill (child welcoming)
106
107 When a child is born the neighbours come to visit the new
108 parents. The women come to admire the baby and the men come to
109 judge the baby (if it is a boy) on other aspects.
110 The neighbours will bring a {\em krentenwegge} along. A
111 krentenwegge is a loaf of currant bread of about 1 \unit{Meter}
112 long. Of course the birth is celebrated with {\em jenever}.
113
114\head nabuurschap (naberschop) \hfill (neighbourship)
115
116 Smaller communities used to be very dependent on the
117 cooperation among the members for their well being. Members of
118 the {\em nabuurschap} helped each other in difficult times
119 during harvest times, funerals or any hardship that fell upon
120 the community.
121
122\head Abraham \& Sarah \hfill (identical)
123
124 When people turn 50 in Hasselt it is said that they see Abraham
125 or Sarah. The custom is to give these people a {\em speculaas}
126 Abraham or a Sarah. Speculaas is a kind of hard spiced biscuit.
127
128\stopitemize
129\stopbuffer
130
131\typebuffer
132
133The \type{\head} can be set up with \type{\setupitemize}. In case of a page
134breaking a \type{\head} will appear on a new page. (The \type {\unit{Meter}}
135command is explained in \in {chapter} [units].)
136
137The example of old customs will look like this:
138
139\getbuffer
140
141The set up parameters of itemize are described in \in {table} [tab:itemizesetup].
142
143\placetable
144 [here,force]
145 [tab:itemizesetup]
146 {Set up parameters in itemize.}
147 {\starttable[ll]
148 \HL
149 \NC \bf Set up \NC \bf Meaning \NC\SR
150 \HL
151 \NC standard \NC standard (global) set up \NC\FR
152 \NC packed \NC no vertical spacing between items \NC\MR
153 \NC serried \NC no horizontal spacing between separator and text \NC\MR
154 \NC joinedup \NC no vertical spacing before and after itemize \NC\MR
155 \NC broad \NC horizontal spacing between separator and text \NC\MR
156 \NC inmargin \NC place separator in margin \NC\MR
157 \NC atmargin \NC place separator on margin \NC\MR
158 \NC stopper \NC place full stop after separator \NC\MR
159 \NC columns \NC put items in columns \NC\MR
160 \NC intro \NC prevent page breaking after introduction line \NC\MR
161 \NC continue \NC continue numbering or lettering \NC\LR
162 \HL
163 \stoptable}
164
165You can use the set up parameters in \type{\startitemize}, but for reasons of
166consistency you can make them valid for the complete document with
167\type{\setupitemize}.
168
169The parameter \type{columns} is used in conjunction with
170a (written) number. If you type this:
171
172\startbuffer
173\startitemize[n,columns,four]
174\item Achter t Werk
175.
176.
177.
178\item Justitiebastion
179\stopitemize
180\stopbuffer
181
182\typebuffer
183
184\page[bigpreference]
185
186You will get:
187
188\startbuffer
189\startitemize[n,packed,columns,four,broad]
190\item Achter t Werk
191\item Baangracht
192\item Brouwersgracht
193\item Eikenlaan
194\item Eiland
195\item Gasthuisstraat
196\item Heerengracht
197\item Hofstraat
198\item Hoogstraat
199\item Julianakade
200\item Justitiebastion
201\item Kaai
202\item Kalverstraat
203\item Kastanjelaan
204\item Keppelstraat
205\stopitemize
206\stopbuffer
207
208\bgroup
209\getbuffer
210\egroup
211
212Sometimes you want to continue the enumeration after a short intermezzo. Then you
213type for example \type{\startitemize[continue]} and numbering
214will continue and all other preferences are kept.
215
216\startbuffer
217\startitemize[continue]
218\item Markt
219\item Meestersteeg
220\item Prinsengracht
221\item Raamstraat
222\item Ridderstraat
223\item Rosmolenstraat
224\item Royenplein
225\item Van Nahuijsweg
226\item Vicariehof
227\item Vissteeg
228\item Watersteeg
229\item Wilhelminalaan
230\item Ziekenhuisstraat
231\stopitemize
232\stopbuffer
233
234\getbuffer
235
236The parameter \type{broad} enlarges the horizontal space between item separator
237and itemtext.
238
239\shortsetup{setupitemize}
240
241An itemize within an itemize is automatically typeset in a correct way. For
242example if you type:
243
244\startbuffer
245In the Netherlands the cities can determine the height of a number of
246taxes. So the cost of living can differ from town to town. There are
247differences of up to 50\% in taxes such as:
248
249\setupitemize[2][width=5em]
250\startitemize[n]
251
252\item[estate tax] real estate tax
253
254 The real estate tax is divided into two components:
255
256 \startitemize[a,packed]
257 \item the ownership tax
258 \item the tenant tax
259 \stopitemize
260
261 If the real estate has no tenant the owner pays both components.
262
263\item dog licence fee
264
265 The owner of one or more dogs pays a fee. When a dog has died
266 or been sold the owner has to inform city hall.
267
268\stopitemize
269\stopbuffer
270
271\typebuffer
272
273then the horizontal space between item separator and text at the second level of
274itemizing is set with \type{\setupitemize[2][width=5em]}.
275
276The example will look like this:
277
278\start
279\getbuffer
280\stop
281
282You can refer to an item if you give it a label (see \type{\item[estate tax]}).
283If you then type:
284
285\startbuffer
286\in{In item}[estate tax] we discussed one of the income sources of Hasselt.
287\stopbuffer
288
289\typebuffer
290
291Youll get a reference to that item:
292
293\getbuffer
294
295\stopchapter
296
297\stopcomponent
298 |