Resources/XML/thuban-1.0.dtd

<?xml version="1.0" encoding="UTF-8"?>
<!--    thuban-1.0.dtd

    Copyright (C) 2001, 2003 by Intevation GmbH
    Authors:
        Jan-Oliver Wagner <[email protected]>
        Bernhard Herzog <[email protected]>

    This program is free software under the GPL (>=v2)
    Read the file COPYING coming with Thuban for details.

    $Revision$
    $Source$
    $Id$
-->

<!-- a session contains zero or more database connections zero or more
     datasources and and zero or more maps

At some point, the namespace attribute will likely be used by Thuban to
identify the version of the file format. 
-->

<!ENTITY % shapesources "fileshapesource | derivedshapesource | dbshapesource">
<!ENTITY % tables "filetable | jointable">
<!ELEMENT session ((dbconnection | %shapesources; | %tables; )*, map*)>
<!ATTLIST session 
        title CDATA #REQUIRED
        xmlns CDATA #IMPLIED
>


<!--
    A db connection represents the connection to a database.

    Currently only connections to postgis databases are supported and
    thus The dbtype attribute must be "postgis".
-->

<!ELEMENT dbconnection EMPTY>
<!ATTLIST dbconnection
        id     ID    #REQUIRED
        dbtype CDATA #REQUIRED
        dbname CDATA #REQUIRED
        host   CDATA ""
        port   CDATA ""
        user   CDATA ""
>


<!-- A dbshapesource represents a table with geometry data in a database

     The dbconn attribute must be the id of a dbconnection element
     occurring earlier in the document.
-->

<!ELEMENT dbshapesource EMPTY>
<!ATTLIST dbshapesource
        id        ID    #REQUIRED
        dbconn    IDREF #REQUIRED
        tablename CDATA #REQUIRED
>

<!-- 
    A fileshapesource is a source of shapes and perhaps attribute data
    read from a file. The filetype attribute must be one of the
    supported file types. Currently only "shapefile" is supported.
 -->

<!ELEMENT fileshapesource EMPTY>
<!ATTLIST fileshapesource
        id       ID   #REQUIRED
        filename CDATA #REQUIRED
        filetype CDATA #REQUIRED
>

<!--
     A derivedshapesource is a source of shapes and attribute data
    derived from another shapesource for the shapes and a table for the
    attribute data.
 -->

<!ELEMENT derivedshapesource EMPTY>
<!ATTLIST derivedshapesource
        id          ID   #REQUIRED
        shapesource IDREF #REQUIRED
        table       IDREF #REQUIRED
>


<!-- a filetable points to the actual file that
        contains the tabular data.

     The filetype Attribute may be onve of "DBF" or "CSV"
-->
<!ELEMENT filetable EMPTY>
<!ATTLIST filetable 
        id       ID    #REQUIRED
        title    CDATA #REQUIRED
        filename CDATA #REQUIRED
        filetype CDATA #REQUIRED>

<!-- 
    A jointable is a table with the result of something equivalent to
    this SQL Statement:

     SELECT * FROM left JOIN right WHERE left.leftcolumn = right.rightcolumn;

    The attributes left and right must be the ids of two tables defined
    previously in the XML-Document file. leftcolumn and rightcolumn are 
    the column names to join on.

    The jointype attribute should be either "INNER" or "LEFT OUTER".
-->
<!ELEMENT jointable EMPTY>
<!ATTLIST jointable
        id          ID    #REQUIRED
        title       CDATA #REQUIRED
        left        IDREF #REQUIRED
        leftcolumn  CDATA #REQUIRED
        right       IDREF #REQUIRED
        rightcolumn CDATA #REQUIRED
        jointype    CDATA #REQUIRED
>

<!-- A Map

        A map consists of a number of layers
        the projection refers to the projection
        used to display the map. If the projection
        is missing, geographic coordinates in decimal
        degrees are assumed.
-->
<!ELEMENT map (projection?, (layer | rasterlayer)*, labellayer?)>
<!ATTLIST map title CDATA #REQUIRED>

<!-- a layer represents a set of geographic objects.
        pointers to the actual data are stored.
        The shapestore attributes contains the id of the data store
        shown in the layer.
        the projection refers to the projection
        in which the data are stored. If the projection
        is missing, geographic coordinates in decimal
        degrees are assumed. Visibility is assumed true
    unless otherwise specified.
-->
<!ELEMENT layer (projection?, classification?)>
<!ATTLIST layer title CDATA #REQUIRED>
<!ATTLIST layer shapestore IDREF #REQUIRED>
<!ATTLIST layer visible (true|false) "true">
<!-- the fill and stroke attributes can be either "None" or "#RRGGBB"
     RGB hex values

     All of fill, stroke and stroke_width may be omitted and default to
     "None", "#000000" and "1" respectively.
 -->
<!ATTLIST layer fill CDATA "None">
<!ATTLIST layer stroke CDATA "#000000">
<!ATTLIST layer stroke_width CDATA "1">


<!-- a rasterlayer represents an image that has some geographic data
    associated with it. The filename points to the image used.
-->
<!ELEMENT rasterlayer (projection?, classification?)>
<!ATTLIST rasterlayer 
        title    CDATA #REQUIRED
        filename CDATA #REQUIRED
        visible  (true|false) "true">


<!-- Classification data -->
<!ELEMENT classification (clnull?, clpoint*, clrange*, clcont*)>
<!ATTLIST classification field CDATA #REQUIRED>
<!ATTLIST classification field_type CDATA #REQUIRED>

<!ELEMENT clnull (cldata*)>
<!ELEMENT clpoint (cldata*)>
<!ELEMENT clrange (cldata*)>
<!ELEMENT clcont (cldata*)>

<!ATTLIST clnull label CDATA #IMPLIED>

<!ATTLIST clpoint value CDATA #REQUIRED>
<!ATTLIST clpoint label CDATA #IMPLIED>

<!ATTLIST clrange min CDATA #IMPLIED>
<!ATTLIST clrange max CDATA #IMPLIED>
<!ATTLIST clrange range CDATA #IMPLIED>
<!ATTLIST clrange label CDATA #IMPLIED>

<!ATTLIST clcont rmin CDATA #REQUIRED>
<!ATTLIST clcont rmax CDATA #REQUIRED>
<!ATTLIST clcont dmin CDATA #REQUIRED>
<!ATTLIST clcont dmax CDATA #REQUIRED>

<!-- Visual appearance of the classification 

     the fill and stroke attributes can be either "None" or "#RRGGBB"
     RGB hex values

     All of fill, stroke and stroke_width may be omitted and default to
     "None", "#000000" and "1" respectively.
 -->
<!ELEMENT cldata EMPTY>
<!ATTLIST cldata 
        stroke       CDATA #IMPLIED
        stroke_width CDATA #IMPLIED
        fill         CDATA #IMPLIED
>


<!-- a projection has a number of parameters
-->
<!ELEMENT projection (parameter*)>
<!ATTLIST projection 
        name CDATA "" 
        epsg CDATA #IMPLIED >

<!-- just a simple parameter consisting of a value
-->
<!ELEMENT parameter EMPTY>
<!ATTLIST parameter value CDATA #REQUIRED>


<!-- The label layer contains text labels -->
<!ELEMENT labellayer (label*) >

<!ELEMENT label EMPTY>
<!ATTLIST label
        x CDATA #REQUIRED
        y CDATA #REQUIRED
        text CDATA #REQUIRED
        halign (left|center|right) #REQUIRED
        valign (top|center|bottom) #REQUIRED>
1	<?xml version="1.0" encoding="UTF-8"?>
2	<!-- thuban-1.0.dtd
3
4	Copyright (C) 2001, 2003 by Intevation GmbH
5	Authors:
6	Jan-Oliver Wagner <[email protected]>
7	Bernhard Herzog <[email protected]>
8
9	This program is free software under the GPL (>=v2)
10	Read the file COPYING coming with Thuban for details.
11
12	$Revision$
13	$Source$
14	$Id$
15	-->
16
17	<!-- a session contains zero or more database connections zero or more
18	datasources and and zero or more maps
19
20	At some point, the namespace attribute will likely be used by Thuban to
21	identify the version of the file format.
22	-->
23
24	<!ENTITY % shapesources "fileshapesource \| derivedshapesource \| dbshapesource">
25	<!ENTITY % tables "filetable \| jointable">
26	<!ELEMENT session ((dbconnection \| %shapesources; \| %tables; ), map)>
27	<!ATTLIST session
28	title CDATA #REQUIRED
29	xmlns CDATA #IMPLIED
30	>
31
32
33	<!--
34	A db connection represents the connection to a database.
35
36	Currently only connections to postgis databases are supported and
37	thus The dbtype attribute must be "postgis".
38	-->
39
40	<!ELEMENT dbconnection EMPTY>
41	<!ATTLIST dbconnection
42	id ID #REQUIRED
43	dbtype CDATA #REQUIRED
44	dbname CDATA #REQUIRED
45	host CDATA ""
46	port CDATA ""
47	user CDATA ""
48	>
49
50
51	<!-- A dbshapesource represents a table with geometry data in a database
52
53	The dbconn attribute must be the id of a dbconnection element
54	occurring earlier in the document.
55	-->
56
57	<!ELEMENT dbshapesource EMPTY>
58	<!ATTLIST dbshapesource
59	id ID #REQUIRED
60	dbconn IDREF #REQUIRED
61	tablename CDATA #REQUIRED
62	>
63
64	<!--
65	A fileshapesource is a source of shapes and perhaps attribute data
66	read from a file. The filetype attribute must be one of the
67	supported file types. Currently only "shapefile" is supported.
68	-->
69
70	<!ELEMENT fileshapesource EMPTY>
71	<!ATTLIST fileshapesource
72	id ID #REQUIRED
73	filename CDATA #REQUIRED
74	filetype CDATA #REQUIRED
75	>
76
77	<!--
78	A derivedshapesource is a source of shapes and attribute data
79	derived from another shapesource for the shapes and a table for the
80	attribute data.
81	-->
82
83	<!ELEMENT derivedshapesource EMPTY>
84	<!ATTLIST derivedshapesource
85	id ID #REQUIRED
86	shapesource IDREF #REQUIRED
87	table IDREF #REQUIRED
88	>
89
90
91	<!-- a filetable points to the actual file that
92	contains the tabular data.
93
94	The filetype Attribute may be onve of "DBF" or "CSV"
95	-->
96	<!ELEMENT filetable EMPTY>
97	<!ATTLIST filetable
98	id ID #REQUIRED
99	title CDATA #REQUIRED
100	filename CDATA #REQUIRED
101	filetype CDATA #REQUIRED>
102
103	<!--
104	A jointable is a table with the result of something equivalent to
105	this SQL Statement:
106
107	SELECT * FROM left JOIN right WHERE left.leftcolumn = right.rightcolumn;
108
109	The attributes left and right must be the ids of two tables defined
110	previously in the XML-Document file. leftcolumn and rightcolumn are
111	the column names to join on.
112
113	The jointype attribute should be either "INNER" or "LEFT OUTER".
114	-->
115	<!ELEMENT jointable EMPTY>
116	<!ATTLIST jointable
117	id ID #REQUIRED
118	title CDATA #REQUIRED
119	left IDREF #REQUIRED
120	leftcolumn CDATA #REQUIRED
121	right IDREF #REQUIRED
122	rightcolumn CDATA #REQUIRED
123	jointype CDATA #REQUIRED
124	>
125
126	<!-- A Map
127
128	A map consists of a number of layers
129	the projection refers to the projection
130	used to display the map. If the projection
131	is missing, geographic coordinates in decimal
132	degrees are assumed.
133	-->
134	<!ELEMENT map (projection?, (layer \| rasterlayer)*, labellayer?)>
135	<!ATTLIST map title CDATA #REQUIRED>
136
137	<!-- a layer represents a set of geographic objects.
138	pointers to the actual data are stored.
139	The shapestore attributes contains the id of the data store
140	shown in the layer.
141	the projection refers to the projection
142	in which the data are stored. If the projection
143	is missing, geographic coordinates in decimal
144	degrees are assumed. Visibility is assumed true
145	unless otherwise specified.
146	-->
147	<!ELEMENT layer (projection?, classification?)>
148	<!ATTLIST layer title CDATA #REQUIRED>
149	<!ATTLIST layer shapestore IDREF #REQUIRED>
150	<!ATTLIST layer visible (true\|false) "true">
151	<!-- the fill and stroke attributes can be either "None" or "#RRGGBB"
152	RGB hex values
153
154	All of fill, stroke and stroke_width may be omitted and default to
155	"None", "#000000" and "1" respectively.
156	-->
157	<!ATTLIST layer fill CDATA "None">
158	<!ATTLIST layer stroke CDATA "#000000">
159	<!ATTLIST layer stroke_width CDATA "1">
160
161
162	<!-- a rasterlayer represents an image that has some geographic data
163	associated with it. The filename points to the image used.
164	-->
165	<!ELEMENT rasterlayer (projection?, classification?)>
166	<!ATTLIST rasterlayer
167	title CDATA #REQUIRED
168	filename CDATA #REQUIRED
169	visible (true\|false) "true">
170
171
172	<!-- Classification data -->
173	<!ELEMENT classification (clnull?, clpoint, clrange, clcont*)>
174	<!ATTLIST classification field CDATA #REQUIRED>
175	<!ATTLIST classification field_type CDATA #REQUIRED>
176
177	<!ELEMENT clnull (cldata*)>
178	<!ELEMENT clpoint (cldata*)>
179	<!ELEMENT clrange (cldata*)>
180	<!ELEMENT clcont (cldata*)>
181
182	<!ATTLIST clnull label CDATA #IMPLIED>
183
184	<!ATTLIST clpoint value CDATA #REQUIRED>
185	<!ATTLIST clpoint label CDATA #IMPLIED>
186
187	<!ATTLIST clrange min CDATA #IMPLIED>
188	<!ATTLIST clrange max CDATA #IMPLIED>
189	<!ATTLIST clrange range CDATA #IMPLIED>
190	<!ATTLIST clrange label CDATA #IMPLIED>
191
192	<!ATTLIST clcont rmin CDATA #REQUIRED>
193	<!ATTLIST clcont rmax CDATA #REQUIRED>
194	<!ATTLIST clcont dmin CDATA #REQUIRED>
195	<!ATTLIST clcont dmax CDATA #REQUIRED>
196
197	<!-- Visual appearance of the classification
198
199	the fill and stroke attributes can be either "None" or "#RRGGBB"
200	RGB hex values
201
202	All of fill, stroke and stroke_width may be omitted and default to
203	"None", "#000000" and "1" respectively.
204	-->
205	<!ELEMENT cldata EMPTY>
206	<!ATTLIST cldata
207	stroke CDATA #IMPLIED
208	stroke_width CDATA #IMPLIED
209	fill CDATA #IMPLIED
210	>
211
212
213	<!-- a projection has a number of parameters
214	-->
215	<!ELEMENT projection (parameter*)>
216	<!ATTLIST projection
217	name CDATA ""
218	epsg CDATA #IMPLIED >
219
220	<!-- just a simple parameter consisting of a value
221	-->
222	<!ELEMENT parameter EMPTY>
223	<!ATTLIST parameter value CDATA #REQUIRED>
224
225
226	<!-- The label layer contains text labels -->
227	<!ELEMENT labellayer (label*) >
228
229	<!ELEMENT label EMPTY>
230	<!ATTLIST label
231	x CDATA #REQUIRED
232	y CDATA #REQUIRED
233	text CDATA #REQUIRED
234	halign (left\|center\|right) #REQUIRED
235	valign (top\|center\|bottom) #REQUIRED>
Name	Value
svn:eol-style	native
svn:keywords	Author Date Id Revision