1 |
3032
|
perry
|
|
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>
|