home *** CD-ROM | disk | FTP | other *** search
/ PC Professionell 2004 December / PCpro_2004_12.ISO / files / webserver / xampp / xampp-cocoon-addon-1.4.9-installer.exe / document-v11.mod < prev    next >
Encoding:
Text File  |  2004-07-12  |  13.9 KB  |  425 lines
  1. <!--
  2.   Copyright 2002-2004 The Apache Software Foundation
  3.  
  4.   Licensed under the Apache License, Version 2.0 (the "License");
  5.   you may not use this file except in compliance with the License.
  6.   You may obtain a copy of the License at
  7.  
  8.       http://www.apache.org/licenses/LICENSE-2.0
  9.  
  10.   Unless required by applicable law or agreed to in writing, software
  11.   distributed under the License is distributed on an "AS IS" BASIS,
  12.   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13.   See the License for the specific language governing permissions and
  14.   limitations under the License.
  15. -->
  16. <!-- ===================================================================
  17.  
  18.      Apache Common Documentation elements (Version 1.1)
  19.  
  20. PURPOSE:
  21.   This DTD was developed to create a simple yet powerful document
  22.   type for software documentation for use with the Apache projects.
  23.   It has now been superceded by v1.2.
  24.  
  25. TYPICAL INVOCATION:
  26.  
  27.   <!ENTITY % document PUBLIC
  28.       "-//APACHE//ENTITIES Documentation V1.1//EN"
  29.       "document-v11.mod">
  30.   %document;
  31.  
  32.   where
  33.  
  34.     x := major version
  35.     y := minor version
  36.  
  37. NOTES:
  38.  
  39. FIXME:
  40.  
  41. CHANGE HISTORY:
  42. [Version 1.0]
  43.   20020608 Initial version. (SN)
  44.  
  45. ==================================================================== -->
  46. <!-- =============================================================== -->
  47. <!-- Useful entities for increased DTD readability -->
  48. <!-- =============================================================== -->
  49. <!ENTITY % text "#PCDATA">
  50. <!-- Entities referred to later on are defined up front -->
  51. <!ENTITY % markup "strong|em|code|sub|sup">
  52. <!ENTITY % special-inline "br|img|icon|acronym">
  53. <!ENTITY % links "link|jump|fork">
  54. <!ENTITY % paragraphs "p|source|note|warning|fixme">
  55. <!ENTITY % tables "table">
  56. <!ENTITY % lists "ol|ul|dl">
  57. <!ENTITY % special-blocks "figure|anchor">
  58. <!-- =============================================================== -->
  59. <!-- Entities for general XML compliance -->
  60. <!-- =============================================================== -->
  61. <!-- Common attributes
  62.         Every element has an ID attribute (sometimes required,
  63.         but usually optional) for links. %common.att;
  64.         is for common attributes where the ID is optional, and
  65.         %common-idreq.att; is for common attributes where the
  66.         ID is required.
  67. -->
  68. <!ENTITY % common.att 'id                     ID              #IMPLIED
  69.          xml:lang               NMTOKEN         #IMPLIED'>
  70. <!ENTITY % common-idreq.att 'id                     ID              #REQUIRED
  71.          xml:lang               NMTOKEN         #IMPLIED'>
  72. <!-- xml:space attribute ===============================================
  73.         Indicates that the element contains white space
  74.         that the formatter or other application should retain,
  75.         as appropriate to its function.
  76. ==================================================================== -->
  77. <!ENTITY % xmlspace.att 'xml:space (default|preserve) #FIXED "preserve"'>
  78. <!-- def attribute =====================================================
  79.         Points to the element where the relevant definition can be
  80.         found, using the IDREF mechanism.  %def.att; is for optional
  81.         def attributes, and %def-req.att; is for required def
  82.         attributes.
  83. ==================================================================== -->
  84. <!ENTITY % def.att 'def                    IDREF           #IMPLIED'>
  85. <!ENTITY % def-req.att 'def                    IDREF           #REQUIRED'>
  86. <!-- ref attribute =====================================================
  87.         Points to the element where more information can be found,
  88.         using the IDREF mechanism.  %ref.att; is for optional
  89.         ref attributes, and %ref-req.att; is for required ref
  90.         attributes.
  91. ================================================================== -->
  92. <!ENTITY % ref.att 'ref                    IDREF           #IMPLIED'>
  93. <!ENTITY % ref-req.att 'ref                    IDREF           #REQUIRED'>
  94. <!-- =============================================================== -->
  95. <!-- Entities for general usage -->
  96. <!-- =============================================================== -->
  97. <!-- Key attribute =====================================================
  98.         Optionally provides a sorting or indexing key, for cases when
  99.         the element content is inappropriate for this purpose.
  100. ==================================================================== -->
  101. <!ENTITY % key.att 'key                    CDATA           #IMPLIED'>
  102. <!-- Title attributes ==================================================
  103.         Indicates that the element requires to have a title attribute.
  104. ==================================================================== -->
  105. <!ENTITY % title.att 'title                  CDATA           #REQUIRED'>
  106. <!-- Name attributes ==================================================
  107.         Indicates that the element requires to have a name attribute.
  108. ==================================================================== -->
  109. <!ENTITY % name.att 'name                   CDATA           #REQUIRED'>
  110. <!-- Email attributes ==================================================
  111.         Indicates that the element requires to have an email attribute.
  112. ==================================================================== -->
  113. <!ENTITY % email.att 'email                  CDATA           #REQUIRED'>
  114. <!-- Link attributes ===================================================
  115.         Indicates that the element requires to have hyperlink attributes.
  116. ==================================================================== -->
  117. <!ENTITY % link.att 'href      CDATA                         #IMPLIED
  118.          role      CDATA                         #IMPLIED
  119.          title     CDATA                         #IMPLIED '>
  120. <!-- =============================================================== -->
  121. <!-- General definitions -->
  122. <!-- =============================================================== -->
  123. <!-- A person is a general unparsed human entity -->
  124. <!ELEMENT person EMPTY>
  125. <!ATTLIST person
  126.   %common.att; 
  127.   %name.att; 
  128.   %email.att; 
  129. >
  130. <!-- =============================================================== -->
  131. <!-- Content definitions -->
  132. <!-- =============================================================== -->
  133. <!ENTITY % local.inline "">
  134. <!ENTITY % link-content.mix "%text;|%markup;|%special-inline; %local.inline;">
  135. <!ENTITY % content.mix "%link-content.mix;|%links;">
  136. <!-- ==================================================== -->
  137. <!-- Phrase Markup -->
  138. <!-- ==================================================== -->
  139. <!-- Strong (typically bold) -->
  140. <!ELEMENT strong (%text; | code)*>
  141. <!ATTLIST strong
  142.   %common.att; 
  143. >
  144. <!-- Emphasis (typically italic) -->
  145. <!ELEMENT em (%text; | code)*>
  146. <!ATTLIST em
  147.   %common.att; 
  148. >
  149. <!-- Code (typically monospaced) -->
  150. <!ELEMENT code (%text;)>
  151. <!ATTLIST code
  152.   %common.att; 
  153. >
  154. <!-- Superscript (typically smaller and higher) -->
  155. <!ELEMENT sup (%text;)>
  156. <!ATTLIST sup
  157.   %common.att; 
  158. >
  159. <!-- Subscript (typically smaller and lower) -->
  160. <!ELEMENT sub (%text;)>
  161. <!ATTLIST sub
  162.   %common.att; 
  163. >
  164. <!-- ==================================================== -->
  165. <!-- Hypertextual Links -->
  166. <!-- ==================================================== -->
  167. <!-- hyperlink (equivalent of <a ...>) -->
  168. <!ELEMENT link (%link-content.mix;)*>
  169. <!ATTLIST link
  170.   %common.att; 
  171.   %link.att; 
  172. >
  173. <!-- windows-replacing link (equivalent of <a ... target="_top">) -->
  174. <!ELEMENT jump (%link-content.mix;)*>
  175. <!ATTLIST jump
  176.   %common.att; 
  177.   %link.att; 
  178. >
  179. <!-- window-forking link (equivalent of <a ... target="_blank">) -->
  180. <!ELEMENT fork (%link-content.mix;)*>
  181. <!ATTLIST fork
  182.   %common.att; 
  183.   %link.att; 
  184. >
  185.  
  186. <!-- ==================================================== -->
  187. <!-- Specials -->
  188. <!-- ==================================================== -->
  189. <!-- Breakline Object (typically forces line break) -->
  190. <!ELEMENT br EMPTY>
  191. <!ATTLIST br
  192.   %common.att; 
  193. >
  194. <!-- Image Object (typically an inlined image) -->
  195. <!ELEMENT img EMPTY>
  196. <!ATTLIST img
  197.   src CDATA #REQUIRED
  198.   alt CDATA #REQUIRED
  199.   height CDATA #IMPLIED
  200.   width CDATA #IMPLIED
  201.   usemap CDATA #IMPLIED
  202.   ismap (ismap) #IMPLIED
  203.   %common.att; 
  204. >
  205. <!-- Image Icon (typically an inlined image placed as graphical item) -->
  206. <!ELEMENT icon EMPTY>
  207. <!ATTLIST icon
  208.   src CDATA #REQUIRED
  209.   alt CDATA #REQUIRED
  210.   height CDATA #IMPLIED
  211.   width CDATA #IMPLIED
  212.   %common.att; 
  213. >
  214. <!-- Acronym (in modern browsers, will have rollover text) -->
  215. <!ELEMENT acronym (%text;)*>
  216. <!ATTLIST acronym
  217.   title CDATA #REQUIRED
  218.   %common.att; 
  219. >
  220.  
  221. <!-- =============================================================== -->
  222. <!-- Blocks definitions -->
  223. <!-- =============================================================== -->
  224. <!ENTITY % local.blocks "">
  225. <!ENTITY % blocks "%paragraphs;|%tables;|%lists;|%special-blocks; %local.blocks;">
  226. <!-- ==================================================== -->
  227. <!-- Paragraphs -->
  228. <!-- ==================================================== -->
  229. <!-- Text Paragraph (normally vertically space delimited. Space can be preserved.) -->
  230. <!ELEMENT p (%content.mix;)*>
  231. <!ATTLIST p
  232.   %common.att; 
  233.   xml:space (default|preserve) #IMPLIED
  234. >
  235. <!-- Source Paragraph (normally space is preserved) -->
  236. <!ELEMENT source (%content.mix;)*>
  237. <!ATTLIST source
  238.   %common.att; 
  239.   %xmlspace.att; 
  240. >
  241. <!-- Note Paragraph (normally shown encapsulated) -->
  242. <!ELEMENT note (%content.mix;)*>
  243. <!ATTLIST note
  244.   %common.att; 
  245. >
  246. <!-- Warning Paragraph (normally shown with eye-catching colors) -->
  247. <!ELEMENT warning (%content.mix;)*>
  248. <!ATTLIST warning
  249.   %common.att; 
  250. >
  251. <!-- Fixme Paragraph (normally not shown) -->
  252. <!ELEMENT fixme (%content.mix;)*>
  253. <!ATTLIST fixme
  254.   author CDATA #REQUIRED
  255.   %common.att; 
  256. >
  257. <!-- ==================================================== -->
  258. <!-- Tables -->
  259. <!-- ==================================================== -->
  260. <!-- Attributes that indicate the spanning of the table cell -->
  261. <!ENTITY % cell.span 'colspan CDATA "1"
  262.          rowspan CDATA "1"'>
  263. <!-- Table element -->
  264. <!ELEMENT table (caption?, tr+)>
  265. <!ATTLIST table
  266.   %common.att; 
  267. >
  268. <!-- The table title -->
  269. <!ELEMENT caption (%content.mix;)*>
  270. <!ATTLIST caption
  271.   %common.att; 
  272. >
  273. <!-- The table row element -->
  274. <!ELEMENT tr (th | td)+>
  275. <!ATTLIST tr
  276.   %common.att; 
  277. >
  278. <!-- The table row header element -->
  279. <!ELEMENT th (%content.mix;)*>
  280. <!ATTLIST th
  281.   %common.att; 
  282.   %cell.span; 
  283. >
  284. <!-- The table row description element -->
  285. <!ELEMENT td (%content.mix;)*>
  286. <!ATTLIST td
  287.   %common.att; 
  288.   %cell.span; 
  289. >
  290. <!-- ==================================================== -->
  291. <!-- Lists -->
  292. <!-- ==================================================== -->
  293. <!-- List item -->
  294. <!ELEMENT li (%content.mix; | %lists;)*>
  295. <!ATTLIST li
  296.   %common.att; 
  297. >
  298. <!-- Unordered list (typically bulleted) -->
  299. <!ELEMENT ul (li | %lists;)+>
  300. <!--    spacing attribute:
  301.             Use "normal" to get normal vertical spacing for items;
  302.             use "compact" to get less spacing.  The default is dependent
  303.             on the stylesheet. -->
  304. <!ATTLIST ul
  305.   %common.att; 
  306.   spacing (normal | compact) #IMPLIED
  307. >
  308. <!-- Ordered list (typically numbered) -->
  309. <!ELEMENT ol (li | %lists;)+>
  310. <!--    spacing attribute:
  311.             Use "normal" to get normal vertical spacing for items;
  312.             use "compact" to get less spacing.  The default is dependent
  313.             on the stylesheet. -->
  314. <!ATTLIST ol
  315.   %common.att; 
  316.   spacing (normal | compact) #IMPLIED
  317. >
  318. <!-- Definition list (typically two-column) -->
  319. <!ELEMENT dl (dt, dd)+>
  320. <!ATTLIST dl
  321.   %common.att; 
  322. >
  323. <!-- Definition term -->
  324. <!ELEMENT dt (%content.mix;)*>
  325. <!ATTLIST dt
  326.   %common.att; 
  327. >
  328. <!-- Definition description -->
  329. <!ELEMENT dd (%content.mix;)*>
  330. <!ATTLIST dd
  331.   %common.att; 
  332. >
  333. <!-- ==================================================== -->
  334. <!-- Special Blocks -->
  335. <!-- ==================================================== -->
  336. <!-- Image Block (typically a separated and centered image) -->
  337. <!ELEMENT figure EMPTY>
  338. <!ATTLIST figure
  339.   src CDATA #REQUIRED
  340.   alt CDATA #REQUIRED
  341.   height CDATA #IMPLIED
  342.   width CDATA #IMPLIED
  343.   usemap CDATA #IMPLIED
  344.   ismap (ismap) #IMPLIED
  345.   %common.att; 
  346. >
  347. <!-- anchor point (equivalent of <a name="...">, typically not rendered) -->
  348. <!ELEMENT anchor EMPTY>
  349. <!ATTLIST anchor
  350.   %common-idreq.att; 
  351. >
  352. <!-- =============================================================== -->
  353. <!-- Document -->
  354. <!-- =============================================================== -->
  355. <!ELEMENT document (header, body, footer?)>
  356. <!ATTLIST document
  357.   %common.att; 
  358. >
  359. <!-- ==================================================== -->
  360. <!-- Header -->
  361. <!-- ==================================================== -->
  362. <!ENTITY % local.headers "">
  363. <!ELEMENT header (title, subtitle?, version?, type?, authors?,
  364.                       notice*, abstract? %local.headers;)>
  365. <!ATTLIST header
  366.   %common.att; 
  367. >
  368. <!ELEMENT title (%text; | %markup;)*>
  369. <!ATTLIST title
  370.   %common.att; 
  371. >
  372. <!ELEMENT subtitle (%text; | %markup;)*>
  373. <!ATTLIST subtitle
  374.   %common.att; 
  375. >
  376. <!ELEMENT version (%text;)>
  377. <!ATTLIST version
  378.   %common.att;
  379.   major CDATA #IMPLIED
  380.   minor CDATA #IMPLIED
  381.   fix CDATA #IMPLIED
  382.   tag CDATA #IMPLIED
  383. >
  384. <!ELEMENT type (%text;)>
  385. <!ATTLIST type
  386.   %common.att; 
  387. >
  388. <!ELEMENT authors (person+)>
  389. <!ATTLIST authors
  390.   %common.att; 
  391. >
  392. <!ELEMENT notice (%content.mix;)*>
  393. <!ATTLIST notice
  394.   %common.att; 
  395. >
  396. <!ELEMENT abstract (%content.mix;)*>
  397. <!ATTLIST abstract
  398.   %common.att; 
  399. >
  400. <!-- ==================================================== -->
  401. <!-- Body -->
  402. <!-- ==================================================== -->
  403. <!ENTITY % local.sections "">
  404. <!ENTITY % sections "section %local.sections;">
  405. <!ELEMENT body (%sections; | %blocks;)+>
  406. <!ATTLIST body
  407.   %common.att; 
  408. >
  409. <!ELEMENT section (title, (%sections; | %blocks;)*)>
  410. <!ATTLIST section
  411.   %common.att; 
  412. >
  413. <!-- ==================================================== -->
  414. <!-- Footer -->
  415. <!-- ==================================================== -->
  416. <!ENTITY % local.footers "">
  417. <!ELEMENT footer (legal %local.footers;)>
  418. <!ELEMENT legal (%content.mix;)*>
  419. <!ATTLIST legal
  420.   %common.att; 
  421. >
  422. <!-- =============================================================== -->
  423. <!-- End of DTD -->
  424. <!-- =============================================================== -->
  425.