diff options
| author | Étienne Loks <etienne.loks@peacefrogs.net> | 2012-11-28 14:42:19 +0100 |
|---|---|---|
| committer | Étienne Loks <etienne.loks@peacefrogs.net> | 2012-11-28 14:42:19 +0100 |
| commit | 72ede57e660210de690e2641732a1860e87a2818 (patch) | |
| tree | 2ed91737d1c6f19c00be00962169c0b6f12d85b1 | |
| parent | c590082daa7b5eca6d5f021e356e4ddd15cee595 (diff) | |
| download | Chimère-72ede57e660210de690e2641732a1860e87a2818.tar.bz2 Chimère-72ede57e660210de690e2641732a1860e87a2818.zip | |
Update documentation
27 files changed, 614 insertions, 58 deletions
diff --git a/docs/_build/html/_images/chimere_admin_import_CSV.png b/docs/_build/html/_images/chimere_admin_import_CSV.png Binary files differnew file mode 100644 index 0000000..e67a37b --- /dev/null +++ b/docs/_build/html/_images/chimere_admin_import_CSV.png diff --git a/docs/_build/html/_images/chimere_admin_import_KML.png b/docs/_build/html/_images/chimere_admin_import_KML.png Binary files differnew file mode 100644 index 0000000..b48d69a --- /dev/null +++ b/docs/_build/html/_images/chimere_admin_import_KML.png diff --git a/docs/_build/html/_images/chimere_admin_import_OSM.png b/docs/_build/html/_images/chimere_admin_import_OSM.png Binary files differnew file mode 100644 index 0000000..a599348 --- /dev/null +++ b/docs/_build/html/_images/chimere_admin_import_OSM.png diff --git a/docs/_build/html/_images/chimere_admin_import_georss.png b/docs/_build/html/_images/chimere_admin_import_georss.png Binary files differnew file mode 100644 index 0000000..5278652 --- /dev/null +++ b/docs/_build/html/_images/chimere_admin_import_georss.png diff --git a/docs/_build/html/_images/chimere_admin_import_shapefile.png b/docs/_build/html/_images/chimere_admin_import_shapefile.png Binary files differnew file mode 100644 index 0000000..ce612be --- /dev/null +++ b/docs/_build/html/_images/chimere_admin_import_shapefile.png diff --git a/docs/_build/html/_sources/administration.txt b/docs/_build/html/_sources/administration.txt index 2f8ddb5..b79c95b 100644 --- a/docs/_build/html/_sources/administration.txt +++ b/docs/_build/html/_sources/administration.txt @@ -6,7 +6,7 @@ Administration ============== :Author: Étienne Loks -:date: 2012-10-08 +:date: 2012-11-28 :Copyright: CC-BY 3.0 This documents presents the administration of Chimère. @@ -130,6 +130,8 @@ basic color it can be set with the English name (for instance: *red*, *blue*, The element type is the type of element the subcategory can contain: POI, route or both. +.. _geographic-items-management: + Edition/moderation of items --------------------------- @@ -155,11 +157,12 @@ There is a some actions available in the action list. To modify an item, classically you have to click on his name. Then you access to a form to freely modify the item. In this form there is all data available to the end user form plus some extra -fields. The *Import fields* only make sense with data imported from an external +fields. +- The *Import fields* only make sense with data imported from an external source or for data to be exported to OSM cf. to the :ref:`import section -<importing>` of this documentation. *Associated items fields* are read only -fields that list items associated to the current one (reference item of an -amendment, associated file of a route). +<importing>` of this documentation. +- *Associated items fields* are read only fields that list items associated to +the current one (reference item of an amendment, associated file of a route). Associated multimedia items are at the bottom of the form. You can freely add, change items and change their order with drag and drop. diff --git a/docs/_build/html/_sources/customisation.txt b/docs/_build/html/_sources/customisation.txt index 19002dc..c8ce2f6 100644 --- a/docs/_build/html/_sources/customisation.txt +++ b/docs/_build/html/_sources/customisation.txt @@ -1,11 +1,11 @@ .. -*- coding: utf-8 -*- -===================== -Chimère customisation -===================== +============= +Customisation +============= :Author: Étienne Loks -:date: 2012-10-08 +:date: 2012-11-28 :Copyright: CC-BY 3.0 This documents presents the installation of Chimère. diff --git a/docs/_build/html/_sources/import_export.txt b/docs/_build/html/_sources/import_export.txt index 3d4b0ed..71f9178 100644 --- a/docs/_build/html/_sources/import_export.txt +++ b/docs/_build/html/_sources/import_export.txt @@ -1,11 +1,11 @@ .. -*- coding: utf-8 -*- -===================== -Chimère import/export -===================== +============= +Import/export +============= :Author: Étienne Loks -:date: 2012-10-08 +:date: 2012-11-28 :Copyright: CC-BY 3.0 This documents presents the administration of Chimère. @@ -15,3 +15,186 @@ The version has been updated for version 2.0.0. Importing --------- + +In Chimère the import mechanism is based on **Import object**. Theses objects +are stored in database to keep trace of imports and to facilitate the +re-importation from the same source. In fact if possible the update of data from +a same type of source is managed. The ability to do such updates depends on the +existence of a unique id for each object on your source. + +To add an **Import object** you need to go to *Chimere > Imports* then **Add**. + +After that you'll have to select your source type and then the form depends on +the type of source. + +Common fields +************* + +- **Name by default**: if no name can be identified to the newly imported object + this is the name that will be used. If this field is empty the name of the + associated category will be use. +- **SRID**: Chimère will try to identify automatically the correct projection + from the given source. But sometimes the information is not present or cannot + be guessed (for instance a Shapefile that uses non standard proj file). In + this case Chimère will use WGS84 by default (the classic latitude/longitude) + but it is not always correct. If you experience problems with items + localisation you should put here the SRID associated to the projection of + your source. +- **Origin**: if not null this field will be associated to each item imported in + order to easily identify where the item came from. For OSM import the source + is automatically added. +- **License**: if not null this field will be associated to each item imported in + order to easily identify the license associated to the item. For OSM import + the license is automatically added. +- **Associated subcategories (mandatory)**: The selected subcategories will be + associated to newly imported items. + + +KML import +********** + +.. image:: _static/chimere_admin_import_KML.png + + +- **Web address/source file (mandatory)**: your KML could be distant or a local + file. You'll have to fill one of the two fields. +- **Filter**: if you want to import only a specific *Folder* of your KML file + put his name on this field. +- **Zipped file**: if your source is a KMLZ file (a zipped KML) check this case. + +Shapefile import +**************** + +.. image:: _static/chimere_admin_import_shapefile.png + + +- **Web address/source file (mandatory)**: your KML could be distant or a local + file. You'll have to fill one of the two fields. +- **Zipped file**: only zipped shapefile are accepted this checkbox have to be + checked. + +GeoRSS import +************* + +Simple GeoRSS and W3C GeoRSS are managed. + +.. image:: _static/chimere_admin_import_georss.png + +- **Web address (mandatory)**: only distant GeoRSS are managed. + +CSV import +********** + +As the format of the CSV file managed by Chimère could vary depending on the +property you have add on your Chimère instance we recommend you to first do +an export of some items in CSV with Chimère. The CSV format of the exported +file will meet Chimère requirements. By the way because of the geometry of +the item this format is not very convenient to add new content but could +be handy to update informations. + +.. image:: _static/chimere_admin_import_CSV.png + +- **Web address/source file (mandatory)**: your CSV file could be distant or a + local file. You'll have to fill one of the two fields. + +.. _osm-import: + +OpenStreetMap import +******************** + +.. image:: _static/chimere_admin_import_OSM.png + +To import from OSM Chimère uses the XAPI API of OSM. + +- **Web address (mandatory)**: XAPI url used to import data. This field should + be filled with a default address. By default the MapQuest server is used as it + seems to be the more robust. If you experience problems with OSM import check + the availability of the XAPI server used and eventually change it. +- **Filter area (mandatory)**: draw the bounding box you want to use for your + OSM import. +- **Filter type (mandatory)**: choose if you want to import way or nodes. +- **Filter tag (mandatory)**: choose the OSM key/value couple used to filter OSM + data. A link to the `OSM Map features page + <https://wiki.openstreetmap.org/wiki/Map_Features>`_ is provided to help you + find appropriate values. +- **Refresh button**: this button convert your choices to appropriate XAPI args. + You have to hit this button before validating the form. + +Importing +********* + +Once your new import item created. Select it in the import object list, select +the **Import** action and validated. + +The import should be processing normally. If not an explicit error message +should be print in the state column of your import. + +Managing imported data +********************** + +All new imported items have the state **Imported**. To make them available on +the map you'll have to validate them. If you don't want an item to be visible on +the map instead of delete them it is recommended to set them to the state +**Disabled**. + +.. Warning:: + Be careful with duplicates between your existing data and imported data. This + is particularly important if you want to export your data to OSM. + +Exporting +--------- + +Export to CSV/KML/Shapefile +*************************** + +Directly from the :ref:`geographic items list <geographic-items-management>` you +can export to the choose format. All you have to do is to select the desired +items, choose the appropriate action in the action list and validate. + +Export to OSM +************* + +.. Warning:: + If you are not sure of what you are doing with OSM export: don't do it! It is + really important to not mess with others data. + +.. Note:: + Only export of OSM nodes are managed. + +OSM export is not that easily managed. First (if not yet done) you'll have to +define an import (:ref:`see above <osm-import>` for details). This will permit +to determine: + +- the area concerned by your export. +- the key/value tag to append to your new/updated items. +- the subcategories concerned by your export. If you think that some items in + theses subcategories should not be in OSM database (because there are not + relevant or because of license issues) beforehand mark them as **Not for OSM** + in the *import fields* of the :ref:`geographic items forms + <geographic-items-management>`. + + +The OSM export in Chimère is designed to be the more preservative possible in +regards to OSM database. That's why before any export an import is done. If +the new import has updated data theses new data will overload data in your +Chimère (if you don't want that: don't do export). All pending imported items +should have been treated before doing an export. + +To launch an export select the appropriate Import object in the imports list. +Then select the **Export to OSM** action and validate. +Then you'll be asked for your OSM username and password and the API you want to +use. If you use regularly Chimère to do export it is recommended to create an +OSM specific account for that. +The test API is available to make export test. If you want to use the test +API you'll have to create a specific account on the test platform. + +.. Warning:: + The data on the test platform are not synced with the main platform you are + not going to have the same data that you got with XAPI. + +Once all this field filled you can (finally!) launch the export. + +When exporting tags are automatically added/updated: + +- *name*: get from the item name in Chimère. +- *source*: to identify Chimère as a source. diff --git a/docs/_build/html/_static/chimere_admin_import_CSV.png b/docs/_build/html/_static/chimere_admin_import_CSV.png Binary files differnew file mode 100644 index 0000000..e67a37b --- /dev/null +++ b/docs/_build/html/_static/chimere_admin_import_CSV.png diff --git a/docs/_build/html/_static/chimere_admin_import_KML.png b/docs/_build/html/_static/chimere_admin_import_KML.png Binary files differnew file mode 100644 index 0000000..b48d69a --- /dev/null +++ b/docs/_build/html/_static/chimere_admin_import_KML.png diff --git a/docs/_build/html/_static/chimere_admin_import_OSM.png b/docs/_build/html/_static/chimere_admin_import_OSM.png Binary files differnew file mode 100644 index 0000000..a599348 --- /dev/null +++ b/docs/_build/html/_static/chimere_admin_import_OSM.png diff --git a/docs/_build/html/_static/chimere_admin_import_georss.png b/docs/_build/html/_static/chimere_admin_import_georss.png Binary files differnew file mode 100644 index 0000000..5278652 --- /dev/null +++ b/docs/_build/html/_static/chimere_admin_import_georss.png diff --git a/docs/_build/html/_static/chimere_admin_import_shapefile.png b/docs/_build/html/_static/chimere_admin_import_shapefile.png Binary files differnew file mode 100644 index 0000000..ce612be --- /dev/null +++ b/docs/_build/html/_static/chimere_admin_import_shapefile.png diff --git a/docs/_build/html/administration.html b/docs/_build/html/administration.html index 518d2a9..df157d0 100644 --- a/docs/_build/html/administration.html +++ b/docs/_build/html/administration.html @@ -26,7 +26,7 @@ <script type="text/javascript" src="_static/underscore.js"></script> <script type="text/javascript" src="_static/doctools.js"></script> <link rel="top" title="Chimère 2.0 documentation" href="index.html" /> - <link rel="next" title="Chimère import/export" href="import_export.html" /> + <link rel="next" title="Import/export" href="import_export.html" /> <link rel="prev" title="Configuration" href="configuration.html" /> </head> <body> @@ -37,7 +37,7 @@ <a href="genindex.html" title="General Index" accesskey="I">index</a></li> <li class="right" > - <a href="import_export.html" title="Chimère import/export" + <a href="import_export.html" title="Import/export" accesskey="N">next</a> |</li> <li class="right" > <a href="configuration.html" title="Configuration" @@ -59,7 +59,7 @@ <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Author:</th><td class="field-body">Étienne Loks</td> </tr> -<tr class="field-even field"><th class="field-name">date:</th><td class="field-body">2012-10-08</td> +<tr class="field-even field"><th class="field-name">date:</th><td class="field-body">2012-11-28</td> </tr> <tr class="field-odd field"><th class="field-name">Copyright:</th><td class="field-body">CC-BY 3.0</td> </tr> @@ -172,7 +172,7 @@ The element type is the type of element the subcategory can contain: POI, route or both.</p> </div> <div class="section" id="edition-moderation-of-items"> -<h2>Edition/moderation of items<a class="headerlink" href="#edition-moderation-of-items" title="Permalink to this headline">¶</a></h2> +<span id="geographic-items-management"></span><h2>Edition/moderation of items<a class="headerlink" href="#edition-moderation-of-items" title="Permalink to this headline">¶</a></h2> <p>The moderation step is quite simple. It works the same with POIs and routes. The moderator can access to all POIs (or routes) by clicking on them on the list.</p> @@ -192,10 +192,11 @@ one by one.</li> <p>To modify an item, classically you have to click on his name. Then you access to a form to freely modify the item. In this form there is all data available to the end user form plus some extra -fields. The <em>Import fields</em> only make sense with data imported from an external -source or for data to be exported to OSM cf. to the <a class="reference internal" href="import_export.html#importing"><em>import section</em></a> of this documentation. <em>Associated items fields</em> are read only -fields that list items associated to the current one (reference item of an -amendment, associated file of a route).</p> +fields. +- The <em>Import fields</em> only make sense with data imported from an external +source or for data to be exported to OSM cf. to the <a class="reference internal" href="import_export.html#importing"><em>import section</em></a> of this documentation. +- <em>Associated items fields</em> are read only fields that list items associated to +the current one (reference item of an amendment, associated file of a route).</p> <p>Associated multimedia items are at the bottom of the form. You can freely add, change items and change their order with drag and drop.</p> <p>Don’t forget to validate your change with one of the <strong>Save</strong> buttons at the @@ -258,7 +259,7 @@ reference item.</li> title="previous chapter">Configuration</a></p> <h4>Next topic</h4> <p class="topless"><a href="import_export.html" - title="next chapter">Chimère import/export</a></p> + title="next chapter">Import/export</a></p> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="_sources/administration.txt" @@ -288,7 +289,7 @@ reference item.</li> <a href="genindex.html" title="General Index" >index</a></li> <li class="right" > - <a href="import_export.html" title="Chimère import/export" + <a href="import_export.html" title="Import/export" >next</a> |</li> <li class="right" > <a href="configuration.html" title="Configuration" diff --git a/docs/_build/html/customisation.html b/docs/_build/html/customisation.html index 1153c89..94a1d4b 100644 --- a/docs/_build/html/customisation.html +++ b/docs/_build/html/customisation.html @@ -8,7 +8,7 @@ <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - <title>Chimère customisation — Chimère 2.0 documentation</title> + <title>Customisation — Chimère 2.0 documentation</title> <link rel="stylesheet" href="_static/default.css" type="text/css" /> <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> @@ -26,7 +26,7 @@ <script type="text/javascript" src="_static/underscore.js"></script> <script type="text/javascript" src="_static/doctools.js"></script> <link rel="top" title="Chimère 2.0 documentation" href="index.html" /> - <link rel="prev" title="Chimère import/export" href="import_export.html" /> + <link rel="prev" title="Import/export" href="import_export.html" /> </head> <body> <div class="related"> @@ -36,7 +36,7 @@ <a href="genindex.html" title="General Index" accesskey="I">index</a></li> <li class="right" > - <a href="import_export.html" title="Chimère import/export" + <a href="import_export.html" title="Import/export" accesskey="P">previous</a> |</li> <li><a href="index.html">Chimère 2.0 documentation</a> »</li> </ul> @@ -47,15 +47,15 @@ <div class="bodywrapper"> <div class="body"> - <div class="section" id="chimere-customisation"> -<h1>Chimère customisation<a class="headerlink" href="#chimere-customisation" title="Permalink to this headline">¶</a></h1> + <div class="section" id="customisation"> +<h1>Customisation<a class="headerlink" href="#customisation" title="Permalink to this headline">¶</a></h1> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Author:</th><td class="field-body">Étienne Loks</td> </tr> -<tr class="field-even field"><th class="field-name">date:</th><td class="field-body">2012-10-08</td> +<tr class="field-even field"><th class="field-name">date:</th><td class="field-body">2012-11-28</td> </tr> <tr class="field-odd field"><th class="field-name">Copyright:</th><td class="field-body">CC-BY 3.0</td> </tr> @@ -102,7 +102,7 @@ for more details.</p> <div class="sphinxsidebarwrapper"> <h3><a href="index.html">Table Of Contents</a></h3> <ul> -<li><a class="reference internal" href="#">Chimère customisation</a><ul> +<li><a class="reference internal" href="#">Customisation</a><ul> <li><a class="reference internal" href="#managing-layers">Managing layers</a></li> <li><a class="reference internal" href="#customizing-the-layout-and-the-design">Customizing the layout and the design</a></li> </ul> @@ -111,7 +111,7 @@ for more details.</p> <h4>Previous topic</h4> <p class="topless"><a href="import_export.html" - title="previous chapter">Chimère import/export</a></p> + title="previous chapter">Import/export</a></p> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="_sources/customisation.txt" @@ -141,7 +141,7 @@ for more details.</p> <a href="genindex.html" title="General Index" >index</a></li> <li class="right" > - <a href="import_export.html" title="Chimère import/export" + <a href="import_export.html" title="Import/export" >previous</a> |</li> <li><a href="index.html">Chimère 2.0 documentation</a> »</li> </ul> diff --git a/docs/_build/html/import_export.html b/docs/_build/html/import_export.html index 2772c8e..00b696c 100644 --- a/docs/_build/html/import_export.html +++ b/docs/_build/html/import_export.html @@ -8,7 +8,7 @@ <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - <title>Chimère import/export — Chimère 2.0 documentation</title> + <title>Import/export — Chimère 2.0 documentation</title> <link rel="stylesheet" href="_static/default.css" type="text/css" /> <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> @@ -26,7 +26,7 @@ <script type="text/javascript" src="_static/underscore.js"></script> <script type="text/javascript" src="_static/doctools.js"></script> <link rel="top" title="Chimère 2.0 documentation" href="index.html" /> - <link rel="next" title="Chimère customisation" href="customisation.html" /> + <link rel="next" title="Customisation" href="customisation.html" /> <link rel="prev" title="Administration" href="administration.html" /> </head> <body> @@ -37,7 +37,7 @@ <a href="genindex.html" title="General Index" accesskey="I">index</a></li> <li class="right" > - <a href="customisation.html" title="Chimère customisation" + <a href="customisation.html" title="Customisation" accesskey="N">next</a> |</li> <li class="right" > <a href="administration.html" title="Administration" @@ -51,15 +51,15 @@ <div class="bodywrapper"> <div class="body"> - <div class="section" id="chimere-import-export"> -<h1>Chimère import/export<a class="headerlink" href="#chimere-import-export" title="Permalink to this headline">¶</a></h1> + <div class="section" id="import-export"> +<h1>Import/export<a class="headerlink" href="#import-export" title="Permalink to this headline">¶</a></h1> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Author:</th><td class="field-body">Étienne Loks</td> </tr> -<tr class="field-even field"><th class="field-name">date:</th><td class="field-body">2012-10-08</td> +<tr class="field-even field"><th class="field-name">date:</th><td class="field-body">2012-11-28</td> </tr> <tr class="field-odd field"><th class="field-name">Copyright:</th><td class="field-body">CC-BY 3.0</td> </tr> @@ -69,6 +69,173 @@ The version has been updated for version 2.0.0.</p> <div class="section" id="importing"> <span id="id1"></span><h2>Importing<a class="headerlink" href="#importing" title="Permalink to this headline">¶</a></h2> +<p>In Chimère the import mechanism is based on <strong>Import object</strong>. Theses objects +are stored in database to keep trace of imports and to facilitate the +re-importation from the same source. In fact if possible the update of data from +a same type of source is managed. The ability to do such updates depends on the +existence of a unique id for each object on your source.</p> +<p>To add an <strong>Import object</strong> you need to go to <em>Chimere > Imports</em> then <strong>Add</strong>.</p> +<p>After that you’ll have to select your source type and then the form depends on +the type of source.</p> +<div class="section" id="common-fields"> +<h3>Common fields<a class="headerlink" href="#common-fields" title="Permalink to this headline">¶</a></h3> +<ul class="simple"> +<li><strong>Name by default</strong>: if no name can be identified to the newly imported object +this is the name that will be used. If this field is empty the name of the +associated category will be use.</li> +<li><strong>SRID</strong>: Chimère will try to identify automatically the correct projection +from the given source. But sometimes the information is not present or cannot +be guessed (for instance a Shapefile that uses non standard proj file). In +this case Chimère will use WGS84 by default (the classic latitude/longitude) +but it is not always correct. If you experience problems with items +localisation you should put here the SRID associated to the projection of +your source.</li> +<li><strong>Origin</strong>: if not null this field will be associated to each item imported in +order to easily identify where the item came from. For OSM import the source +is automatically added.</li> +<li><strong>License</strong>: if not null this field will be associated to each item imported in +order to easily identify the license associated to the item. For OSM import +the license is automatically added.</li> +<li><strong>Associated subcategories (mandatory)</strong>: The selected subcategories will be +associated to newly imported items.</li> +</ul> +</div> +<div class="section" id="kml-import"> +<h3>KML import<a class="headerlink" href="#kml-import" title="Permalink to this headline">¶</a></h3> +<img alt="_images/chimere_admin_import_KML.png" src="_images/chimere_admin_import_KML.png" /> +<ul class="simple"> +<li><strong>Web address/source file (mandatory)</strong>: your KML could be distant or a local +file. You’ll have to fill one of the two fields.</li> +<li><strong>Filter</strong>: if you want to import only a specific <em>Folder</em> of your KML file +put his name on this field.</li> +<li><strong>Zipped file</strong>: if your source is a KMLZ file (a zipped KML) check this case.</li> +</ul> +</div> +<div class="section" id="shapefile-import"> +<h3>Shapefile import<a class="headerlink" href="#shapefile-import" title="Permalink to this headline">¶</a></h3> +<img alt="_images/chimere_admin_import_shapefile.png" src="_images/chimere_admin_import_shapefile.png" /> +<ul class="simple"> +<li><strong>Web address/source file (mandatory)</strong>: your KML could be distant or a local +file. You’ll have to fill one of the two fields.</li> +<li><strong>Zipped file</strong>: only zipped shapefile are accepted this checkbox have to be +checked.</li> +</ul> +</div> +<div class="section" id="georss-import"> +<h3>GeoRSS import<a class="headerlink" href="#georss-import" title="Permalink to this headline">¶</a></h3> +<p>Simple GeoRSS and W3C GeoRSS are managed.</p> +<img alt="_images/chimere_admin_import_georss.png" src="_images/chimere_admin_import_georss.png" /> +<ul class="simple"> +<li><strong>Web address (mandatory)</strong>: only distant GeoRSS are managed.</li> +</ul> +</div> +<div class="section" id="csv-import"> +<h3>CSV import<a class="headerlink" href="#csv-import" title="Permalink to this headline">¶</a></h3> +<p>As the format of the CSV file managed by Chimère could vary depending on the +property you have add on your Chimère instance we recommend you to first do +an export of some items in CSV with Chimère. The CSV format of the exported +file will meet Chimère requirements. By the way because of the geometry of +the item this format is not very convenient to add new content but could +be handy to update informations.</p> +<img alt="_images/chimere_admin_import_CSV.png" src="_images/chimere_admin_import_CSV.png" /> +<ul class="simple"> +<li><strong>Web address/source file (mandatory)</strong>: your CSV file could be distant or a +local file. You’ll have to fill one of the two fields.</li> +</ul> +</div> +<div class="section" id="openstreetmap-import"> +<span id="osm-import"></span><h3>OpenStreetMap import<a class="headerlink" href="#openstreetmap-import" title="Permalink to this headline">¶</a></h3> +<img alt="_images/chimere_admin_import_OSM.png" src="_images/chimere_admin_import_OSM.png" /> +<p>To import from OSM Chimère uses the XAPI API of OSM.</p> +<ul class="simple"> +<li><strong>Web address (mandatory)</strong>: XAPI url used to import data. This field should +be filled with a default address. By default the MapQuest server is used as it +seems to be the more robust. If you experience problems with OSM import check +the availability of the XAPI server used and eventually change it.</li> +<li><strong>Filter area (mandatory)</strong>: draw the bounding box you want to use for your +OSM import.</li> +<li><strong>Filter type (mandatory)</strong>: choose if you want to import way or nodes.</li> +<li><strong>Filter tag (mandatory)</strong>: choose the OSM key/value couple used to filter OSM +data. A link to the <a class="reference external" href="https://wiki.openstreetmap.org/wiki/Map_Features">OSM Map features page</a> is provided to help you +find appropriate values.</li> +<li><strong>Refresh button</strong>: this button convert your choices to appropriate XAPI args. +You have to hit this button before validating the form.</li> +</ul> +</div> +<div class="section" id="id2"> +<h3>Importing<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3> +<p>Once your new import item created. Select it in the import object list, select +the <strong>Import</strong> action and validated.</p> +<p>The import should be processing normally. If not an explicit error message +should be print in the state column of your import.</p> +</div> +<div class="section" id="managing-imported-data"> +<h3>Managing imported data<a class="headerlink" href="#managing-imported-data" title="Permalink to this headline">¶</a></h3> +<p>All new imported items have the state <strong>Imported</strong>. To make them available on +the map you’ll have to validate them. If you don’t want an item to be visible on +the map instead of delete them it is recommended to set them to the state +<strong>Disabled</strong>.</p> +<div class="admonition warning"> +<p class="first admonition-title">Warning</p> +<p class="last">Be careful with duplicates between your existing data and imported data. This +is particularly important if you want to export your data to OSM.</p> +</div> +</div> +</div> +<div class="section" id="exporting"> +<h2>Exporting<a class="headerlink" href="#exporting" title="Permalink to this headline">¶</a></h2> +<div class="section" id="export-to-csv-kml-shapefile"> +<h3>Export to CSV/KML/Shapefile<a class="headerlink" href="#export-to-csv-kml-shapefile" title="Permalink to this headline">¶</a></h3> +<p>Directly from the <a class="reference internal" href="administration.html#geographic-items-management"><em>geographic items list</em></a> you +can export to the choose format. All you have to do is to select the desired +items, choose the appropriate action in the action list and validate.</p> +</div> +<div class="section" id="export-to-osm"> +<h3>Export to OSM<a class="headerlink" href="#export-to-osm" title="Permalink to this headline">¶</a></h3> +<div class="admonition warning"> +<p class="first admonition-title">Warning</p> +<p class="last">If you are not sure of what you are doing with OSM export: don’t do it! It is +really important to not mess with others data.</p> +</div> +<div class="admonition note"> +<p class="first admonition-title">Note</p> +<p class="last">Only export of OSM nodes are managed.</p> +</div> +<p>OSM export is not that easily managed. First (if not yet done) you’ll have to +define an import (<a class="reference internal" href="#osm-import"><em>see above</em></a> for details). This will permit +to determine:</p> +<ul class="simple"> +<li>the area concerned by your export.</li> +<li>the key/value tag to append to your new/updated items.</li> +<li>the subcategories concerned by your export. If you think that some items in +theses subcategories should not be in OSM database (because there are not +relevant or because of license issues) beforehand mark them as <strong>Not for OSM</strong> +in the <em>import fields</em> of the <a class="reference internal" href="administration.html#geographic-items-management"><em>geographic items forms</em></a>.</li> +</ul> +<p>The OSM export in Chimère is designed to be the more preservative possible in +regards to OSM database. That’s why before any export an import is done. If +the new import has updated data theses new data will overload data in your +Chimère (if you don’t want that: don’t do export). All pending imported items +should have been treated before doing an export.</p> +<p>To launch an export select the appropriate Import object in the imports list. +Then select the <strong>Export to OSM</strong> action and validate. +Then you’ll be asked for your OSM username and password and the API you want to +use. If you use regularly Chimère to do export it is recommended to create an +OSM specific account for that. +The test API is available to make export test. If you want to use the test +API you’ll have to create a specific account on the test platform.</p> +<div class="admonition warning"> +<p class="first admonition-title">Warning</p> +<p class="last">The data on the test platform are not synced with the main platform you are +not going to have the same data that you got with XAPI.</p> +</div> +<p>Once all this field filled you can (finally!) launch the export.</p> +<p>When exporting tags are automatically added/updated:</p> +<ul class="simple"> +<li><em>name</em>: get from the item name in Chimère.</li> +<li><em>source</em>: to identify Chimère as a source.</li> +</ul> +</div> </div> </div> @@ -80,8 +247,23 @@ The version has been updated for version 2.0.0.</p> <div class="sphinxsidebarwrapper"> <h3><a href="index.html">Table Of Contents</a></h3> <ul> -<li><a class="reference internal" href="#">Chimère import/export</a><ul> -<li><a class="reference internal" href="#importing">Importing</a></li> +<li><a class="reference internal" href="#">Import/export</a><ul> +<li><a class="reference internal" href="#importing">Importing</a><ul> +<li><a class="reference internal" href="#common-fields">Common fields</a></li> +<li><a class="reference internal" href="#kml-import">KML import</a></li> +<li><a class="reference internal" href="#shapefile-import">Shapefile import</a></li> +<li><a class="reference internal" href="#georss-import">GeoRSS import</a></li> +<li><a class="reference internal" href="#csv-import">CSV import</a></li> +<li><a class="reference internal" href="#openstreetmap-import">OpenStreetMap import</a></li> +<li><a class="reference internal" href="#id2">Importing</a></li> +<li><a class="reference internal" href="#managing-imported-data">Managing imported data</a></li> +</ul> +</li> +<li><a class="reference internal" href="#exporting">Exporting</a><ul> +<li><a class="reference internal" href="#export-to-csv-kml-shapefile">Export to CSV/KML/Shapefile</a></li> +<li><a class="reference internal" href="#export-to-osm">Export to OSM</a></li> +</ul> +</li> </ul> </li> </ul> @@ -91,7 +273,7 @@ The version has been updated for version 2.0.0.</p> title="previous chapter">Administration</a></p> <h4>Next topic</h4> <p class="topless"><a href="customisation.html" - title="next chapter">Chimère customisation</a></p> + title="next chapter">Customisation</a></p> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="_sources/import_export.txt" @@ -121,7 +303,7 @@ The version has been updated for version 2.0.0.</p> <a href="genindex.html" title="General Index" >index</a></li> <li class="right" > - <a href="customisation.html" title="Chimère customisation" + <a href="customisation.html" title="Customisation" >next</a> |</li> <li class="right" > <a href="administration.html" title="Administration" diff --git a/docs/_build/html/index.html b/docs/_build/html/index.html index 75d01c2..0576faf 100644 --- a/docs/_build/html/index.html +++ b/docs/_build/html/index.html @@ -84,11 +84,12 @@ <li class="toctree-l2"><a class="reference internal" href="administration.html#managing-end-user-amendment">Managing end user amendment</a></li> </ul> </li> -<li class="toctree-l1"><a class="reference internal" href="import_export.html">Chimère import/export</a><ul> +<li class="toctree-l1"><a class="reference internal" href="import_export.html">Import/export</a><ul> <li class="toctree-l2"><a class="reference internal" href="import_export.html#importing">Importing</a></li> +<li class="toctree-l2"><a class="reference internal" href="import_export.html#exporting">Exporting</a></li> </ul> </li> -<li class="toctree-l1"><a class="reference internal" href="customisation.html">Chimère customisation</a><ul> +<li class="toctree-l1"><a class="reference internal" href="customisation.html">Customisation</a><ul> <li class="toctree-l2"><a class="reference internal" href="customisation.html#managing-layers">Managing layers</a></li> <li class="toctree-l2"><a class="reference internal" href="customisation.html#customizing-the-layout-and-the-design">Customizing the layout and the design</a></li> </ul> diff --git a/docs/_build/html/objects.inv b/docs/_build/html/objects.inv Binary files differindex d0161af..7538b6a 100644 --- a/docs/_build/html/objects.inv +++ b/docs/_build/html/objects.inv diff --git a/docs/_build/html/searchindex.js b/docs/_build/html/searchindex.js index e21926c..b2a8630 100644 --- a/docs/_build/html/searchindex.js +++ b/docs/_build/html/searchindex.js @@ -1 +1 @@ -Search.setIndex({objects:{},terms:{all:[1,3,6],code:[0,1,3,4],forget:[1,3],yellow:3,signific:[1,4],osm:[0,6,3],follow:[1,6,4],feedpars:[1,4],row:3,content:[6,3],hold:6,depend:[2,1,4],zone:4,readabl:[6,4],base_url:[],send:4,easiest:0,init:4,program:[],titl:3,text:6,sens:3,town:[],sourc:[2,1,3,4],string:[1,4],createsuperus:6,relev:[3,4],administr:[0,2,3,4,5,6],button:[6,3],list:[3,4],geograph:[6,3,4],item:[2,6,3],form:[6,3],quick:[],initialis:[2,1,6,4],dir:4,pleas:4,base_us:[],direct:1,sign:4,second:3,design:[0,2],download:4,further:1,myusernam:4,click:[6,3],blue:3,index:[],appear:3,compar:[],section:[6,3],multimedia:[6,3],abl:6,beautifulsoup:4,access:[6,3],delet:[6,3],version:[0,1,2,3,4,5,6],"new":[0,1,2,3,4,6],net:[1,4],chimer:[0,1,3,6,4],chose:[],createdb:4,french:4,"005k":1,witch:6,address:[],path:[6,3,4],modifi:[0,6,3,4],sinc:4,interpret:[],box:[6,3],search:3,larger:0,host:[],prior:[],permit:[6,3],action:3,template_context_processor:[],chang:[0,1,3,6,4],apart:[],chanc:6,environn:1,chimere_tag:1,repositori:[1,4],extra:[0,3],father:[],modul:[],apt:[1,4],vim:[1,4],put:3,authentifi:3,subcategori:[2,6,3],fake:1,marker:1,instal:[0,1,6,4,2],select:[6,3],from:[1,3,4],would:[1,4],univers:4,upgrad:[2,1],next:1,websit:[6,4],few:[6,3],handler:[],usr:[1,4],criteria:3,type:[0,6,3,4],more:[0,6,3,4],sort:[6,3],where_is_your_chimer:3,desir:4,mypassword:[],share:4,relat:4,server_url:1,customis:[0,1,2],phone:6,"export":[2,3,5],indic:[],particular:4,recommand:4,unpack:4,cach:[2,1,6],must:[0,1,6,4],psql:4,"static":[1,4],account:[6,3,4],word:3,hour:6,prepar:1,work:[1,3,6],uniqu:[6,4],soup:4,paragraph:[1,6],can:[0,1,3,6,4],lc_messag:4,default_categori:[],root:4,control:6,prompt:4,tar:4,give:6,process:[1,3],sudo:[],smtp:4,templat:[0,1,4,2],tarbal:1,tag:[3,4],want:[0,6,3,4],default_cent:[],spe:[],mapnik:[0,6],lxml:[1,4],end:[0,6,3,2],freshli:3,anoth:4,length:[1,4],write:[],pure:0,reject:3,verifi:1,simpl:[6,3],css:[0,6],email_host:4,map:[0,6,3],product:1,rebas:1,pypi:4,clone:[1,4],after:[1,3],superus:6,upload:[1,4],manuali:[],befor:[1,3],plane:1,beauti:4,date:[0,1,3,4,5,6],multipl:3,data:[1,3,4],"short":4,practic:6,third:3,bind:1,bing:0,postgi:4,lost:1,stash:1,django:[0,1,6,4],issu:[],inform:[6,3],environ:[1,6],jquery_js_url:4,allow:6,order:[6,3],oper:3,checkbox:3,move:[1,4],becaus:[1,4],meter:1,through:[],addus:4,tinymce_url:4,still:4,mainli:[0,3],dynam:6,paramet:4,style:0,group:6,cli:[1,6],fit:[0,4],psycopg2:4,clickabl:[],better:4,window:[],requir:[1,6],where_is_chimer:4,media_root:[],hidden:[6,3],main:3,extra_url:[],changepassword:6,them:[1,3,4],recal:[],thei:[6,3],python:[1,4],dai:6,initi:[1,6,4],framework:[2,6],facilit:3,nov:4,now:[1,3,4],choic:[],name:[0,1,3,6,4],jquery_css_url:4,pyshar:[],gpsbabel:[1,4],off:[],drop:3,refresh:1,easili:3,xvjf:4,html2text:4,each:[0,6,3],found:4,unicod:4,updat:[0,1,2,3,4,5,6],mean:[6,3],compil:[2,4],domain:6,replac:[3,4],jquery_url:1,hard:[],procedur:4,realli:[],backport:[1,4],forgot:[6,3],extract:4,special:[1,3,4],out:3,variabl:[1,6,4],won:1,tinymc:4,newli:3,publish:1,categori:[2,6,3],adapt:[1,4],modpython:[],ref:[],correct:[1,4],red:3,common:[1,4],postgr:4,uncommit:1,migrat:[2,1,4],precaut:1,given:[1,4],free:4,reason:6,base:[6,4],ask:6,org:[1,4],"9227c9":3,mychimer:[1,6],unpredict:4,gdal:[1,4],care:[3,4],spatial_ref_si:4,could:1,area:[0,6,2],static_url:1,keep:3,filter:3,perhap:1,isn:3,outsid:6,root_urlconf:[1,4],auth:6,south:[1,4],first:[1,3,6,4],feed:[6,4],teh:3,major:1,suffix:[],render:6,feel:4,onc:[6,3],number:[1,3,6,4],yourself:3,restrict:6,mai:6,instruct:1,alreadi:4,done:[0,1,6,4],least:[1,6,4],mydjango:4,owner:4,stabl:[1,4],installed_app:1,optionali:4,size:3,differ:[0,6],"long":6,district:[],script:1,associ:[6,3],top:[],mkdir:[1,4],system:3,messag:6,attach:3,chimere_dynamic_categori:[],cliquabl:3,master:1,conveni:3,option:1,copi:[0,1,4],install_path:4,part:4,consult:3,detail_cont:[],haven:1,png:[],rss:6,serv:[1,6],kind:0,provid:[3,4],remov:[1,3],project:[2,1,6,4],pythoninterpret:[],ressourc:6,database_password:[],other:6,browser:[2,1],favorit:4,ani:[1,4],myproject:0,packag:[1,4],manner:[],have:[1,3,6,4],tabl:[3,4],need:[0,6,3,4],element:3,pg_version:4,plpgsql:4,local_set:[1,6,4],engin:[],bz2:4,min:1,rout:[6,3],port:[],note:3,also:[1,3],etienn:[],take:4,which:[],librari:4,default_data:4,simplifi:1,map_lay:[],sethandl:[],usernam:6,choos:4,most:[6,3,4],larg:4,letter:[1,4],deploi:[],geodjango:4,icon:[1,3,6],time_zon:4,don:[1,3,6,4],url:[1,3,6,4],doc:[],clear:3,later:[1,6],flow:[],your_chimere_path:1,inde:3,database_port:[],pythonhandl:[],left:[],fact:3,visibl:3,wsgi:[1,4],show:6,german:[],visitor:[2,1],database_us:[],directli:[6,3],session:6,loaddata:4,secret_kei:4,permiss:[6,4],cryptograph:4,staff:6,celeri:[1,4],current:[1,3,6],onli:[0,1,3,6,4],locat:1,execut:1,copyright:[0,1,3,4,5,6],explain:3,configur:[2,1,6,4],apach:[1,4],should:[1,4],theme:6,simpliest:4,local:[1,6,4],media_url:[],contribut:[1,4],get:[2,1,4],familiar:6,your_local_nam:1,stop:1,blank:3,wheezi:[1,4],a2ensit:4,report:1,geo:4,restart:1,layout:[0,2],enabl:1,specif:4,chimere_localnam:[1,6],reload:[6,4],integr:1,contain:3,where:6,explainatori:[],view:6,set:[1,3,6,4],project_nam:4,"chim\u00e8r":[0,1,2,3,4,5,6],knowledg:1,displai:[6,3],see:[6,3],mandatori:[6,3],epsg_display_project:[],concern:3,jqueri:[1,4],statu:[6,3],avaibl:[],correctli:3,databas:[2,1,6,4],someth:4,cours:4,label:[6,3],state:[6,3],epsg_project:[],between:1,"import":[2,1,3,4,5,6],experi:1,email:4,accord:4,javascript:[1,4],appreci:4,kei:[0,6,4],postgresql_psycopg2:[],job:[],here:4,purpl:3,addit:4,cyclemap:[0,6],both:3,last:4,expos:3,admin:[1,3,4],gpsbabel_opt:1,etc:[6,4],instanc:[0,1,3,4],forgotten:6,freeli:3,login:3,com:6,load:[],simpli:6,technic:6,point:[1,6],color:[6,3],arriv:6,chmod:4,header:3,colon:0,littl:6,poi:3,mapquest:[0,6],mod_python:[],backend:[],quit:3,folow:1,come:3,due:6,empti:[],example_project:[0,1,4],json:4,valu:[1,3,4],administration_:[],modif:[6,3],popul:4,createlang:4,regroup:4,imag:4,understand:3,present:[0,2,3,4,5,6],"case":6,chimere_path:[1,6],look:[6,3],amend:[2,3],vanilla:[],properti:[2,1,3,6],harder:[],easier:6,trick:1,defin:[0,6],error:1,value_of_your_localnam:1,envvar:4,fixtur:4,compilemessag:[1,4],openstreetmap:[],real:3,layer:[0,6,2],customiz:6,libj:[1,4],"\u00e9tienn":[0,1,3,4,5,6],site:[2,6,3,4],destin:4,archiv:4,uncom:4,conf:4,sever:1,develop:3,welcom:[2,6],open:6,author:[0,1,3,4,5,6],media:[1,4],make:[1,3,6],exchang:[],same:[6,3,4],member:6,html:[0,3],descend:3,compat:0,document:[0,2,3,4,5,6],mod_wsgi:4,pan:6,complet:[6,4],http:[1,3,4],webserv:[2,1,4],logic:0,effect:3,solut:4,moment:[],user:[2,1,3,6,4],mani:[1,3,6],extern:[6,3],rvb:3,posgi:4,recent:3,pwprompt:4,task:6,moder:[2,6,3],center:[],chimere_app_path:[1,6],entri:3,well:[0,4],exampl:[6,4],thi:[0,1,3,4,5,6],english:3,model:[2,1,6],self:3,piec:6,propos:[6,3],explan:[],identifi:[6,3],just:[1,4],chimere_hide_propertymodel:6,obtain:4,activ:[1,6,4],insid:[6,3],human:6,touch:[1,4],flavor:6,yet:1,languag:[0,4,2],web:[0,1,6,2],easi:1,field:[1,3,6,4],particulari:[],"53k":4,shortcut:3,apache2:4,identif:3,add:[0,1,3,6],setenv:[],appli:[1,3,6],save:3,explanatori:3,match:[],bin:[1,4],applic:[6,3,4],format:3,read:3,database_engin:[],database_nam:[],password:[6,3],mod:4,linux:[1,4],insert:[],like:[1,3,6,4],semi:0,mychimere_project:4,unidecod:4,property_i_j:[],zoom:6,staticfil:1,server:[1,6,4],edit:[2,1,3,4],api:0,necessari:[1,6,4],"_static":[],django_settings_modul:[],resiz:3,page:[0,6,3,2],two:6,encount:4,www:[1,4],right:[6,3],chimere_display_area:[],manual:6,creation:4,some:[0,1,3,4],begin:[1,4],revel:[],sampl:[1,4],language_cod:4,home:[],transport:[0,6],distribut:4,lead:3,confirm:3,makemessag:4,definit:[],per:6,whole:[],libapache2:4,evolv:[],leav:[],proj:4,slash:3,three:3,localhost:[],refer:[0,3,4],core:[],plu:3,previou:1,run:1,bold:3,chimere_default_cent:[],usag:6,step:[1,3,6],squeez:[1,4],prerequisit:[2,4],wget:4,trustworthi:6,sub:3,postgresql:4,chimere_restricted_ext:[],column:3,eventuali:[],manag:[0,1,2,3,4,6],srv:[1,6],stand:4,discard:3,backup:1,disabl:[6,3],ratatouil:[],own:6,effici:3,additionn:[],pythonpath:[],submitt:3,encod:4,bound:6,automat:6,appropri:[0,6,4],been:[0,1,3,4,5,6],contrib:[1,4],openlay:0,your:[0,1,3,6,4],libgeo:4,accordingli:4,git:[1,4],fill:[],lwpostgi:[],wai:[0,4],pictur:6,lok:[0,1,3,4,5,6],secret:4,submit:[3,4],custom:[0,6,4,2],avail:[0,1,3,6,4],interfac:6,"var":[1,4],submiss:[],treat:3,"function":6,properli:6,interest:[6,3],simplejson:[1,4],forc:[2,1],ascend:3,basic:[1,3,6],back:3,pwd:1,collectstat:[1,4],link:[0,3],translat:[2,1,4],pyexiv2:[1,4],line:[1,4],"true":6,congratul:4,pull:1,made:[0,1,3],utf:4,possibl:[6,3],createus:4,checkout:[1,4],chimere_default_categori:[],pythondebug:[],rc2:[],rc3:1,below:4,limit:6,otherwis:[6,3],problem:[1,4],urn:6,crosstrack:1,gone:[],aerial:0,creat:[2,1,3,6,4],classic:3,parser:4,"char":4,exist:4,rule:[1,4],file:[0,1,3,6,4],syncdb:[1,4],chimere_default_zoom:[],check:[6,3,4],probabl:[1,6],echo:4,encrypt:4,automaticali:[],todo:4,when:[6,3],detail:[0,6,3],gettext:4,"default":[0,1,6,4],old:1,valid:3,kombu:1,branch:[1,4],chimere_admin_01:[],test:1,you:[0,1,3,6,4],draw:[6,3],repeat:1,peacefrog:[1,4],symbol:[],bottom:3,drag:[6,3],database_host:[],log:[1,3,6,4],consid:1,sql:4,debian:[1,4],longer:[],migrate_properti:1,directori:[0,1,4],root_path:[],descript:[1,6,4],dgango:[],chown:[1,4],time:[6,4]},objtypes:{},titles:["Chim\u00e8re customisation","Upgrade","Welcome to Chim\u00e8re’s documentation!","Administration","Installation","Chim\u00e8re import/export","Configuration"],objnames:{},filenames:["customisation","upgrade","index","administration","install","import_export","configuration"]})
\ No newline at end of file +Search.setIndex({objects:{},terms:{all:[5,1,3,6],code:[0,1,3,4],forget:[1,3],yellow:3,signific:[1,4],osm:[0,6,3,5],abil:5,follow:[1,6,4],feedpars:[1,4],row:3,content:[5,6,3],hold:6,depend:[2,1,4,5],zone:4,readabl:[6,4],base_url:[],send:4,easiest:0,init:4,program:[],titl:3,text:6,sens:3,town:[],sourc:[2,1,3,4,5],string:[1,4],mechan:5,veri:5,relev:[5,3,4],administr:[0,2,3,4,5,6],button:[5,6,3],list:[5,3,4],geograph:[5,6,3,4],"try":5,item:[2,6,3,5],form:[5,6,3],quick:[],particularli:5,initialis:[2,1,6,4],dir:4,pleas:4,base_us:[],direct:1,sign:4,second:3,design:[0,5,2],download:4,further:1,myusernam:4,click:[6,3],append:5,blue:3,index:[],what:5,appear:3,compar:[],section:[6,3],multimedia:[6,3],abl:6,beautifulsoup:4,overload:5,access:[6,3],delet:[5,6,3],version:[0,1,2,3,4,5,6],"new":[0,1,2,3,4,5,6],net:[1,4],chimer:[0,1,3,4,5,6],chose:[],createdb:4,french:4,georss:5,"005k":1,witch:6,address:5,path:[6,3,4],modifi:[0,6,3,4],sinc:4,interpret:[],box:[5,6,3],search:3,larger:0,host:[],prior:[],permit:[5,6,3],action:[5,3],template_context_processor:[],chang:[0,1,3,4,5,6],apart:[],chanc:6,environn:1,chimere_tag:1,repositori:[1,4],extra:[0,3],father:[],modul:[],apt:[1,4],vim:[1,4],put:[5,3],authentifi:3,subcategori:[2,6,3,5],fake:1,marker:1,instal:[0,1,6,4,2],select:[5,6,3],from:[5,1,3,4],would:[1,4],univers:4,upgrad:[2,1],next:1,websit:[6,4],few:[6,3],handler:[],usr:[1,4],recommend:5,type:[0,6,3,4,5],more:[0,6,3,4,5],sort:[6,3],where_is_your_chimer:3,desir:[5,4],mypassword:[],share:4,relat:4,server_url:1,customis:[0,1,2],warn:5,phone:6,"export":[2,3,5],indic:[],particular:4,recommand:4,unpack:4,cach:[2,1,6],must:[0,1,6,4],psql:4,"static":[1,4],account:[5,6,3,4],word:3,sometim:5,hour:6,prepar:1,work:[1,3,6],uniqu:[5,6,4],soup:4,paragraph:[1,6],xapi:5,can:[0,1,3,4,5,6],lc_messag:4,meet:5,default_categori:[],root:4,appropri:[0,6,4,5],control:6,prompt:4,tar:4,give:6,process:[5,1,3],sudo:[],smtp:4,templat:[0,1,4,2],tarbal:1,tag:[5,3,4],want:[0,6,3,4,5],default_cent:[],spe:[],mapnik:[0,6],alwai:5,lxml:[1,4],end:[0,6,3,2],freshli:3,anoth:4,length:[1,4],write:[],pure:0,reject:3,verifi:1,csv:5,simpl:[5,6,3],css:[0,6],email_host:4,map:[0,6,3,5],product:1,rebas:1,mess:5,pypi:4,clone:[1,4],after:[5,1,3],superus:6,upload:[1,4],manuali:[],befor:[5,1,3],plane:1,beauti:4,date:[0,1,3,4,5,6],multipl:3,data:[5,1,3,4],"short":4,practic:6,third:3,bind:1,bing:0,explicit:5,lost:1,stash:1,django:[0,1,6,4],issu:5,inform:[5,6,3],environ:[1,6],jquery_js_url:4,allow:6,order:[5,6,3],origin:5,checkbox:[5,3],help:5,move:[1,4],becaus:[5,1,4],meter:1,createsuperus:6,through:[],addus:4,tinymce_url:4,still:4,mainli:[0,3],dynam:6,paramet:4,style:0,group:6,cli:[1,6],fit:[0,4],psycopg2:4,clickabl:[],better:4,platform:5,window:[],pend:5,requir:[5,1,6],where_is_chimer:4,media_root:[],hidden:[6,3],main:[5,3],extra_url:[],changepassword:6,them:[5,1,3,4],recal:[],thei:[6,3],python:[1,4],dai:6,initi:[1,6,4],framework:[2,6],facilit:[5,3],instead:5,nov:4,now:[1,3,4],choic:5,eventu:5,name:[0,1,3,4,5,6],jquery_css_url:4,pyshar:[],gpsbabel:[1,4],off:[],drop:3,refresh:[5,1],easili:[5,3],xvjf:4,html2text:4,each:[0,6,3,5],found:4,unicod:4,updat:[0,1,2,3,4,5,6],mean:[6,3],compil:[2,4],domain:6,replac:[3,4],jquery_url:1,hard:[],procedur:4,realli:5,backport:[1,4],forgot:[6,3],wgs84:5,extract:4,special:[1,3,4],out:3,variabl:[1,6,4],won:1,optionali:4,newli:[5,3],publish:1,categori:[2,6,3,5],adapt:[1,4],print:5,got:5,modpython:[],ref:[],correct:[5,1,4],red:3,common:[5,1,4],postgr:4,uncommit:1,migrat:[2,1,4],precaut:1,given:[5,1,4],free:4,standard:5,reason:6,base:[5,6,4],postgi:4,org:[1,4],"9227c9":3,mychimer:[1,6],unpredict:4,gdal:[1,4],care:[5,3,4],spatial_ref_si:4,launch:5,could:[5,1],area:[0,6,5,2],ask:[5,6],static_url:1,keep:[5,3],filter:[5,3],perhap:1,isn:3,outsid:6,root_urlconf:[1,4],auth:6,licens:5,south:[1,4],first:[5,1,3,6,4],oper:3,teh:3,major:1,attent:[],render:6,feel:4,onc:[5,6,3],cryptograph:4,number:[1,3,6,4],yourself:3,restrict:6,mai:6,instruct:1,alreadi:4,done:[0,1,6,4,5],least:[1,6,4],mydjango:4,owner:4,stabl:[1,4],installed_app:1,tinymc:4,size:3,differ:[0,6],"long":6,district:[],script:1,associ:[5,6,3],top:[],mkdir:[1,4],system:3,messag:[5,6],attach:3,chimere_dynamic_categori:[],accept:5,cliquabl:3,master:1,choos:[5,4],conveni:[5,3],"final":5,store:5,option:1,copi:[0,1,4],install_path:4,sync:5,part:4,consult:3,pythondebug:[],haven:1,png:[],rss:6,serv:[1,6],kind:0,provid:[5,3,4],remov:[1,3],project:[2,1,6,4,5],pythoninterpret:[],ressourc:6,database_password:[],other:[5,6],transport:[0,6],browser:[2,1],latitud:5,favorit:4,beforehand:5,ani:[5,1,4],myproject:0,packag:[1,4],manner:[],have:[5,1,3,6,4],tabl:[3,4],need:[0,6,3,4,5],seem:5,element:3,pg_version:4,plpgsql:4,local_set:[1,6,4],engin:[],bz2:4,min:1,rout:[6,3],port:[],note:[5,3],also:[1,3],etienn:[],take:4,which:[],default_data:4,simplifi:1,map_lay:[],sure:5,sethandl:[],trace:5,normal:5,usernam:[5,6],object:5,most:[6,3,4],larg:4,letter:[1,4],deploi:[],geodjango:4,why:5,icon:[1,3,6],time_zon:4,don:[5,1,3,6,4],url:[5,1,3,6,4],doc:[],clear:3,later:[1,6],flow:[],your_chimere_path:1,inde:3,database_port:[],pythonhandl:[],left:[],fact:[5,3],visibl:[5,3],wsgi:[1,4],think:5,show:6,german:[],visitor:[2,1],database_us:[],directli:[5,6,3],session:6,loaddata:4,secret_kei:4,permiss:[6,4],detail_cont:[],find:5,staff:6,celeri:[1,4],current:[1,3,6],onli:[0,1,3,4,5,6],locat:1,execut:1,copyright:[0,1,3,4,5,6],explain:3,configur:[2,1,6,4],apach:[1,4],should:[5,1,4],theme:6,simpliest:4,folder:5,local:[5,1,6,4],media_url:[],hit:5,contribut:[1,4],get:[2,1,4,5],familiar:6,your_local_nam:1,stop:1,regularli:5,cannot:5,wheezi:[1,4],a2ensit:4,report:1,geo:4,restart:1,layout:[0,2],enabl:1,chimere_localnam:[1,6],reload:[6,4],feed:[6,4],integr:1,contain:3,where:[5,6],explainatori:[],view:6,set:[5,1,3,6,4],project_nam:4,"chim\u00e8r":[0,1,2,3,4,5,6],knowledg:1,see:[5,6,3],mandatori:[5,6,3],arg:5,epsg_display_project:[],concern:[5,3],jqueri:[1,4],statu:[6,3],avaibl:[],correctli:3,databas:[2,1,6,4,5],someth:4,cours:4,label:[6,3],state:[5,6,3],epsg_project:[],between:[5,1],"import":[2,1,3,4,5,6],experi:[5,1],email:4,accord:4,javascript:[1,4],appreci:4,kei:[0,6,4,5],postgresql_psycopg2:[],job:[],here:[5,4],purpl:3,addit:4,cyclemap:[0,6],both:3,last:4,expos:3,admin:[1,3,4],gpsbabel_opt:1,etc:[6,4],instanc:[0,1,3,4,5],forgotten:6,freeli:3,login:3,com:6,load:[],simpli:6,technic:6,point:[1,6],color:[6,3],arriv:6,chmod:4,header:3,colon:0,littl:6,poi:3,mapquest:[0,6,5],mod_python:[],backend:[],quit:3,coupl:5,folow:1,come:3,classic:[5,3],three:3,empti:5,example_project:[0,1,4],json:4,valu:[5,1,3,4],interest:[6,3],modif:[6,3],popul:4,createlang:4,regroup:4,imag:4,blank:3,understand:3,shapefil:5,present:[0,2,3,4,5,6],"case":[5,6],chimere_path:[1,6],look:[6,3],amend:[2,3],vanilla:[],properti:[2,1,3,6,5],harder:[],easier:6,trick:1,defin:[0,6,5],suffix:[],abov:5,error:[5,1],value_of_your_localnam:1,envvar:4,fixtur:4,compilemessag:[1,4],openstreetmap:5,real:3,layer:[0,6,2],customiz:6,kmlz:5,libj:[1,4],"\u00e9tienn":[0,1,3,4,5,6],site:[2,6,3,4],destin:4,archiv:4,uncom:4,conf:4,sever:1,"null":5,develop:3,welcom:[2,6],open:6,author:[0,1,3,4,5,6],media:[1,4],make:[5,1,3,6],exchang:[],same:[5,6,3,4],member:6,preserv:5,html:[0,3],descend:3,compat:0,document:[0,2,3,4,5,6],mod_wsgi:4,pan:6,complet:[6,4],http:[1,3,4],webserv:[2,1,4],logic:0,effect:3,solut:4,moment:[],user:[2,1,3,6,4],mani:[1,3,6],extern:[6,3],robust:5,rvb:3,posgi:4,recent:3,pwprompt:4,task:6,moder:[2,6,3],center:[],chimere_app_path:[1,6],entri:3,well:[0,4],non:5,exampl:[6,4],thi:[0,1,3,4,5,6],english:3,model:[2,1,6],self:3,piec:6,propos:[6,3],explan:[],identifi:[5,6,3],just:[1,4],chimere_hide_propertymodel:6,obtain:4,activ:[1,6,4],insid:[6,3],distant:5,human:6,touch:[1,4],flavor:6,yet:[5,1],languag:[0,4,2],web:[0,1,5,6,2],like:[1,3,6,4],easi:1,particulari:[],"53k":4,shortcut:3,apache2:4,identif:3,add:[0,1,3,6,5],setenv:[],appli:[1,3,6],save:3,explanatori:3,match:[],bin:[1,4],applic:[6,3,4],format:[5,3],read:3,regard:5,database_engin:[],database_nam:[],password:[5,6,3],mod:4,linux:[1,4],insert:[],specif:[5,4],semi:0,mychimere_project:4,unidecod:4,property_i_j:[],zoom:6,staticfil:1,server:[5,1,6,4],edit:[2,1,3,4],api:[0,5],necessari:[1,6,4],"_static":[],django_settings_modul:[],resiz:3,page:[0,6,3,5,2],two:[5,6],encount:4,www:[1,4],right:[6,3],chimere_display_area:[],manual:6,creation:4,some:[0,1,3,4,5],begin:[1,4],revel:[],sampl:[1,4],language_cod:4,home:[],guess:5,librari:4,distribut:4,basic:[1,3,6],lead:3,confirm:3,makemessag:4,kml:5,definit:[],localis:5,per:6,whole:[],libapache2:4,evolv:[],leav:[],proj:[5,4],slash:3,duplic:5,localhost:[],refer:[0,3,4],core:[],plu:3,previou:1,run:1,bold:3,chimere_default_cent:[],usag:6,step:[1,3,6],squeez:[1,4],prerequisit:[2,4],srid:5,wget:4,handi:5,trustworthi:6,sub:3,postgresql:4,zip:5,chimere_restricted_ext:[],column:[5,3],eventuali:[],geometri:5,manag:[0,1,2,3,4,5,6],srv:[1,6],stand:4,discard:3,backup:1,disabl:[5,6,3],ratatouil:[],own:6,effici:3,additionn:[],pythonpath:[],submitt:3,encod:4,bound:[5,6],automat:[5,6],due:6,been:[0,1,3,4,5,6],contrib:[1,4],openlay:0,mark:5,your:[0,1,3,4,5,6],libgeo:4,accordingli:4,git:[1,4],fill:5,lwpostgi:[],wai:[0,4,5],pictur:6,lok:[0,1,3,4,5,6],secret:4,submit:[3,4],custom:[0,6,4,2],avail:[0,1,3,4,5,6],interfac:6,"var":[1,4],submiss:[],treat:[5,3],"function":6,properli:6,administration_:[],simplejson:[1,4],forc:[2,1],ascend:3,criteria:3,vari:5,back:3,pwd:1,collectstat:[1,4],link:[0,3,5],translat:[2,1,4],pyexiv2:[1,4],line:[1,4],"true":6,congratul:4,pull:1,made:[0,1,3],utf:4,possibl:[5,6,3],"default":[0,1,6,4,5],checkout:[1,4],chimere_default_categori:[],displai:[6,3],rc2:[],rc3:1,below:4,limit:6,otherwis:[6,3],problem:[5,1,4],urn:6,crosstrack:1,gone:[],featur:5,aerial:0,creat:[2,1,3,4,5,6],createus:4,parser:4,"char":4,exist:[5,4],rule:[1,4],file:[0,1,3,4,5,6],syncdb:[1,4],chimere_default_zoom:[],check:[5,6,3,4],probabl:[1,6],echo:4,encrypt:4,automaticali:[],todo:4,when:[5,6,3],detail:[0,6,3,5],gettext:4,field:[5,1,3,6,4],old:1,valid:[5,3],kombu:1,branch:[1,4],chimere_admin_01:[],test:[5,1],you:[0,1,3,4,5,6],node:5,draw:[5,6,3],repeat:1,determin:5,peacefrog:[1,4],symbol:[],bottom:3,drag:[6,3],database_host:[],log:[1,3,6,4],consid:1,sql:4,debian:[1,4],longitud:5,longer:[],migrate_properti:1,directori:[0,1,4],root_path:[],descript:[1,6,4],dgango:[],chown:[1,4],came:5,time:[6,4],w3c:5,convert:5},objtypes:{},titles:["Customisation","Upgrade","Welcome to Chim\u00e8re’s documentation!","Administration","Installation","Import/export","Configuration"],objnames:{},filenames:["customisation","upgrade","index","administration","install","import_export","configuration"]})
\ No newline at end of file diff --git a/docs/_static/chimere_admin_import_CSV.png b/docs/_static/chimere_admin_import_CSV.png Binary files differnew file mode 100644 index 0000000..e67a37b --- /dev/null +++ b/docs/_static/chimere_admin_import_CSV.png diff --git a/docs/_static/chimere_admin_import_KML.png b/docs/_static/chimere_admin_import_KML.png Binary files differnew file mode 100644 index 0000000..b48d69a --- /dev/null +++ b/docs/_static/chimere_admin_import_KML.png diff --git a/docs/_static/chimere_admin_import_OSM.png b/docs/_static/chimere_admin_import_OSM.png Binary files differnew file mode 100644 index 0000000..a599348 --- /dev/null +++ b/docs/_static/chimere_admin_import_OSM.png diff --git a/docs/_static/chimere_admin_import_georss.png b/docs/_static/chimere_admin_import_georss.png Binary files differnew file mode 100644 index 0000000..5278652 --- /dev/null +++ b/docs/_static/chimere_admin_import_georss.png diff --git a/docs/_static/chimere_admin_import_shapefile.png b/docs/_static/chimere_admin_import_shapefile.png Binary files differnew file mode 100644 index 0000000..ce612be --- /dev/null +++ b/docs/_static/chimere_admin_import_shapefile.png diff --git a/docs/administration.rst b/docs/administration.rst index 2f8ddb5..b79c95b 100644 --- a/docs/administration.rst +++ b/docs/administration.rst @@ -6,7 +6,7 @@ Administration ============== :Author: Étienne Loks -:date: 2012-10-08 +:date: 2012-11-28 :Copyright: CC-BY 3.0 This documents presents the administration of Chimère. @@ -130,6 +130,8 @@ basic color it can be set with the English name (for instance: *red*, *blue*, The element type is the type of element the subcategory can contain: POI, route or both. +.. _geographic-items-management: + Edition/moderation of items --------------------------- @@ -155,11 +157,12 @@ There is a some actions available in the action list. To modify an item, classically you have to click on his name. Then you access to a form to freely modify the item. In this form there is all data available to the end user form plus some extra -fields. The *Import fields* only make sense with data imported from an external +fields. +- The *Import fields* only make sense with data imported from an external source or for data to be exported to OSM cf. to the :ref:`import section -<importing>` of this documentation. *Associated items fields* are read only -fields that list items associated to the current one (reference item of an -amendment, associated file of a route). +<importing>` of this documentation. +- *Associated items fields* are read only fields that list items associated to +the current one (reference item of an amendment, associated file of a route). Associated multimedia items are at the bottom of the form. You can freely add, change items and change their order with drag and drop. diff --git a/docs/customisation.rst b/docs/customisation.rst index 19002dc..c8ce2f6 100644 --- a/docs/customisation.rst +++ b/docs/customisation.rst @@ -1,11 +1,11 @@ .. -*- coding: utf-8 -*- -===================== -Chimère customisation -===================== +============= +Customisation +============= :Author: Étienne Loks -:date: 2012-10-08 +:date: 2012-11-28 :Copyright: CC-BY 3.0 This documents presents the installation of Chimère. diff --git a/docs/import_export.rst b/docs/import_export.rst index 3d4b0ed..71f9178 100644 --- a/docs/import_export.rst +++ b/docs/import_export.rst @@ -1,11 +1,11 @@ .. -*- coding: utf-8 -*- -===================== -Chimère import/export -===================== +============= +Import/export +============= :Author: Étienne Loks -:date: 2012-10-08 +:date: 2012-11-28 :Copyright: CC-BY 3.0 This documents presents the administration of Chimère. @@ -15,3 +15,186 @@ The version has been updated for version 2.0.0. Importing --------- + +In Chimère the import mechanism is based on **Import object**. Theses objects +are stored in database to keep trace of imports and to facilitate the +re-importation from the same source. In fact if possible the update of data from +a same type of source is managed. The ability to do such updates depends on the +existence of a unique id for each object on your source. + +To add an **Import object** you need to go to *Chimere > Imports* then **Add**. + +After that you'll have to select your source type and then the form depends on +the type of source. + +Common fields +************* + +- **Name by default**: if no name can be identified to the newly imported object + this is the name that will be used. If this field is empty the name of the + associated category will be use. +- **SRID**: Chimère will try to identify automatically the correct projection + from the given source. But sometimes the information is not present or cannot + be guessed (for instance a Shapefile that uses non standard proj file). In + this case Chimère will use WGS84 by default (the classic latitude/longitude) + but it is not always correct. If you experience problems with items + localisation you should put here the SRID associated to the projection of + your source. +- **Origin**: if not null this field will be associated to each item imported in + order to easily identify where the item came from. For OSM import the source + is automatically added. +- **License**: if not null this field will be associated to each item imported in + order to easily identify the license associated to the item. For OSM import + the license is automatically added. +- **Associated subcategories (mandatory)**: The selected subcategories will be + associated to newly imported items. + + +KML import +********** + +.. image:: _static/chimere_admin_import_KML.png + + +- **Web address/source file (mandatory)**: your KML could be distant or a local + file. You'll have to fill one of the two fields. +- **Filter**: if you want to import only a specific *Folder* of your KML file + put his name on this field. +- **Zipped file**: if your source is a KMLZ file (a zipped KML) check this case. + +Shapefile import +**************** + +.. image:: _static/chimere_admin_import_shapefile.png + + +- **Web address/source file (mandatory)**: your KML could be distant or a local + file. You'll have to fill one of the two fields. +- **Zipped file**: only zipped shapefile are accepted this checkbox have to be + checked. + +GeoRSS import +************* + +Simple GeoRSS and W3C GeoRSS are managed. + +.. image:: _static/chimere_admin_import_georss.png + +- **Web address (mandatory)**: only distant GeoRSS are managed. + +CSV import +********** + +As the format of the CSV file managed by Chimère could vary depending on the +property you have add on your Chimère instance we recommend you to first do +an export of some items in CSV with Chimère. The CSV format of the exported +file will meet Chimère requirements. By the way because of the geometry of +the item this format is not very convenient to add new content but could +be handy to update informations. + +.. image:: _static/chimere_admin_import_CSV.png + +- **Web address/source file (mandatory)**: your CSV file could be distant or a + local file. You'll have to fill one of the two fields. + +.. _osm-import: + +OpenStreetMap import +******************** + +.. image:: _static/chimere_admin_import_OSM.png + +To import from OSM Chimère uses the XAPI API of OSM. + +- **Web address (mandatory)**: XAPI url used to import data. This field should + be filled with a default address. By default the MapQuest server is used as it + seems to be the more robust. If you experience problems with OSM import check + the availability of the XAPI server used and eventually change it. +- **Filter area (mandatory)**: draw the bounding box you want to use for your + OSM import. +- **Filter type (mandatory)**: choose if you want to import way or nodes. +- **Filter tag (mandatory)**: choose the OSM key/value couple used to filter OSM + data. A link to the `OSM Map features page + <https://wiki.openstreetmap.org/wiki/Map_Features>`_ is provided to help you + find appropriate values. +- **Refresh button**: this button convert your choices to appropriate XAPI args. + You have to hit this button before validating the form. + +Importing +********* + +Once your new import item created. Select it in the import object list, select +the **Import** action and validated. + +The import should be processing normally. If not an explicit error message +should be print in the state column of your import. + +Managing imported data +********************** + +All new imported items have the state **Imported**. To make them available on +the map you'll have to validate them. If you don't want an item to be visible on +the map instead of delete them it is recommended to set them to the state +**Disabled**. + +.. Warning:: + Be careful with duplicates between your existing data and imported data. This + is particularly important if you want to export your data to OSM. + +Exporting +--------- + +Export to CSV/KML/Shapefile +*************************** + +Directly from the :ref:`geographic items list <geographic-items-management>` you +can export to the choose format. All you have to do is to select the desired +items, choose the appropriate action in the action list and validate. + +Export to OSM +************* + +.. Warning:: + If you are not sure of what you are doing with OSM export: don't do it! It is + really important to not mess with others data. + +.. Note:: + Only export of OSM nodes are managed. + +OSM export is not that easily managed. First (if not yet done) you'll have to +define an import (:ref:`see above <osm-import>` for details). This will permit +to determine: + +- the area concerned by your export. +- the key/value tag to append to your new/updated items. +- the subcategories concerned by your export. If you think that some items in + theses subcategories should not be in OSM database (because there are not + relevant or because of license issues) beforehand mark them as **Not for OSM** + in the *import fields* of the :ref:`geographic items forms + <geographic-items-management>`. + + +The OSM export in Chimère is designed to be the more preservative possible in +regards to OSM database. That's why before any export an import is done. If +the new import has updated data theses new data will overload data in your +Chimère (if you don't want that: don't do export). All pending imported items +should have been treated before doing an export. + +To launch an export select the appropriate Import object in the imports list. +Then select the **Export to OSM** action and validate. +Then you'll be asked for your OSM username and password and the API you want to +use. If you use regularly Chimère to do export it is recommended to create an +OSM specific account for that. +The test API is available to make export test. If you want to use the test +API you'll have to create a specific account on the test platform. + +.. Warning:: + The data on the test platform are not synced with the main platform you are + not going to have the same data that you got with XAPI. + +Once all this field filled you can (finally!) launch the export. + +When exporting tags are automatically added/updated: + +- *name*: get from the item name in Chimère. +- *source*: to identify Chimère as a source. |
