Re: Adding custom key/value pairs

["Wolfgang Schuster" <schuster.wolfgang@googlemail.com>]

On Tue, Apr 15, 2008 at 5:34 PM, Aditya Mahajan <adityam@umich.edu> wrote:
> Hi Wolfgang,
>
>
> On Tue, 15 Apr 2008, Wolfgang Schuster wrote:
>
> > On Mon, Apr 14, 2008 at 6:11 PM, Aditya Mahajan <adityam@umich.edu> wrote:
> >> On Mon, 14 Apr 2008, Taco Hoekwater wrote:
> >>
> >>> Wolfgang Schuster wrote:
> >>>>
> >>>> Why not, I have nothing against a few predefined title pages layouts.
> >>>
> >>> Somewhat related: it would be nice if there was some common code for
> >>> titles (books as well as articles).
> >>>
> >>> [snip]
> >>>
> >>> Anyway, the maps module contains all the code to do everything. And
> >>> the same is true for the TUG module. And for quite a few others I have
> >>> laying around. Lots of duplicate code all over, so a common framework
> >>> would be great. I've been meaning to write one for a long time, but
> >>> somehow I never quite get around to actually doing it.
> >>>
> >>> Just saying this to let you know that I would really welcome a module
> >>> with commands like \setuptitle, \definetitle, and \placetitle.
> >>
> >> I agree with that. It will be really nice to have a module that does a few
> >> "simple" titles (alternate=(a|b|c), etc.) For one of my personal modules,
> >> I was following something along the lines of the maps module. But I find
> >> Wolfgang's solution on the wiki to be more ConTeXtish than what all other
> >> modules use.
> >
> > Hi Aditya,
> >
> > could you use a few lines what do you expect from a placetitle/placetitlepage
> > command or a titlepage environment.
>
> Some of the things that I use \placetitle for:
>
> * Writing academic papers. Currenly, I have a macro that I use like this:
>
> \article
>        [title ={...},
>         author={...},
>        publication={...},% This just goes to pdf subtitle
>        date={...},
>        bottom={...}, %text placed at page bottom,
>                      %usually current revision number
>        thanks={...}, %placed on the footer of the first page
>        ]
>
> \startabstract
> ...
> \stopabstract
>
> \startkeywords
> ....
> \stopkeywords
>
> The abstract environment places a head ("Abstract") followed by its
> content. The formatting depends on whether it is a journal article, or a
> conference article.
>
> keyword also places a head followed by its content.
>
> Currently, what I have is that \article places all its contents, and so do
> abstract and keyword. So, I do not have to store anything.
>
> * TUGBoat articles: This uses a style file originally by Hans, which I
> have modified considerably, but still uses the same interface.
>
> This uses
>
> \setvariables
>    [tugboat]
>    [title={...},
>     author={...},
>     address={...},
>     email={...},
>     year={...},
>     volume={..},
>     number={...},
>     page={...}]
>
> The title and the author go to the document title. The address and email
> go at the end of the article. The year, volume, number, and page go to the
> header and footer of the article.
>
> The rest of the article is somethng like
>
> \starttext
> \startArticle
>
> \startAbstract
> ....
> \stopAbstract
> ...
>
> \stopArticle
> \stoptext
>
> This structure is the reason I think something like \setuptitle (or
> \setupdocumenttitle) is needed.
>
> * Practex journal, which uses
>
> http://wiki.contextgarden.net/Modules/Pracjourn
>
> * My Ways which use
>
> http://wiki.contextgarden.net/Modules/MyWay
>
> * and finally Maps which use
>
> http://wiki.contextgarden.net/Modules/Maps
>
> --------------------
>
> Notice that almost all of them so similar things, but in slightly
> different manner. What I wish for is a common interface, and I really like
> your idea of \setuptitle. In fact, I think that something like that should
> be part of the core.

I module should be enogh for the start, makes it easier to test without
the need to create a new relase or replace one of the core files and to
generate a new format file.

> The module does not need to take care of all the formatting requirements:
> just provide the interface. For a particular publications, the module for
> that publication can modify the \placetitle command to do what they want.
> With this, the user documentation can just say that use
>
> \setuptitle[title=...,author=..., date=....] %and maybe setups={...}
>
> So, we will have a consistent user inteferface for all documents.
>
> > What should we do with the abstract, did it depend on the document title ...
>
> In general, the formatting of the abstract will depend on the kind of the
> document. Just need something like
>
> \definetitlesubstructure% or something more appropriate
>   [abstract]
>   [headtext={Abstract},
>    headstyle=bold,
>    headcolor=blue,
>    headalign=middle,
>    inbetween=\blank,%between the head and the body
>    style=small, %for the contents
>    color=black, %for the contents
>   ]

I would replace headetext with \setuphead[abstract] and the format
for the table of content (is this what do you mean with "for the content")
with \setuplist but should abstract use a own command to place the
title \definehead[abstract]  or can we use one of the predefined ones
(title -- new page or subject -- if you need a abstract in different languages
on one page).

> This should define a command that captures its contents, and provides a
> command \placetitlesubstructure[abstract].
>
> Similarly, we can define
>
> \definetitlesubstructure
>   [keywords]
>   [....]
>
> Then, \placetitlesubstructure[abstract] and
> \placetitlesubstracutre[keywords] and go in the after={...} key of
> \setuptitle.

Can't the abstract just placed after the text has been set with
\start/\stopabstract.

> As I said before, the module just needs to collect the information, and
> provide one or two simple styles. Once the information is collected, it is
> easy to use other keys (e.g. thanks key in my first case) and let the user
> define a setups that take of how to handle those keys.

Wolfgang
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________