<!-- ============================================================= -->
-<!-- Gamebook Document Type Definition v0.11 -->
+<!-- Gamebook Document Type Definition v0.12 -->
<!-- ============================================================= -->
<!--
Change Log:
+25 March 2006 (version 0.12.0)
+ * Added "illref", "illustrations" and "illgroup". Still backwards
+ compatible.
+
26 December 2005 (version 0.11.4)
* Added link.attributes and the optional "series" attribute to
"bookref", and fleshed out the "bookref" and "footref"
4 January 2003 (version 0.10.2)
* Moved the specialized character entity definitions into module
files.
-
+x
5 October 2002 (version 0.10.1)
* Added the "lellips" and "minus" entities and changed the definition
of the "emdash" entity.
<!ENTITY % inline.content "#PCDATA | a | bookref | footref | em | strong | thought | foreign | quote | cite | code | br | typ | onomatopoeia | spell | item | %character.content;">
-<!ENTITY % block.content "p | ul | ol | dl | table | blockquote | illustration | combat | choice | signpost | hr">
+<!ENTITY % block.content "p | ul | ol | dl | table | blockquote | illustration | combat | choice | signpost | hr | illref">
<!ENTITY % core.attributes "
class CDATA #IMPLIED
Examples:
- <gamebook version="0.11" xml:lang="en-UK">
+ <gamebook version="0.12" xml:lang="en-UK">
<meta . . .> . . . </meta>
<section . . .> . . . </section>
. . .
</gamebook>
- <gamebook version="0.11" > . . . </gamebook>
+ <gamebook version="0.12" > . . . </gamebook>
-->
<!-- ::::::::::::::::::::: section Element ::::::::::::::::::::::: -->
-<!ELEMENT section ( meta, footnotes?, data )>
+<!ELEMENT section ( meta, footnotes?, illustrations?, data )>
<!ATTLIST section
%core.attributes;
%link.attributes;
-->
+<!ELEMENT illustrations ( illustration | illgroup )*>
+<!ATTLIST illustrations
+ %core.attributes;
+>
+<!--
+
+The "illustrations" element represents a collection of illustrations.
+The illustrations, or illustration groups, should be listed in the
+order they appear in the book.
+
+Example:
+
+ <illustrations>
+ <illustration . . . />
+ <illgroup . . .>. . .</illgroup>
+ . . .
+ </illustrations>
+
+-->
+
+<!ELEMENT illgroup ( illustration )*>
+<!ATTLIST illgroup
+ %core.attributes;
+ %link.attributes;
+>
+
+<!--
+
+The "illgroup" element represents a group of illustrations contained
+within one section. It is used when individual links to the each
+illustration from the illustrations index are not wanted.
+
+Example:
+
+ <illgroup idref=". . .">
+ <illustration . . . />
+ <illustration . . . />
+ . . .
+ </illgroup>
+
+ <illgroup idref=". . ." class="hidden">
+ <illustration . . . />
+ <illustration . . . />
+ . . .
+ </illgroup>
+
+-->
+
<!ELEMENT footnotes ( footnote )*>
<!ATTLIST footnotes
%core.attributes;
Example:
<data . . .>
- <p . . .>This paragraph requires an appropriate
- <a id="reference" idref="footnote-reference" . . .>footnote</a>.
+ <p . . .>This paragraph requires an appropriate footnote
+ <a id="reference" idref="footnote-reference" . . ./>.
</p>
. . .
</data>
-->
+<!ELEMENT illref EMPTY>
+<!ATTLIST illref
+ %core.attributes;
+ %link.attributes;
+>
+
+<!--
+
+The "illref" element is used to mark the location of an illustration.
+The actual illustration is declared elsewhere.
+
+Since the placement of a particular illustration may depend on the
+output format, one "illref" is required for each format.
+
+Example:
+
+ <illref idref="ill2" class="html"/>
+ <illref idref="ill2" class="pdf"/>
+
+-->
+
<!ELEMENT signpost ( %inline.content; | %block.content; )*>
<!ATTLIST signpost
%core.attributes;
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE gamebook SYSTEM "gamebook.dtd">
-<gamebook version="0.11" xml:lang="en-UK">
+<gamebook version="0.12" xml:lang="en-UK">
<meta>
<title>Flight from the Dark</title>