Thread: [Refdb-users] Citestylex DTD
Status: Beta
Brought to you by:
mhoenicka
From: David N. <dav...@sw...> - 2004-07-11 11:16:33
|
I'm exploring the nooks and crannies of the citestylex DTD. I am unable to locate any documentation on it at all, aside from an outdated dtdparse tree on the refdb documentation page (along with the DTD itself). The DTD shows how a style should be structured, but provides little guidance as to what the elements and attributes actually _do_, ie. how they affect bibliography and citation presentation. While many are obvious, some are obscure and others just plain peculiar. I'm hoping someone on this list can point me to some documentation explaining the effects of the various citestylex components. If not, a lot of experimentation awaits me. Anything I'm unable to nut out for myself I'll have to beg the list to help me with. Any pointers that may save me work will be gratefully accepted. Regards, David. |
From: Bruce D'A. <bd...@fa...> - 2004-07-11 13:45:54
|
On Jul 11, 2004, at 7:16 AM, David Nebauer wrote: > The DTD shows how a style should be structured, but provides little=20 > guidance as to what the elements and attributes actually _do_, ie.=20 > how they affect bibliography and citation presentation. While many=20 > are obvious, some are obscure and others just plain peculiar. I also find citestylex difficult. I think the style spec language in=20 BiblioX is more user-friendly (though has other problems that I think=20 need to be fixed), and think long-term it'd be better to switch to=20 that. Here's an article: <reftype class=3D"article" aftersep=3D"."> <author aftersep=3D": "> <name> <surname weight=3D"bold"></surname> <forename beforesep=3D", "></forename> </name> <name beforesep=3D"; "> <forename></forename> <surname beforesep=3D" "></surname> </name> <name beforesep=3D"; and "> <forename></forename> <surname beforesep=3D" "></surname> </name> </author> <title beforesep=3D"=93" aftersep=3D"=94 "></title> <journal beforesep=3D"In "> <editor aftersep=3D", "> <name> <forename aftersep=3D" "></forename> <surname></surname> </name> <name beforesep=3D", "> <forename aftersep=3D" "></forename> <surname></surname> </name> <name beforesep=3D", and "> <forename aftersep=3D" "></forename> <surname></surname> </name> </editor> <title shape=3D"italic"></title> <volume beforesep=3D", "></volume> <number beforesep=3D":"></number> <date beforesep=3D", "> <year></year> </date> <pages beforesep=3D", "> <start beforesep=3D"p."></start> </pages> <isn type=3D"ISBN" beforesep=3D", ISBN "></isn> </journal> <uri fonttype=3D"monospace" beforesep=3D" [" aftersep=3D"]"></uri> </reftype> |
From: Markus H. <mar...@mh...> - 2004-07-12 20:59:34
|
David Nebauer writes: > I'm exploring the nooks and crannies of the citestylex DTD. I am unable > to locate any documentation on it at all, aside from an outdated > dtdparse tree on the refdb documentation page (along with the DTD itself). > Sorry about this, but this is almost all you can get. There is a brief overview in the manual (see Fig. 10-1 in chapter 10, "Bibliographies"). > The DTD shows how a style should be structured, but provides little > guidance as to what the elements and attributes actually _do_, ie. how > they affect bibliography and citation presentation. While many are > obvious, some are obscure and others just plain peculiar. > > I'm hoping someone on this list can point me to some documentation > explaining the effects of the various citestylex components. If not, a > lot of experimentation awaits me. Anything I'm unable to nut out for > myself I'll have to beg the list to help me with. > > Any pointers that may save me work will be gratefully accepted. > As stated above, there is not much to find on this issue, with the exception of the existing styles that you can peruse and maybe use as a starting point for your own experiments. I'm not sure whether you've figured out the general idea of a citation style. There's essentially a separate definition for the in-text citation (CITSTYLE) and for each publication type (BOOK, JOUR etc) that requires a special treatment. All other types can be handled by the catch-all GEN type. Each definition in turn basically lists the bits and pieces in the order that you expect them to appear in the printout. These pieces will be retrieved from the database, optionally preceded and followed by static strings defined with the PRECEEDING, FOLLOWING, and SEPARATOR elements. The general appearance of the bibliography, like the sorting order, is again specified in the CITSTYLE element. Some of the elements are fairly complicated as they have to deal with a lot of variability. This holds true for the AUTHORLIST element which has to take care of the whole insanity of publisher's styles regarding things like name part sequences or maximum number of authors listed. I'll be happy to answer more specific questions about this not-so-smooth DTD, but I'm afraid it won't go away anytime soon. We'll have to live with it for a while. Anyone who wants to document the DTD in a human-readable fashion is more than welcome to do so. regards, Markus -- Markus Hoenicka mar...@ca... (Spam-protected email: replace the quadrupeds with "mhoenicka") http://www.mhoenicka.de |