I wanted to download the latest version of citeproc to see what
annote support there was (see next email).
I didn’t get a “next email” but I can answer this: there is none yet.
I didn’t send it because I figured that out
It will be really easy to add to CSL, but there are some complications
that would need to be ironed out with the source data. Put simply,
what is the annotation markup, where do the annotations reside, and
how do they get configured?
While there’s finally some momentum on the MODS list for adding inline
markup for this sort of stuff, currently the MODS “note” element does
not allow any additional children; just plain text.
I have my annotations in separate linked files (or sometimes embedded
in the mods:extension element), using a custom markup.
I then remembered your blog entry on it. Thinking more about annotated
bibliographies I’m unconvinced that it makes sense to store the
annotation in the MODS record. Abstracts certainly. But not only are
annotations a per-user thing they should be a “per-purpose” thing, ie a
good annotated bibliography presents the articles in some kind of
conceptual order, rather than alpha or crono, or at least structured by
topic. And the annotations should either flow or be focused on similar
questions, questions which will change “per-purpose”.
Off the top of my head, I’m thinking more in terms of a separate
database of annotations, many per cite, which are then pulled
separately into with another tag similar to citeref. That should pull
the MODS data, formatted in full reference format as desired, because
it is called from within the annotation data.
workflow something like this:
Write annotations, store in an annote DB format that includes a field
like ref call. Create a container
document (eg in Docbook) using something like a <annoteref=“annoteKey”>
tag (or a ).
Then transform that using xslt so that it now has something like:On Apr 8, 2005, at 11:25 AM, Bruce D’Arcus wrote:
On Apr 7, 2005, at 3:06 PM, James Howison wrote:
Annotation text and tags.
Then run that through the same citeproc processors as normal except
that rather than inserting the key (eg Howison, 2005) it inserts the
full reference as it would have been formatted in the reference list.
Optionally a regular reference list could go at the end of the document
(usually done if the annotations, or discussions, are long or if there
are citations in the annotation to sources not part of the annotated
bibliography)
Nice thing about this is that it makes it easy to use references to
other articles within annotations and have them formatted properly
(just use the biblioref syntax as usual which gets replaced by the key
and goes into the ending reference list.
This requires a little more infrastructure but is, I think, quite
flexible.
Could we also, then, have and so on?
–James
+1 315 395 4056
Details: http://freelancepropaganda.com/jameshowison.vcf