Gitiles
Code Review Sign In
git.eclipse.org / sourceediting / webtools.sourceediting / bd19ea5c631110c54ed0e462286894284a13f1d5 / . / docs / org.eclipse.wst.xmleditor.doc.user / topics / twmacro.html
blob: cd16ee400b3710b7132633992545ebe42c7a9d49 [file] [log] [blame]
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]1<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html lang="en-us" xml:lang="en-us">
syeshinbefd53e2005-07-27 18:16:40 +0000[diff] [blame]3<head>
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]4<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
kpriceb59c9f62008-04-02 21:24:37 +0000[diff] [blame]5<meta name="copyright" content="Copyright (c) 2000, 2008 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 http://www.eclipse.org/legal/epl-v10.html. Contributors: IBM Corporation - initial API and implementation" />
6<meta name="DC.rights.owner" content="(C) Copyright 2000, 2008" />
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]7<meta content="public" name="security" />
8<meta content="index,follow" name="Robots" />
9<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
10<meta content="task" name="DC.Type" />
11<meta name="DC.Title" content="Working with XML templates" />
kpriceb59c9f62008-04-02 21:24:37 +0000[diff] [blame]12<meta name="abstract" content="XML content assist provides a comment template, a section of predefined code that you can insert into a file. You may find a template useful when you have a certain piece of code you want to reuse several times, and you do not want to write it out every time." />
13<meta name="description" content="XML content assist provides a comment template, a section of predefined code that you can insert into a file. You may find a template useful when you have a certain piece of code you want to reuse several times, and you do not want to write it out every time." />
14<meta content="XML templates, working with predefined code" name="DC.subject" />
15<meta content="XML templates, working with predefined code" name="keywords" />
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]16<meta scheme="URI" name="DC.Relation" content="../topics/txedtsrc.html" />
17<meta scheme="URI" name="DC.Relation" content="../topics/twcdast.html" />
18<meta content="XHTML" name="DC.Format" />
19<meta content="twmacro" name="DC.Identifier" />
20<meta content="en-us" name="DC.Language" />
21<link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" />
syeshinbefd53e2005-07-27 18:16:40 +0000[diff] [blame]22<title>Working with XML templates</title>
syeshin66078272005-09-20 16:53:38 +0000[diff] [blame]23</head>
syeshinbefd53e2005-07-27 18:16:40 +0000[diff] [blame]24<body id="twmacro"><a name="twmacro"><!-- --></a>
25
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]26
syeshinbefd53e2005-07-27 18:16:40 +0000[diff] [blame]27<h1 class="topictitle1">Working with XML templates</h1>
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]28
29
30
31
kpriceb59c9f62008-04-02 21:24:37 +0000[diff] [blame]32<div><p>XML content assist provides a comment template, a section of predefined
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]33code that you can insert into a file. You may find a template useful when
34you have a certain piece of code you want to reuse several times, and you
35do not want to write it out every time.</p>
36
37<div class="section"><p>You can use a default template as provided, customize that template,
38or create your own templates.</p>
kpriceb59c9f62008-04-02 21:24:37 +0000[diff] [blame]39<p>For example, you can work on a group of
40XML pages that should all contain a table with a specific appearance. Create
41a template that contains the tags for that table, including the appropriate
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]42attributes and attribute values for each tag. (You can copy and paste the
43tags from a structured text editor into the template's <span class="uicontrol">Pattern</span> field.)
44Then select the name of the template from a content assist proposal list whenever
kpriceb59c9f62008-04-02 21:24:37 +0000[diff] [blame]45you want to insert your custom table into an XML file.</p>
46<p>To create a new
47XML template, complete the following steps:</p>
syeshinbefd53e2005-07-27 18:16:40 +0000[diff] [blame]48</div>
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]49
50<ol>
51<li class="stepexpand"><span>Click <span class="menucascade"><span class="uicontrol">Window</span> &gt; <span class="uicontrol">Preferences</span>
kpriceb59c9f62008-04-02 21:24:37 +0000[diff] [blame]52</span> and select <span class="menucascade"><span class="uicontrol">XML</span> &gt; <span class="uicontrol">XML
53Files</span> &gt; <span class="uicontrol">Templates</span></span>.</span></li>
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]54
55<li class="stepexpand"><span>Click <span class="uicontrol">New</span> if you want to create a completely
syeshinbefd53e2005-07-27 18:16:40 +0000[diff] [blame]56new template.</span></li>
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]57
58<li class="stepexpand"><span>Supply a new template <span class="uicontrol">Name</span> and <span class="uicontrol">Description</span>.</span>
59</li>
60
61<li class="stepexpand"><span>Specify the <span class="uicontrol">Context</span> for the template.</span>
62 This is the context in which the template is available in the proposal
syeshinbefd53e2005-07-27 18:16:40 +0000[diff] [blame]63list when content assist is requested. </li>
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]64
65<li class="stepexpand"><span>Specify the <span class="uicontrol">Pattern</span> for your template using
syeshind0bdb8e2005-10-27 17:44:14 +0000[diff] [blame]66the appropriate tags, attributes, or attribute values to be inserted by content
67assist.</span></li>
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]68
69<li class="stepexpand"><span>If you want to insert a variable, click the <span class="uicontrol">Insert Variable</span> button
70and select the variable to be inserted. </span> For example, the <strong>date</strong> variable
71indicates the current date will be inserted. </li>
72
kpriceb59c9f62008-04-02 21:24:37 +0000[diff] [blame]73<li class="stepexpand"><span>Click <span class="uicontrol">OK</span> and then <span class="uicontrol">Apply</span> to
syeshinbefd53e2005-07-27 18:16:40 +0000[diff] [blame]74save your changes.</span></li>
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]75
syeshinbefd53e2005-07-27 18:16:40 +0000[diff] [blame]76</ol>
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]77
78<div class="section">You can edit, remove, import, or export a template by using the same
79preferences page. If you have modified a default template, you can restore
syeshinbefd53e2005-07-27 18:16:40 +0000[diff] [blame]80it to its default value. You can also restore a removed template if you have
81not exited from the workbench since it was removed. <p>If you have a template
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]82that you do not want to remove but you no longer want it to appear in the
kpriceb59c9f62008-04-02 21:24:37 +0000[diff] [blame]83content assist list, clear its check box in the table on the Templates preferences
84page.</p>
syeshinbefd53e2005-07-27 18:16:40 +0000[diff] [blame]85</div>
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]86
87</div>
88
syeshind0bdb8e2005-10-27 17:44:14 +0000[diff] [blame]89<div><div class="reltasks"><strong>Related tasks</strong><br />
90<div><a href="../topics/txedtsrc.html" title="You can use the Source view to view and work with a file's source code directly.">Editing in the Source view</a></div>
91<div><a href="../topics/twcdast.html" title="You can use content assist to help you finish a tag or line of code in the Source view of the XML editor. You can also use content assist to insert templates into your XML code.">Using XML content assist</a></div>
syeshinbefd53e2005-07-27 18:16:40 +0000[diff] [blame]92</div>
kpriceef160682006-08-29 18:08:31 +0000[diff] [blame]93</div>
94
95</body>
syeshinbefd53e2005-07-27 18:16:40 +0000[diff] [blame]96</html>