[mapserver-commits] r9634 - in trunk/docs/de: include utilities
svn at osgeo.org
svn at osgeo.org
Sat Dec 19 09:37:54 EST 2009
Author: gislars
Date: 2009-12-19 09:37:54 -0500 (Sat, 19 Dec 2009)
New Revision: 9634
Modified:
trunk/docs/de/include/labels.inc
trunk/docs/de/utilities/msencrypt.txt
trunk/docs/de/utilities/tile4ms.txt
Log:
(doc-de) added translation for tile4ms and msencrypt
Modified: trunk/docs/de/include/labels.inc
===================================================================
--- trunk/docs/de/include/labels.inc 2009-12-19 14:27:21 UTC (rev 9633)
+++ trunk/docs/de/include/labels.inc 2009-12-19 14:37:54 UTC (rev 9634)
@@ -186,7 +186,7 @@
svn :ref:`Subversion <svn>`
swig :ref:`SWIG MapScript API Reference <swig>`
sym2img :ref:`sym2img <sym2img>`
- sym_construction :ref:`Cartographic Symbol Construction with MapServer <sym_construction>`
+ sym_construction :ref:`Konstruktion von kartographischen Signaturen <sym_construction>`
sym_examples :ref:`Symbology Examples <sym_examples>`
symbol :ref:`SYMBOL <symbol>`
template :ref:`Templating <template>`
Modified: trunk/docs/de/utilities/msencrypt.txt
===================================================================
--- trunk/docs/de/utilities/msencrypt.txt 2009-12-19 14:27:21 UTC (rev 9633)
+++ trunk/docs/de/utilities/msencrypt.txt 2009-12-19 14:37:54 UTC (rev 9634)
@@ -5,16 +5,16 @@
*****************************************************************************
-Purpose
+Zweck
-----------------------------------------------------------------------------
+
+Erstellt einen Schlüssel für eine Verschlüsselung oder verschlüsselt Teile
+der Verbindungsdaten im Mapfile (ab Version 4.10). Normalerweise werden
+Verbindunsparameter für Datenbanken (Parameter CONNECTION) verschlüsselt.
+Folgende CONNECTIONTYPEs unterstützen diese Verschlüsselungsmethode:
-Used to create an encryption key or to encrypt portions of connection strings for
-use in mapfiles (added in v4.10) . Typically you might want to encrypt portions of
-the CONNECTION parameter for a database connection. The following CONNECTIONTYPEs
-are supported for using this encryption method:
+::
-::
-
OGR
Oracle Spatial
PostGIS
@@ -23,47 +23,46 @@
Syntax
-----------------------------------------------------------------------------
-To create a new encryption key:
-
+Einen neuen Schlüssel erstellen:
+
::
-
+
msencrypt -keygen [key_filename]
-
-To encrypt a string:
-
+
+Eine Zeichenkette verschlüsseln:
+
::
-
+
msencrypt -key [key_filename] [string_to_encrypt]
-Use in Mapfile
+Verwendung im Mapfile
-----------------------------------------------------------------------------
+Der Pfad zum Schlüssel kann über zwei Mechanismen angegeben werden. Entweder
+wird die Umgebungsvariable MS_ENCRYPTION_KEY gesetzt oder die Direktive
+CONFIG wird im MAP-Objekt des Mapfiles benutzt. Zum Beispiel:
-The location of the encryption key can be specified by two mechanisms, either by
-setting the environment variable MS_ENCRYPTION_KEY or using a CONFIG directive
-in the MAP object of your mapfile. For example:
-
::
-
+
CONFIG MS_ENCRYPTION_KEY "/path/to/mykey.txt"
-
-Use the { and } characters as delimiters for encrypted strings inside database
-CONNECTIONs in your mapfile. For example:
-
+
+Es können geschweifte Klammen {} als Begrenzer des Schlüssels benutzt werden.
+Zum Beispiel:
+
::
-
+
CONNECTIONTYPE ORACLESPATIAL
CONNECTION "user/{MIIBugIBAAKBgQCP0Yj+Seh8==}@service"
-
+
Example
.............................................................................
.. note:
-
- The following PostGIS example requires at least MapServer 5.0.3 or 5.2)
- Let's say we have a LAYER that uses a POSTGIS connection as follows:
-
+ Das folgende PostGIS-Beispiel benötigt mind. MapServer 5.0.3 oder 5.2.
+
+ Angenommen ein LAYER benutzt eine PostGIS-Verbindung wie folgt:
+
::
-
+
LAYER
NAME "provinces"
TYPE POLYGON
@@ -76,52 +75,53 @@
COLOR 255 0 0
END
END
-
-Here are the steps to encrypt the password in the above connection:
-
-1. Generate an encryption key (note that this key should not be stored anywhere within
- your web server's accessible directories):
-
+
+Mit den folgenden Schritten wurde das Passwort im obigen Beispiel verschlüsselt:
+
+1. Erstellung eines Schlüssels (Dieser Schlüssel sollte nicht in Verzeichnissen
+ gespeichert werden die für den Webserver zugänglich sind):
+
::
-
+
msencrypt -keygen "E:\temp\mykey.txt"
+
+Der erstellte Schlüssel könnte wie folgt aussehen:
-And this generated key file might contain something like:
-
::
-
+
2137FEFDB5611448738D9FBB1DC59055
-
-2. Encrypt the connection's password using that generated key:
+
+2. Verschlüsselung des Verbindungspasswortes mit dem erstellten Schlüssel:
::
-
+
msencrypt -key "E:\temp\mykey.txt" "iluvyou18"
+
+Dies liefert das verschlüsselte Passwort, das auf der Kommandozeile ausgegeben
+wird (und in einem der nächsten Schritte benutzt wird):
-Which returns the password encrypted, at the commandline (you'll
-use it in a second):
+::
-::
-
3656026A23DBAFC04C402EDFAB7CE714
+
+3. Bearbeitung des Mapfiles um sicherzustellen das 'mykey.txt' gefunden wird.
+ Hierzu wird die Umgebungsvariable "MS_ENCRYPTION_KEY" benutzt. Der Parameter
+ CONFIG kann zum setzen der Umgebungsvariablen benutzt werden:
-3. Edit the mapfile to make sure the 'mykey.txt' can be found, using the
- "MS_ENCRYPTION_KEY" environment variable. The CONFIG parameter inside the
- MAP object can be used to set an environment variable inside a mapfile:
+::
-::
-
MAP
...
CONFIG "MS_ENCRYPTION_KEY" "E:/temp/mykey.txt"
...
END #mapfile
-
-4. Modify the layer's CONNECTION to use the generated password key,
- making sure to use the “{}” brackets around the key:
-
+
+4. Anpassung des Parameters CONNECTION, damit das verschlüsselte Passwort
+ benutzt wird. Dies muss dabei in geschweiften Klammern "{}" geschrieben
+ werden:
+
::
-
+
CONNECTION "host=127.0.0.1 dbname=gmap user=postgres password={3656026A23DBAFC04C402EDFAB7CE714} port=5432"
-
-5. Done! Give your new encrypted mapfile a try with the :ref:`shp2img` utility!
+
+5. Fertig! Mit :ref:`shp2img` kann das verschlüsselte Mapfile getestet werden.
Modified: trunk/docs/de/utilities/tile4ms.txt
===================================================================
--- trunk/docs/de/utilities/tile4ms.txt 2009-12-19 14:27:21 UTC (rev 9633)
+++ trunk/docs/de/utilities/tile4ms.txt 2009-12-19 14:37:54 UTC (rev 9634)
@@ -4,25 +4,28 @@
tile4ms
*****************************************************************************
-Purpose
+Zweck
-----------------------------------------------------------------------------
+
+Erzeugt ein Shapefile mit Tileindex (Kachelindex) das von MapServer verarbeitet
+werden kann. Das Programm erzeugt ein Shapefile mit Rechtecken aller
+Ausdehnungen der angegebenen Shapefiles in [metafile] (ein Dateiname pro Zeile)
+und die zugehörige DBF-Datei mit Dateinamen für jede Kachel in der Spalte
+LOCATION (wie von mapserv erwartet).
-Creates a tile index shapefile for use with MapServer's TILEINDEX feature. The program
-creates a shapefile of rectangles from extents of all the shapefiles listed in [metafile]
-(one shapefile name per line) and the associated DBF with the filename for each shape tile
-in a column called LOCATION as required by mapserv.
-Description
+Beschreibung
-----------------------------------------------------------------------------
-This utility creates a shapefile containing the MBR (minimum bounding rectangle) of all
-shapes in the files provided, which can then be used in the LAYER object's TILEINDEX parameter
-of the mapfile. The new filed created with this command is used by MapServer to only load
-the files assocated with that extent (or tile).
+Dieses Programm erzeugt ein Shapefile mit MBR (minimum bounding rectangle /
+kleinstes umgebenes Rechteck) aller Objekte. Die erzeugte Datei kann im
+LAYER-Objekt per Parameter TILEINDEX benutzt werden. Diese Datei wird von
+MapServer benutzt um nur die den Extent (bzw. Kachel) betreffenden Dateien zu
+verarbeiten.
Syntax
-----------------------------------------------------------------------------
::
-
+
tile4ms <meta-file> <tile-file> [-tile-path-only]
<meta-file> INPUT file containing list of shapefile names
(complete paths 255 chars max, no extension)
@@ -34,52 +37,52 @@
-Short Example
+Kurzes Beispiel
-----------------------------------------------------------------------------
+
+Erzeuge tileindex.shp für alle Kacheln unterhalb von /path/to/data:
-create tileindex.shp for all tiles under the /path/to/data directory:
-
::
- <on Unix>
-
+ <on Unix>
+
cd /path/to/data
find . -name "/*.shp" -print > metafile.txt
tile4ms metafile.txt tileindex
- <on Windows>
+ <on Windows>
dir /b /s *.shp > metafile.txt
tile4ms metafile.txt tileindex
-
-Long Example
+
+Ausführliches Beispiel
-----------------------------------------------------------------------------
+
+Dieses Beispiel benutzt die TIGER-Zensusdaten, die nach Land/Bundesland
+unterteilt sind. (Der Datensatz enthält mehr als 3200 Länder, also wirklich
+sehr groß). In diesem Bespiel sollen alle Seen des Staates Minnesota angezeigt
+werden. (Die TIGER-Daten wurden dafür bereits in das Shapefile-Format konvertiert.
+Mit ogrtindex könnte auf die Daten auch direkt zugegriffen werden.)
+Der TIGER-Datensatz für Minnesota enthält Daten für 87 unterschiedliche
+Staaten, jeweils mit den Dateien für die Seen ('wp.shp').
+
+1. Zuerst muss das 'meta-file' erstellt werden. Dies ist eine Textdatei mit
+ Pfadangaben zu allen 'wp.shp'-Dateien für Minnesota. Zur Erstellung können
+ folgende Kommandos benutzt werden:
-This example uses TIGER Census data, where the data contains files divided
-up by county (in fact there are over 3200 counties, a very large dataset
-indeed). In this example we will show how to display all lakes for the
-state of Minnesota. (note that here we have already converted the TIGER data
-into shapefile format, but you could keep the data in TIGER format and use
-the ogrtindex utility instead) The TIGER Census data for Minnesota is made
-up of 87 different counties, each containing its own lakes file ('wp.shp').
+ ::
-1. We need to create the 'meta-file' for the tile4ms command. This is a text
- file of the paths to all 'wp.shp' files for the MN state. To create this
- file we can use a few simple commands:
-
- ::
-
DOS: dir wp.shp /b /s > wp_list.txt
- (this includes full paths to the data, you might want to edit the txt
- file to remove the full path)
+ (Die Pfadangabe sollte angepasst werden, so dass nur der relative
+ Pfad vorhanden bleibt)
UNIX: find -name *wp.shp -print > wp_list.txt
-
-The newly created file might look like the following (after removing the
-full path):
-
+
+Die erzeugte Datei könnte wie folgt aussehen (nach Entfernung des absoluten
+Pfades):
+
::
-
+
001\wp.shp
003\wp.shp
005\wp.shp
@@ -91,39 +94,39 @@
017\wp.shp
019\wp.shp
. . .
+
+2. Ausfühunr des Preogramms tile4ms mit dem eben erstellten meta-file um
+ die Indexdatei zu erzeugen:
-2. Execute the tile4ms command with the newly created meta-file to create the
- index file:
+ ::
- ::
-
tile4ms wp_list.txt index
Processed 87 of 87 files
+
+3. Eine neue Datei 'index.shp' wurde erstellt. Dies ist die Indexdatei mit allen
+ MBR für alle 'wp.shp'.Dateien für ganz Minnesota, siehe Abbildung 1.
+ Die Attributtabelle dieser Datei enthält eine Spalte 'LOCATION', die wiederum
+ den Pfad zu den wp.shp-Dateien enthält, siehe Abbildung 2.
-3. A new file named 'index.shp' is created. This is the index file with the MBRs
- of all 'wp.shp' files for the entire state, as shown in Figure1. The attribute
- table of this file contains a field named 'LOCATION', that contains the path to
- each 'wp.shp file', as shown in Figure2.
+ **Abbildung 1: Von tile4ms erzeugte Indexdatei**
- **Figure 1: Index file created by tile4ms utility**
-
.. image:: ../images/tile4ms-view.png
- **Figure 2: Attributes of index file created by tile4ms utility**
+ **Abbildung 2: Attribute der erzeugten Indexdatei**
.. image:: ../images/tile4ms-attributes.png
+
+4. Der letzte Schritt besteht in der Verwendung im Mapfile.
+ - LAYER-Objekt TILEINDEX - gibt den Pfad zur Indexdatei an
+ - Layer-Objekt TILEITEM - gibt des Namen der Attributspalte an, die die
+ Pfade enthält (Standard ist 'location')
+ - Der Parameter DATA kann weggelassen werden.
-4. The final step is to use this in your mapfile.
- - LAYER object's TILEINDEX - must point to the location of the index file
- - LAYER object's TILEITEM - specify the name of the field in the index file
- containing the paths (default is 'location')
- - do not need to use the LAYER's DATA parameter
-
For example:
::
-
+
LAYER
NAME 'mn-lakes'
STATUS ON
@@ -137,7 +140,7 @@
END
END
END
-
- When you view the layer in a MapServer application, you will notice that when
- you are zoomed into a small area of the state only those lakes layers are
- loaded, which speeds up the application.
\ No newline at end of file
+
+Wird dieser Layer in einer MapServer-Anwendung benutzt, werden bei großem
+Maßstab (dicht am Boden) nur die betroffenen Dateien werden geladen. Dies
+beschleunigt die Anwandung.
More information about the mapserver-commits
mailing list