refdb-users

[Refdb-users] refdb and SGML/docbook issues

[Marc B. <ba...@sm...>]

Hi,

first of all, let me say that I am a real docbook/SGML beginner,
so I might say studip things or overlook something obvious.

1) Getting it to work

The last days I fiddled with getting refdb+docbooc+jade going on
my Debian woody system. For that I had to modify some things in
the refdb distribution (only minor changes, but when you don't
know where you need to interfere ..)

I had to add a line "CATALOG /etc/sgml/catalog" to
/usr/local/share/refdb/dsssl/catalog to get the Public identifiers
mapped correctly.

I also had to replace the 'sgmldecl="docbook.dcl" ' line by
'sgmldecl=' in /usr/local/bin/runbib and in /usr/local/bin/refdbjade

Now it seems to work fine.

2) First time error

I guess it is normal/OK that in the first pass, when the *.bib.sgml
file does not yet exist, there is an error message about this ?

/usr/bin/jade:rapport.sgml:168:0:E: cannot find "rapport.bib.sgml"; [..]

as well as the "errors" for each citation reference

/usr/bin/jade:rapport.sgml:16:66:X: reference to non-existent ID[..]

Or am I missing something ?

3) Other languages than english ?

As I am currently writing a text in French, I'd like to have the
"Reference List" text replaced with something in French (for instance
"Bibliographie" or so ..). How do I go about this ?

4) Multiple entities

I have tried to follow the hint in the documentation about using
sgmlnorm for documents with multiple entities. It works, but my
solution seems particularly ugly .. maybe I did overlook something ?
I actually use a custom header with Docbook ref and inclusion of
bibliography, then paste the output of sgmlnorm to that, then
add a &bibliography reference to the entity before the final
</book>,</article>  or whatever.

Is there a better way ?

I attach my slightly modified Makefile and header and footer as
example.

Thanks in advance for any hints,
  Marc Baaden

[Refdb-users] refdb and SGML/docbook issues

[Markus H. <mar...@mh...>]

Hi Marc,

Marc Baaden writes:
 > I had to add a line "CATALOG /etc/sgml/catalog" to
 > /usr/local/share/refdb/dsssl/catalog to get the Public identifiers
 > mapped correctly.
 > 

This is a bit surprising as the Debian Jade/Openjade binaries
automatically use the standard catalog /etc/sgml/catalog. In any case,
if this should turn out to be necessary (I'll be able to test this in
a week or two - got a used bargain box for testing), I'd do it the
other way round - include the RefDB catalog in the master catalog.

 > I also had to replace the 'sgmldecl="docbook.dcl" ' line by
 > 'sgmldecl=' in /usr/local/bin/runbib and in /usr/local/bin/refdbjade
 > 

This makes me suspicious. What version do you run? 0.9.2 uses its own
copies of the declaration files unless you specify different paths on
the ./configure command line.

 > Now it seems to work fine.
 > 
 > 2) First time error
 > 
 > I guess it is normal/OK that in the first pass, when the *.bib.sgml
 > file does not yet exist, there is an error message about this ?
 > 
 > /usr/bin/jade:rapport.sgml:168:0:E: cannot find "rapport.bib.sgml"; [..]
 > 
 > as well as the "errors" for each citation reference
 > 
 > /usr/bin/jade:rapport.sgml:16:66:X: reference to non-existent ID[..]
 > 
 > Or am I missing something ?
 > 

No, this is expected (and described in the manual). You're
bootstrapping, so neither the bib file nor the IDs it contains exist
during the first run.

 > 3) Other languages than english ?
 > 
 > As I am currently writing a text in French, I'd like to have the
 > "Reference List" text replaced with something in French (for instance
 > "Bibliographie" or so ..). How do I go about this ?
 > 

You'd have to edit the XML files that describe the bibliography
styles. Customize them as you see fit, change the style names, and load
them with the refdba:addstyle command.

 > 4) Multiple entities
 > 
 > I have tried to follow the hint in the documentation about using
 > sgmlnorm for documents with multiple entities. It works, but my
 > solution seems particularly ugly .. maybe I did overlook something ?
 > I actually use a custom header with Docbook ref and inclusion of
 > bibliography, then paste the output of sgmlnorm to that, then
 > add a &bibliography reference to the entity before the final
 > </book>,</article>  or whatever.
 > 
 > Is there a better way ?
 > 

There is a better way, but I can't provide it at the moment. The
solution would be to rewrite refdbxp based on the OpenSP library and
make it fully SGML-aware. Unfortunately I'm not much of a C++
programmer, so this project is pretty close to the bottom of my todo
list. I'm afraid we'll have to live with half-assed solutions for the
time being.

regards,
Markus

-- 
Markus Hoenicka
mar...@ca...
(Spam-protected email: replace the quadrupeds with "mhoenicka")
http://www.mhoenicka.de