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