blob: 2728d0512c0147f2f608e6ff5ddb28cd08f3f0e9 [file] [log] [blame]
kprice159fa582006-05-08 21:30:45 +00001<?xml version="1.0" encoding="utf-8"?>
2<!--Arbortext, Inc., 1988-2005, v.4002-->
kprice647b7352006-05-17 21:27:16 +00003<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN"
4 "task.dtd">
5<?Pub Inc?>
kprice159fa582006-05-08 21:30:45 +00006<task id="taddnot" xml:lang="en-us">
7<title>Adding notations</title>
9<searchtitle>Adding notations</searchtitle>
11<shortdesc>A notation is a means of associating a binary description with
12an entity or attribute. The most common uses of notations are to include familiar
13types of binary references, such as GIFs and JPGs, in an XML file.</shortdesc>
kprice9623e9d2007-05-03 03:43:05 +000015<keywords><indexterm>XML schema editor<indexterm>notations</indexterm></indexterm>
16<indexterm>XML schema files<indexterm>notations</indexterm></indexterm>
kprice159fa582006-05-08 21:30:45 +000017</keywords>
20<context><p>For example, you are making a catalogue of your clothing and want
21to include an image of one of your shirts. You would have to create a notation
22like this: <userinput>&lt;notation name="My_Shirt" system="GIF">&lt;/notation></userinput> which
23defines a notation for a GIF image.</p><p>The following instructions were
24written for the Resource perspective, but they will also work in many other
25perspectives.</p><p>To create a notation, follow these steps:</p></context>
27<step><cmd>Open your XML schema in the XML schema editor.</cmd></step>
28<step><cmd>In the Outline view, right-click your XML schema and click <uicontrol>Add
30<step><cmd>In the Properties view, type the name of the notation in the <uicontrol>Name</uicontrol> field.</cmd>
32<step><cmd>Click the <uicontrol>Other</uicontrol> tab.</cmd></step>
33<step><cmd>In the <uicontrol>public</uicontrol> field, type a public identifier.</cmd>
34<info> This is optional if you enter a value in the <uicontrol>system</uicontrol> field.</info>
36<step><cmd>In the <uicontrol>system</uicontrol> field, type a URI reference.</cmd>
37<info> This is optional if you enter a value in the <uicontrol>public</uicontrol> field.</info>
39<step><cmd>Click the <uicontrol>Documentation</uicontrol> tab if you want
40to provide any information about this notation.</cmd><info>The <uicontrol>Documentation</uicontrol> page
kprice647b7352006-05-17 21:27:16 +000041is used for human readable material, such as a description. <uicontrol>App
kprice159fa582006-05-08 21:30:45 +000042Info</uicontrol> page can be used to provide information for applications.</info>
kprice647b7352006-05-17 21:27:16 +000044<step><cmd>Click the <uicontrol>Extensions</uicontrol> tab if you want to
45add application information elements to your annotations of schema components.</cmd>
46<info>The <uicontrol>Extensions</uicontrol> page allows you to specify the
kprice9623e9d2007-05-03 03:43:05 +000047schema and add XML content to your annotations.</info></step>
kprice159fa582006-05-08 21:30:45 +000048</steps>
kprice647b7352006-05-17 21:27:16 +000051<?Pub *0000002959?>