/[thuban]/branches/WIP-pyshapelib-bramz/Doc/manual/thuban-manual.xml
ViewVC logotype

Diff of /branches/WIP-pyshapelib-bramz/Doc/manual/thuban-manual.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 2023 by frank, Fri Dec 5 13:54:46 2003 UTC revision 2209 by jan, Sun May 16 09:38:48 2004 UTC
# Line 19  Line 19 
19        </author>        </author>
20          </authorgroup>          </authorgroup>
21      <copyright>      <copyright>
22        <year>2003</year>        <year>2003, 2004</year>
23        <holder>Intevation GmbH</holder>        <holder>Intevation GmbH</holder>
24      </copyright>      </copyright>
25     <revhistory>     <revhistory>
# Line 32  Line 32 
32       </revision>       </revision>
33  -->  -->
34       <revision>       <revision>
35            <revnumber>1.0.0</revnumber>
36            <date>22-Jan-2004</date>
37            <revremark>
38                            Corresponds to Thuban 1.0.0.
39                            New: Installation instructions for Win32.
40                    </revremark>
41         </revision>
42         <revision>
43          <revnumber>1.0pre3</revnumber>          <revnumber>1.0pre3</revnumber>
44          <date>04-Dec-2003</date>          <date>04-Dec-2003</date>
45          <revremark>          <revremark>
46                          Corresponds to Thuban 1.0rc1                          Corresponds to Thuban 1.0rc1.
47                          New: I18n, right button legend menu, EPSG projectons,                          New: I18n, right button legend menu, EPSG projectons,
48              PostGIS support.              PostGIS support.
49                  </revremark>                  </revremark>
# Line 93  Line 101 
101          <para>          <para>
102          Required:          Required:
103          <itemizedlist>          <itemizedlist>
104              <listitem><para>Python 2.2.1 (<literal>http://www.python.org</literal>)</para></listitem>              <listitem><para>Python 2.2.1
105              <listitem><para>wxWindows 2.4 (<literal>http://www.wxwindows.org</literal>)</para></listitem>                          (<literal>http://www.python.org</literal>)
106              <listitem><para>wxPython 2.4 (<literal>http://www.wxpython.org</literal>)</para></listitem>                          </para></listitem>
107              <listitem><para>proj 4.4.5 Projection Library (<literal>http://www.remotesensing.org/proj/</literal>)</para></listitem>              <listitem><para>wxWindows 2.4
108              <listitem><para>SQLite 2.8.3 (<literal>http://www.hwaci.com/sw/sqlite/</literal>)</para></listitem>                          (<literal>http://www.wxwindows.org</literal>)
109              <listitem><para>PySQLite 0.4.3 (<literal>http://pysqlite.sourceforge.net</literal>)</para></listitem>                          </para></listitem>
110                <listitem><para>wxPython 2.4
111                            (<literal>http://www.wxpython.org</literal>)
112                            </para></listitem>
113                <listitem><para>proj 4.4.5 Projection Library
114                            (<literal>http://www.remotesensing.org/proj/</literal>)
115                            </para></listitem>
116                <listitem><para>SQLite 2.8.3
117                            <literal>http://www.hwaci.com/sw/sqlite/</literal>)
118                            </para></listitem>
119                <listitem><para>PySQLite 0.4.3
120                            (<literal>http://pysqlite.sourceforge.net</literal>)
121                            </para></listitem>
122          </itemizedlist>          </itemizedlist>
123          </para>          </para>
124          <para>          <para>
125          Optional:          Optional:
126          <itemizedlist>          <itemizedlist>
127              <listitem><para>GDAL 1.1.8 (<literal>http://www.remotesensing.org/gdal/</literal>)</para></listitem>              <listitem><para>GDAL 1.1.8
128              <listitem><para>psycopg 1.0.8 (<literal>http://initd.org/software/psycopg</literal>)</para></listitem>                          (<literal>http://www.remotesensing.org/gdal/</literal>)
129                            </para></listitem>
130                <listitem><para>psycopg 1.0.8
131                            (<literal>http://initd.org/software/psycopg</literal>)
132                            </para></listitem>
133              </itemizedlist>              </itemizedlist>
134          </para>          </para>
135                  <para>                  <para>
136                  Along with the source codes, the download page also offers                  Along with the source codes, the download page also offers full
137                  full installation packages for Debian, Windows and RPM-based systems                  installation packages for Debian, Windows and RPM-based systems
138                  (Mandrake, RedHat, SuSE, etc).                  (Mandrake, RedHat, SuSE, etc).
139                  </para>                  </para>
140                  <section><title>RPM-based GNU/Linux Systems</title>                  <section><title>RPM-based GNU/Linux Systems</title>
141                          <section><title>Installing Binary Packages</title>                          <section><title>Installing Binary Packages</title>
142                                  <para>                                  <para>
143                                  The most wide-spread RPM-based GNU/Linux Systems are RedHat,                                  The most wide-spread RPM-based GNU/Linux
144                                  Mandrake and SuSE. The documentation of these distributions                                  Systems are RedHat, Mandrake and SuSE.
145                                  should contain information about how to install third-party                                  The documentation of these distributions
146                                  RPM packages. Nonetheless, a short summary is provided here.                                  should contain information about how to
147                                    install third-party RPM packages.
148                                    Nonetheless, a short summary is provided here.
149                                  </para>                                  </para>
150                                  <para>                                  <para>
151                                  RPM packages can be installed applying several tools.                                  RPM packages can be installed applying several
152                                  The most basic one is the command line program "rpm".                                  tools. The most basic one is the command line
153                                  The hardware architecture is identified in the name                                  program "rpm".  The hardware architecture is
154                                  of RPM packages, eg. 'i386' for most Intel/AMD architectures.                                  identified in the name of RPM packages, eg.
155                                  If you have a different hardware architecture, where no                                  'i386' for most Intel/AMD architectures.  
156                                  binary RPM packages are provided, you must rebuild binary                                  If you have a different hardware architecture,
157                                  packages from the RPM source packages first (see below).                                  where no binary RPM packages are provided,
158                                    you must rebuild binary packages from the
159                                    RPM source packages first (see below).
160                                  Typical rpm commands look like:                                  Typical rpm commands look like:
161    
162                                  <programlisting>                                  <programlisting>
163                                  rpm --install Thuban-0.9.0-1.i386.rpm                                  rpm --install Thuban-0.9.0-1.i386.rpm
164                                  </programlisting>                                  </programlisting>
165    
166                                  Depending on what you already have installed on your                                  Depending on what you already have installed
167                                  system, you are informed that some packages are                                  on your system, you are informed that some
168                                  required, but not installed. You need to install them                                  packages are required, but not installed.
169                                  first. Either they are provided by your GNU/Linux distributor                                  You need to install them first. Either they
170                                  or available somewhere on the Internet.                                  are provided by your GNU/Linux distributor
171                                  The more essential and special ones are provided together                                  or available somewhere on the Internet.  
172                                  with the Thuban package.                                  The more essential and special ones are
173                                    provided together with the Thuban package.
174                                  </para>                                  </para>
175    
176                                  <para>                                  <para>
# Line 256  rpm -bb thuban.spec Line 285  rpm -bb thuban.spec
285                          <ulink url="http://www.rpm.org/">homepage of RPM</ulink>.                          <ulink url="http://www.rpm.org/">homepage of RPM</ulink>.
286                                  </para>                                  </para>
287                          </section>                          </section>
288                  </section>                  </section> <!-- Intro - Installation - RPM-->
289    
290                    <section><title>Win32 Systems</title>
291                    <para>
292                            A common installation package of Thuban for Win32
293                            systems is available from the Thuban website download
294                            section. This installation package is configured for
295                            displaying file based vector data (Shapefiles). For the
296                            display of raster data or the connection to spatial
297                            databases additional steps are needed.  
298                    </para>
299                    <para>
300                            The required Python packages are listed and linked on
301                            the download page as well.  If you don't have Python
302                            installed already, download the packages for Python,
303                            wxPython for Python and the SQLite Python Libraries as
304                            well as the Thuban package. Install all four packages
305                            in the order: Python, wxPython, SQLite, Thuban. Follow
306                            the installation instructions provided by the seperate
307                            setups. The Thuban installation package will add an
308                            entry in the menu folder you configured.
309                    </para>
310                    <section><title>Raster Data: Installation of GDAL</title>
311                    <para>
312                            Enabling the raster data features of Thuban is
313                            straight forward. For the examples we assume that
314                            Thuban has been installed under
315                            <literal>C:\Thuban</literal>:
316                            <itemizedlist>
317                            <listitem>
318                            <para>
319                            Download the zip-archive <ulink
320                            url="ftp://intevation.de/thuban/win2k/gdal-win2k.zip"
321                            >gdal-win2k</ulink>.
322                            </para></listitem>
323                            <listitem><para>Extract the archive (e.g. with
324                            <ulink
325                            url="http://www.info-zip.org/pub/infozip/WiZ.html"
326                            >WiZ (InfoZip)</ulink>) into the
327                            <literal>C:\Thuban\Lib</literal>
328                            directory of your Thuban installation.
329                            </para>
330                            </listitem>
331                            <listitem>
332                            <para>
333                            Extent the <varname>PYTHONPATH</varname>
334                            environment variable (in your Windows Control Panel)
335                            to make the new libraries available for Thuban.
336                            <programlisting>
337    %PYTHONPATH%;C:\Thuban\Lib\gdal;C:\Thuban\Lib\gdal\pymod
338                            </programlisting>
339                            </para>
340                            </listitem>
341                            <listitem>
342                            <para>
343                            Extent also the <varname>PATH</varname>
344                            environment variable accordingly:
345                            <programlisting>
346    %PATH%;C:\Thuban\Lib\gdal
347                            </programlisting>
348                            </para>
349                            </listitem>
350                            </itemizedlist>
351                            After this installation steps Thuban is ready to
352                            display raster data (e.g. the
353                            <literal>island.tif</literal> from the Iceland Demo
354                            data set.
355                    </para>
356                    </section> <!-- Win32: GDAL-->
357    
358                    <section><title>Working with PostGIS: Installation of PsycoPG</title>
359                    <para>
360                            To access PostgreSQL/PostGIS spatial databases with
361                            Thuban you have to install the PsycoPG package for
362                            Windows:
363                            <itemizedlist>
364                            <listitem>
365                            <para>
366                            Download the zip-archive
367                            <ulink
368                                    url="http://stickpeople.com/projects/python/win-psycopg/win-psycopg22.zip"
369                            >win-psycopg22.zip</ulink>.
370                            </para>
371                            </listitem>
372                            <listitem>
373                            <para>
374                            Extract the zip-archive into a directory either already
375                            in your <varname>PYTHONPATH</varname> or extent your
376                            <varname>PYTHONPATH</varname> variable to the directory
377                            you have extracted the archive to.
378                            </para>
379                            </listitem>
380                            </itemizedlist>
381                            For installation and maintenance of spatial databases
382                            we refer to the  <ulink
383                            url="http://postgis.refractions.net"
384                            >PostGIS Homepage</ulink>.
385                    </para>
386                    </section> <!-- Win32: PsycoPG-->
387    
388                    </section> <!-- Intro - Installation - Win32 -->
389          </section>          </section>
390    
391          <section><title>Internationalization</title>          <section><title>Internationalization</title>
# Line 1702  registry.Add(Command('hello_world', _('H Line 1831  registry.Add(Command('hello_world', _('H
1831                       helptext = _('Welcome everyone on this planet')))                       helptext = _('Welcome everyone on this planet')))
1832    
1833  # find the extensions menu (create it anew if not found)  # find the extensions menu (create it anew if not found)
1834  extensions_menu = main_menu.find_menu('extensions')  extensions_menu = main_menu.FindOrInsertMenu('extensions', _('E&xtensions'))
 if extensions_menu is None:  
     extensions_menu = main_menu.InsertMenu('extensions', _('E&xtensions'))  
1835    
1836  # finally bind the new command with an entry in the extensions menu  # finally bind the new command with an entry in the extensions menu
1837  extensions_menu.InsertItem('hello_world')  extensions_menu.InsertItem('hello_world')
# Line 1938  extensions_menu.InsertItem('hello_world' Line 2065  extensions_menu.InsertItem('hello_world'
2065      <figure>      <figure>
2066      <title>Database Management Dialog</title>      <title>Database Management Dialog</title>
2067      <mediaobject>      <mediaobject>
2068      <imageobject><imagedata fileref="./images/app_postgis_db_management.png" format="PNG" scale="&imgscale;"/></imageobject>      <imageobject><imagedata fileref="../images/app_postgis_db_management.png" format="PNG" scale="&imgscale;"/></imageobject>
2069      <imageobject><imagedata fileref="./images/app_postgis_db_management.eps" format="EPS" scale="&imgscale;"/></imageobject>      <imageobject><imagedata fileref="./images/app_postgis_db_management.eps" format="EPS" scale="&imgscale;"/></imageobject>
2070      </mediaobject>      </mediaobject>
2071      </figure>      </figure>
# Line 1952  extensions_menu.InsertItem('hello_world' Line 2079  extensions_menu.InsertItem('hello_world'
2079          <figure>          <figure>
2080          <title>Add Database Dialog</title>          <title>Add Database Dialog</title>
2081          <mediaobject>          <mediaobject>
2082          <imageobject><imagedata fileref="./images/app_postgis_db_add.png" format="PNG" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="../images/app_postgis_db_add.png" format="PNG" scale="&imgscale;"/></imageobject>
2083          <imageobject><imagedata fileref="./images/app_postgis_db_add.eps" format="EPS" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="./images/app_postgis_db_add.eps" format="EPS" scale="&imgscale;"/></imageobject>
2084          </mediaobject>          </mediaobject>
2085          </figure>          </figure>
# Line 1982  extensions_menu.InsertItem('hello_world' Line 2109  extensions_menu.InsertItem('hello_world'
2109          <figure>          <figure>
2110          <title>Add Database Dialog</title>          <title>Add Database Dialog</title>
2111          <mediaobject>          <mediaobject>
2112          <imageobject><imagedata fileref="./images/app_postgis_add_layer.png" format="PNG" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="../images/app_postgis_add_layer.png" format="PNG" scale="&imgscale;"/></imageobject>
2113          <imageobject><imagedata fileref="./images/app_postgis_add_layer.eps" format="EPS" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="./images/app_postgis_add_layer.eps" format="EPS" scale="&imgscale;"/></imageobject>
2114          </mediaobject>          </mediaobject>
2115          </figure>          </figure>
Legend:
Removed from v.2023  
changed lines
  Added in v.2209
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26