Debian Codegraph @

texmf-dist/doc/latex/ntgclass/classdoc.tex

raw
1 \documentclass[a4paper,10pt]{artikel1} % or just 'article'
2 \usepackage{shortvrb}
3 \newcommand\Lopt[1]{\textsf{#1}}
4 \newcommand\file[1]{\texttt{#1}}
5
6 \begin{document}
7
8 \title{An introduction to the Dutch \LaTeX\ document
9 classes\thanks{Updated for \LaTeXe\ by Johannes Braams, 6 february
10 1994}}
11 \author{Victor Eijkhout}
12 \date{3 September 1989}
13 \maketitle
14
15 \section{Background}
16
17 The Dutch \LaTeX\ document classes are an attempt to provide \LaTeX\
18 users with facilities of the standard distribution document classes
19 `article' and `report', but coupled to typography that is geared
20 towards Dutch usage. In order to ensure interchangeability, the new
21 styles implemented the commands of the distribution styles. In
22 principle, then, no manual for these styles would be needed. There
23 are a few points, however, that can't go without comment.
24
25 Table 1 lists all files connected with the Dutch document classes.
26 These files can be found on the \texttt{tex-nl} fileserver
27 on the \texttt{hearn} node of Bitnet/Earn and on the \textsc{ctan}.
28 Not all of them are necessary, the ones with extension \file{.tex}
29 contain just blah.
30
31 Remark: there exists a Dutch version of `letter', which is so
32 specifically Dutch that I decided not to include it in this list.
33
34 \begin{table}[hbtp]
35 \begin{center}
36 \begin{tabular}{|@{\tt\hspace{1em}}r|l|}
37 \hline
38 ntgclass.tex & The \LaTeXe\ source for this text\\
39 ntgclass.dtx & The source for all the class files\\
40 ntgclass.dst & A \textsf{docstrip} program to produce\\
41 & the class files from the source.\\
42 artikel1.cls & article compatible, design 1, straightforward \\
43 artikel2.cls & article compatible, design 2, rather different \\
44 artikel3.cls & article compatible, design 3,
45 parskip instead of indent\\
46 rapport1.cls & report compatible, design 1 \\
47 rapport3.cls & report compatible, design 3 \\
48 book.cls & book compatible, design 1\\
49 ntg10.clo & 10 point option for all styles \\
50 ntg11.clo & 11 point option for all styles \\
51 ntg12.clo & 12 point option for all styles \\
52 artdoc.tex & the genesis of the `artikel' classes, in Dutch \\
53 briefdoc.tex & the genesis of the `brief class, also in Dutch \\
54 rapdoc.tex & the genesis of the `rapport' classes, also in
55 Dutch.\\
56 \hline
57 \end{tabular}
58 \end{center}
59 \caption{List of files}
60 \end{table}
61
62
63 \section{Languages}
64
65 These styles have been developed bearing in mind suggestions of Hubert
66 Partl for making the language of styles switchable. Thus, on their
67 own these styles will produce English captions like `chapter' and
68 `table of contents', but specifying the options `dutch' or `german',
69 or any language option that follows the directions of Partl, will
70 switch these to the language of the option.
71
72 \MakeShortVerb{\|}
73
74 \section{Design}
75
76 At the moment there are styles compatible with `article' and with
77 `report'. The Dutch names for these are `artikel' and `rapport'. In
78 contrast to the standard styles, however, the user can now choose from
79 different visual designs. Names of the styles are formed by appending
80 their number to the name, for instance `rapport3'.
81 \begin{enumerate}
82 \item Design one is meant to be a universally acceptable style. It
83 has been kept as uncontroversial as possible. Under heavy protests
84 of the implementer (me) the one point that has turned out to be
85 controversial, the table of contents, has been made subject to a
86 switch that can restore the old \LaTeX\ layout. Explanation of this
87 follows.
88 \item Design two will probably never be heavily used. It is more
89 something of a heroic attempt to be different. At the moment only
90 available in `artikel' form.
91 \item Design three meets the wishes of people who like a zero
92 |\parindent| and a positive |\parskip|. As just setting these
93 parameters within for instance `artikel1' will give some unwanted
94 side effects, I~decided to repair these in a separate style.
95 \end{enumerate}
96 Credits for the visual design go to one real-life designer and a
97 couple of books by designers I consulted. The full story can be found
98 elsewhere.
99
100 \subsection{User options}
101
102 As was mentioned above, the new layout of the table of contents has
103 turned out to be somewhat controversial. So, in order to ensure wider
104 acceptance of these styles I~have incorporated a switch that will
105 restore the old layout. Just specify the \Lopt{oldtoc} option. This is
106 available in designs 1 and~3. Number~2 really insists on being
107 different.
108
109 %I~do no page sizing, so kindly use an option like \texttt{a4}.
110 %There is a nice one on the server, which is not the one
111 %by John Pavel.
112
113 \subsection{Option files}
114
115 Like in the standard styles there exist option files for $10/11/12$
116 point layout. Until now, however, I~have managed to get away with
117 using the same option files for both the `artikel' `rapport', and
118 `boek' styles. The option files then have to have some neutral names.
119 Which are at the moment \file{ntg10}, \file{ntg11},
120 and~\file{ntg12}. `NTG', of course, stands for Nederlandse \TeX\
121 Gebruikersgroep, i.e., Dutch \TeX\ Users Group.
122
123 When doing the `rapport' styles, I~needed to modify the `\file{titlepag}'
124 option file. Thus there is a Dutch version of that, bearing the name
125 of `voorwerk' (literal translation: `frontwork'). Probably the
126 majority of Dutch \LaTeX\ users don't even know that this is the
127 correct term. You're never too old to learn.
128
129 With the \LaTeXe\ version of thes classes the file \file{voorwerk.sty}
130 has disappeared. It has been turned into the internal option
131 \Lopt{voorwerk}, just like \file{titlpage.sty} has disappeared into
132 the internal option \Lopt{titlepage}.
133 \end{document}
134