From 65929d7fa2357270a4f955f32652231ee3ac955c Mon Sep 17 00:00:00 2001
From: Jonathan Blake <jonathan.blake@projectaon.org>
Date: Tue, 13 Nov 2012 18:46:57 +0000
Subject: [PATCH] added the "puzzle" and "deadend" elements

git-svn-id: https://projectaon.org/data/trunk@2165 f6f3e2d7-ff33-0410-aaf5-b4bee2cdac11
---
 en/xml/gamebook.dtd | 56 +++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 54 insertions(+), 2 deletions(-)

diff --git a/en/xml/gamebook.dtd b/en/xml/gamebook.dtd
index f360d1a..e3b2fed 100644
--- a/en/xml/gamebook.dtd
+++ b/en/xml/gamebook.dtd
@@ -11,6 +11,9 @@ more general utility.
 
 Change Log:
 
+13 November 2012 (version 0.13.3)
+ * added the "puzzle" and "deadend" elements
+
 24 May 2011 (version 0.13.2)
  * added the "relationship" attribute to the "creator" and "contributor"
    elements
@@ -189,7 +192,7 @@ III. Block Elements
 
 <!ENTITY % inline.content "#PCDATA | a | bookref | footref | em | strong | thought | foreign | quote | cite | code | line | br | typ | onomatopoeia | spell | item | %character.content;">
 
-<!ENTITY % block.content "p | ul | ol | dl | table | blockquote | illustration | combat | choice | hr | illref | poetry">
+<!ENTITY % block.content "p | ul | ol | dl | table | blockquote | illustration | combat | choice | puzzle | deadend | hr | illref | poetry">
 
 <!ENTITY % mixed.content "choose | signpost">
 
@@ -490,7 +493,7 @@ order to create more complex data representations.
 
 A "section" element can used as a linking element. The most useful way 
 to utilize this is to make it a named anchor and thus the target of a 
-"choice" element.
+"choice" or "puzzle" element.
 
 Examples:
 
@@ -1138,6 +1141,55 @@ Example:
 
 -->
 
+<!ELEMENT puzzle ( %inline.content; | %mixed.content; )*>
+<!ATTLIST puzzle
+          %core.attributes;
+          %link.attributes;
+          idrefs IDREFS #IMPLIED
+>
+<!--
+
+The "puzzle" element contains the text describing the action of
+proceeding to the section that is the answer for a puzzle or riddle
+presented elsewhere within the section. It's a linking element and
+therefore can link to the place to which the correct answer to the
+puzzle leads. In the case that the puzzle has multiple solutions, use a
+space separated list of IDs in the "idrefs" attribute. This link
+information should not generally be presented to the reader.
+
+Examples:
+
+ <section id="section12" . . .> . . . </section>
+ . . .
+ <puzzle idref="section12">If you know the answer to her riddle, turn to
+ the entry of that number.</puzzle>
+
+
+ <section id="section23" . . .> . . . </section>
+ . . .
+ <section id="section350" . . .> . . . </section>
+ . . .
+ <puzzle idrefs="section23 section350">If you know only one of the two
+ correct numbers that you need to open the lock, turn to the entry of
+ that number.</puzzle>
+
+-->
+
+<!ELEMENT deadend ( %inline.content; | %mixed.content; )*>
+<!ATTLIST deadend
+          %core.attributes;
+>
+<!--
+
+The "deadend" element contains the text describing the fact that an
+adventure has come to an end (e.g. the character has died).
+
+Example:
+
+ <deadend>Tragically, your life ends here.</deadend>
+
+-->
+
 <!ELEMENT illustration ( meta?, instance+ )>
 <!ATTLIST illustration
           %core.attributes;
-- 
2.17.1