getting there but not there yet (aka setting up basic workflow)

CSL Development
1

This is probably a xbiblio-user question but that doesn’t seem to exist
yet :wink:

I am working my way through Bruce’s “Bleeding Edge” Instructions.
Please forgive my latex-isms as that’s where I’m coming from. I’ve
never written an XSL transform—I’m basically new to xml.

I have (thanks to Bruce’s workflow description)
http://tinyurl.com/59ebs

  1. A document that is in docbook-ng format (validates and transforms
    ok using oXygen’s docbook HTML and PDF) (well actually that is thanks
    to Norman’s beta of the new docbook book)
  2. A bibliography in MODS format (used bib2xml) stored in an eXist
    database on localhost called ‘mods’
  3. The citeproc source
  4. A transformation scenario set-up in oXygen using the
    citeproc/xsl/document/dbng-xhtml.xsl sheet for the “XSL URL” using
    Saxon8.1B with a parameter citation-style of author-year.
    (BTW is there a way to ‘export’ and ‘import’ transformation scenarios
    for oXygen?)

I’m far from sure what I’m doing (for example I started running that
transformation on the mods file!).

In the docbook file I have citations set up like this:

(Which I picked up (of all places from the header graphic on the
citeproc homepage ;).)

and the ‘mods’ database running on localhost has a MODS record with
that identifier

Now where and how do I specify that I
a) want a Bibliography in the document (I guess that’s something to do
with which should go at the bottom of the docbook file?)
b) that it should use the references in the mods collection in the
eXist database (I think that’s the default so maybe I don’t have to
change that …)

Basic questions I know :wink:

Other questions:

  1. The css files didn’t get created (screen.css etc). Am I meant to
    create those and add them into the transformation scenario, or are
    there defaults that are specified by the xsl (or the csls?)
  2. The file was looking for images in …/images which I didn’t
    specifiy at all… (I used this ) which should
    (I think) be ./graphics from the folder that the original docbook file
    is in.
  3. PDF images didn’t get converted to something html’y (well PDFs work
    on OSX but nowhere else AFAIK. Is that something that would be
    specified in the XSL transformations?
  4. What’s the relationship between the bibliomixed type stuff
    mentioned on this page:
    http://docbook.org/tdg5/en/html/bibliography.html and citeproc?

Hmmm. I think that’s it for now :wink: I’m going to blog this up once I
get it working.

–James
US Cell: +1 315 395 4056
Full Contact Details on VCard:
http://freelancepropaganda.com/jameshowison.vcf

2

Now where and how do I specify that I
a) want a Bibliography in the document (I guess that’s something to do
with which should go at the bottom of the docbook
file?)

It could, but I handle that in the document stylesheet, so it’s
automatic. See “dbng-xhtml.xsl”, where you have this template:

<xsl:template match=“/”>



<xsl:value-of select=“$title”/>









<xsl:value-of select=“db:*/@label” />

xsl:apply-templates/
<xsl:if test=“//db:footnote”>

Notes:


<xsl:apply-templates select=“//db:footnote”
mode=“footnote-list” />

</xsl:if>

References


<xsl:call-template name=“bib:format-bibliography”>
<xsl:with-param name=“output-format” select=“‘xhtml’”/>
</xsl:call-template>





</xsl:template>

The bibliography template then handles rendering for the bibliography
(for example, the section text).

b) that it should use the references in the mods collection in the
eXist database (I think that’s the default so maybe I don’t have to
change that …)

Right. I store my MODS records as individual documents, using the -s
option in bibutils to get those files.

Basic questions I know :wink:

That’s fine; the documentation is thin now, and more aimed at
developers.

Other questions:

  1. The css files didn’t get created (screen.css etc). Am I meant to
    create those and add them into the transformation scenario, or are
    there defaults that are specified by the xsl (or the csls?)

No, sorry. I should include that in the damned samples directory, but
just forgot. See attached.

  1. The file was looking for images in …/images which I didn’t
    specifiy at all… (I used this ) which
    should (I think) be ./graphics from the folder that the original
    docbook file is in.

Again, feel free to create a new dbng-xhtml.xsl file and modify as you
wish. This sort of configuration is handled there; in templates like
this:

<xsl:template match=“db:imageobject”>
{../../db:title}


<xsl:value-of select=“…/…/db:title” />


</xsl:template>

  1. PDF images didn’t get converted to something html’y (well PDFs
    work on OSX but nowhere else AFAIK. Is that something that would be
    specified in the XSL transformations?

No, you’ll have to handle conversion on your own. All XSLT does is
work with XML.

  1. What’s the relationship between the bibliomixed type stuff
    mentioned on this page:
    Page moved and citeproc?

Nothing. I completely cut out all the DocBook bib stuff, and instead
use my own (internal) intermediate representation, which is sort of a
cross between xhtml and fo.

Bruce

screen.css (872 Bytes)

3

Options > export transformation scenario.

Bruce