From mboxrd@z Thu Jan  1 00:00:00 1970
X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/74329
Path: news.gmane.org!not-for-mail
From: Wolfgang Schuster <schuster.wolfgang@googlemail.com>
Newsgroups: gmane.comp.tex.context
Subject: Re: Problem with letter module
Date: Mon, 6 Feb 2012 12:40:53 +0100
Message-ID: <229FB39E-E4D1-4EDC-8E43-4E4D212DAB7E@googlemail.com>
References: <201201182114.15080.romain.diss@yahoo.fr>
	<FC6BE627-C4E1-4D30-BC01-7058C5B77A92@googlemail.com>
	<9D5A94D1-B97A-45F3-98AC-A1FC37FAA602@fiee.net>
Reply-To: mailing list for ConTeXt users <ntg-context@ntg.nl>
NNTP-Posting-Host: plane.gmane.org
Mime-Version: 1.0 (Apple Message framework v1257)
Content-Type: text/plain; charset="windows-1252"
Content-Transfer-Encoding: quoted-printable
X-Trace: dough.gmane.org 1328528488 28455 80.91.229.3 (6 Feb 2012 11:41:28 GMT)
X-Complaints-To: usenet@dough.gmane.org
NNTP-Posting-Date: Mon, 6 Feb 2012 11:41:28 +0000 (UTC)
Cc: Henning Hraban Ramm <hraban@fiee.net>
To: mailing list for ConTeXt users <ntg-context@ntg.nl>
Original-X-From: ntg-context-bounces@ntg.nl Mon Feb 06 12:41:27 2012
Return-path: <ntg-context-bounces@ntg.nl>
Envelope-to: gctc-ntg-context-518@m.gmane.org
Original-Received: from balder.ntg.nl ([195.12.62.10])
	by plane.gmane.org with esmtp (Exim 4.69)
	(envelope-from <ntg-context-bounces@ntg.nl>)
	id 1RuMwo-0005Fk-8r
	for gctc-ntg-context-518@m.gmane.org; Mon, 06 Feb 2012 12:41:26 +0100
Original-Received: from localhost (localhost [127.0.0.1])
	by balder.ntg.nl (Postfix) with ESMTP id CB2EBCB21F;
	Mon,  6 Feb 2012 12:41:25 +0100 (CET)
X-Virus-Scanned: Debian amavisd-new at balder.ntg.nl
Original-Received: from balder.ntg.nl ([127.0.0.1])
	by localhost (balder.ntg.nl [127.0.0.1]) (amavisd-new, port 10024)
	with LMTP id dNwOt+fn-VvW; Mon,  6 Feb 2012 12:41:19 +0100 (CET)
Original-Received: from balder.ntg.nl (localhost [127.0.0.1])
	by balder.ntg.nl (Postfix) with ESMTP id 9E0F1CB215;
	Mon,  6 Feb 2012 12:41:18 +0100 (CET)
Original-Received: from localhost (localhost [127.0.0.1])
	by balder.ntg.nl (Postfix) with ESMTP id D416ACB215
	for <ntg-context@ntg.nl>; Mon,  6 Feb 2012 12:41:16 +0100 (CET)
X-Virus-Scanned: Debian amavisd-new at balder.ntg.nl
Original-Received: from balder.ntg.nl ([127.0.0.1])
	by localhost (balder.ntg.nl [127.0.0.1]) (amavisd-new, port 10024)
	with LMTP id LFIoFxJk+uQC for <ntg-context@ntg.nl>;
	Mon,  6 Feb 2012 12:41:02 +0100 (CET)
Original-Received: from filter3-til.mf.surf.net (filter3-til.mf.surf.net
	[194.171.167.219])
	by balder.ntg.nl (Postfix) with ESMTP id 299DFCB210
	for <ntg-context@ntg.nl>; Mon,  6 Feb 2012 12:41:01 +0100 (CET)
Original-Received: from mail-ee0-f41.google.com (mail-ee0-f41.google.com [74.125.83.41])
	by filter3-til.mf.surf.net (8.14.3/8.14.3/Debian-5+lenny1) with ESMTP
	id q16Bf09a026369
	for <ntg-context@ntg.nl>; Mon, 6 Feb 2012 12:41:00 +0100
Original-Received: by eekc13 with SMTP id c13so2412224eek.14
	for <ntg-context@ntg.nl>; Mon, 06 Feb 2012 03:41:00 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=googlemail.com; s=gamma;
	h=subject:mime-version:content-type:from:in-reply-to:date:cc
	:content-transfer-encoding:message-id:references:to:x-mailer;
	bh=+SvjLpD54gXe/doHHTEdUBMlJEpjdcAjgVYaHMu0Z8o=;
	b=Ub5IBZIXPO1AdBS1bYg77G5KdmTK3kEqGyWlGFaGs3Gt5CfCMcaRHtLzXgpqQbxaua
	3O0xbafAzozhIezdAv8a60thuQaMybRMbuFh1jyvhjqgHEutid6ja62C+Viq8LgcuyTb
	QcC5vjvlemo/1PgzN3brIohp2WTMzx24D8W8A=
Original-Received: by 10.14.95.4 with SMTP id o4mr3710008eef.95.1328528459511;
	Mon, 06 Feb 2012 03:40:59 -0800 (PST)
Original-Received: from [192.168.2.35] (p57AFB605.dip.t-dialin.net. [87.175.182.5])
	by mx.google.com with ESMTPS id c16sm60193463eei.1.2012.02.06.03.40.56
	(version=TLSv1/SSLv3 cipher=OTHER);
	Mon, 06 Feb 2012 03:40:58 -0800 (PST)
In-Reply-To: <9D5A94D1-B97A-45F3-98AC-A1FC37FAA602@fiee.net>
X-Mailer: Apple Mail (2.1257)
X-Bayes-Prob: 0.0001 (Score 0, tokens from: @@RPTN)
X-CanIt-Geo: ip=74.125.83.41; country=US; region=CA; city=Mountain View;
	postalcode=94043; latitude=37.4192; longitude=-122.0574;
	metrocode=807; areacode=650;
	http://maps.google.com/maps?q=37.4192,-122.0574&z=6
X-CanItPRO-Stream: uu:ntg-context@ntg.nl (inherits from uu:default,
	base:default)
X-Canit-Stats-ID: 0eGuzF07V - 83653923aca1 - 20120206 (trained as not-spam)
X-Scanned-By: CanIt (www . roaringpenguin . com) on 194.171.167.219
X-BeenThere: ntg-context@ntg.nl
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: mailing list for ConTeXt users <ntg-context.ntg.nl>
List-Unsubscribe: <http://www.ntg.nl/mailman/options/ntg-context>,
	<mailto:ntg-context-request@ntg.nl?subject=unsubscribe>
List-Archive: <http://www.ntg.nl/pipermail/ntg-context>
List-Post: <mailto:ntg-context@ntg.nl>
List-Help: <mailto:ntg-context-request@ntg.nl?subject=help>
List-Subscribe: <http://www.ntg.nl/mailman/listinfo/ntg-context>,
	<mailto:ntg-context-request@ntg.nl?subject=subscribe>
Original-Sender: ntg-context-bounces@ntg.nl
Errors-To: ntg-context-bounces@ntg.nl
Xref: news.gmane.org gmane.comp.tex.context:74329
Archived-At: <http://permalink.gmane.org/gmane.comp.tex.context/74329>


Am 06.02.2012 um 00:05 schrieb Henning Hraban Ramm:

> Am 2012-01-19 um 00:21 schrieb Wolfgang Schuster:
> =

>> There isn=92t a new documentation yet but I=92ll give a short overview.
> ...
> =

> Since my letter/invoice setup doesn=92t work anymore (and perhaps you rem=
ember it was a tricky one) - can we expect some docs anytime soon?

I'll write one when I=92m in the right mood.

For a few changes read the following I posted a while ago: http://www.ntg.n=
l/pipermail/ntg-context/2012/064695.html

> E.g. \copyletterelement is gone, and I guess my "\startsetups letter:loca=
tion" and \defineletterelement doesn=92t do anything, or any of the other s=
etup commands, at least my logo and sender data don=92t show up=85

I made few changes in the recent version of the module which breaks backwar=
d compatibility with old styles.

1. External styles

The predefined styles are loaded from external files with the \uselettersty=
le command, in the past these files had names in the form <style>.nls. The =
name system has changed and personal styles have to follow the form =93lett=
er-<style>.tex=94, you could also use =93mkiv=94 and =93mkii=94 as extensio=
ns.

2. Setup commands

Previously there has been only the \setupletterstyle command to change the =
values of the elements, now the various types of elements have dedicated co=
mmands.

The =93layers=94 (which are used for the =93head=94, =93address=94 or =93re=
ference line=94) are configured with the \setupletterlayer and \setupletter=
frame command, the first is used to move the layer to it=92s position on th=
e page with the =93x=94 and =93y=94 keys and you can select one letter elem=
ents (which are created with \defineletterelement) with the =93alternative=
=94 key. With the \setupletterframe you can change the =93width=94 and =93h=
eight=94 of the element.

The =93sections=94 (which are used for the =93subject=94 and =93content=94)=
 are configured with the \setuplettersection command which allows you to ch=
ange the alignment and spacing before and after the element.

Global settings like the bodyfont, whitespace or language can be changed wi=
th the \setuplettersoptions command.

The old \setupletterstyle command had been reduced to change the style and =
color for the variables which are set with \setupletter (or \startletter), =
e.g. you can say \setupletter[date][textstyle=3Dbold,color=3Dred] to change=
 the layout of the date in the reference line.

A complete list with all values for the various commands can be seen in the=
 following document: https://bitbucket.org/wolfs/correspondence/downloads/c=
ommands.pdf

3. \defineletterelement

One limitation of the old module was that element names had been shared bet=
ween layers and section (i.e. it was impossible to have a layer and a secti=
on with the same name). This limitation was removed and it=92s now possible=
 to layers and sections with the same name but ti handle this the \definele=
tterlement command needed a additional argument. The syntax for the command=
 is now

   \defineletterelement[<type>][<element>][<name>]{<content>}

As a example I show a definition for the head with the name =93test=94 whic=
h prints the value of the =93firstname=94 key.

   \defineletterelement[layer][head][test]{\correspondenceparameter{firstna=
me}}

The old \copyletterelement command is no longer available, when you miss a =
few default just send me a mail and I=92ll add them.

4. \startsetups

The old version used \startsetups for the content of the elements. With the=
 current version all internals use now \letterelement but there is a method=
 to feed them with the \startsetups argument, all you need is \setuplettero=
ptions[option=3Dsetups] in your document. Nevertheless also the names for \=
startsetups have been changed to follow the unique named mentioned above an=
d the old name =93letter:location=94 is now =93letter:layer:location=94.

5. Layout

The layout of the letter environment can be changed with the \setupletterla=
yout command, it is possible to use a different layout for the first (first=
page) and the following (secondpage) pages but starting from the second pag=
e one can also set different value for left (leftpage) and right (rightpage=
) pages.

Wolfgang
___________________________________________________________________________=
________
If your question is of interest to others as well, please add an entry to t=
he Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-cont=
ext
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________=
________