expanded on manual

1 files changed, 216 insertions, 3 deletions

diff --git a/letterspace.tex b/letterspace.tex
index 257981b..fea85df 100644
--- a/letterspace.tex
+++ b/letterspace.tex
@@ -12,6 +12,12 @@
   spaceskip=.5em,
 ]
 
+\defineletterspace [smallcaps]
+\setupletterspace  [smallcaps] [
+  spacefactor=.05,
+  spaceskip=.25em,
+]
+
 \defineletterspace [textemph]
 \setupletterspace  [textemph] [
   spacefactor=.125,
@@ -19,6 +25,7 @@
 ]
 
 \let\te\textemph
+\unexpanded\def\name#1{\smallcaps{\sc#1}}
 
 \defineletterspace [ugly]
 \setupletterspace  [ugly] [
@@ -55,6 +62,9 @@
 
 \setupbodyfontenvironment [default] [em=italic]
 
+\def\quote#1{\bgroup\italic#1\egroup}
+\def\uprightslash{\bgroup\rm/\egroup}
+
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 % Presenting the Interface                                      %
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -243,6 +253,103 @@
 \def\phglistdots{\gleaders\hbox to 1em{\hss.\hss}\hfill}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Bibliography                                                  %
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Bib: Setups                                                   %
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\setuppublications [
+  alternative=ssa,
+  refcommand=authoryear,
+  %sorttype=bbl,
+  sort=author,
+  numbering=yes,
+  autohang=yes,
+]
+
+\setuppublicationlist [
+  artauthor=\invertedauthor,
+]
+
+\setupcite [authoryear] [compress=no]
+
+%%% Used in bibliography formatting.
+\definestartstop [bibindent] [
+  before={\startnarrower[left]%
+          \setupindenting[-\leftskip,yes,first]%
+          \clubpenalty-9000%
+          \widowpenalty-9000%
+          },  
+  after=\stopnarrower,
+]
+
+\unexpanded\def\ctay#1{\cite[authoryear][#1]}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Bib: Entries                                                  %
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\startpublication [
+  k=lt,
+  t=book,
+  a={{Willberg/Forssman}},
+  y=1997,
+  %n=1,
+  s={Lesetypographie},
+]
+  \author[]{Hans Peter}[]{}{Willberg}
+  \author[]{Friedrich}[]{}{Forssmann}
+  \pubyear{1997}
+  \title{Lesetypographie}
+  \city{Mainz}
+\stoppublication
+
+\startpublication [
+  k=mt,
+  t=book,
+  a={Bodoni},
+  y=1818,
+  %n=1,
+  s={Manuale},
+]
+  \author[]{Giambattista}[]{}{Bodoni}
+  \pubyear{1818}
+  \title{Manuale Tipografico, 2~vols}
+  \city{Parma}
+\stoppublication
+
+\startpublication [
+  k=bh,
+  t=book,
+  a={Bringhurst},
+  y=2008,
+  %n=1,
+  s={Elements},
+]
+  \author[]{Robert}[]{}{Bringhurst}
+  \pubyear{2008}
+  \title{The Elements of Typographic Style}
+  \edition{3.2}
+  \city{Point Roberts WA, Vancouver}
+\stoppublication
+
+\startpublication[
+  k=roemer,
+  t=article,
+  a={Roemer},
+  y=2011,
+  %n=3,
+  s={Gewichten},
+]
+  \artauthor[]{Christine}[]{}{Roemer}
+  \pubyear{2011}
+  \arttitle{Gewichten -- Wichtiges und Unwichtiges mit \LATEX\ markieren}
+  \journal{Die \TEX nische Komödie}
+  \volume{2011:1}
+  \pages{6--16}
+\stoppublication
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 % Misc                                                          %
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
@@ -315,6 +422,13 @@
 
 \placelist[chapter,section][criterium=all]
 
+\chapter{Introduction}
+
+Robert \name{Bringhurst} quotes Frederick \name{Goudy}’s famous
+dictum on the topic of letterspacing: \quote{A man who would
+letterspace lowercase would steal sheep.}\footnote{\ctay{bh},
+S.~31.}
+
 \chapter{Commands}
 
 \section{Default Letterspace Command}
@@ -329,7 +443,7 @@
 
 \chapter{Applications}
 
-\section{Things to Avoid}
+\section{Precautions}
 
 \te{Letterspacing} is a dynamic property of a string of text, as
 opposed to static font properties that are e.g. italics or slant.
@@ -353,13 +467,112 @@ Moderate values don’t express how important a particular emphasis
 is to the author? Just \ugly{widen the spacing} and no reader
 will ever skip over your message \dots.
 Sure, everybody will get the cue, though the appearance of the
-paragraph, possibly the whole page will certainly be spoilt.
-
+highlighted text, the paragraph, and possibly the whole page will
+certainly be spoilt.
+Granted, from this perspective letterspacing might appear to be
+too dangerous a tool, only begging for misuse.
+But this judgement is premature as letterspacing has in fact a
+long tradition and was employed in many outstanding examples of
+typography.
+Apart from its seductive versatility there are no objections
+against letterspacing on a general level, as long as it is
+carefully utilized.
+
+Letterspacing has two prevailing uses: ({\it1}) for emphases and
+({\it2}) for spacing capital letters, which is especially
+valuable in display situations like for instance the front matter
+of books or section headings.
+Both come with a set of peculiarities that the typesetter must
+consider in order to figure out the appropriate values for the
+interword and letter spacings.
 
 \section{Emphasis}
+Documents that require many levels of different emphases are
+among the primary targets of letterspacing.
+For example, in linguistics an author might wish to distinguish
+({\it1}) names of cited authors, ({\it2}) ordinary text emphasis,
+({\it3}) inline quoted passages, and ({\it4}) word forms or
+etymological roots.
+To be sure, this can be accomplished with a mapping like
+  {\it1}: small capitals,
+  {\it2}: italics,
+  {\it3}: quotation marks, and
+  {\it4}: a slanted face.
+But \te{quotation marks} are hard to keep track of, if the enveloped
+text exceeds a certain length; also, they disencourage skimming
+because the reader always has to check whether the point that
+caught his eye might belong to a quotation instead of the main
+text.
+In various fonts -- mainly sans serif -- \te{slant} cannot easily
+be told apart from italics, thus defeating the very purpose of
+emphasis, in other fonts it might not be available at all.
+\te{Bold face} might seem to be an obvious alternative but even
+semi bold weights cause text to stand out from the surrounding
+paragraph, diverting the readers attention away from its normal
+trail along successive lines.
+Besides, the more a text is intermingled with different weights,
+the closer it resembles the look of a dictionary.
+
+After these deliberations the validity of \te{letterspacing,}
+including lower case, as a means of emphasis is already half
+established.
+It beats slant with respect to availability and differentiating
+effect.
+It is preferable over quotation marks because the emphasized
+passage clearly differs from the main font style.
+Finally, it triumphs over weight switching as the result is very
+close to the mean overall distribution of ink within the text
+body.
+In the previous graduation of emphasis levels an alternative
+involving letter spacing could be as follows:
+  {\it1}: small caps,
+  {\it2}: letterspaced text font,
+  {\it3}: italics, and
+  {\it4}: letterspaced italics or slants.
+Here another convenient feature of letterspacing becomes
+apparent: as it is basically a different method of typesetting
+the same font it can theoretically be applied on any typeface and
+weight.
+It follows, that in the foregoing mapping, parts of longer
+(italic) quotations may be emphasized as well:
+  \quote{%
+    regum timendorum in proprios greges {\uprightslash}
+    reges in ipsos imperium est \te{Iouis} {\uprightslash}
+    \te{clari} Giganteo triumpho {\uprightslash}
+    cuncta supercilio \te{mouentis.}%
+  }
+However, substituting rule {\it2} for {\it3}, the resulting
+mapping will be less satisfactory.
+As quotations are prone to extending over multiple lines, whereas
+normal emphasis rarely spans more than two words, letter spacing
+the former might lead to the unbalanced appearance of paragraphs.
+So best avoid letterspacing in cases where the object possibly
+encompasses entire sentences.
+
+Caution is necessary concerning \te{punctuation} adjacient to the
+letterspaced passage.
+In contrast to italicized or bold emphasis where an immediately
+succeeding punctuation sign is best typeset in the surrounding
+main face (e.g. „et {\it tu}, Brute?“), letter spacing may
+require the sign to be typeset as part of the emphasis.
+The reason for this consists partly in the larger interword
+spacing that extends to the surrounding spaces, and partly also
+on the letterspacing itself which would be disrupted by a
+tighter-spaced character.
+(Bad: \te{O Tite}, tute, \te{Tati}, tibi tanta, \te{tyranne}, tulisti;
+good: \te{O Tite,} tute, \te{Tati,} tibi tanta, \te{tyranne,} tulisti.)
 
 \section{Capital Spacing}
 
+\section{Don’t’s}
+-- different letterspace widths for the same meaning
+
+
+\title{References}
+
+\startbibindent
+  \placepublications[criterium=all]
+\stopbibindent
 
 \stopbodymatter
 \stoptext