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