blob: d85a62275860b86801c755023bb7b1af76222d1a [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "">
<!-- /*******************************************************************************
* Copyright (c) 2000, 2005 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/ -->
<link rel="stylesheet" type="text/css" href="../../org.eclipse.wst.doc.user/common.css" />
<title>Generate an XML file from a DTD</title>
<body id="tcrexdtd"><a name="tcrexdtd"><!-- --></a>
<h1 class="topictitle1">Generating XML files from DTDs</h1>
<div><p>You can generate an XML file from your DTD if you want to quickly
create an XML file based on your DTD file. Generating an XML file from your
DTD saves you time by creating an XML file that is already associated with
your DTD, and contains at least some of the elements and attributes in your
<div class="section"><p>After you have generated your XML file, you can further customize
it in the XML editor.</p>
<p>The following instructions were written for the Resource
perspective, but they will also work in many other perspectives.</p>
create an XML file from a DTD file follow these steps:</p>
<ol><li class="skipspace"><span>In the Navigator view, right-click the DTD file that you want to
work with.</span></li>
<li class="skipspace"><span>From its pop-up menu click <b> <span class="menucascade"><span class="uicontrol">Generate</span> &gt; <span class="uicontrol">XML File</span></span></b>.</span></li>
<li class="skipspace"><span>Select a project or folder to contain the XML file and type a name
for it.</span> The name of the file must end in <kbd class="userinput">.xml</kbd>.</li>
<li class="skipspace"><span>Click <b> <span class="uicontrol">Next</span></b>.</span></li>
<li class="skipspace"><span>Select the <b> <span class="uicontrol">Root element</span>
</b>of the XML file.</span> The root element of an XML file is the element that contains all other
elements in that file. All the elements that you have defined in the DTD will
be shown in the<span class="uicontrol">Root element</span> list.</li>
<li class="skipspace"><span>Select from the following content options: </span><ul><li>
<b><span class="uicontrol">Create optional attributes</span> </b>- Both
mandatory and optional attributes will be generated.</li>
<li><b><span class="uicontrol">Create optional elements</span> </b>- Both
mandatory and optional elements will be generated.</li>
<li><b><span class="uicontrol">Create first choice of required choice</span></b> -
The first option of a required choice will be generated in your XML file.</li>
<li><b><span class="uicontrol">Fill elements and attributes with data</span></b> - any
elements and attributes generated will be filled with sample data.</li>
<p>If you do not select any of these options, then only the minimum
amount of content required for the XML file will be created.</p>
<li class="skipspace"><span>Specify the <b> <span class="uicontrol">Public ID</span></b> or
<b> <span class="uicontrol">System
ID</span>.</b></span> You do not need to specify both. If you do, the Public ID will
be used before the System ID. </li>
<li class="skipspace"><span>Click <b> <span class="uicontrol">Finish</span></b>.</span></li>
<div class="skipspace">
XML file will only contain the selected root element and any elements or attributes
contained in the root element. You can now add elements, attributes, entities,
and notations to the XML file, however, they must follow the rules established
in the DTD that you used to create the XML file.</p>
<div><p><b class="relconceptshd">Related concepts</b><br />
<a href="../topics/cwxmledt.html" title="The XML editor is a tool for creating and viewing XML files">XML editor</a><br />
<p><b class="reltaskshd">Related tasks</b><br />
<a href="../topics/tcretxml.html" title="You can create a new empty XML file, which you can then edit in the XML editor.">Creating an XML file from scratch</a><br />
<a href="../topics/tcrexxsd.html" title="Generating an XML file from an XML schema">Generating an XML file from an XML schema</a><br />
<a href="../topics/txedttag.html" title="Editing XML files">Editing XML files</a><br />