From 8183beebcd7efe287b21d93be781a986b2aa455a Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Thu, 17 Mar 2011 20:48:08 +0100 Subject: readme --- README.rst | 57 +++++++++++++++++++++++++++ doc/context/third/letterspace/letterspace.tex | 28 +++++++------ 2 files changed, 74 insertions(+), 11 deletions(-) create mode 100644 README.rst 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 -- cgit v1.2.3