On 2/17/2018 8:29 PM, Alan Braslau wrote:
HANS: there is one specific comment for you, below.
well, up to you to decide if it's auser overload (at some point we need
to stop and users should copy/patch setups ... that's the idea
concerning a title with commands ... no way around math in titles i
guess (and tex math is sort of standard); we can think of having a
"textitle" field, or abuse "title:en" for the formatted ones
On Sat, 17 Feb 2018 15:27:03 +0100
Otared Kavian <ota...@gmail.com> wrote:
Dear all,
I am in the process of learning how to use the bibliography mechanism
in mkiv, and I would lik eto understand the meanings of the various
parameters in the command:
\setupbtxrendering [...,1,...] [..,..2=..,..]
1 NAME
2 textstate = start stop
pagestate = start stop
separator = COMMAND
criterium = previous cite here all none
filter = TEXT
specification = NAME
title = TEXT
before = COMMAND
after = COMMAND
dataset = NAME
method = dataset force local global none
sorttype = short dataset list reference used default
cite index repeat = yes no
group = NAME
numbering = yes no num index tag short page
Indeed serveral of them are clear enough (such as dataset), some can
be guessed by trial and error (such as numbering=yes or no) but some
seem to me obscure or difficult to guess (what would numbering=page
mean, or what would separator=COMMAND do, what does the title=TEXT
corresponds to, etc).
Has someone some examples to play with in order to learn the meaning
of these options?
Also, in real case document I would like to be able to typeset the
bibliography with the following style:
the autho's name is followed by a « : »
the title of an article is in italic
the title of a book is in slanted sans serif
the number of the volume is in bold
Is it possible to do this by an appropriate setting of btxrendering,
without going into the BibTeX file?
Thanks in advance for any help: OK
First of all, don't put any such formatting in the BibTeX file: that is
a LaTeX-style hack, and we have designed the ConTeXt system to avoid
any such need. The dataset should contain only data, and hacks should
be avoided.
There is some limitation to this. Say, for example that the title
contains mathematical symbols. One would be hard pressed not to include
dollar-sign delimiters and math syntax! Another example could be
"edition={second}" and "edition={2\high{nd}}". Of course, one could
introduce conversion sets (like for months), but this gets complicated.
How about "edition={second, revised with corrections}"?
Most of the customizations that you ask are obtained through setups:
For the author's name, depends on what you want: " : " after the list
of authors or after each author? If you want this after the list of
authors, then one needs to redefine a setup:
From publ-imp-authors.mkvi
\startsetups \s!btx:\s!list:\s!author:others
\ifcase\currentbtxoverflow \else
\btxparameter\c!otherstext
\fi
\stopsetups
(this gets called at the end of the author list construction). One could add at
the end \btxcolon, defined (in publ-ini.mkiv) as
\unexpanded\def\btxcolon {\removeunwantedspaces:\space}
but you would want a space before, so you would probably want to add, rather
"\space:\space"
HANS: perhaps this requested use might call for a new parameter
(separator:names:5=,) to be put at the *end* of an author list in *all*
of the appropriate setups, rather than having to redefine the :others
setup which is sort-of a hack? In this case, Otared would then use
\setupbtx [apa:list:author] [separator:names:5={\space:\space}]
(assuming that he uses the apa specification)
DON'T try this, as we do not implement it (yet)!
For the other requests:
\setupbtx [apa:list:title] [style=italic]
(the default for apa)
\setupbtx [apa:list:title:book] [style={slanted,sans}]
(untested)
\setupbtx [apa:list:volume] [style=bold]
(apa default is italic)
On your other questions, a rendering uses the standard list mechanism,
so some of the parameters (such as pagestate) get passed on. See
\setuplist
Others, such as numbering= yes no num index tag short page
controls the numbering of the list. It is numbering=num (or yes for
default and aps) but numbering=no (for apa).
numbering=index puts the dataset index (which depends on an internal
hash) rather than num which is a cite instance number.
numbering=tag puts the bibtex tag (as used in \cite).
numbering=short puts the short tag, for example KAV18, that is a short
author-year concoction.
numbering=page, I don't know what this does (in my test, it put "?").
Many (but not all) of the rendering parameters are described (somewhat)
in the documentation, which of course is not perfect!
Alan
--
-----------------------------------------------------------------
Hans Hagen | PRAGMA ADE
Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
tel: 038 477 53 69 | www.pragma-ade.nl | www.pragma-pod.nl
-----------------------------------------------------------------
___________________________________________________________________________________
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://context.aanhet.net
archive : https://bitbucket.org/phg/context-mirror/commits/
wiki : http://contextgarden.net
___________________________________________________________________________________
