<?xml version="1.0" encoding='ISO-8859-1'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 
  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % cartoweb SYSTEM "cartoweb.ent" >
  %cartoweb;
  ]>
<!-- $Id: book.xml,v 1.43 2007-09-21 06:58:56 fredj Exp $ -->
<book id="cartoweb">
  <title>&cartoweb; Documentation</title>
  <bookinfo>
    <corpauthor>&c2c;</corpauthor>
    <pubdate>
      <?dbtimestamp format="Y-m-d"?>
    </pubdate>
   <edition>&cw_version;</edition>
   <mediaobject>
     <imageobject>
       <imagedata fileref="logo.png" format="PNG" />
     </imageobject>
   </mediaobject>
  </bookinfo>
  <part id="cartoweb.intro">
    <title>Presentation and Architecture</title>
    <partintro>
      <para>This first part of the documentation is an overall presentation
      of both the visible and the hidden features of &cartoweb;. The goals are
      first to give an idea of what &cartoweb; can readily do if used as it
      is shipped, and second to explain why it is a powerful framework to 
      build more advanced applications.
      </para>
    </partintro>
    <xi:include href="intro/presentation.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="intro/feature.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="intro/architecture.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
  </part>
  <part id="cartoweb.user">
    <title>User Manual</title>
    <partintro>
      <para>
       This user manual, second part of the &cartoweb; documentation, 
       is aimed at administrators who have to setup, configure and maintain
       a &cartoweb; environment. 
      </para>
      <para>
       It is not an end-user documentation, so you won't find here instructions on 
       how to navigate, select layers or do whatever operations the distant users 
       are allowed to do through their browser.
      </para>
      <para>
       On the other side, if you want to go beyond the standard, out-of-the-box 
       possibilities of &cartoweb;, you'll definitely have to look at the third
       part of this documentation, intended for developers.
       </para>
    </partintro>
    <xi:include href="user/install.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/structure.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/project.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/config.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/caches.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/layers.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/location.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/images.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/query.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/annotate.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/output.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/pdf.xml"
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/views.xml"
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/edit.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/security.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/i18n.xml"
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/template.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/accounting.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/locate.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/ajax.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/geostat.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/tooltips.xml"
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/search.xml"
       xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/ogcLayerLoader.xml"
       xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/wmsBrowserLight.xml"
       xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/routing.xml"
       xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="user/bboxHistory.xml"
       xmlns:xi="http://www.w3.org/2001/XInclude" />

  </part>
  <part id="cartoweb.dev">
    <title>Developer Manual</title>
    <partintro>
      <para>
       As is implied by its name, this part of the documentation is aimed
       at those who need to customize or extend &cartoweb; for their
       specific needs.
      </para>
    </partintro>
    <xi:include href="dev/soapcalls.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="dev/newplugin.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="dev/mapoverlay.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="dev/security.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="dev/i18n.xml"
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="dev/code_convention.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="dev/unit_test.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="dev/code_documentation.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="dev/debug.xml"
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="dev/performance.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="dev/views_upgrade.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="dev/ajax.xml" 
      xmlns:xi="http://www.w3.org/2001/XInclude" />
  </part>

  <!-- The appendixes -->
  <xi:include href="appendix/debian_install.xml" 
    xmlns:xi="http://www.w3.org/2001/XInclude" />
  <xi:include href="appendix/windows_install.xml" 
    xmlns:xi="http://www.w3.org/2001/XInclude" />
  <xi:include href="appendix/create_new_project.xml" 
    xmlns:xi="http://www.w3.org/2001/XInclude" />
  <xi:include href="appendix/make_doc.xml" 
    xmlns:xi="http://www.w3.org/2001/XInclude" />

  <index id="cartoweb.index" />
</book>
