From b4fc5f639874db951177ec539299d20908adb654 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 9 Jan 2006 00:44:40 +0000 Subject: doc 4 git-svn-id: svn://tug.org/texlive/trunk@80 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/ntgclass/00readme.txt | 30 + Master/texmf-dist/doc/latex/ntgclass/a4.pdf | Bin 0 -> 149067 bytes Master/texmf-dist/doc/latex/ntgclass/artdoc.pdf | Bin 0 -> 146448 bytes Master/texmf-dist/doc/latex/ntgclass/artdoc.tex | 682 +++++++++++++++++++++ Master/texmf-dist/doc/latex/ntgclass/brief.pdf | Bin 0 -> 198831 bytes Master/texmf-dist/doc/latex/ntgclass/brief.tex | 229 +++++++ Master/texmf-dist/doc/latex/ntgclass/briefdoc.pdf | Bin 0 -> 81879 bytes Master/texmf-dist/doc/latex/ntgclass/briefdoc.tex | 306 ++++++++++ Master/texmf-dist/doc/latex/ntgclass/catalog.txt | 25 + Master/texmf-dist/doc/latex/ntgclass/changes.txt | 5 + Master/texmf-dist/doc/latex/ntgclass/classdoc.pdf | Bin 0 -> 69777 bytes Master/texmf-dist/doc/latex/ntgclass/classdoc.tex | 164 +++++ Master/texmf-dist/doc/latex/ntgclass/manifest.txt | 47 ++ Master/texmf-dist/doc/latex/ntgclass/ntgclass.pdf | Bin 0 -> 376559 bytes Master/texmf-dist/doc/latex/ntgclass/rapdoc.pdf | Bin 0 -> 138589 bytes Master/texmf-dist/doc/latex/ntgclass/rapdoc.tex | 710 ++++++++++++++++++++++ 16 files changed, 2198 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/ntgclass/00readme.txt create mode 100644 Master/texmf-dist/doc/latex/ntgclass/a4.pdf create mode 100644 Master/texmf-dist/doc/latex/ntgclass/artdoc.pdf create mode 100644 Master/texmf-dist/doc/latex/ntgclass/artdoc.tex create mode 100644 Master/texmf-dist/doc/latex/ntgclass/brief.pdf create mode 100644 Master/texmf-dist/doc/latex/ntgclass/brief.tex create mode 100644 Master/texmf-dist/doc/latex/ntgclass/briefdoc.pdf create mode 100644 Master/texmf-dist/doc/latex/ntgclass/briefdoc.tex create mode 100644 Master/texmf-dist/doc/latex/ntgclass/catalog.txt create mode 100644 Master/texmf-dist/doc/latex/ntgclass/changes.txt create mode 100644 Master/texmf-dist/doc/latex/ntgclass/classdoc.pdf create mode 100644 Master/texmf-dist/doc/latex/ntgclass/classdoc.tex create mode 100644 Master/texmf-dist/doc/latex/ntgclass/manifest.txt create mode 100644 Master/texmf-dist/doc/latex/ntgclass/ntgclass.pdf create mode 100644 Master/texmf-dist/doc/latex/ntgclass/rapdoc.pdf create mode 100644 Master/texmf-dist/doc/latex/ntgclass/rapdoc.tex (limited to 'Master/texmf-dist/doc/latex/ntgclass') diff --git a/Master/texmf-dist/doc/latex/ntgclass/00readme.txt b/Master/texmf-dist/doc/latex/ntgclass/00readme.txt new file mode 100644 index 00000000000..be1dcc6ad3c --- /dev/null +++ b/Master/texmf-dist/doc/latex/ntgclass/00readme.txt @@ -0,0 +1,30 @@ + NTG document classes distribution + + 20 February 2004 + +This file contains the distribution guide for the new version +of the NTG document classes and the A4 package. +The classes are maintained by NTG Working Group 13 + +This distribution is described in the files ending with .txt. + + * 00readme.txt is this file. + + * manifest.txt lists all the files in the distribution. + +For more information about the document classes see the file +ntgclass.tex. + +These files may be distributed and/or modified under the +conditions of the LaTeX Project Public License, either version 1.3 +of this license or (at your option) any later version. +The latest version of this license is in + http://www.latex-project.org/lppl.txt +and version 1.3 or later is part of all distributions of LaTeX +version 2003/12/01 or later. + +Please do not request updates from us. Distribution is done only +through mail servers and TeX organisations. + + +--- Copyright 1994-2004 NTG. All rights reserved --- diff --git a/Master/texmf-dist/doc/latex/ntgclass/a4.pdf b/Master/texmf-dist/doc/latex/ntgclass/a4.pdf new file mode 100644 index 00000000000..fb63ff89f6f Binary files /dev/null and b/Master/texmf-dist/doc/latex/ntgclass/a4.pdf differ diff --git a/Master/texmf-dist/doc/latex/ntgclass/artdoc.pdf b/Master/texmf-dist/doc/latex/ntgclass/artdoc.pdf new file mode 100644 index 00000000000..c52fa417efe Binary files /dev/null and b/Master/texmf-dist/doc/latex/ntgclass/artdoc.pdf differ diff --git a/Master/texmf-dist/doc/latex/ntgclass/artdoc.tex b/Master/texmf-dist/doc/latex/ntgclass/artdoc.tex new file mode 100644 index 00000000000..b581d235295 --- /dev/null +++ b/Master/texmf-dist/doc/latex/ntgclass/artdoc.tex @@ -0,0 +1,682 @@ +% \iffalse meta-comment +% +% % \iffalse meta-comment +% % +% % Copyright (C) 1990-2004 Nederlandstalige TeX Gebruikersgroep. +% % All rights reserved. +% % +% % This file is part of the NTG document classes distribution +% % ---------------------------------------------------------- +% % +% % It may be distributed and/or modified under the +% % conditions of the LaTeX Project Public License, either version 1.3 +% % of this license or (at your option) any later version. +% % The latest version of this license is in +% % http://www.latex-project.org/lppl.txt +% % and version 1.3 or later is part of all distributions of LaTeX +% % version 2003/12/01 or later. +% % +% % This work has the LPPL maintenance status "maintained". +% % +% % The Current Maintainer of this work is Johannes Braams. +% % +% % The list of all files belonging to the NTG document classes +% % distribution is given in the file `manifest.txt. +% % +% % The list of derived (unpacked) files belonging to the distribution +% % and covered by LPPL is defined by the unpacking scripts (with +% % extension .ins) which are part of the distribution. +% % \fi +% \fi +\documentclass[a4paper]{artikel1} %ja,ja, onze eigen documentstijl! +\usepackage[dutch]{babel} + +\begin{document} +\date{3 september 1989 / 3 juni 1994} +\title{Documentstijlen Artikel$x$\\ + Verantwoording} +\author{Victor Eijkhout} +\maketitle + +\begin{abstract} + Dit is de verantwoording voor de documentstijlen `Artikel1', + `Artikel2', en~`Artikel3'. Deze stijlen zijn bedoeld als een + \emph{mogelijke} vervanging van de stijl `article'. In dit verhaal + zijn beschreven +\begin{enumerate} +\item de redenen waarom bepaalde veranderingen zijn aangebracht; +\item de parameters en commando's die op de veranderingen betrekking + hebben; en +\item de wijze waarop de veranderingen zijn ge"implementeerd. +\end{enumerate} +Tegelijk is dit document een uitprobeerobject voor de nieuwe +stijlen\footnote{De hoeveelheid gebruikte \LaTeX-constructies is + derhalve aan de ruime kant. De lezer wordt vriendelijk gevraagd zich + hieraan niet te ergeren.}. +\end{abstract} + + +\part{Algemeen} + +\section{Verantwoording} + +De documentstijlen `Artikel$x$' zijn bedoeld als verbetering van de +standaard \LaTeX-document\-stijl `Article'. De meeste macros zijn +derhalve modificaties van constructies uit `article.sty' of +`latex.tex'. + +Bij het ontwerpen van de opmaak heb ik advies gehad van Inge +Eijkhout~\cite{Inge}. Het boek `Tekstwijzer'~\cite{Karel} van Karel +Treebus was verder een hulp (de opmaak van de inhoudsopgave in +`Artikel1' is daar zelfs compleet uit overgenomen). Ook erken ik de +invloed van John Miles' `Ontwerpen voor Desktop +Publishing'~\cite{Miles}. Nico Poppelier heeft met raad en daad ter +zijde gestaan. Wat er fout is aan deze stijlen blijft natuurlijk voor +mijn rekening komen. + +\section{Overzicht}\label{overzicht:sectie} + +De documentstijlen `Artikel$x$' zijn geheel compatibel met `Article': +er zijn geen commando's toegevoegd of weggelaten. De veranderingen +ten opzichte van `Article' betreffen enkel de opmaak. In het +bijzonder is er gesleuteld aan: +\begin{enumerate} +\item witregels rond koppen van secties, subsecties en subsubsecties + (van nu af aan `sectiekoppen' genoemd), +\item verdere veranderingen aan de opmaak van deze koppen, +\item de hoeveelheid inspringing bij lijststructuren (gegenereerd met + het \LaTeX\ \verb.\@list. commando), in het bijzonder `itemize', + `enumerate', en (specifiek voor `article') `description', en +\item verdere opmaak van lijststructuren, +\item verdere opmaak van sectiekoppen, en +\item de inhoudsopgave. +\end{enumerate} +Over het algemeen is het de bedoeling geweest een strakke opmaak te +krijgen (de standaard stijlen van \LaTeX\ `zwemmen' over de pagina). + +\section{Exportkwaliteit documentstijlen} + +De documentstijlen `Artikel$x$' kunnen zowel gebruik maken van de +stijloptie `Dutch' (auteur: Johannes Braams) als van `German' (auteur: +Hubert Partl), als van elke andere optie die de door Partl in `German' +gesuggereerde parametrisaties doorvoert. Deze opties zijn een +reparatie voor het euvel dat de meeste taalspecifieke termen in de +stijlen van de heer Lamport niet geparametriseerd zijn. + +In `Dutch' worden definities uit `Article' en dergelijke overreden +door geparametriseerde versies\footnote{Een listige truc laat `Dutch' + achterhalen door welke stijl hij aangeroepen is; de `Artikel' + stijlen zijn een onbekende stijl voor `Dutch'}, die op verschillende +talen ingesteld kunnen worden. Deze definities hadden natuurlijk al +in de stijlen van heer Lamport geparametriseerd moeten zijn. + +De optie `German' is minder drastisch dan `Dutch': deze gaat ervan uit +dat hij door geparametriseerde stijlbestanden opgeroepen wordt, en zet +zelf alleen de parameters. De `Artikel' stijlen zijn geparametriseerd +volgens de suggestie van Partl. + +\subsection{Kanttekening}De stijl `Dutch' parametriseert +onder andere het commando `abstract'. Aangezien ik dit commando om +opmaaktechnische redenen al herdefinieer, kan `Dutch' niet op +`Artikel' losgelaten worden alsof het gewoon `Article' was. Momenteel +is `Artikel' dus een `onbekende documentstijl' waar het `Dutch' +betreft, en wordt er geen gebruik gemaakt van het feit dat een aantal +definities zich ook in `Dutch' bevinden. + +\subsection{Een steek onder water} +Hoewel het mij tegen de borst stuit het Engels een voorkeurspositie te +geven onder de wereldtalen --~zeker in een voor het Nederlands +bedoelde stijl~-- heb ik besloten de Engelse parameterwaarden uit +`Dutch' als verstekwaarde in de `Artikel'-stijlen op te nemen. Een +belangrijk argument hiervoor is dat dit de stijlen geheel gelijk maakt +aan `Article' op commando\-nivo: zonder extra opties worden er Engelse +teksten geleverd, en voor Nederlands of Duits in een optiebestand +nodig. + +Een minstens zo belangrijk argument\footnote{mij door Nico Poppelier + aan de hand gedaan} hiervoor is dat de `Artikel'-stijlen zo een +steek onder water naar Leslie Lamport vormen. Ze zeggen als het ware +`\emph{Look here buster,} zo had het van begin af aan moeten zijn'. + +\part{Mechanismen; veranderingen in Artikel1} + +In de nu volgende subsecties worden de veranderingen ten opzichte van +de oude artikelstijl besproken in volgorde van oplopende +moeilijkheidsgraad van implementatie. De algemene mechanismen worden +besproken, alsmede hun concrete realisatie in~`Artikel1'. + +\section{Trivialiteiten} + +In de `article'-stijl staat `raggedbottom' aan voor enkelzijdige +documenten. Dit moet uit. `Frenchspacing' dient altijd aan te staan. + +\subsection{Paginanummers} +De gebruiker kan met \verb.\pagestyle{STIJL}. een stijl van kop- en +voetregels opgeven. De `Article' stijl definieert `plain' +(gecentreerde voetregels), en `headings' en `myheadings' +(asymmetrische kopregels). Als een gebruiker een stijl specificeert, +resulteert dat in de aanroep van een commando \verb.\ps@STIJL.. + +Omdat ik paginanummers wil hebben die rechts staan voor enkelzijdige +documenten, en links/rechts voor tweezijdige documenten heb ik het +commando \verb.\ps@plain., de verstekwaarde, omgebouwd. + +\subsection{De samenvatting in `Artikel1'} +In `Artikel1' heb ik de samenvatting tegen de linker kantlijn aan +getrokken. Het is nu enkel een groep waarbinnen de korpsgrootte +`small' gebruikt wordt. + +\section{Makkelijke veranderingen: witregels} + +De \LaTeX\ artikelstijl wordt gekenmerkt door een overmaat aan +witregels. Hierin is stevig gesnoeid. + +\subsection{Witregels rond koppen} + +De `article'-stijl maak zowel het wit boven als onder koppen rekbaar. +Gevoegd bij het feit dat de `natuurlijke lengte' van dit wit al aan de +ruime kant is, maakt dit het paginabeeld erg los. Witregels moeten +kleiner worden, en mogen tussen kop en de eerste regel van de tekst +niet rekbaar zijn. Verder verdient het aanbeveling de witruimte in +termen van het regeltransport aan te geven. + +\subsubsection{Relevante concepten} +Het wit onder en boven koppen wordt bepaald door parameters 4~en~5 van +\verb.\@start.\-\verb.section., hetwelk commando in `art1$x$.sty' +gebruikt wordt om de sectiekopcommando's te defini"eren. Parameter~4 +dient (in ons geval) het negatieve van de gewenste skip te +specificeren. + +\newpage +\subsubsection{Implementatie van de veranderingen} +De volgende waarden voor de verticale witruimte zijn gebruikt +\begin{table}[ht] + \begin{center} + \begin{tabular}{|l|r|r|} \hline + \emph{kop} & \emph{wit boven kop}&\emph{wit onder kop}\\ \hline + section & -2-1+.5 & .5\\ + subsection & -1-.5+.25 & .25\\ + subsubsection& -1-.5+.25 & .25\\ \hline + \end{tabular} + \end{center} + \caption{Hoeveelheid vertikaal wit in termen van + `normalbaselineskip'} +\end{table} +(in eerste instantie waren mij hogere waarden gesuggereerd, na +inspectie bleken deze waarden beter te voldoen). + +De hoeveelheid wit boven koppen steekt niet zo nauw. Die eronder wel. +In het bijzonder is het een merkwaardig idee het wit onder koppen +rekbaar te hebben. De grootte van dit wit draagt aanzienlijk bij aan +het ritme van de pagina. + + +Opmerking: Aangezien alle skips in termen van de `baselineskip' +gegeven worden, kunnen deze definities opgetild worden van het +optiebestand naar het stijlbestand. + + +\subsection{Witregels rond lijststructuren} + +Witregels rond de items van een lijststructuur maken het paginabeeld +onrustiger, en zijn vaak niet functioneel: een `itemize'-structuur is +meestal \'e\'en doorlopend betoog waarin witregels ongewenst zijn. Er +valt iets voor te zeggen rondom `description'-structuren wel witregels +toe te staan, aangezien de beschrijvende termen in feite een kopje +vormen. + +De eerste tekstregel na een lijststructuur dient niet ingesprongen te +worden, ongeacht of de gebruiker een regel open gelaten heeft achter +de lijst (bij voorbeeld om zijn invoer overzichtelijker te maken). + + +\subsubsection{Inventaris van relevante concepten} +\LaTeX\ bestuurt witregels rond en in lijststructuren met de +parameters `topsep', `partopsep', `itemsep', `parsep'. +\begin{figure}[hb] + \begin{center} + \begin{tabular}{ll} + topsep & ruimte boven een lijst\\ + partopsep & extra als de lijst een nieuwe paragraaf opent\\ + itemsep & ruimte tussen items\\ + parsep & ruimte tussen paragrafen.\\ + \end{tabular} + \end{center} + \caption{Parameters in tabel-omgeving} +\end{figure} +Deze parameters worden gezet in `art1$x$.sty' in het commando +\begin{verbatim} +@list\romannumeral\the\@listdepth +\end{verbatim} +hetgeen ge`eval'd wordt in \verb.\@list.. + +Spaties na een lijststructuur kunnen onderdrukt worden door +\verb.\if@ignoretrue. toe te voegen aan `enditemize' +en~`endenumerate'. Het is nog niet duidelijk of voorkomen kan worden +dat er ingesprongen wordt als de gebruiker een lege regel ingeeft. + + +\subsubsection{Implementatie van de veranderingen} +Voor de gebruikte lijststructuren (met mogelijke uitzondering van +`description') dienen al deze parameters nul te zijn. + +Opmerking: als voor de `labelwidth' en de `labelsep' een oplossing in +termen van fontparameters gevonden wordt, kunnen de `listi' en +dergelijke commando's opgetild worden van het stijloptiebestand naar +het stijlbestand zelf. + + +\subsection{Verdere witregels} +Het wit rond lijststructuren wordt bestuurd door de locale `topsep', +die we boven nul gemaakt hebben, en door de globale `topsep'. Voor +een strakke opmaak is het wenselijk die nul te maken, echter hiermee +verdwijnt ook het wit op een plaats waar dat wel wenselijk is: rond +`verbatim' delen van het document. De oplossing zou kunnen zijn het +invoegen van een `topsep' in het \verb.\verbatim. commando. + +De witregel tussen voetnoten wordt bestuurd door de `footnotesep'. Ik +zou niet weten waarom die anders dan nul zou moeten zijn. + + +\section{Ook niet moeilijk: fonts} + +Er moet wat met fonts gerommeld worden. Voornamelijk moeten ze +kleiner, en het cursief moet vervangen worden door wat in Nederlandse +terminologie `gecursiveerd' heet; wij \TeX ies kennen dit als +`slanted'. + +\subsection{Fonts in sectiekoppen} + +De fonts gebruikt in tussenkopjes zijn proefondervindelijk tot stand +gekomen, en waarschijnlijk nog aan mutatie onderhevig. De +oorspronkelijk idee"en komen uit de `Sober'-stijl van Nico Poppelier. +Daarna is het `italic' vervangen door `slanted'. Kwestie van smaak. +Ik hou niet van de~\mbox{\emph{cmti}}. Verder is het klein kapitalen +font als `\dots~en hopeloos ouderwets'~\cite{Inge} de laan +uitgestuurd. + +\subsection{Theorems en het `emphasize' font} + +Om tekst te beklemtonen gebruikt \LaTeX\ het cursieve font +\texttt{cmti}. Dit vin' ik niet mooi. Binnen de Nederlandse stijlen +wordt er dus beklemtoond met \texttt{cmsl}. Ook in de `theorem' +omgevingen is deze vervanging doorgevoerd. + + +\section{Moeilijke veranderingen: eenheidsinspringing} + +Ten einde een strakke paginaopmaak te verkrijgen, verdient het +aanbeveling het aantal (impliciete) kantlijnen tot een minimum te +beperken. De radicaalste oplossing voor dit probleem bestaat uit + +\begin{enumerate} +\item alle labels in lijststructuren tegen de linkerkantlijn aan te + plaatsen (dit is niet zo mooi als er ver ingesprongen wordt), +\item voetnoten niet te laten inspringen (ingesprongen voetnoten zien + er alleen goed uit als ze meer dan \'e\'en regel lang zijn), en +\item een eenheidsinspringing in te voeren voor + \begin{itemize} + \item alinea's, + \item teksten van koppen op alle nivo's, en + \item de ingesprongen tekst in lijststructuren. + \end{itemize} +\end{enumerate} +Laten we er voorlopig dus vanuit gaan dat er een parameter +`unitindent' is. De berekening van deze grootheid komt verderop aan de +orde. + +\subsection{Inspring bij lijststructuren} + +Labels voor items in een lijst defini"eren gemakkelijk een tweede +kantlijn. Het kan dus gewenst zijn ze tegen de linkerkantlijn van de +omringende tekst aan te plaatsen. + +\subsubsection{Inventaris van relevante concepten} +Een lijst op het eerste nivo springt in over `leftmargini'. Het label +wordt van de tekst gescheiden door `labelsep', en heeft breedte +`labelwidth', tenzij de natuurlijke breedte groter is. De linkerkant +van het label staat echter altijd op `labelwidth' plus `labelsep' van +de ingesprongen kantlijn. De inhoud van het label wordt in de +omringende box geplaatst door het commando `makelabel'. + +Al deze begrippen worden ingevuld in de commando's `list$x$'. + +\subsubsection{Implementatie van de veranderingen} +Het zetten van parameters kan mooi in de `list$x$' commando's +gebeuren: +\begin{verbatim} +\def\@listi{\leftmargin=\unitindent + \labelsep=\enspace + \labelwidth=\leftmargin + \advance\labelwidth by -\labelsep}} +\end{verbatim} +Als de `unitindent' door fontparameters bepaald wordt, hoeft deze +definitie niet meer in het optiebestand te staan, maar kan naar de +stijldefinitie opgetild worden. + +Het veranderen van de definitie van `makelabel' is lastiger: dit moet +in het tweede argument van `list' gebeuren. We zullen dus `itemize' en +`enumerate' moeten herdefini"eren met een nieuwe definitie van +`makelabel'. + +\subsubsection{Speciale behandeling eerste nivo} + +Omdat de `unitindent' tamelijk groot uitvalt, heb ik ervoor gekozen +labels op het eerste nivo rechts aan te lijnen (waardoor ze dus in +bescheiden mate een nieuwe kantlijn definieren), andere labels lijnen +links. + +Dit is ge"implementeerd door in het `commands' argument van +\verb.\@list. de definitie van `makelabel' afhankelijk te maken van de +\verb.\@listdepth.. + + + +\subsection{Inspring bij koppen} + +De plaatsing van de tekst van koppen (achter het sectienummer) is in +\LaTeX\ ogenschijnlijk willekeurig, en draagt hiermee (zeker als twee +koppen onder elkaar staan) bij tot een onrustig paginabeeld. Dit kan +aanmerkelijk verbeterd worden door voor het sectienummer en de erop +volgende spatie een eenheidsbreedte te nemen. + +\subsubsection{Inventaris van relevante concepten} +In het commando \verb.\@sect. wordt een commando \verb.\@svsec. +ge`edef't dat het sectie nummer afdrukt, gevolgd door +`1~em'\footnote{Ter herinnering: + \begin{itemize} + \item Er zijn 5 nivo's van sectiekoppen: `section', `subsection', + `subsubsection', `paragraph', en `subparagraph'. + \item De eerste 3 nivo's zijn genummerd. + \item De laatste twee nivo's geven een kop die in de tekst is + ingebed. + \end{itemize}}\footnote{Aangezien de definitie van 'em' met het + gebruikte font meeverandert, geeft het gebruik van twee of drie + koppen onder elkaar een merkwaardig visueel effect.}. + +\subsubsection{Implementatie van de veranderingen} +Er moet een nieuwe versie van \verb.\@sect. komen die een verbeterde +\verb.\@svsec. bevat: +\begin{verbatim} +\edef\@svsec{\hbox to \unitindent + {\csname the#1\endcsname\hfil}} +\end{verbatim} +In plaats van `unitindent' kan als breedte ook een verdere +parametrisatie met +\begin{verbatim}\csname #1labelwidth\endcsname +\end{verbatim} +gekozen worden. De `unitindent' kan als volgt gegenereerd worden: +\begin{verbatim} +\newdimen\unitindent +{\setbox0\hbox{\normalsize\bf 2.2.2\ } + \global\unitindent=\wd0} +\parindent=\unitindent +\leftmargini=\unitindent +\end{verbatim} + +Dit is helaas nog niet voldoende. Als een gebruiker erg veel van +secties en subsecties houdt, kunnen de nummers een grotere breedte dan +die van `2.2.2' krijgen. Daarom wordt het label iedere keer bij een +nieuw kopje opgemeten, en zonodig wordt de `unitindent' bijgesteld. +Bij het afsluiten van het document wordt dan de definitieve waarde +(die misschien de oude is, en misschien veel meer) naar het +\texttt{.aux}-bestand geschreven. Dat wil zeggen: er wordt een +toewijzing van die waarde aan de unitindent weggeschreven. + +Adders en voetangels te over: hiervoor moet het commando `enddocument' +herschreven worden. + + +\section{Verdere moeilijke veranderingen: de opmaak van + lange koppen. Zoals deze dus. Reeds. Antidisestablishmentarianism. + Hottentottententententoonstelling.} + +\LaTeX\ zet koppen als ingesprongen paragrafen. Het is echter niet +gewoon dat een meerregelige kop zo behandeld wordt: beter is het vrije +regelval te gebruiken en vooral woordafbreking (zelfs in samengestelde +woorden) te verbieden. + +\subsection{Inventaris van relevante concepten} +Binnen het commando \verb.\@sect. wordt de kop van de sectie gezet als +\begin{verbatim} +{\interlinepenalty\@M #8\par} +\end{verbatim} + +\subsection{Implementatie van de veranderingen} +Aan de zetcommando's voor de sectiekoppen dient een aanroep van +`headstyle' toegevoegd te worden, waar +\begin{verbatim} +\def\headstyle{\nohyphenation \rightskip=0cm plus 3cm} +\end{verbatim} +of zoiets. Het commando `nohyphenation' kan op verschillende manieren +bereikt worden, ik heb gekozen voor \verb+\hyphenpenalty=10000+, en +idem zo voor de `exhyphenpenalty'. + +\section{Opties} + +De stijlen `Artikel1' en `Artikel3' hebben een door de gebruiker te +kiezen optie. Hiermee kan de gebruiker de opmaak naar eigen +goeddunken varieren. Misschien dat er nog wel meer van dat soort +opties komen. + +\subsection{Hoe werken opties} +Een door de gebruiker gespecificeerde stijloptie wordt soms +gerealiseerd door een commando in het stijlbestand, en soms door een +in te laden optiebestand. Het mechanisme dat dit bewerkstelligt is +het volgende. + +Ergens bovenin het stijlbestand worden commando's \verb.\ds@OPTION. +gedefinieerd. Als de gebruiker de betreffende optie meegegeven heeft, +wordt dit commando uitgevoerd door \verb.\@options., dat ook ergens +bovenin het stijlbestand staat. Voor die opties waarvoor geen +\verb.\ds@OPTION. macro gedefinieerd is, wordt na de verwerking van +het stijlbestand door \LaTeX\ een bestand \verb.OPTION.STY. geladen. + +\section{De inhoudsopgave} + +\subsection{Beschrijving} +\subsubsection{Inventaris van kwalen} +Treebus vindt het zogenaamde `uitpunten' van een inhoudsopgave een +minder geslaagd idee. Ook over het steeds verder inspringen van kopjes +in de inhoudsopgave is hij niet te spreken. Laat dit nu precies zijn +wat \LaTeX\ doet. + +Wat mij dan nog stoort zijn de grote verschillen in zetwijze +van kopjes op verschillende nivo's. + +\subsubsection{Remedie} + +\paragraph{Kantlijnen} +Alle nummers worden tegen de linker kantlijn getrokken, en de kopjes +staan dan (allemaal) op `unitindent' van de linker kantlijn. Dit +levert geen problemen op omdat er net zoveel nivo's nummering in +kopjes als in de inhoudsopgave voorkomen. + +\paragraph{Fonts} +Kopjes worden in drie verschillende fonts gezet om de hierarchie uit +te doen komen. Ik heb gekozen voor `bf', `sl', en `rm' in +`normalsize'. Er valt over te twisten of dit misschien gewoon de fonts +van de koppen zelf moeten zijn. + +\paragraph{Verdere zetwijze} +Er wordt vrije regelval gebruikt. Het paginanummer verschijnt direct +achter het kopje (met een vaste hoeveelheid wit). + +\subsection{Implementatie} + +Ten eerste is er een commando \verb+\toc@font+ gekomen dat het font +bepaalt waarmee een kop in de inhoudsopgave gaat verschijnen. Deze +bepaling gebeurt in \verb+\@sect+, die daartoe verder is aangepast. + +Ten tweede is er, als vervanging van \verb+\@dottedtocline+, +een commando\\ \verb+\@regtocline+ dat de opmaak van de kop regelt. +De merkwaardige sequentie +\begin{verbatim} +\@tempdima=\unitindent +\end{verbatim} +zorgt ervoor dat het nummer (dat in \verb+\@sect+ in een `numberline' +gestopt is) op de goede breedte gezet wordt. + +De \verb+\l@TYPE+ commando's (waar `type' is `section' en dergelijke) +zijn omgezet zodat ze \verb+\@regtocline+ gebruiken. Uitzondering: +\verb+\l@part+. Daar kom ik nog wel een keer aan toe. + + + +\part{Veranderingen in Artikel2} + +In de documentstijl `Artikel2' is voor veel zaken een geheel andere +keuze gemaakt dan in~`Artikel1'. Vaak betekende dit dat, gegeven de +moeite die in `Artikel1' geinvesteerd was, slechts een paar parameters +veranderd hoefden te worden. In enkele gevallen, echter, moest een +geheel nieuwe aanpak gevolgd worden. + +\section{Variaties} + +De beide hier beschreven documentstijlen hebben als voornaamste +verbetering ten opzichte van `Article' een nadrukkelijk aanwezige +tweede kantlijn. In `Artikel1' wordt deze kantlijn gebruikt door al +het eenmaal ingesprongen materiaal. In~`Artikel2' wordt deze kantlijn +minder radicaal gevolgd: +\begin{itemize} +\item`verbatim' omgevingen worden weer gewoon tegen de linkerkantlijn + geplaatst; +\item de eerste kantlijn voor lijststructuren bedraagt de helft van de + paragraafinspinging; en +\item de labelbreedte van voetnoten is hieraan gelijk gemaakt. +\end{itemize} +Alles bij elkaar wordt het gewicht van de pagina verder tegen de +linkerkantlijn geplaatst. + +Van een andere kant bekeken is de tweede kantlijn (zeg dat die door de +`parindent' bepaald wordt) in de stijl~`Artikel2' juist nadrukkelijker +aanwezig: +\begin{itemize} +\item alle tussenkopjes springen in over de `parindent, en +\item de eerste regel na een kopje springt ook in. +\end{itemize} + + +\section{Behandeling van koppen} +\subsection{Sectie, subsectie, subsubsectie} +\subsubsection{Elementaria} + +Het laten inspringen van koppen gaat door een positieve waarde voor de +derde parameter van \verb.\@startsection. te specificeren. Door de +vierde parameter positief te maken springt de eerste regel na de kop +ook in. + +Omdat de tekst van de kopjes nu geen verdere kantlijn definieert hoeft +er niet zo'n moeite gedaan te worden om die te plaatsen als +in~`Artikel1'. Ik heb de normale \LaTeX-constructie van een vaste +`skip' weer in ere hersteld; op drie-tiende `em' deze keer. + +\subsubsection{Complicaties} + +Om te voorkomen dat bij lange koppen de tekst alsnog een tweede +kantlijn gaat defini"eren moest de \verb.\@hangfrom. die dit +bewerkstelligt verwijderd worden. Bij volledig verwijderen, echter, +zal de tweede regel van de kop tegen de linker kantlijn geplaatst +worden. Ook niet de bedoeling. + +In de aanpak die ik gevolgd heb hangt de tekst nu aan de inspringing; +het commando \verb.\@svsec. dat het nummer zet is gewoon in de tekst +geplaatst. + + +\subsection{Part} + +Het zou leuk zijn als de eerste regel na een `part'-kop ook insprong. +Het al dan niet inspringen van deze regel wordt bestuurd door de +schakelaar \verb.\@ifafterindent. waarop getest wordt in +\verb.\@afterheading.. Normaal wordt inspringen voorkomen door deze +schakelaar in `part' op onwaar te zetten. + +Het zal de perceptieve lezer duidelijk zijn wat ik gedaan heb om +inspringen van de eerste regel na een `part' af te dwingen. + +\section{De samenvatting} + +In `Article' (maar niet in `Artikel1') wordt de samenvatting gezet +door middel van de `quotation' omgeving. Dit, op zijn beurt, is een +`list' met slechts een item, in dit geval de tekst van de +samenvatting. Net als in~`Article' zou ik de samenvatting ingesprongen +willen zien over de alineainspring. Dit lukt niet meer als de +samenvatting als een `quotation' gezet wordt, aangezien de +lijstinspringing (op het eerste nivo) de helft van de +alineainspringing bedraagt. + +Ik heb er derhalve voor gekozen de samenvatting expliciet als een +lijst te zetten, waarbij in het tweede argument van `list' (het +argument waarin commando's meegegeven kunnen worden) de `leftmargin' +op `unitindent' gezet wordt. + +\section{De inhoudsopgave} + +De inhoudsopgave wordt in `Artikel2' net zo gezet als in~`Artikel1', +met het verschil dat de sectienummers nu niet links maar rechts +lijnen. Dit in het kader van het beklemtonen van de tweede kantlijn. +Hiertoe moest het commando `numberline' uit `LaTeX.tex' overgenomen en +aangepast worden. + +Overigens is de tweede kantlijn in de inhoudsopgave verder naar rechts +dan in de rest van het document. De inhoudsopgave dient dus liever +niet op een tekstpagina te beginnen. + +Dat de tweede kantlijn verder naar rechts staat betekent overigens dat +het woord `inhoudsopgave', dat als een sectiekop gezet wordt, +voorafgegaan moet worden door een `skip' ter breedte van het verschil. + + + +\part{Veranderingen in Artikel3} + +Uitgaande van `Artikel1' was het kinderspel een stijl te maken die net +zo strak links lijnend oogde, maar die bovendien geen +alinea\-inspringing heeft en dit compenseert met een `parskip'. +\begin{itemize} +\item Er is gekozen voor een `parskip' ter grootte van de helft van de + `baselineskip'. +\item De `topsep' in lijststructuren --~de witruimte boven en onder de + gehele lijst~-- is \emph{minus} de halve `parskip'; netto effect is + dat hier de helft van de witruimte komt die zich tussen alineas + bevindt. +\item De grootte van de `unitindent' kon ongewijzigd blijven, + aangezien kopjes nog steeds op dezelfde wijze gezet worden. +\item Het wit onder kopjes is op nul gezet. Dit betekent niet dat er + geen wit staat, want de `parskip' krijg je hoe dan ook kado. +\end{itemize} +Het geheel oogt wel aardig. + +\begin{thebibliography}{9} + +\bibitem{Inge}Inge Eijkhout, Gesprekken en correspondentie, 1989. + +\bibitem{Leslie}Leslie Lamport, \emph{\LaTeX, a document preparation + system}, Addison-Wesley, 1986. + +\bibitem{Miles}John Miles, \emph{Ontwerpen voor Desktop + Publishing\footnote{De Nederlandse uitgave is goedkoper dan de + Engelse, maar doet een zware aanslag op je ogen, door het soort + zetfout dat in \TeX\ onmogelijk zou kunnen voorkomen.}, Alles + over layout en typografie op de personal computer}, Uitgeverij + Mingus, Baarn~1988. + +\bibitem{Karel}Karel Treebus, \emph{Tekstwijzer, een gids voor het + grafisch verwerken van tekst}, SDU~uitgeverij, 1988. + +\end{thebibliography} + + +\newpage +\tableofcontents +\listoftables +\listoffigures + +\end{document} + + + + + + diff --git a/Master/texmf-dist/doc/latex/ntgclass/brief.pdf b/Master/texmf-dist/doc/latex/ntgclass/brief.pdf new file mode 100644 index 00000000000..2237d5783a2 Binary files /dev/null and b/Master/texmf-dist/doc/latex/ntgclass/brief.pdf differ diff --git a/Master/texmf-dist/doc/latex/ntgclass/brief.tex b/Master/texmf-dist/doc/latex/ntgclass/brief.tex new file mode 100644 index 00000000000..e05f3445a08 --- /dev/null +++ b/Master/texmf-dist/doc/latex/ntgclass/brief.tex @@ -0,0 +1,229 @@ +% \iffalse meta-comment +% +% % \iffalse meta-comment +% % +% % Copyright (C) 1990-2004 Nederlandstalige TeX Gebruikersgroep. +% % All rights reserved. +% % +% % This file is part of the NTG document classes distribution +% % ---------------------------------------------------------- +% % +% % It may be distributed and/or modified under the +% % conditions of the LaTeX Project Public License, either version 1.3 +% % of this license or (at your option) any later version. +% % The latest version of this license is in +% % http://www.latex-project.org/lppl.txt +% % and version 1.3 or later is part of all distributions of LaTeX +% % version 2003/12/01 or later. +% % +% % This work has the LPPL maintenance status "maintained". +% % +% % The Current Maintainer of this work is Johannes Braams. +% % +% % The list of all files belonging to the NTG document classes +% % distribution is given in the file `manifest.txt. +% % +% % The list of derived (unpacked) files belonging to the distribution +% % and covered by LPPL is defined by the unpacking scripts (with +% % extension .ins) which are part of the distribution. +% % \fi +% \fi +\documentclass{brief} %% er is een optie 'adresrechts' + +%\maaketiketten %% werkt nog niet naar behoren + +\begin{document} + +%%%%%%%%%%%%%%%%%%%%%%%%%%% briefhoofd %%%%%%%%%%%%%%%%%%%%%%%%%% +% De gebruiker wordt geacht zijn eigen \briefhoofd te definieren, +% of voorgedrukt briefpapier te gebruiken, +% maar hij kan een redelijk standaard hoofd aangemeten krijgen +% door \maakbriefhoofd. +\maakbriefhoofd{WG 13}{Werkgroep 13\\ de De Facto Standaard + \\ in Nederlandse \TeX pertise} + +% De PTT staat toe dat boven in het venster klein (5 a 6 punt) +% een antwoordadres gedrukt wordt. Het hoeft natuurlijk niet. +% En svp alleen voor binnenlands gebruik. +\antwoordadres{Toernooiveld 5, \\ 6525 ED Nijmegen} + +%%%%%%%%%%%%%%%%%%% de referentieregel %%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\uwbriefvan{13 januari 1988} % vier gegevens in de referentieregels +\datum{8 october 1989} % hier mist alleen de 'uwkenmerk' +\onskenmerk{VE-NTG 002} % volgorde en plaatsing ligt vast +% datum wordt automatisch ingevuld wanneer niet gespecificeerd + +%%%%%%%%%%%%%%%%%%%%%%%%%%% voetregel %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% maximaal vier gegevens, de gebruiker specificeert zowel het +% kopje, als wat er onder komt. Gegevens worden geplaatst in de +% opgegeven volgorde. +\voetitem{fax:}{12345 abc} +\voetitem{telefoon:}{080-613169} +\voetitem{telefoon \\ priv\'e:}{080-448664} + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% de brief zelf %%%%%%%%%%%%%%%%%%%%%%%%%% +% bijna zoals in 'letter.sty', alleen zijn de commando's +% nu in de nederlandse taal. +\begin{brief}{Werkgroep 13\\Nederlandse \TeX\ groep\\Nederland} + +\betreft{nieuwe briefstijl} +\opening{Hallo volkjes,} + +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. + + + +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. + +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. + +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. + +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. + +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. + +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. + +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. +Dit is een test om te zien hoe ver ik gevorderd ben met het +autentieke Nederlandse briefontwerp. +Het zal waarschijnlijk nog wel een tijdje duren voor er +echt iets moois uitkomt. Sprak hij bescheiden. + +\ondertekening{Victor Eijkhout \\ co\"ordinator \en Johannes Braams \\ lid + \en Nico Poppelier \\ lid} +\afsluiting{Hoogachtend,\\ Werkgroep 13} + +\bijlagen{De broncode van deze brief} +\cc{Stichting `de Kettingbrief'} +\ps{PS: panta rei} + + +\end{brief} + +%\end{document} %% hier stoppen, behalve als je 'maaketiketten' + %% wil testen. + +\onskenmerk{VE-JD1} +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\onskenmerk{VE-JD2} +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\end{document} + +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\begin{brief}{Jan Doedel\\ klinkhamerdreef 37\\ Duckstad} +\opening{Hallo,} daar ben ik dan \ondertekening{Victor}\afsluiting{doei} +\end{brief} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/ntgclass/briefdoc.pdf b/Master/texmf-dist/doc/latex/ntgclass/briefdoc.pdf new file mode 100644 index 00000000000..558ce17b424 Binary files /dev/null and b/Master/texmf-dist/doc/latex/ntgclass/briefdoc.pdf differ diff --git a/Master/texmf-dist/doc/latex/ntgclass/briefdoc.tex b/Master/texmf-dist/doc/latex/ntgclass/briefdoc.tex new file mode 100644 index 00000000000..bf1c38be08d --- /dev/null +++ b/Master/texmf-dist/doc/latex/ntgclass/briefdoc.tex @@ -0,0 +1,306 @@ +% \iffalse meta-comment +% +% % \iffalse meta-comment +% % +% % Copyright (C) 1990-2004 Nederlandstalige TeX Gebruikersgroep. +% % All rights reserved. +% % +% % This file is part of the NTG document classes distribution +% % ---------------------------------------------------------- +% % +% % It may be distributed and/or modified under the +% % conditions of the LaTeX Project Public License, either version 1.3 +% % of this license or (at your option) any later version. +% % The latest version of this license is in +% % http://www.latex-project.org/lppl.txt +% % and version 1.3 or later is part of all distributions of LaTeX +% % version 2003/12/01 or later. +% % +% % This work has the LPPL maintenance status "maintained". +% % +% % The Current Maintainer of this work is Johannes Braams. +% % +% % The list of all files belonging to the NTG document classes +% % distribution is given in the file `manifest.txt. +% % +% % The list of derived (unpacked) files belonging to the distribution +% % and covered by LPPL is defined by the unpacking scripts (with +% % extension .ins) which are part of the distribution. +% % \fi +% \fi +\documentclass[a4paper,10pt]{artikel1} +\usepackage[dutch]{babel} + +\begin{document} +\title{De Nederlandse Briefstijl} +\author{Victor Eijkhout} +\date{4 december 1991} +\maketitle + +\begin{abstract} + Een bescheiden handleiding voor de Nederlandse briefstijl, met + opmerkingen over het wat, hoe en waarom. +\end{abstract} + +\section{Verantwoording} + +De Nederlandse \LaTeX-stijl `brief' conformeert zich aan +NEN-normen\footnote{Mijn zeer grote dank aan Jan Grootenhuis die mijn + aandacht vestigde op het bestaan van de normbladen.} 1026 voor +briefpapier, 3162 voor het indelen van documenten, 1025 voor +enveloppen, en 3516 voor het ontwerp van formulieren. + +Briefontwerp is controversieel. Iedereen heeft een smaak, en met name +bij briefpapier is die vaak zeer uitgesproken. Ik wil beklemtonen dat +ik bij de implementatie van de briefstijl bijna nergens mijn smaak +nodig heb gehad. Dankzij de NEN-normen is het ontwerp van briefpapier +een zaak van exacte wetenschap, niet van schone kunsten. + +Deze stijl is redelijk incompatibel met de \LaTeX\ `letter' stijl. +Hij is in bescheiden mate met opties in te stellen, en de +sleutelwoorden kunnen uit een aantal talen gekozen worden. Alle +teksten zijn verder geparametriseerd. Het is dus goed mogelijk +stijlopties te maken om deze stijl aan een specifieke omgeving aan te +passen. + +Als de gebruiker geen gebruik maakt van een voorgedrukt briefhoofd, +kan hij zijn eigen briefhoofd in \LaTeX\ implementeren, of door de +stijl een briefhoofd geleverd krijgen. Het ontwerp van dit briefhoofd +is de enige plaats waar mijn smaak zich heeft doen gelden, maar zelfs +dit ontwerp heb ik gejat uit een NEN-norm. + +Opmerking: zeker bij het gebruik van vensterenveloppen is het voor de +briefstijl van cruciaal belang dat de gebruikte printer goed afgesteld +staat. Dit valt te controleren aan de hand van het adres: dit dient op +33mm van de linker kantlijn te staan, terwijl de `baseline' van de +eerste regel zich 59mm onder de bovenrand van het papier dient te +bevinden. + +\section{Velden van het briefpapier} + +Deze sectie behandelt de indeling van brieven aan de hand van +NEN-norm~1026. + +\subsection{Marges} + +Alle marges conformeren zich aan NEN-1026, behalve de rechtermarge die +ik voor een evenwichtiger bladverdeling gelijk gemaakt heb aan de +linkermarge. Met een gezette brief ziet dit er beduidend beter uit. + +De linkermarge is 33 millimeter; er zijn nog geen voorzieningen voor +de versmalde marge van 20 millimeter, die voor facturen beter is. Dit +zal misschien ooit een optie worden. + +Om aan te sluiten by traditionele getypte briefopmaak is `raggedright' +bij verstek ingeschakeld. Aangezien briefhoofd, referentieregels, en +voetregel de brief vrij breed kunnen maken, is de corpsgrootte bij +verstek 11-punt. 10~en~12 zijn opties. + +\subsection{Briefhoofd} + +Het moeilijkste deel van een brief, en de voornaamste plek waar de +ontwerper van briefpapier zijn creativiteit kwijt kan is het +briefhoofd. In de huidige stijl heeft de gebruiker drie +mogelijkheden. + +Een. Hij gebruikt voorgedrukt briefpapier. Als dit zich een beetje aan +NEN-normen houdt is er verder niets aan de hand. + +Twee. De gebruiker kan zelf een macro \verb.\briefhoofd. schrijven. +Als dit binnen de hoogte van \verb.\@headheight. blijft, is er niets +aan de hand; voorkeursbreedte is \verb.4\refveldbreedte., dat wil +zeggen, de breedte van de referentieregel. + +Drie. Er is een macro van twee argumenten, `maakbriefhoofd', die een +briefhoofd levert dat ge"inspireerd is op de voorbeeldbrief in +NEN-1026. Voorbeeld: +\begin{verbatim} +\maakbriefhoofd{WG13}{Werkgroep 13 \\ + Mathematisch Instituut \\ + Toernooiveld 5 \\ + 6525 ED Nijmegen} +\end{verbatim} +Het eerste argument levert een tekst op die links boven een verticale +lijn gezet wordt. Het links aanlijnen gebeurt met \verb.\hfil., dus +met een \verb.\hfill. in het argument kan een deel van het hoofd naar +rechts worden geschoven. + +Het tweede argument van `maakbriefhoofd' wordt als een blokje tekst +rechts onder de lijn in het briefhoofd gehangen. In principe is dit +argument er voor het adres van de afzender. Er is echter een +mogelijkheid het antwoordadres in het adresveld op te nemen, zie hier +onder. In het briefhoofd kan dan een omschrijving als `adviesburo +voor gespecialiseerde algemeenheden' staan. + +Het tekstblok in het tweede argument lijnt links met de datum en het +vierde voetitem (zie onder), en blijft idealiter binnen de marge van +de pagina. Er worden echter geen `overfull box' meldingen gegeven als +de tekst te breed is. + +Er is een `sterretje'-versie van `maakbriefhoofd'; deze geeft op de +vervolgbladen alleen het eerste argument plus de streep. Dat maakt de +kop van de pagina wat minder zwaar. + +\subsection{Adresveld} + +Het adresveld wordt zodanig geplaatst dat het in het venster van een +vensterenvelop zichtbaar is als het venster 5cm onder de bovenrand van +de envelop begint. Omdat er zowel vensterenveloppen zijn met het +venster links als rechts, is er een optie \texttt{adresrechts} die het +adresveld rechts plaatst. De voorkeurspositie is echter links; er +blijft dan namelijk rechts een `ontvangerruimte' waar de geadresseerde +stempels (`binnen gekomen dd.') en dergelijke kan zetten. + +Het adresveld komt op dezelfde manier tot stand als in de oude +`letter' stijl: de gebruiker geeft +\begin{verbatim} +\begin{brief}{Jan \TeX er\\ + Overfullplein 10000 \\ + Baselinestad} +\end{verbatim} +in, en hieruit destilleert \LaTeX\ de naam en het verdere adres van de +geadresseerde. De naam komt nog voor op de vervolgbladen. + +Het schijnt van de PTT te mogen dat er (helemaal boven) in het ruitje +van de vensterenvelop een antwoordadres wordt opgenomen, als dat maar +gebeurt zodanig dat het geen verwarring schept met het adres. Er is +een commando \verb.\antwoordadres. dat een adres als argument +accepteert, met de regels gescheiden door~\verb.\\.. Voorbeeld: +\begin{verbatim} +\maakbriefhoofd{WG13}{De de facto standaard \\ + in Vaderlandse \\ + \TeX verwerking} +\antwoordadres{Mathematisch Instituut \\ + Toernooiveld 5 \\ + 6525 ED Nijmegen} +\end{verbatim} + + +\subsection{De Referentieregels} + +Direct onder het adresveld volgt ruimte voor gegevens van de +geadresseerde, `Uw brief van' en `Uw kenmerk', en van afzender, `Ons +kenmerk' en `Datum'. + +Voor deze referentiegegevens staan de gebruiker de commando's +\verb.\uwbriefvan., \verb.\uwkenmerk., \verb.\onskenmerk., en +\verb.\datum. ter beschikking. Deze macro's hebben elk \'e\'en +argument tussen accolades. De datum wordt automatisch ingevuld; niet +ingevulde gegevens worden niet opgenomen. + +De teksten die hier in de kopjes staan worden in eerste instantie door +de taalopties bepaald. Verstekwaarde is natuurlijk `nederlands', maar +er zijn `engels', `amerikaans', en `duits' beschikbaar. Ik houd me +aanbevolen voor correcte terminologie in andere talen; enkele fouten +in de Duitse termen zijn op aanwijzing van Marc van Woerkom verbeterd. +Wie geeft me de Franse termen? + +De teksten in de referentieregel zijn waardes van de macros\\ +\verb.\uwbriefvantekst., \verb.\uwkenmerktekst., +\verb.\onskenmerktekst., en \verb.\datumtekst.. Het is dus mogelijk +`doorkiesnummer' in plaats van `ons kenmerk' te krijgen door deze +tekst als `onskernmerktekst' te declareren, bij voorbeeld met +\verb.\renewcommand. in het preamble. + + +\subsection{De tekst van de brief} + +Hier hoeft op deze plaats niets over gezegd te worden, anders dan dat +de aanhef, net als in de `letter' stijl met \verb.\opening. gebeurt. +Er is een `betreft' commando. + +Ook de afsluiting staat in het \LaTeX-boek beschreven, maar de +commandonamen zijn Nederlands geworden: `ondertekening' (was +`signature'), `afsluiting' (was `closing'), `ps', en `cc' Dit is +Engels, maar bijna niemand weet wat het betekent. Verder is er zowel +een `bijlage' als `bijlagen' (was~`encl'). + +\subsection{Ondertekening} + +Hier is iets meer vrijheid dan in de standaard briefstijl. Commando's +`ondertekening' en `afsluiting' kunnen in willekeurig welke volgorde +gegeven worden. + +Meervoudige auteurs in de ondertekening zijn mogelijk: +\begin{verbatim} +\ondertekening{Ik \\ directeur \en + Jij \\ adjunct \\ (oprichter)} +\end{verbatim} +geeft twee naast elkaar geplaatste handtekeningen. + +\subsection{Voetruimte} + +`In de voetruimte' (ik citeer NEN-1026) `komen die gegevens van de +afzender die niet reeds in het briefhoofd zijn vermeld'. De keuze +hiervan wordt aan de gebruiker overgelaten. Enkele suggesties zijn: +kantooradres, telefoonnummer van de centrale, faxnummer, +inschrijvingsnummer en -plaats in het handelsregister. + +Er kunnen maximaal vier voetitems zijn. Items verschijnen op de +pagina in de volgorder waarin de gebruiker ze gedeclareerd heeft. Bij +twee items of meer is het laatste rechtsgeplaatst. Goeie truc. + +Omdat hier beduidend meer keuze is dan bij de referentieregel, moet de +gebruiker zelf het hoofdje en de daaronder geplaatste tekst van items +in de voetregel voorschrijven. De macro van twee argumenten +\verb.\voetitem. staat hem/haar daartoe ter beschikking. Elke van de +argumenten kan meer dan \'e\'en regel lang zijn, gebruik~\verb.\\.. +Voorbeeld: +\begin{verbatim} +\voetitem{fax:}{12345 Winat nl} +\voetitem{telefoon:}{080-613169\\ bgg: 612986} +\voetitem{telefoon\\ priv\'e:}{080-448664} +\end{verbatim} + +\subsection{Hulplijntjes; vouwstreepjes} + +Door een optie `streepjes' in te schakelen, is het briefpapier van +hulpstreepjes te voorzien. + +Volgens NEN-1026 heeft briefpapier een instelstreepje halverwege, niet +voor vouwen in twee"en zoals hele volksstammen denken, maar voor het +aanlijnen van de perforator. Aan de rechterzijde van het blad zijn +twee vouwstreepjes, een voor vouwen in drie"en, en een voor vouwen in +twee"en. Geen van beide bevindt zich op de helft of een-derde van de +papierhoogte. Omdat enveloppen hoger zijn dan een A4-tje gedeeld door +2 of~3 zou dat ook niet kunnen. Vensters, weet U wel? + +Ik ben uitgegaan van envelopformaten EN-C5 ($162\times229$mm voor een +A4 in twee"en) en EN-DL ($110\times220$ voor een A4 in drie"en) +volgens NEN-1025 en ISO 269-1979. Vouwstreepjes bevinden zich op +105mm en 155mm onder de bovenrand van het papier. + + +\section{Vervolgbladen} + +Boven elk vervolgblad komt het briefhoofd (mogelijk verkort, zie +boven) en een verkorte vorm van de referentieregel; deze regel bevat +het bladnummer. + +Als het briefhoofd met daaronder de `vervolgreferentieregel' (galgje! +galgje!) te veel ruimte innemen, gaat de extra ruimte af van de +teksthoogte. Voor dit mechanisme durf ik niet voor de volle +achtien-en-een-half procent in te staan. Het lijkt in ieder geval te +werken. + + +\section{Opties} + +De optie `adresrechts' is boven al genoemd, evenals `streepjes'; +verder is er nog een optie `typhulp' die een hulplijntje voor het +aanlijnen van het adres zet. Misschien leuk als je deze stijl gebruikt +voor briefpapier dat daarna voor de typmachine gebruikt wordt. + +Belangrijker zijn natuurlijk de taalopties. + +Voor mensen met te goede of slechte ogen zijn er de 10- en 12-punts +opties. Let op: de kopjes in de referentie- en voetregel blijven in +\texttt{cmssq8} staan. + +Puur voor het genoegen van de implementator van de briefstijl is er de +optie `USletter' die het papier 19.7 millimeter korter maakt. + +\section{Labels} + +Pijnlijk punt. Dit moet nog gedaan worden. +\end{document} diff --git a/Master/texmf-dist/doc/latex/ntgclass/catalog.txt b/Master/texmf-dist/doc/latex/ntgclass/catalog.txt new file mode 100644 index 00000000000..abe4c3330c3 --- /dev/null +++ b/Master/texmf-dist/doc/latex/ntgclass/catalog.txt @@ -0,0 +1,25 @@ +Name: ntgclass +Problems-To: JLBraams@cistron.nl +Author: J.L. Braams and V. Eijkhout +Version: 2.2-patch level 3 + +Description: + +The ntgclass bundle provides a number of document classes that +implement alternative layouts for the standard LaTeX document classes. +These classes were originally developped by Victor Eijkhout and the +NTG WG13. +The classes provided are: +artikel1, artikel2, artikel3; rapport1, rapport3; boek, boek3; brief. +This bundle also includes the a4 package, originally written for +LaTeX209 to support printing on A4 paper. + +Keywords: latex, document classes + +See-Also: + +Address: +J.L. Braams +Kooienswater 62 +2715 AJ Zoetermeer +The Netherlands diff --git a/Master/texmf-dist/doc/latex/ntgclass/changes.txt b/Master/texmf-dist/doc/latex/ntgclass/changes.txt new file mode 100644 index 00000000000..afedf7a8799 --- /dev/null +++ b/Master/texmf-dist/doc/latex/ntgclass/changes.txt @@ -0,0 +1,5 @@ + +This file lists changes to the NTG files in reverse chronological order. +======================================================================== + + diff --git a/Master/texmf-dist/doc/latex/ntgclass/classdoc.pdf b/Master/texmf-dist/doc/latex/ntgclass/classdoc.pdf new file mode 100644 index 00000000000..8e16c04cc5f Binary files /dev/null and b/Master/texmf-dist/doc/latex/ntgclass/classdoc.pdf differ diff --git a/Master/texmf-dist/doc/latex/ntgclass/classdoc.tex b/Master/texmf-dist/doc/latex/ntgclass/classdoc.tex new file mode 100644 index 00000000000..94e0cb8665c --- /dev/null +++ b/Master/texmf-dist/doc/latex/ntgclass/classdoc.tex @@ -0,0 +1,164 @@ +% \iffalse meta-comment +% +% % \iffalse meta-comment +% % +% % Copyright (C) 1990-2004 Nederlandstalige TeX Gebruikersgroep. +% % All rights reserved. +% % +% % This file is part of the NTG document classes distribution +% % ---------------------------------------------------------- +% % +% % It may be distributed and/or modified under the +% % conditions of the LaTeX Project Public License, either version 1.3 +% % of this license or (at your option) any later version. +% % The latest version of this license is in +% % http://www.latex-project.org/lppl.txt +% % and version 1.3 or later is part of all distributions of LaTeX +% % version 2003/12/01 or later. +% % +% % This work has the LPPL maintenance status "maintained". +% % +% % The Current Maintainer of this work is Johannes Braams. +% % +% % The list of all files belonging to the NTG document classes +% % distribution is given in the file `manifest.txt. +% % +% % The list of derived (unpacked) files belonging to the distribution +% % and covered by LPPL is defined by the unpacking scripts (with +% % extension .ins) which are part of the distribution. +% % \fi +% \fi +\documentclass[a4paper,10pt]{artikel1} % or just 'article' +\usepackage{shortvrb} +\newcommand\Lopt[1]{\textsf{#1}} +\newcommand\file[1]{\texttt{#1}} + +\begin{document} + +\title{An introduction to the Dutch \LaTeX\ document + classes\thanks{Updated for \LaTeXe\ by Johannes Braams, 6 february + 1994}} +\author{Victor Eijkhout} +\date{3 September 1989} +\maketitle + +\section{Background} + +The Dutch \LaTeX\ document classes are an attempt to provide \LaTeX\ +users with facilities of the standard distribution document classes +`article' and `report', but coupled to typography that is geared +towards Dutch usage. In order to ensure interchangeability, the new +styles implemented the commands of the distribution styles. In +principle, then, no manual for these styles would be needed. There +are a few points, however, that can't go without comment. + +Table 1 lists all files connected with the Dutch document classes. +These files can be found on the \texttt{tex-nl} fileserver +on the \texttt{hearn} node of Bitnet/Earn and on the \textsc{ctan}. +Not all of them are necessary, the ones with extension \file{.tex} +contain just blah. + +Remark: there exists a Dutch version of `letter', which is so +specifically Dutch that I decided not to include it in this list. + +\begin{table}[hbtp] + \begin{center} + \begin{tabular}{|@{\tt\hspace{1em}}r|l|} + \hline + ntgclass.tex & The \LaTeXe\ source for this text\\ + ntgclass.dtx & The source for all the class files\\ + ntgclass.dst & A \textsf{docstrip} program to produce\\ + & the class files from the source.\\ + artikel1.cls & article compatible, design 1, straightforward \\ + artikel2.cls & article compatible, design 2, rather different \\ + artikel3.cls & article compatible, design 3, + parskip instead of indent\\ + rapport1.cls & report compatible, design 1 \\ + rapport3.cls & report compatible, design 3 \\ + book.cls & book compatible, design 1\\ + ntg10.clo & 10 point option for all styles \\ + ntg11.clo & 11 point option for all styles \\ + ntg12.clo & 12 point option for all styles \\ + artdoc.tex & the genesis of the `artikel' classes, in Dutch \\ + briefdoc.tex & the genesis of the `brief class, also in Dutch \\ + rapdoc.tex & the genesis of the `rapport' classes, also in + Dutch.\\ + \hline + \end{tabular} + \end{center} + \caption{List of files} +\end{table} + + +\section{Languages} + +These styles have been developed bearing in mind suggestions of Hubert +Partl for making the language of styles switchable. Thus, on their +own these styles will produce English captions like `chapter' and +`table of contents', but specifying the options `dutch' or `german', +or any language option that follows the directions of Partl, will +switch these to the language of the option. + +\MakeShortVerb{\|} + +\section{Design} + +At the moment there are styles compatible with `article' and with +`report'. The Dutch names for these are `artikel' and `rapport'. In +contrast to the standard styles, however, the user can now choose from +different visual designs. Names of the styles are formed by appending +their number to the name, for instance `rapport3'. +\begin{enumerate} +\item Design one is meant to be a universally acceptable style. It + has been kept as uncontroversial as possible. Under heavy protests + of the implementer (me) the one point that has turned out to be + controversial, the table of contents, has been made subject to a + switch that can restore the old \LaTeX\ layout. Explanation of this + follows. +\item Design two will probably never be heavily used. It is more + something of a heroic attempt to be different. At the moment only + available in `artikel' form. +\item Design three meets the wishes of people who like a zero + |\parindent| and a positive |\parskip|. As just setting these + parameters within for instance `artikel1' will give some unwanted + side effects, I~decided to repair these in a separate style. +\end{enumerate} +Credits for the visual design go to one real-life designer and a +couple of books by designers I consulted. The full story can be found +elsewhere. + +\subsection{User options} + +As was mentioned above, the new layout of the table of contents has +turned out to be somewhat controversial. So, in order to ensure wider +acceptance of these styles I~have incorporated a switch that will +restore the old layout. Just specify the \Lopt{oldtoc} option. This is +available in designs 1 and~3. Number~2 really insists on being +different. + +%I~do no page sizing, so kindly use an option like \texttt{a4}. +%There is a nice one on the server, which is not the one +%by John Pavel. + +\subsection{Option files} + +Like in the standard styles there exist option files for $10/11/12$ +point layout. Until now, however, I~have managed to get away with +using the same option files for both the `artikel' `rapport', and +`boek' styles. The option files then have to have some neutral names. +Which are at the moment \file{ntg10}, \file{ntg11}, +and~\file{ntg12}. `NTG', of course, stands for Nederlandse \TeX\ +Gebruikersgroep, i.e., Dutch \TeX\ Users Group. + +When doing the `rapport' styles, I~needed to modify the `\file{titlepag}' +option file. Thus there is a Dutch version of that, bearing the name +of `voorwerk' (literal translation: `frontwork'). Probably the +majority of Dutch \LaTeX\ users don't even know that this is the +correct term. You're never too old to learn. + +With the \LaTeXe\ version of thes classes the file \file{voorwerk.sty} +has disappeared. It has been turned into the internal option +\Lopt{voorwerk}, just like \file{titlpage.sty} has disappeared into +the internal option \Lopt{titlepage}. +\end{document} + diff --git a/Master/texmf-dist/doc/latex/ntgclass/manifest.txt b/Master/texmf-dist/doc/latex/ntgclass/manifest.txt new file mode 100644 index 00000000000..43d088f2db8 --- /dev/null +++ b/Master/texmf-dist/doc/latex/ntgclass/manifest.txt @@ -0,0 +1,47 @@ +% +% CONTENTS OF THE NTG DOCUMENT CLASSES DISTRIBUTION +% ================================================= +% +% Documentation: +% -------------- +% +% 00readme.txt -- The distribution guide. +% manifest.txt -- This file. +% changes.txt -- List of changes in reverse chronological order. +% catalog.txt -- A short description for the macro catalog. +% +% artdoc.tex -- A description of the artikel classes, in dutch +% artdoc.pdf +% briefdoc.tex -- A description of the brief class, in dutch +% briefdoc.pdf +% rapdoc.tex -- A description of the rapport classes, in dutch +% rapdoc.pdf +% classdoc.tex -- A description of the document classes, in english +% classdoc.pdf +% +% Classes: +% -------- +% +% ntgclass.dtx -- NTG document classes artikel1,2,3/boek,boek3/rapport1,3. +% ntgclass.pdf +% brief.dtx -- NTG document class brief +% brief.pdf +% +% Classes: +% -------- +% +% a4.dtx -- The package a4 from NTG/WG13 (Braams, Poppelier) +% a4.pdf +% +% Installation script for the various parts: +% ------------------------------------------- +% +% a4.ins -- installation script for the a4 package +% ntgclass.ins -- NTG document classes installation script +% +% +% Support files: +% -------------- +% +% brief.tex -- A sample file with three letters +% diff --git a/Master/texmf-dist/doc/latex/ntgclass/ntgclass.pdf b/Master/texmf-dist/doc/latex/ntgclass/ntgclass.pdf new file mode 100644 index 00000000000..d743d45d684 Binary files /dev/null and b/Master/texmf-dist/doc/latex/ntgclass/ntgclass.pdf differ diff --git a/Master/texmf-dist/doc/latex/ntgclass/rapdoc.pdf b/Master/texmf-dist/doc/latex/ntgclass/rapdoc.pdf new file mode 100644 index 00000000000..b129c6d24c8 Binary files /dev/null and b/Master/texmf-dist/doc/latex/ntgclass/rapdoc.pdf differ diff --git a/Master/texmf-dist/doc/latex/ntgclass/rapdoc.tex b/Master/texmf-dist/doc/latex/ntgclass/rapdoc.tex new file mode 100644 index 00000000000..c241b5f6652 --- /dev/null +++ b/Master/texmf-dist/doc/latex/ntgclass/rapdoc.tex @@ -0,0 +1,710 @@ +% \iffalse meta-comment +% +% % \iffalse meta-comment +% % +% % Copyright (C) 1990-2004 Nederlandstalige TeX Gebruikersgroep. +% % All rights reserved. +% % +% % This file is part of the NTG document classes distribution +% % ---------------------------------------------------------- +% % +% % It may be distributed and/or modified under the +% % conditions of the LaTeX Project Public License, either version 1.3 +% % of this license or (at your option) any later version. +% % The latest version of this license is in +% % http://www.latex-project.org/lppl.txt +% % and version 1.3 or later is part of all distributions of LaTeX +% % version 2003/12/01 or later. +% % +% % This work has the LPPL maintenance status "maintained". +% % +% % The Current Maintainer of this work is Johannes Braams. +% % +% % The list of all files belonging to the NTG document classes +% % distribution is given in the file `manifest.txt. +% % +% % The list of derived (unpacked) files belonging to the distribution +% % and covered by LPPL is defined by the unpacking scripts (with +% % extension .ins) which are part of the distribution. +% % \fi +% \fi +\documentclass[oldtoc,a4paper,10pt]{rapport3} +\usepackage[dutch]{babel} + + +\begin{document} +\date{3 september 1989 / 3 juni 1994} +\title{Documentstijlen RAPPORT$x$\\ + Verantwoording} +\author{Victor Eijkhout} +\maketitle + +\begin{abstract} + Dit is de verantwoording voor de documentstijlen `Rapport$x$'. Deze + stijlen zijn bedoeld als een mogelijke vervanging van de stijl + `Report'. In dit verhaal zijn beschreven +\begin{enumerate} +\item de redenen waarom bepaalde veranderingen zijn aangebracht; +\item de parameters en commando's die op de veranderingen betrekking + hebben; en +\item de wijze waarop de veranderingen zijn ge"implementeerd. +\end{enumerate} +Tegelijk is dit document een uitprobeerobject voor de nieuwe +stijlen\footnote{De hoeveelheid gebruikte \LaTeX-constructies is + derhalve aan de ruime kant. De lezer wordt vriendelijk gevraagd zich + hieraan niet te ergeren.}. +\end{abstract} + +\tableofcontents +\listoftables +\listoffigures + +\part{Algemeen} + +\chapter{Verantwoording} + +De documentstijlen `Rapport$x$' zijn bedoeld als verbetering van de +standaard \LaTeX-document\-stijl `report'. De meeste macros zijn +derhalve modificaties van constructies uit `report.sty' of +`latex.tex'. Ook zijn deze stijlen te beschouwen als opwerking van +`Artikel1' en `Artikel2' (`Article'-compatibel) tot `Report'-status. + +Bij het ontwerpen van de opmaak heb ik het advies van Inge +Eijkhout~\cite{Inge} dat ik kreeg bij het ontwerpen van de `Artikel1' +stijl onverminderd kunnen gebruiken. Evenzo vermeld ik wederom de +`Tekstwijzer'~\cite{Treebus} van Karel Treebus en John Miles' +`Ontwerpen voor Desktop Publishing'~\cite{Miles}. Voor het ontwerp +van het zogenaamde `voorwerk' ben ik te rade gegaan bij Stanley +Morison~\cite{Morison}. Wat er fout is aan deze stijlen blijft +natuurlijk voor mijn rekening komen. + + +\section{Overzicht} + +De documentstijlen `Rapport1' en `Rapport2' zijn geheel compatibel met +`report': er zijn geen commando's toegevoegd of weggelaten. De +veranderingen ten opzichte van `report' betreffen enkel de opmaak. In +het bijzonder is er gesleuteld aan: +\begin{enumerate} +\item witregels rond koppen van secties, subsecties en subsubsecties + (van nu af aan `sectiekoppen' genoemd), +\item verdere veranderingen aan de opmaak van deze koppen, +\item de hoeveelheid inspringing bij lijststructuren (gegenereerd met + het \LaTeX\ \verb.\@list. commando), in het bijzonder `itemize', + `enumerate', en (specifiek voor `report') `description', en +\item verdere opmaak van lijststructuren, +\item verdere opmaak van sectiekoppen, en +\item de inhoudsopgave. +\end{enumerate} +Over het algemeen is het de bedoeling geweest een strakke opmaak te +krijgen (de standaard stijlen van \LaTeX\ `zwemmen' over de pagina). + + + +\chapter{Exportkwaliteit documentstijlen} + +De documentstijlen `Rapport$x$' kunnen zowel gebruik maken van de +stijloptie `Dutch' (auteur: Johannes Braams) als van `German' (auteur: +Hubert Partl), als van elke andere optie die de door Partl in `German' +gesuggereerde parametrisaties doorvoert. Deze opties zijn een +reparatie voor het euvel dat de meeste taalspecifieke termen in de +stijlen van de heer Lamport niet geparametriseerd zijn. + +In `Dutch' worden definities uit `Article' en dergelijke overreden +door geparametriseerde versies\footnote{Een listige truc laat `Dutch' + achterhalen door welke stijl hij aangeroepen is; de `Artikel' + stijlen zijn een onbekende stijl voor `Dutch'}, die op verschillende +talen ingesteld kunnen worden. Deze definities hadden natuurlijk al +in de stijlen van heer Lamport geparametriseerd moeten zijn. + + +De optie `German' is minder drastisch dan `Dutch': deze gaat ervan uit +dat hij door geparametriseerde stijlbestanden opgeroepen wordt, en zet +zelf alleen de parameters. De `Artikel' stijlen zijn geparametriseerd +volgens de suggestie van Partl. + +\section{Kanttekeningen} +De stijl `Dutch' parametriseert onder andere het commando `abstract'. +Aangezien ik dit commando om opmaaktechnische redenen al herdefinieer, +kan `Dutch' niet op `Artikel' losgelaten worden alsof het gewoon +`Article' was. Momenteel is `Artikel' dus een `onbekende +documentstijl' waar het `Dutch' betreft, en wordt er geen gebruik +gemaakt van het feit dat een aantal definities zich ook in `Dutch' +bevinden. + +\section{Een steek onder water} +Hoewel het mij tegen de borst stuit het Engels een voorkeurspositie te +geven onder de wereldtalen --~zeker in een voor het Nederlands +bedoelde stijl~-- heb ik besloten de Engelse parameterwaarden uit +`Dutch' als verstekwaarde in de `Artikel'-stijlen op te nemen. Een +belangrijk argument hiervoor is dat dit de stijlen geheel gelijk maakt +aan `Article' op commando\-nivo: zonder extra opties worden er Engelse +teksten geleverd, en voor Nederlands of Duits in een optiebestand +nodig. + +Een minstens zo belangrijk argument\footnote{mij door Nico Poppelier + aan de hand gedaan} hiervoor is dat de `Artikel'-stijlen zo een +steek onder water naar Leslie Lamport vormen. Ze zeggen als het ware +`\emph{Look here buster,} zo had het van begin af aan moeten zijn'. + + +\part{Specifiek} + +\chapter{Mechanismen; veranderingen in Rapport1} + +In de nu volgende subsecties worden de veranderingen ten opzichte van +de oude artikelstijl besproken in volgorde van oplopende +moeilijkheidsgraad van implementatie. De algemene mechanismen worden +besproken, alsmede hun concrete realisatie in~`Rapport1'. + +\section{Trivialiteiten} + +In de `report'-stijl staat `raggedbottom' aan voor enkelzijdige +documenten. Dit moet uit. `Frenchspacing' dient altijd aan te staan. + +\subsection{Paginanummers} +De gebruiker kan met \verb.\pagestyle{STIJL}. een stijl van kop- en +voetregels opgeven. De `Article' stijl definieert `plain' +(gecentreerde voetregels), en `headings' en `myheadings' +(asymmetrische kopregels). Als een gebruiker een stijl specificeert, +resulteert dat in de aanroep van een commando \verb.\ps@STIJL.. + +Omdat ik paginanummers wil hebben die rechts staan voor enkelzijdige +documenten, en links/rechts voor tweezijdige documenten heb ik het +commando \verb.\ps@plain., de verstekwaarde, omgebouwd. + + +\section{Makkelijke veranderingen: witregels} + +De \LaTeX\ artikelstijl wordt gekenmerkt door een overmaat aan +witregels. Hierin is stevig gesnoeid. + +\subsection{Witregels rond koppen} + +De `report'-stijl maak zowel het wit boven als onder koppen rekbaar. +Gevoegd bij het feit dat de `natuurlijke lengte' van dit wit al aan de +ruime kant is, maakt dit het paginabeeld erg los. Witregels moeten +kleiner worden, en mogen tussen kop en de eerste regel van de tekst +niet rekbaar zijn. Verder verdient het aanbeveling de witruimte in +termen van het regeltransport aan te geven. + +\subsubsection{Relevante concepten} +Het wit onder en boven koppen wordt bepaald door parameters 4~en~5 van +\verb.\@start.\-\verb.section., hetwelk commando in `art1$x$.sty' +gebruikt wordt om de sectiekopcommando's te defini"eren. Parameter~4 +dient (in ons geval) het negatieve van de gewenste skip te +specificeren. + +\subsubsection{Implementatie van de veranderingen} +De volgende waarden voor de verticale witruimte zijn gebruikt +\begin{table}[h] + \begin{center} + \begin{tabular}{|l|r|r|} + \hline + \emph{kop} & \emph{wit boven kop}&\emph{wit onder kop}\\ + \hline + section & -2-1+.5 & .5\\ + subsection & -1-.5+.25 & .25\\ + subsubsection& -1-.5+.25 & .25\\ + \hline + \end{tabular} + \end{center} + \caption{Hoeveelheid vertikaal wit in termen van + `normalbaselineskip'} +\end{table} +(in eerste instantie waren mij hogere waarden gesuggereerd, na +inspectie bleken deze waarden beter te voldoen). + +De hoeveelheid wit boven koppen steekt niet zo nauw. Die eronder wel. +In het bijzonder is het een merkwaardig idee het wit onder koppen +rekbaar te hebben. De grootte van dit wit draagt aanzienlijk bij aan +het ritme van de pagina. + + + +\noindent Opmerking: Aangezien alle skips in termen van de +`baselineskip' gegeven worden, kunnen deze definities opgetild worden +van het optiebestand naar het stijlbestand. + + +\subsection{Witregels rond lijststructuren} + +Witregels rond de items van een lijststructuur maken het paginabeeld +onrustiger, en zijn vaak niet functioneel: een `itemize'-structuur is +meestal \'e\'en doorlopend betoog waarin witregels ongewenst zijn. Er +valt iets voor te zeggen rondom `description'-structuren wel witregels +toe te staan, aangezien de beschrijvende termen in feite een kopje +vormen. + +De eerste tekstregel na een lijststructuur dient niet ingesprongen te +worden, ongeacht of de gebruiker een regel open gelaten heeft achter +de lijst (bij voorbeeld om zijn invoer overzichtelijker te maken). + + +\subsubsection{Inventaris van relevante concepten} +\LaTeX\ bestuurt witregels rond en in lijststructuren met de +parameters uit figuur~1. + +\begin{figure} + \begin{center} + \begin{tabular}{ll} + topsep & ruimte boven een lijst\\ + partopsep & extra als de lijst een nieuwe paragraaf opent\\ + itemsep & ruimte tussen items\\ + parsep & ruimte tussen paragrafen.\\ + \end{tabular} + \end{center} + \caption{witregelparameters in lijsten.} +\end{figure} + + +\noindent Deze parameters worden gezet in `art1$x$.sty' in het +commando +\begin{verbatim} +@list\romannumeral\the\@listdepth +\end{verbatim} +hetgeen ge`eval'd wordt in \verb.\@list.. + +Spaties na een lijststructuur kunnen onderdrukt worden door +\verb.\if@ignoretrue. toe te voegen aan `enditemize' +en~`endenumerate'. Het is nog niet duidelijk of voorkomen kan worden +dat er ingesprongen wordt als de gebruiker een lege regel ingeeft. + + +\subsubsection{Implementatie van de veranderingen} +Voor de gebruikte lijststructuren (met mogelijke uitzondering van +`description') dienen al deze parameters nul te zijn. + +Opmerking: als voor de `labelwidth' en de `labelsep' een oplossing in +termen van fontparameters gevonden wordt, kunnen de `listi' en +dergelijke commando's opgetild worden van het stijloptiebestand naar +het stijlbestand zelf. + + +\subsection{Verdere witregels} +Het wit rond lijststructuren wordt bestuurd door de locale `topsep', +die we boven nul gemaakt hebben, en door de globale `topsep'. Voor +een strakke opmaak is het wenselijk die nul te maken, echter hiermee +verdwijnt ook het wit op een plaats waar dat wel wenselijk is: rond +`verbatim' delen van het document. De oplossing zou kunnen zijn het +invoegen van een `topsep' in het \verb.\verbatim. commando. + +De witregel tussen voetnoten wordt bestuurd door de `footnotesep'. Ik +zou niet weten waarom die anders dan nul zou moeten zijn. + + +\section{Ook niet moeilijk: fonts} + +Er moet wat met fonts gerommeld worden. Voornamelijk moeten ze +kleiner, en het cursief moet vervangen worden door wat in Nederlandse +terminologie `gecursiveerd' heet; wij \TeX ies kennen dit als +`slanted'. + +\subsection{Fonts in sectiekoppen} + +De fonts gebruikt in tussenkopjes zijn proefondervindelijk tot stand +gekomen, en waarschijnlijk nog aan mutatie onderhevig. De +oorspronkelijk idee"en komen uit de `Sober'-stijl van Nico Poppelier. +Daarna is het `italic' vervangen door `slanted'. Kwestie van smaak. +Ik hou niet van de~\mbox{\emph{cmti}}. Verder is het klein kapitalen +font als `\dots~en hopeloos ouderwets'~\cite{Inge} de laan +uitgestuurd. + +\subsection{Theorems en het `emphasize' font} + +Om tekst te beklemtonen gebruikt \LaTeX\ het cursieve font +\texttt{cmti}. Dit vin' ik niet mooi. Binnen de Nederlandse stijlen +wordt er dus beklemtoond met \texttt{cmsl}. Ook in de `theorem' +omgevingen is deze vervanging doorgevoerd. + + +\section{Moeilijke veranderingen: eenheidsinspringing} + +Ten einde een strakke paginaopmaak te verkrijgen, verdient het +aanbeveling het aantal (impliciete) kantlijnen tot een minimum te +beperken. De radicaalste oplossing voor dit probleem bestaat uit + +\begin{enumerate} +\item alle labels in lijststructuren tegen de linkerkantlijn aan te + plaatsen (dit is niet zo mooi als er ver ingesprongen wordt), +\item voetnoten niet te laten inspringen (ingesprongen voetnoten zien + er alleen goed uit als ze meer dan \'e\'en regel lang zijn), en +\item een eenheidsinspringing in te voeren voor + \begin{itemize} + \item alinea's, + \item teksten van koppen op alle nivo's, en + \item de ingesprongen tekst in lijststructuren. + \end{itemize} +\end{enumerate} +Laten we er voorlopig dus vanuit gaan dat er een parameter +`unitindent' is. De berekening van deze grootheid komt verderop aan de +orde. + +\subsection{Inspring bij lijststructuren} + +Labels voor items in een lijst defini"eren gemakkelijk een tweede +kantlijn. Het kan dus gewenst zijn ze tegen de linkerkantlijn van de +omringende tekst aan te plaatsen. + +\subsubsection{Inventaris van relevante concepten} +Een lijst op het eerste nivo springt in over `leftmargini'. Het label +wordt van de tekst gescheiden door `labelsep', en heeft breedte +`labelwidth', tenzij de natuurlijke breedte groter is. De linkerkant +van het label staat echter altijd op `labelwidth' plus `labelsep' van +de ingesprongen kantlijn. De inhoud van het label wordt in de +omringende box geplaatst door het commando `makelabel'. + +Al deze begrippen worden ingevuld in de commando's `list$x$'. + +\subsubsection{Implementatie van de veranderingen} +Het zetten van parameters kan mooi in de `list$x$' commando's +gebeuren: +\begin{verbatim} +\def\@listi{\leftmargin=\unitindent + \labelsep=\enspace + \labelwidth=\leftmargin + \advance\labelwidth by -\labelsep}} +\end{verbatim} +Als de `unitindent' door fontparameters bepaald wordt, hoeft deze +definitie niet meer in het optiebestand te staan, maar kan naar de +stijldefinitie opgetild worden. + +Het veranderen van de definitie van `makelabel' is lastiger: dit moet +in het tweede argument van `list' gebeuren. We zullen dus `itemize' en +`enumerate' moeten herdefini"eren met een nieuwe definitie van +`makelabel'. + +Omdat de `unitindent' tamelijk groot uitvalt, heb ik ervoor gekozen +labels op het eerste nivo rechts aan te lijnen (waardoor ze dus in +bescheiden mate een nieuwe kantlijn definieren), andere labels lijnen +links. + + + +\subsection{Inspring bij koppen} + +De plaatsing van de tekst van koppen (achter het sectienummer) is in +\LaTeX\ ogenschijnlijk willekeurig, en draagt hiermee (zeker als twee +koppen onder elkaar staan) bij tot een onrustig paginabeeld. Dit kan +aanmerkelijk verbeterd worden door voor het sectienummer en de erop +volgende spatie een eenheidsbreedte te nemen. + +\subsubsection{Inventaris van relevante concepten} +In het commando \verb.\@sect. wordt een commando \verb.\@svsec. +ge`edef't dat het sectie nummer afdrukt, gevolgd door +`1~em'\footnote{Ter herinnering: + \begin{enumerate} + \item Er zijn 5 nivo's van sectiekoppen: `section', `subsection', + `subsubsection', `paragraph', en `subparagraph'. + \item De eerste 3 nivo's zijn genummerd. + \item De laatste twee nivo's geven een kop die in de tekst is + ingebed. + \end{enumerate}}\footnote{Aangezien de definitie van 'em' met het + gebruikte font meeverandert, geeft het gebruik van twee of drie + koppen onder elkaar een merkwaardig visueel effect.}. + +\subsubsection{Implementatie van de veranderingen} +Er moet een nieuwe versie van \verb.\@sect. komen die een verbeterde +\verb.\@svsec. bevat: +\begin{verbatim} +\edef\@svsec{\hbox to \unitindent + {\csname the#1\endcsname\hfil}} +\end{verbatim} +In plaats van `unitindent' kan als breedte ook een verdere +parametrisatie met +\begin{verbatim} +\csname #1labelwidth\endcsname +\end{verbatim} +gekozen worden. De `unitindent' kan als volgt gegenereerd worden: +\begin{verbatim} +\newdimen\unitindent +{\setbox0\hbox{\normalsize\bf 2.2.2\ } + \global\unitindent=\wd0} +\parindent=\unitindent +\leftmargini=\unitindent +\end{verbatim} + +Dit is helaas nog niet voldoende. Als een gebruiker erg veel van +secties en subsecties houdt, kunnen de nummers een grotere breedte dan +die van `2.2.2' krijgen. Daarom wordt het label iedere keer bij een +nieuw kopje opgemeten, en zonodig wordt de `unitindent' bijgesteld. +Bij het afsluiten van het document wordt dan de definitieve waarde +(die misschien de oude is, en misschien veel meer) naar het +\texttt{.aux}-bestand geschreven. Dat wil zeggen: er wordt een +toewijzing van die waarde aan de unitindent weggeschreven. + +Adders en voetangels te over: hiervoor moet het commando +`enddocument' herschreven worden. + + + +\section{Verdere moeilijke veranderingen: de opmaak van + lange koppen. Zoals deze dus. Reeds. Antidisestablishmentarianism. + Hottentottententententoonstelling.} + +\LaTeX\ zet koppen als ingesprongen paragrafen. Het is echter niet +gewoon dat een meerregelige kop zo behandeld wordt: beter is het vrije +regelval te gebruiken en vooral woordafbreking (zelfs in samengestelde +woorden) te verbieden. + +\subsection{Inventaris van relevante concepten} +Binnen het commando \verb.\@sect. wordt de kop van de sectie gezet als +\begin{verbatim} +{\interlinepenalty\@M #8\par} +\end{verbatim} + +\subsection{Implementatie van de veranderingen} +Aan de zetcommando's voor de sectiekoppen dient een aanroep van +`headstyle' toegevoegd te worden, waar +\begin{verbatim} +\def\headstyle{\nohyphenation \rightskip=0cm plus 3cm} +\end{verbatim} +of zoiets. Het commando `nohyphenation' kan op verschillende manieren +bereikt worden, ik heb gekozen voor \verb+\hyphenpenalty=10000+, en +idem zo voor de `exhyphenpenalty'. + + +\section{Opties} + +De stijlen `Rapport1' en `Rapport3' hebben een door de gebruiker te +kiezen optie. Hiermee kan de gebruiker de opmaak naar eigen +goeddunken varieren. Misschien dat er nog wel meer van dat soort +opties komen. + + +\subsection{Hoe werken opties} +Een door de gebruiker gespecificeerde stijloptie wordt soms +gerealiseerd door een commando in het stijlbestand, en soms door een +in te laden optiebestand. Het mechanisme dat dit bewerkstelligt is +het volgende. + +Ergens bovenin het stijlbestand worden commando's \verb.\ds@OPTION. +gedefinieerd. Als de gebruiker de betreffende optie meegegeven heeft, +wordt dit commando uitgevoerd door \verb.\@options., dat ook ergens +bovenin het stijlbestand staat. Voor die opties waarvoor geen +\verb.\ds@OPTION. macro gedefinieerd is, wordt na de verwerking van +het stijlbestand door \LaTeX\ een bestand \verb.OPTION.STY. geladen. + +\subsection{De `oldtoc' optie} +Sommige mensen houden nogal van uitgepunte inhoudsopgaves. Ik niet, +vandaar dat een inhoudsopgave analoog aan die van de `Tekstwijzer' +standaard is. Met de optie `oldtoc' kan de oude \LaTeX\ inhoudsopgave +verkregen worden. + + +\subsection{Het `Voorwerk' optiebestand} +Een essentieel verschil tussen `Rapport' en `Artikel' is dat de eerste +een heus voorwerk heeft: een titelpagina, een afzonderlijke pagina +voor de samenvatting, en losse pagina's voor de titels van de delen. +Met in het achterhoofd een citaat van Stanley Morison~\cite{Morison} +over de opbouw van de titelpagina: +\begin{quotation} + Daar onderkast een noodzakelijk kwaad is, dat we in de hand moeten + houden als we het niet kunnen uitroeien, moet het gebruik daarvan + worden vermeden daar waar dat het minst logisch en het + onaantrekkelijkst is: in grote corpsen. De belangrijkste regel moet + uit kapitalen worden gezet~[\dots]. En wat er ook nog met de rest + van de pagina moge gebeuren, de naam van de schrijver moet, zoals + alle met nadruk gepresenteerde eigennamen, uit kapitalen worden + gezet. +\end{quotation} +heb ik de `Titlepage.sty' vervangen door een `Voorwerk' stijloptie, +die titel en schrijversnaam in kapitalen zet. + + +\section{De inhoudsopgave} + +\subsection{Beschrijving} +\subsubsection{Inventaris van kwalen} +Treebus vindt het zogenaamde `uitpunten' van een inhoudsopgave een +minder geslaagd idee. Ook over het steeds verder inspringen van kopjes +in de inhoudsopgave is hij niet te spreken. Laat dit nu precies zijn +wat \LaTeX\ doet. + +Wat mij dan nog stoort zijn de grote verschillen in zetwijze van +kopjes op verschillende nivo's. + +\subsubsection{Remedie} + +\paragraph{Kantlijnen} +Alle nummers worden tegen de linker kantlijn getrokken, en de kopjes +staan dan (allemaal) op `unitindent' van de linker kantlijn. Dit +levert geen problemen op omdat er net zoveel nivo's nummering in +kopjes als in de inhoudsopgave voorkomen. + +\paragraph{Fonts} +Kopjes worden in drie verschillende fonts gezet om de hierarchie uit +te doen komen. Ik heb gekozen voor `bf', `sl', en `rm' in +`normalsize'. Er valt over te twisten of dit misschien gewoon de fonts +van de koppen zelf moeten zijn. + +\paragraph{Verdere zetwijze} +Er wordt vrije regelval gebruikt. Het paginanummer verschijnt direct +achter het kopje (met een vaste hoeveelheid wit). + +\subsection{Implementatie} + +Ten eerste is er een commando \verb+\toc@font+ gekomen dat het font +bepaalt waarmee een kop in de inhoudsopgave gaat verschijnen. Deze +bepaling gebeurt in \verb+\@sect+, die daartoe verder is aangepast. + +Ten tweede is er, als vervanging van \verb+\@dottedtocline+, een +commando \verb+\@regtocline+\\ dat de opmaak van de kop regelt. De +merkwaardige sequentie +\begin{verbatim} +\@tempdima=\unitindent +\end{verbatim} +zorgt ervoor dat het nummer (dat in \verb+\@sect+ in een `numberline' +gestopt is) op de goede breedte gezet wordt. + +De \verb+\l@TYPE+ commando's (waar `type' is `section' en dergelijke) +zijn omgezet zodat ze \verb+\@regtocline+ gebruiken. Uitzondering: +\verb+\l@part+. Daar kom ik nog wel een keer aan toe. + + + +\chapter{Veranderingen in Rapport2} + +In de documentstijl `Rapport2' is voor veel zaken een geheel andere +keuze gemaakt dan in~`Rapport1'. Vaak betekende dit dat, gegeven de +moeite die in `Rapport1' geinvesteerd was, slechts een paar parameters +veranderd hoefden te worden. In enkele gevallen, echter, moest een +geheel nieuwe aanpak gevolgd worden. + +\section{Variaties} + +De beide hier beschreven documentstijlen hebben als voornaamste +verbetering ten opzichte van `report' een nadrukkelijk aanwezige +tweede kantlijn. In `Rapport1' wordt deze kantlijn gebruikt door al +het eenmaal ingesprongen materiaal. In~`Rapport2' wordt deze kantlijn +minder radicaal gevolgd: +\begin{itemize} +\item`verbatim' omgevingen worden weer gewoon tegen de linkerkantlijn + geplaatst; +\item de eerste kantlijn voor lijststructuren bedraagt de helft van de + paragraafinspinging; en +\item de labelbreedte van voetnoten is hieraan gelijk gemaakt. +\end{itemize} +Alles bij elkaar wordt het gewicht van de pagina verder tegen de +linkerkantlijn geplaatst. + +Van een andere kant bekeken is de tweede kantlijn (zeg dat die door de +`parindent' bepaald wordt) in de stijl~`Rapport2' juist nadrukkelijker +aanwezig: +\begin{itemize} +\item alle tussenkopjes springen in over de `parindent, en +\item de eerste regel na een kopje springt ook in. +\end{itemize} + + +\section{Behandeling van koppen} +\subsection{Sectie, subsectie, subsubsectie} +\subsubsection{Elementaria} + +Het laten inspringen van koppen gaat door een positieve waarde voor de +derde parameter van \verb.\@startsection. te specificeren. Door de +vierde parameter positief te maken springt de eerste regel na de kop +ook in. + +Omdat de tekst van de kopjes nu geen verdere kantlijn definieert hoeft +er niet zo'n moeite gedaan te worden om die te plaatsen als +in~`Rapport1'. Ik heb de normale \LaTeX-constructie van een vaste +`skip' weer in ere hersteld; op drie-tiende `em' deze keer. + +\subsubsection{Complicaties} + +Om te voorkomen dat bij lange koppen de tekst alsnog een tweede +kantlijn gaat defini"eren moest de \verb.\@hangfrom. die dit +bewerkstelligt verwijderd worden. Bij volledig verwijderen, echter, +zal de tweede regel van de kop tegen de linker kantlijn geplaatst +worden. Ook niet de bedoeling. + +In de aanpak die ik gevolgd heb hangt de tekst nu aan de inspringing; +het commando \verb.\@svsec. dat het nummer zet is gewoon in de tekst +geplaatst. + + +\subsection{Part} + +Het zou leuk zijn als de eerste regel na een `part'-kop ook insprong. +Het al dan niet inspringen van deze regel wordt bestuurd door de +schakelaar \verb.\@ifafterindent. waarop getest wordt in +\verb.\@afterheading.. Normaal wordt inspringen voorkomen door deze +schakelaar in `part' op onwaar te zetten. + +Het zal de perceptieve lezer duidelijk zijn wat ik gedaan heb om +inspringen van de eerste regel na een `part' af te dwingen. + +\section{De inhoudsopgave} + +De inhoudsopgave wordt in `Rapport2' net zo gezet als in~`Rapport1', +met het verschil dat de sectienummers nu niet links maar rechts +lijnen. Dit in het kader van het beklemtonen van de tweede kantlijn. +Hiertoe moest het commando `numberline' uit `LaTeX.tex' overgenomen en +aangepast worden. + +Overigens is de tweede kantlijn in de inhoudsopgave verder naar rechts +dan in de rest van het document. De inhoudsopgave dient dus liever +niet op een tekstpagina te beginnen. + +Dat de tweede kantlijn verder naar rechts staat betekent overigens dat +het woord `inhoudsopgave', dat als een sectiekop gezet wordt, +voorafgegaan moet worden door een `skip' ter breedte van het verschil. + + +\part{Veranderingen in Rapport3} + +Uitgaande van `Rapport1' was het kinderspel een stijl te maken die net +zo strak links lijnend oogde, maar die bovendien geen +alinea\-inspringing heeft en dit compenseert met een `parskip'. +\begin{itemize} +\item Er is gekozen voor een `parskip' ter grootte van de helft van de + `baselineskip'. +\item De `topsep' in lijststructuren --~de witruimte boven en onder de + gehele lijst~-- is \emph{minus} de halve `parskip'; netto effect is + dat hier de helft van de witruimte komt die zich tussen alineas + bevindt. +\item De grootte van de `unitindent' kon ongewijzigd blijven, + aangezien kopjes nog steeds op dezelfde wijze gezet worden. +\item Het wit onder kopjes is op nul gezet. Dit betekent niet dat er + geen wit staat, want de `parskip' krijg je hoe dan ook kado. +\end{itemize} +Het geheel oogt wel aardig. + + +\begin{thebibliography}{9} + +\bibitem{Inge}Inge Eijkhout, \emph{Gesprekken en correspondentie}, + 1989. + +\bibitem{Leslie}Leslie Lamport, \emph{\LaTeX, a document preparation + system}, Addison-Wesley, 1986. + +\bibitem{Miles}John Miles, \emph{Ontwerpen voor Desktop + Publishing\footnote{De Nederlandse uitgave is goedkoper dan de + Engelse, maar doet een zware aanslag op je ogen, door het soort + zetfout dat in \TeX\ onmogelijk zou kunnen voorkomen.}, Alles + over layout en typografie op de personal computer}, Uitgeverij + Mingus, Baarn~1988. + +\bibitem{Morison}Stanley Morison, \emph{Grondbeginselen der + Typografie}, (vertaling uit het Engels door Huib van Krimpen) + Uitgeverij de Buitenkant, Amsterdam 1987. + +\bibitem{Treebus}Karel Treebus, \emph{Tekstwijzer, een gids voor het + grafisch verwerken van tekst}, SDU~uitgeverij, 1988. + +\end{thebibliography} + + +%\vfill\eject +%\tableofcontents + + +\end{document} + + + + + + -- cgit v1.2.3