OpenOffice.org 2.0 File Format Change Proposal
Improved Citation Support, 19 Aug 2004
Document identifier:04-08-19-xml-biblio.sxw
Editors:

Bruce D'Arcus, <bdarcus@openoffice.org>
Daniel Vogelheim <Daniel.Vogelheim@sun.com>.

04-08-19-xml-biblio.sxw
Copyright © Sun Microsystems, Inc 2004. All Rights Reserved.

22 March 2004
Page 1 of 7

Table of Contents
1 Paragraph Elements Content........................................................................................................ 3
1.1 Required changes to OASIS Open Office 1.0 Schema................................................... ........3
1.2 Bibliographic Citation........................................................................................................... ..3
1.2.1 Citation Source............................................................................................... ................4
1.2.2 Citation Body............................................................................................... ...................5
1.3 Relax-NG Schema Suffix............................................................................................... ........5Appendix A. References............................................................................................................. .....604-08-19-xml-biblio.sxw
Copyright © Sun Microsystems, Inc 2004. All Rights Reserved.

22 March 2004
Page 2 of 7

1 Paragraph Elements Content
1.1 Required changes to OASIS Open Office 1.0 SchemaThis section describes changes that must be applied to the [OO] schema in order to integrate theproposed file format change.

Relax-NG Schema Prefix
The schema language used within this specification is Relax-NG (see [RNG]).
Prefix for the normative Relax-NG schema:
12345<?xml version="1.0" encoding="UTF-8"?><!-OpenOffice.org 2.0 biblio
19 Aug 2004
Relax-NG Schema

67-->

8910

<grammar xmlns="http://relaxng.org/ns/structure/1.0"><include href="office-strict-schema-1.0-cd-1.rng">

Required Changes[none; the schema additions can be merge in using the 'combine' attribute]

Relax-NG Schema Intermediate
Intermediate for the normative Relax-NG schema:
11</include>

1.2 Bibliographic Citation[... to become chapter 5.9 ...]The bibliographic citation used in this document was developed by the BiblioX project [BiblioX]. Thisvariant is based on the biblioref element recently approved for inclusion in DocBook. The
bibliographic citations use the following namespace :12xmlns:bib="http://www.silmaril.ie/bibliox/xbc"

A bibliographic citation consists of a citation source and a citation body. The citation source
determines the content of a citation, which a bibliographic citation processor can then suitably
render into the citation body.
13141516171819<define name="paragraph-content" combine="choice"><element name="bib:citation"><ref name="bib-citation-source"/><optional><ref name="bib-citation-body"/></optional></element>

04-08-19-xml-biblio.sxw
Copyright © Sun Microsystems, Inc 2004. All Rights Reserved.

22 March 2004
Page 3 of 7

20</define>

1.2.1 Citation Source
A citation source consists of a sequence of bibliographic references, which as a whole make up acitation.
21222324252627<define name="bib-citation-source"><element name="bib:citation-source"><oneOrMore><ref name="bib-biblioref"/></oneOrMore></element></define>

Bibliographic Reference
A bibliographic reference contains a bib:linkend attribute reference to the actual citation. (Thename linkend is derived from DocBook.) Additionally, the references contains a number of<bib:detail> elements that specify which parts (a range of pages, paragraphs, etc.) of thereference are being cited. Also contained are a sequence of captions that may lead or follow thebibliographic reference.
2829303132333435
36
37
38

<define name="bib-biblioref"><element name="bib:biblioref"><ref name="bib-biblioref-attlist"/><zeroOrMore><ref name="bib-detail"/></zeroOrMore><zeroOrMore><ref name="bib-caption"/></zeroOrMore></element></define>

The bib:linkend attribute names the bibliographic entry that is cited here.
3940
41
42
43

<define name="bib-biblioref-attlist" combine="interleave"><attribute name="bib:linkend"><data type="token" datatypeLibrary=""/></attribute></define>

The optional bib:citation attribute gives a hint to the citation processor how this bibliographic
reference is to be rendered. The interpretation of the attribute value is left to the citation processor.
44454647484950<define name="bib-biblioref-attlist" combine="interleave"><optional><attribute name="bib:citation-style"><ref name="string"/></attribute></optional></define>

Bibliographic Reference Detail
The <bib:detail> element provides details on which parts of the referenced citation is beingreferred to. It gives a range of pages (or similar) which is covered by the citation. The bib:units
attribute specifies whether the range refers to pages, chapters, lines, paragraphs or figures.
51<define name="bib-detail">

04-08-19-xml-biblio.sxw
Copyright © Sun Microsystems, Inc 2004. All Rights Reserved.

22 March 2004
Page 4 of 7

52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

<element name="bib:detail"><attribute name="bib:begin"><ref name="string"/></attribute><optional><attribute name="bib:end"><ref name="string"/></attribute></optional><attribute name="bib:units"><choice><value>pages</value><value>chapters</value><value>lines</value><value>paragraphs</value><value>figures</value></choice></attribute></element></define>

Reference Caption
The caption contains formatted text to lead or follow the citation.
72
73
74
75
76
77
78
79

<define name="bib-caption"><element name="bib:caption"><ref name="bib-caption-attlist"/><zeroOrMore><ref name="paragraph-content"/></zeroOrMore></element></define>

The caption position determines whether the caption should be positioned before or after thecitation.
80
81
82
83
84
85
86
87

<define name="bib-caption-attlist"><attribute name="bib:position"><choice><value>before</value><value>after</value></choice></attribute></define>

1.2.2 Citation Body
The citation body contains a rendition of the citation using the same content model as a<text:span> element. This allows applications to process bibliographic citations without having toimplement the full citation logic, and also allows specialized bibliographic software to pre-process
citations without having to implement the full OASIS Open Office 1.0 specification.<definename="bib-citation-body">
88
89
90
91
92
93
94

<define name="bib-citation-body"><element name="bib:citation-body"><zeroOrMore><ref name="paragraph-content"/></zeroOrMore></element></define>

04-08-19-xml-biblio.sxw
Copyright © Sun Microsystems, Inc 2004. All Rights Reserved.

22 March 2004
Page 5 of 7

1.3 Relax-NG Schema Suffix
Suffix for the normative Relax-NG schema:95</grammar>

04-08-19-xml-biblio.sxw
Copyright © Sun Microsystems, Inc 2004. All Rights Reserved.

22 March 2004
Page 6 of 7

Appendix A.References[OO] Michael Brauer, Daniel Vogelheim, Open Office Specification 1.0, http://www.oasisopen.org/committees/download.php/6032/office-spec-1.0-cd-1.sxw, OASIS , 2004.
[RNG] James Clark, MURATA Makoto, RELAX NG Specification, http://oasisopen.org/committees/relax-ng/spec-20011203.html, OASIS , 2001.

04-08-19-xml-biblio.sxw
Copyright © Sun Microsystems, Inc 2004. All Rights Reserved.

22 March 2004
Page 7 of 7