home *** CD-ROM | disk | FTP | other *** search
/ Internet Magazine 2003 Autumn / INTERNET109.ISO / pc / software / windows / building / xmlspy / xmlspyentcomplete5.exe / Data1.cab / _99E0280EBBCC4CDFA2884302E5F69D79 < prev    next >
Encoding:
Extensible Markup Language  |  2003-01-16  |  4.6 KB  |  102 lines
  1. <?xml version="1.0" encoding="iso-8859-1"?>
  2. <!--Common DITA topic to HTML application by IBM Corp., 2001, 2002-->
  3. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  4. <html lang="en-US">
  5.     <head>
  6.         <meta http-equiv="generator" content="IBM Darwin Information Typing Architecture topic-to-html transform" />
  7.         <meta name="copyright" content="(C) Copyright IBM Corp. 1994, 2002" />
  8.         <meta name="security" content="public" />
  9.         <link rel="stylesheet" type="text/css" href="common.css" />
  10.         <title>DITA Readme</title>
  11.     </head>
  12.     <body class="base">
  13.         <a name="readmetop" />
  14.         <h1 class="topictitle1">DITA Readme</h1>
  15.         <div>
  16.             <p>This document describes the package content, change history, and some release notes for the package called "dita10.zip" on developerWorks.</p>
  17.         </div>
  18.         <div class="nested1">
  19.             <a name="install" />
  20.             <a name="d3e11">á</a>
  21.             <h2 class="topictitle2">Installing DITA</h2>
  22.             <div>
  23.                 <p>Please read and understand the <a href="..\license.txt">IBM Darwin Information Typing Architecture Specification Agreement</a>.</p>
  24.                 <p>The DITA package has the following directory structure:</p>
  25.                 <pre>dita
  26.   css
  27.   docs
  28.     images
  29.   dtd
  30.   xsl</pre>
  31.                 <p>Use an unzip tool to extract the package into a location of your choice. </p>
  32.             </div>
  33.         </div>
  34.         <div class="nested1">
  35.             <a name="using" />
  36.             <a name="d3e26">á</a>
  37.             <h2 class="topictitle2">Using DITA stylesheets</h2>
  38.             <div>
  39.                 <div>These are examples of command-line invocations of popular XSLT engines to produce this particular document (<cite>DITA-readme.xml</cite>) as an HTML result:<div class="figborder">
  40.                         <br />
  41.                         <div>
  42.                             <strong>Figure 1. Sample processing invocations</strong>
  43.                         </div>
  44.                         <a name="using__xsltinvoke" />
  45.                         <dl>
  46.                             <dt>
  47.                                 <b>using Xalan-Java/ LotusXSL-Java:</b>
  48.                             </dt>
  49.                             <dd>
  50.                                 <pre style="font-size: 80%;">c:\pkg\dita\docs>java org.apache.xalan.xslt.Process -in DITA-readme.xml -xsl ..\xsl\topic2html.xsl -out DITA-readme.html
  51. </pre>
  52.                             </dd>
  53.                             <dt>
  54.                                 <b>using Xalan-C++/ LotusXSL-C++:</b>
  55.                             </dt>
  56.                             <dd>
  57.                                 <pre style="font-size: 90%;">c:\pkg\dita\docs>testXSLT -in DITA-readme.xml -xsl ..\xsl\topic2html.xsl -out DITA-readme.html
  58. </pre>
  59.                             </dd>
  60.                             <dt>
  61.                                 <b>using saxon:</b>
  62.                             </dt>
  63.                             <dd>
  64.                                 <pre style="font-size: 90%;">C:\pkg\dita\docs>saxon DITA-readme.xml ..\xsl\topic2html.xsl > DITA-readme.html
  65. </pre>
  66.                             </dd>
  67.                             <dt>
  68.                                 <b>using xt:</b>
  69.                             </dt>
  70.                             <dd>
  71.                                 <pre style="font-size: 90%;">C:\pkg\dita\docs>xt DITA-readme.xml ..\xsl\topic2html.xsl > DITA-readme.html
  72. </pre>
  73.                             </dd>
  74.                         </dl>
  75.                     </div>
  76.                 </div>
  77.             </div>
  78.         </div>
  79.         <div class="nested1">
  80.             <a name="changes" />
  81.             <a name="d3e65">á</a>
  82.             <h2 class="topictitle2">Changes for this release</h2>
  83.             <div>
  84.                 <p>Following the initial public distribution of DITA in March 2000, IBM's "XML Workgroup" has been using the tools in several significant prototypes.  Based on feedback both from external forums and these prototype activities, the Workgroup  provided some updates to the DITA tools in an October 2001 package called dita01.zip.</p>
  85.                 <p>The current release is the result of a series of reviews and usability studies that have lead to a number of new or better understood design features.  The most succinct description of these is in the Introduction to the Darwin Information Typing Architecture article, under the heading "Main features of the DITA architecture."</p>
  86.             </div>
  87.         </div>
  88.         <div class="nested1">
  89.             <a name="closing" />
  90.             <a name="d3e73">á</a>
  91.             <h2 class="topictitle2">Important closing words...</h2>
  92.             <div>
  93.                 <p>The wisdom in the <a href="..\license.txt">IBM Darwin Information Typing Architecture Specification Agreement</a> included with this package is very important.  The DITA design is progressing, but still quite evolutionary.    It is possible that documents created with the current version of these DTDs will need to be modified to work with future versions of the DTDs. The DITA team encourages you to use the dtds and tools and to help us advance the design, with the understanding that this package  is unsupported.  As with any new technology, always do an appropriate risk assessment and ensure that you have a backup plan. </p>
  94.                 <p>Now, specialize away!</p>
  95.                 <pre style="font-family: sans-serif;">Don Day
  96. <a href="mailto:dond@us.ibm.com">dond@us.ibm.com</a>
  97. IBM Corporation, Austin, Texas</pre>
  98.             </div>
  99.         </div>
  100.     </body>
  101. </html>
  102.