1
|
|
2
|
<h2>Troubleshooting</h2>
|
3
|
|
4
|
<p>
|
5
|
What follows is some common problems encountered and some tips for working with
|
6
|
mapbuilder in development.
|
7
|
</p>
|
8
|
|
9
|
<ul>
|
10
|
<li><span class="title">The <a href="javascript:">Javascript console</a>
|
11
|
is your friend.</span> While we have attempted to trap the more common errors and
|
12
|
provide a meaningful error message in an alert, error messages in the
|
13
|
javascript console can provide additional information about where and why
|
14
|
and error occurred.
|
15
|
</li>
|
16
|
<li><span class="title">Mozilla based browsers provide better debugging tools.</span>
|
17
|
It is very difficult to diagnose problems in Internet Explorer.
|
18
|
Mozilla provides some very nice developer tools through XUL extensions and
|
19
|
with the Venkman JavaScript debugger.
|
20
|
</li>
|
21
|
<li><span class="title">HTML DOCTYPE declarations.</span>
|
22
|
Some HTML doctype declarations cause problems using mapbuilder (including XHTML
|
23
|
and those that refer to "loose.dtd").
|
24
|
The following doctype declarations are known to work correctly:
|
25
|
<pre><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"></pre>
|
26
|
<pre><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"></pre>
|
27
|
</li>
|
28
|
<li><span class="title">no extra whitespace in config properties</span>
|
29
|
don't put in extra whitespace or comments for properties in config.
|
30
|
Properties should look like <b><property>value</property></b>
|
31
|
and not have any carriage returns within the element.
|
32
|
</li>
|
33
|
<li><span class="title">Empty HTML tags</span>
|
34
|
Don't use the empty node form in the HTML page for mapbuilder elements
|
35
|
(i.e. <b><div id="mbId"/></b>).
|
36
|
This is because some browsers do not recognize the empty tag as being closed.
|
37
|
</li>
|
38
|
<li><span class="title">XML mime types:</span>
|
39
|
The XML documents you retrieve must have a mime type of "text/xml".
|
40
|
File types that typically aren't served with that mime type include
|
41
|
context documents (.cml), collections (.ccml) and often XSL files as well (.xsl).
|
42
|
Check that the mime type mapping file for your server contains a line like:
|
43
|
<pre>text/xml xml xsl cml ccml</pre>
|
44
|
If you are using Apache, this file will be specified in the httpd.conf.
|
45
|
</li>
|
46
|
<li><span class="title">Browser caching of XSL stylesheets</span>
|
47
|
Both IE and Mozilla based browsers cache stylesheets loaded by mapbuilder.
|
48
|
If you are modifying widget stylesheets, be sure to clear the browser cache
|
49
|
before reloading the page.
|
50
|
</li>
|
51
|
<li><span class="title">add more here</span>
|
52
|
</li>
|
53
|
<li><span class="title"></span>
|
54
|
</li>
|
55
|
<li><span class="title"></span>
|
56
|
</li>
|
57
|
</ul>
|