From 211ad38549de75b1a99ecee00af05e7d605dadd0 Mon Sep 17 00:00:00 2001
From: Thomas Wolmer <thomas.wolmer@projectaon.org>
Date: Sat, 25 Mar 2006 20:33:13 +0000
Subject: [PATCH]  * Added "illref", "illustrations" and "illgroup". Still
 backwards    compatible.

git-svn-id: https://projectaon.org/data/trunk/xml@145 f6f3e2d7-ff33-0410-aaf5-b4bee2cdac11
---
 gamebook.dtd | 91 ++++++++++++++++++++++++++++++++++++++++++++++------
 1 file changed, 82 insertions(+), 9 deletions(-)

diff --git a/gamebook.dtd b/gamebook.dtd
index 08a2406..b01f342 100644
--- a/gamebook.dtd
+++ b/gamebook.dtd
@@ -1,5 +1,5 @@
 <!-- ============================================================= -->
-<!--             Gamebook Document Type Definition v0.11           -->
+<!--             Gamebook Document Type Definition v0.12           -->
 <!-- ============================================================= -->
 <!--
 
@@ -13,6 +13,10 @@ $Id$
 
 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"
@@ -49,7 +53,7 @@ Change Log:
 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.
@@ -150,7 +154,7 @@ III. Block Elements
 
 <!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
@@ -206,13 +210,13 @@ document. The data should conform to the IETF RFC1766.
 
 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>
 
 -->
 
@@ -397,7 +401,7 @@ Examples:
 
 <!-- ::::::::::::::::::::: section Element ::::::::::::::::::::::: -->
 
-<!ELEMENT section ( meta, footnotes?, data )>
+<!ELEMENT section ( meta, footnotes?, illustrations?, data )>
 <!ATTLIST section
           %core.attributes;
           %link.attributes;
@@ -459,6 +463,54 @@ Examples:
 
 -->
 
+<!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;
@@ -492,8 +544,8 @@ named anchor within the document.
 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>
@@ -907,6 +959,27 @@ Example:
 
 -->
 
+<!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;
@@ -1605,7 +1678,7 @@ DTD. For current practice, please refer to published XML files.
 <?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>
-- 
2.34.1