On 13 Mar 2009, at 19:38, Bob Stayton wrote:
Hi,
Regarding the endnotes, what I meant was if you create <footnote>
elements in DocBook and render them with the stock stylesheets, they
appear at the bottom of the page as footnotes. However, if you add
my customization, they do not appear at the bottom of the page but
instead appear grouped together at the end. The end of what? That
depends on your needs. Some people put them at the end of each
chapter, others put them in an appendix at the end of a book.
Actually, reading your comment again, it sounds more like you want
to put a bibliography at the end of your book, and create citations
in your chapters that link to the bibliographic entries. That can
be done with bibliography, and creating links to biblioentry
elements in the bibliography, as described here:
http://www.sagehill.net/docbookxsl/Bibliographies.html
exactly what i meant , thanks
Regarding creating a customization layer, it lets you customize the
stylesheets without editing the original files. Here the specific
reference:
http://www.sagehill.net/docbookxsl/CustomMethods.html#CustomizationLayer
excelllent suggestion , i ve got some homework for the weekend now
bram
Bob Stayton
Sagehill Enterprises
[email protected]
----- Original Message ----- From: "Bram Vogelaar" <[email protected]
>
To: "DocBook Apps" <[email protected]>
Sent: Friday, March 13, 2009 12:18 PM
Subject: Re: [docbook-apps] Moving towards docbook
Hello Bob
On 13 Mar 2009, at 18:45, Bob Stayton wrote:
Hi,
Regarding item #2, support for the <acknowledgements> element is
just now being added to the stylesheets. The latest snapshot
versions will do better.
excellent thanks
Regarding item #5, it is not the default behavior to generate an
index (back-of-book alphabetized index) for each part element.
You should only get an index where you place an empty <index/>
element, which is typically at the end of a book element. Or
perhaps you mean Table of Contents? If the latter, then you want
to customize the stylesheet parameter named "generate.toc". That
process is described here:
http://www.sagehill.net/docbookxsl/TOCcontrol.html#TOCcomponents
sorry, yes of course i meant Toc , ill have a look at your book
again, It been very informative so far
Regarding item #6, my book has an example of customizing
footnotes to be rendered as endnotes:
http://www.sagehill.net/docbookxsl/Endnotes.html
What i understand from this, is that the full text references will
end up at the bottom of the same page where you added the actual
reference. In the biology world we are raised with the notion that
references will end up at the end of a book/ article in a index
type style. do have any clues how to achieve this or have i
completely missed your point?
My book also describes how to create a stylesheet customization
layer, but I'm not clear on how that would integrate into the
"frameworks" you are talking about.
I dont really get this question, to what specific section does this
reference?
if its with regards to my 2nd question, than i am trying to find
out what all the xsl's in the docbook-xsl-ns folder can do. (which
is included in the oxygen project as the framework folder.
bram
Bob Stayton
Sagehill Enterprises
[email protected]
----- Original Message ----- From: "Bram Vogelaar" <[email protected]
>
To: "DocBook Apps" <[email protected]>
Sent: Friday, March 13, 2009 10:21 AM
Subject: [docbook-apps] Moving towards docbook
Hello Docbook community
For one of projects we are moving away from using word (large
files are almost impossible to edit by multiple people in a
controlled way, and limited output options) as our main
documentation system.
We are planning to move to docbook and the initial transition
went very smoothly and impressed my non-CS bosses. Now i am stuck
with a couple of questions you might be able to help me with :
1) when i create the following docbook files.
manual.xml
<?xml version="1.0" encoding="UTF-8"?>
<?oxygen RNGSchema="http://www.oasis-open.org/docbook/xml/5.0/rng/docbookxi.rng
" type="xml"?>
<book xmlns="http://docbook.org/ns/docbook"; xmlns:xi="http://www.w3.org/2001/XInclude
"
xmlns:xlink="http://www.w3.org/1999/xlink"; version="5.0">
<xi:include href="parts/info.xml"
xmlns:xi="http://www.w3.org/2001/XInclude";>
</xi:include>
<xi:include href="parts/part1.xml"
xmlns:xi="http://www.w3.org/2001/XInclude";>
</xi:include>
........
</book>
info.xml
<?xml version="1.0" encoding="UTF-8"?>
<info xmlns="http://docbook.org/ns/docbook"; version="5.0">
.......
</info>
in which i make all sections of the book /manual an external
file i get the following error
"E [oNVDL] element "info" from namespace "http://docbook.org/ns/
docbook" not allowed in this context"
while when i use the same info block in the manual.xml the file
is rendered fine.
Could some explain to me how to use the info block in a separate
file.
2) when using a acknowledgement i get an error rendering with the
$ {frameworks}/docbook/xsl/fo/docbook.xsl file i get an
rendering error while using the ${frameworks}/docbook/xsl/html/
docbook.xsl it gets rendered as a dedication.
Is this expected behavior or a bug?
3) i am also a bit overwhelmed by the amount of rendering
options in the framework folder, could someone point me towards
a introduction/ howto about all the different output options.
I figured out how to use the pdf, html , html-chunked and chm
ones but i am not sure i also might like to use.
4) seeing as that the rendering steps can be written as ant
jobs (i believe please correct me), has anyone any pointers as
how to setup up a cruisecontrol (http://
cruisecontrol.sourceforge.net/ )setup ( or similar)
that renders the files automagically upon change
5) we would like to divide our manuals into parts , but in the
default setup this results in the generation of a new index for
every part of the book. Where can i change this behavior?
6) As biologist we are attached to the hip with endnote (or
reference manager), could someone explain how they incorporated
and or replaced their endnote reference libraries to work with
their docbook workflow.
especially the conversion from endnote to docbook, cite-while-
you- write , and the auto numbering and formating that is done by
endnote
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
open.org
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
