readme

2 files changed, 74 insertions, 11 deletions

diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..f42e197
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,57 @@
+======
+ What
+======
+
+The *Letterspace* module for ConTeXt MkIV allows for defining letterspacing
+macros.
+
+==============
+ Installation
+==============
+
+Copy the program tree into your local ConTeXt tree, i.e. if you have the
+minimals installed inside ``$HOME/context/``, issue the following command from
+the module root: ::
+
+    cp -r tex/ ~/context/tex/texmf-local/
+
+Optionally do the same for the documentation tree: ::
+
+    cp -r doc/ ~/context/tex/texmf-local/
+
+Next, update the ConTeXt filename database so that the module can be found: ::
+
+    context --generate
+
+Congratulations, the *Letterspace* module is now ready to use. As a test, chdir
+into the documentation directory and build the manual: ::
+
+    cd doc/context/third/letterspace/
+    context letterspace.tex
+
+===============
+ Documentation
+===============
+
+If you don’t want to build the documentation yourself, there should always be an
+uptodate version at the BitBucket repository_.
+
+
+=====
+ Who
+=====
+
+Written by Philipp Gesang, Heidelberg.
+Email me (``megas.kapaneus`` at ``gmail`` dot ``com``)
+or file a tracker item at BitBucket_ if something doesn’t seem right.
+
+=========
+ License
+=========
+
+The *Letterspace* module is licensed under the terms of the BSD license with two
+clauses. See the file ``COPYING`` or the *License* chapter in the manual for
+details.
+
+.. _repository: https://bitbucket.org/phg/t-letterspace/downloads
+.. _BitBucket:  https://bitbucket.org/phg/t-letterspace
diff --git a/doc/context/third/letterspace/letterspace.tex b/doc/context/third/letterspace/letterspace.tex
index 8d16366..26de8f7 100644
--- a/doc/context/third/letterspace/letterspace.tex
+++ b/doc/context/third/letterspace/letterspace.tex
@@ -408,9 +408,11 @@
 
 \setupindenting [yes,next,medium]
 
-\useURL [leibnizausgabe] [http://www.leibniz-edition.de/Baende/] [] [Leibniz-Edition]
+\useURL [leibnizausgabe] [http://www.leibniz-edition.de/Baende/] [] [\name{Leibniz}-Edition]
 \useURL [soulpackage] [http://ctan.larsko.net/macros/latex/contrib/soul/] [] [soul]
 
+\pdfcompresslevel9
+
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 % Makeup for Front Matter                                       %
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -465,14 +467,14 @@
   location={right,header},
 ]
 
-\setupheadertexts
-  [{\tfx\getmarking[title]}]    [{\pagenumber}]
-  [{\pagenumber}]        [{\tfx\getmarking[title]}]
-
 \title{Content}
 
 \placelist[chapter,section][criterium=all]
 
+\setupheadertexts
+  [{\tfx\getmarking[chapter]}] [{\pagenumber}]
+  [{\pagenumber}]              [{\tfx\getmarking[chapter]}]
+
 \chapter{Introduction}
 
 Robert \name{Bringhurst} quotes Frederick \name{Goudy}’s famous
@@ -500,8 +502,9 @@ For instance, the \from [soulpackage] package provides some means
 but at the same time severely limits the content passed to
 macros.
 Nevertheless there are magnificent examples of letterspacing done
-right, like the \from [leibnizausgabe] by the Leibniz-Archiv in
-Hanover that has been typeset with \smallcaps{EDMAC} and \PDFTEX.
+right, like the \from [leibnizausgabe] by the
+\name{Leibniz}-Archiv in Hanover that has been typeset with
+\smallcaps{EDMAC} and \PDFTEX.
 Nowadays the Lua node library removes the technical restrictions
 and thus leaves the task of correct letterspacing to the user.
 The \te{Letterspace} module for \CONTEXT\ was designed to collect
@@ -588,9 +591,12 @@ command is to define separate macros for different purposes.
 \defineletterspace [LSemphasis]
 \defineletterspace [LSsmcp]
 
-\setupletterspace [LSbighead]  [factor=.2,   spaceskip=.7em, suppresskern=yes]
-\setupletterspace [LSemphasis] [factor=.111, spaceskip=.4em, suppresskern=no,]
-\setupletterspace [LSsmcp]     [factor=.06,  spaceskip=.4em, suppresskern=no,]
+\setupletterspace [LSbighead]
+  [factor=.2,   spaceskip=.7em, suppresskern=yes]
+\setupletterspace [LSemphasis]
+  [factor=.111, spaceskip=.4em, suppresskern=no,]
+\setupletterspace [LSsmcp]
+  [factor=.06,  spaceskip=.4em, suppresskern=no,]
 
 \LSbighead{\bf\WORD This is a candidate for sectioning, innit?}
 \blank [line]
@@ -739,7 +745,7 @@ 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
+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 onto the surrounding spaces, and partly also