diff --git a/.github/workflows/doc.yml b/.github/workflows/doc.yml index 72ec66ce47..baec5da3ff 100644 --- a/.github/workflows/doc.yml +++ b/.github/workflows/doc.yml @@ -18,7 +18,7 @@ env: jobs: doc: - name: Documentation + name: Doc structure runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 @@ -30,3 +30,27 @@ jobs: run: | cd docs/ make html SPHINXOPTS="-W" + + - name: Check translations build + run: | + cd docs/ + make gettext + rm ./_build/locale/changelog.pot + sphinx-intl update -l fr + sphinx-intl build + sphinx-build -b html -D language='fr' -d _build/doctrees . _build/html/fr + + - name: Check missing translations + uses: tj-actions/verify-changed-files@v17 + id: verify-changed-files + with: + files: | + **/*.po + + - name: Check no translation file has changed + if: steps.verify-changed-files.outputs.files_changed == 'true' + run: | + echo "Translation file(s) changed: ${{ steps.verify-changed-files.outputs.changed_files }}" + git diff + core.setFailed('Please update doc translation y running `make gettext` and `sphinx-intl update -l fr`, then fix or update translation, and commit the changes.') + diff --git a/Makefile b/Makefile index a89baf4538..20d48f0d10 100644 --- a/Makefile +++ b/Makefile @@ -41,6 +41,9 @@ serve: deps: $(docker_compose) run --rm web bash -c "pip-compile -q --strip-extras && pip-compile -q --strip-extras dev-requirements.in && pip-compile -q --strip-extras docs/requirements.in" +doc_translations: + $(docker_compose) run --rm sphinx bash -c "make gettext && rm ./_build/locale/changelog.pot && sphinx-intl update -l fr" + flake8: $(docker_compose) run --rm web flake8 geotrek diff --git a/docs/changelog.rst b/docs/changelog.rst index e9af4bba3a..7276ee370f 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -349,7 +349,7 @@ Do not use - Causes bug in Geotrek-Rando-v3 exposing Outdoor data **New features** - Add `include_externals` filter to Cirkwi trek exports, to allow excluding treks with an external id (eid) (#3947) -- Tourism : add price to TouristicEvent model - ref #3587 +- Tourism: add price to TouristicEvent model - ref #3587 - Add `check_versions` command to check Geotrek, Python, Django, PostgreSQL and PostGIS versions. - Add ``GeotrekCourseParser`` and ``GeotrekSiteParser`` in Aggregator to retrieve Outdoor models (refs #3569) - Add trail on leaflet overlay @@ -669,7 +669,7 @@ Do not use - Causes bug in Geotrek-Rando-v3 exposing Outdoor data **Improvements** -- Add arguments loadsignage : sealing / manager (#3377) +- Add arguments loadsignage: sealing / manager (#3377) - Various minor improvements for APIDAE Trek parser - The "near_xxx" API filters now use the topological link regarding topological objects. This will provide better performances for those endpoints when topologies are enabled. See Issues `#3472 `_ and `#3505 `_. - Enable using Suricate workflow without moderation steps @@ -1029,8 +1029,8 @@ In preparation for HD Views developments (PR #3298) **Bug fixes** - Blade list view now takes into account custom columns from ``COLUMNS_LISTS`` setting -- Fix Suricate Workflow : do not unlock reports when resolving them -- Fix Suricate Workflow : display clickable links in report related emails +- Fix Suricate Workflow: do not unlock reports when resolving them +- Fix Suricate Workflow: display clickable links in report related emails 2.88.0 (2022-10-11) @@ -1741,11 +1741,11 @@ Disabled infrastructure's block have been removed **New features** -- APIv2 : Add ``attachment`` field to Touristic Event serialization +- APIv2: Add ``attachment`` field to Touristic Event serialization **Minor improvements** -- Add possibility to fill ``code`` field in Signage model when using ``loadsignage`` command. Two parameters added : ``code_field`` and ``code_default`` +- Add possibility to fill ``code`` field in Signage model when using ``loadsignage`` command. Two parameters added: ``code_field`` and ``code_default`` **Bug fixes** @@ -1759,11 +1759,11 @@ Disabled infrastructure's block have been removed **New features** -- APIv2 : Add filter by portal on outdoor practices and ratings +- APIv2: Add filter by portal on outdoor practices and ratings **Bug fixes** -- APIv2 : Fix exceptions on filter by portals or themes in Outdoor Course route +- APIv2: Fix exceptions on filter by portals or themes in Outdoor Course route 2.70.0 (2021-11-02) @@ -1771,12 +1771,12 @@ Disabled infrastructure's block have been removed **New features** -- Add UUIDS to the following objects, and to APIv2 serialization for those included : +- Add UUIDS to the following objects, and to APIv2 serialization for those included: Path, TouristicContent, TouristicEvent, Outdoor Site, Outdoor Course, Attachment, and Topology (inherited by POI, Trek, Service, Trail, Signage, Infrastructure, PhysicalEdge, CompetenceEdge, LandEdge) -- APIv2 : Add pictograms to outdoor practice routes -- APIv2 : Add cities to outdoor sites and outdoor courses routes -- APIv2 : Add filter by themes, cities, districts, types, and structures to outdoor sites and outdoor courses routes -- APIv2 : Change Web Links serialization on outdoor sites routes, to detailed instead of just an id +- APIv2: Add pictograms to outdoor practice routes +- APIv2: Add cities to outdoor sites and outdoor courses routes +- APIv2: Add filter by themes, cities, districts, types, and structures to outdoor sites and outdoor courses routes +- APIv2: Change Web Links serialization on outdoor sites routes, to detailed instead of just an id **Breaking changes** @@ -1834,8 +1834,8 @@ Disabled infrastructure's block have been removed **New features** -- APIv2 : Add 'children' and 'parent' fields to Outdoor Site serialization -- APIv2 : Add filter by pratices on outdoor courses +- APIv2: Add 'children' and 'parent' fields to Outdoor Site serialization +- APIv2: Add filter by pratices on outdoor courses - Filter interventions by Outdoor model targets in Intervention module's list view **User Interface** @@ -1855,11 +1855,11 @@ Disabled infrastructure's block have been removed **New features** -- APIv2 : Add filter by ratings on outdoor courses and sites -- APIv2 : Add filter by pratices in hierarchy on outdoor courses and sites -- APIv2 : Add filter by ratings in hierarchy on outdoor courses and sites +- APIv2: Add filter by ratings on outdoor courses and sites +- APIv2: Add filter by pratices in hierarchy on outdoor courses and sites +- APIv2: Add filter by ratings in hierarchy on outdoor courses and sites - Display children sites' ratings in site page -- APIv2 : Add 'sector' and 'attachment' fields to Outdoor Site serialization +- APIv2: Add 'sector' and 'attachment' fields to Outdoor Site serialization - Add DISPLAY_COORDS_AS_DECIMALS setting to format coordinates as decimal degrees instead of degrees minutes seconds - Enable translations on 'equipment' field on Outdoor Course @@ -1880,14 +1880,14 @@ Disabled infrastructure's block have been removed **New features** -- APIv2 : Add filter on Outdoor Site route to only retrieve root sites from hierarchy +- APIv2: Add filter on Outdoor Site route to only retrieve root sites from hierarchy - Add fields 'duration', 'type', 'gear', 'ratings_description' to Outdoor Course -- Add fields on APIv2 for Course model : 'min_elevation', 'max_elevation', 'children', 'parents', 'attachments' +- Add fields on APIv2 for Course model: 'min_elevation', 'max_elevation', 'children', 'parents', 'attachments' - Add excluded_pois on Course and Site models. - Add filter on APIVv2 POI endpoint to retrieve pois related to Course or Site - Replace Outdoor Site 'ratings_min' and 'ratings_max' fields with 'ratings' - Make Outdoor Site and Course 'ratings' form fields dynamically change on practice selection -- APIv2 : Add children courses to sites' serialization +- APIv2: Add children courses to sites' serialization - Add Course Type management to admin site @@ -1919,13 +1919,13 @@ Disabled infrastructure's block have been removed - Add helper to make requests to Suricate - Add parser to retrieve statuses, activities, and reports (in bounding box) from Suricate - Add sync_suricate command to retrieve Suricate data -- Change Report model to use one of 3 modes : No Suricate, Suricate Report or Suricate Management (SURICATE_REPORT_ENABLED and SURICATE_MANAGEMENT_ENABLED settings) +- Change Report model to use one of 3 modes: No Suricate, Suricate Report or Suricate Management (SURICATE_REPORT_ENABLED and SURICATE_MANAGEMENT_ENABLED settings) - Generalize existing filters in APIv2 - Add 'near_outdoorsite' and 'near_outdoorcourse' filters in APIv2 - Add 'created_before', 'updated_before', 'created_after' and 'updated_after' filters in APIv2 - Add route to APIv2 to retrieve Geotrek version - Add API_V2_DESCRIPTION setting to change description text in API v2 Swagger page -- Add endpoints for services in APIv2 : service, service type +- Add endpoints for services in APIv2: service, service type - Add link between reports and interventions @@ -1974,7 +1974,7 @@ Disabled infrastructure's block have been removed **New features** -- Add endpoints for user feedback in APIv2 : report category, report activity, report problem magnitude, and report status +- Add endpoints for user feedback in APIv2: report category, report activity, report problem magnitude, and report status - Ensure APIv2 returns treks list and touristic contents list as ordered by localized name **Bug fixes** @@ -2003,7 +2003,7 @@ Disabled infrastructure's block have been removed First, if you changed file `/opt/geotrek-admin/var/conf/nginx.conf.in`, back it up somewhere. 1 - While installing, choose 'Y' to get the new version. 2 - Copy your changes from the backed up file to the new version. -3 - Execute : `dpkg-reconfigure geotrek-admin` to reapply your customization. +3 - Execute: `dpkg-reconfigure geotrek-admin` to reapply your customization. **User Interface** @@ -2535,7 +2535,7 @@ HAPPY NEW YEAR! **Doc improvements** - Fix doc development command line -- Improving docs : advanced configuration / synchronisation +- Improving docs: advanced configuration / synchronisation 2.38.6 (2020-10-20) @@ -3110,7 +3110,7 @@ No changes. Just force a new build in CI **Bug fixes** -- Fix sync_rando : sensitive area with multi polygons +- Fix sync_rando: sensitive area with multi polygons 2.29.8 (2019-09-26) @@ -3730,11 +3730,11 @@ No changes. Just force a new build in CI - Allow to exclude POIs from a trek - New access rights to edit draft path - New access rights to edit attributes and not the geometry -- Allow to remove duplicate path in database : command remove_duplicate_paths +- Allow to remove duplicate path in database: command remove_duplicate_paths **Bug fixes** -- Fix snap on crossing point : take all paths easier +- Fix snap on crossing point: take all paths easier - Fix a clash between current url and SYNC_RANDO_OPTIONS - Fix screamshotter when SSL is enabled @@ -3990,7 +3990,7 @@ No changes. Just force a new build in CI **Bug fixes** * Fix download of python packages for pypi.python.org (SSL is now required) -* API v2 : Fix full URL pictures in nested serializers +* API v2: Fix full URL pictures in nested serializers * Fix network SVG (add viewbox) to make them visible in Geotrek-rando * Hide file parsers form if no one is available @@ -4906,7 +4906,7 @@ No changes. Just force a new build in CI **Breaking changes** -* Before running install, run this SQL command to add a column for file attachments : +* Before running install, run this SQL command to add a column for file attachments: :: @@ -5010,7 +5010,7 @@ In order to enable those features under construction, add ``experimental = True` :notes: - After upgrading, mark all POIs as published in the languages of your choice :: + After upgrading, mark all POIs as published in the languages of your choice:: UPDATE o_t_poi SET public_fr = TRUE; UPDATE o_t_poi SET date_publication = now(); @@ -5093,7 +5093,7 @@ In order to enable those features under construction, add ``experimental = True` **Upgrades notes** -Since the map export have changed, empty the cache : +Since the map export have changed, empty the cache: :: @@ -5209,11 +5209,11 @@ Support edition of several fields on the same map, via django-leaflet new featur :notes: - Just before upgrading, delete the following folders :: + Just before upgrading, delete the following folders:: rm -rf lib/src/django-modeltranslation - After upgrading, mark all treks as published in the languages of your choice :: + After upgrading, mark all treks as published in the languages of your choice:: UPDATE o_t_itineraire SET public_fr = TRUE; UPDATE o_t_itineraire SET date_publication = now(); @@ -5252,10 +5252,10 @@ Support edition of several fields on the same map, via django-leaflet new featur * Improved details in trek form, use Chosen for many-to-many widgets * Documented the configuration of map layers apparence * Show layers colors in layer switcher -* Detail page : replace "Maintenance" by "Works" (fixes #889) -* Detail page : interventions on paths are now grouped together, +* Detail page: replace "Maintenance" by "Works" (fixes #889) +* Detail page: interventions on paths are now grouped together, and a small icon is shown (fixes #735) -* Detail page : show intervention costs (ref #958, fixes #764) +* Detail page: show intervention costs (ref #958, fixes #764) * Show project intervention total costs (fixes #958) * Allow to override the Trek public document template (see *advanced configuration* in docs) @@ -5364,7 +5364,7 @@ Special thanks to Noël Martinon, Félix Merzeau, Gil Deluermoz and Camille Mont It is a good thing, since it paves the way for the last Ubuntu LTS release (14.04). However, it breaks the *Long Term Support* philosophy of the previous one (12.04), supposed to be supported until 2019. - **Morality** : we cannot trust the *Ubuntu GIS stable* repository anymore. + **Morality**: we cannot trust the *Ubuntu GIS stable* repository anymore. Regarding *Geotrek*, such upgrades of Ubuntu packages is not supposed to be covered by its installation script. If you face any problems, please refer to the @@ -5405,7 +5405,7 @@ Read all release notes carefully. * Command to import shapefile with points into POI as topologies (fixes #952) * Add views to serve DEM on object area as JSON (*Geotrek-Rando 3D*) -* New tourism module : external datasources can be configured from Adminsite (*GeoJSON, TourInFrance, ...*) +* New tourism module: external datasources can be configured from Adminsite (*GeoJSON, TourInFrance, ...*) and added to maps (by module, or published on *Geotrek-rando*...) * Show number of attached files in tab (fixes #743) * New permission to control download of attachments @@ -5421,7 +5421,7 @@ Read all release notes carefully. * Add fullscreen button on maps (fixes #904) * Add all controls on detail map (fixes #907) * Add a button to close filters (fixes #424) -* Added new sections in documention : *FAQ*, *User-manal* and *Advanced configuration* +* Added new sections in documention: *FAQ*, *User-manal* and *Advanced configuration* ** Internal changes ** @@ -5437,7 +5437,7 @@ Read all release notes carefully. :notes: - * Before upgrading, backup your trail records and geometries, using pgAdmin :: + * Before upgrading, backup your trail records and geometries, using pgAdmin:: CREATE TABLE backup_sentiers AS SELECT * FROM l_v_sentier; CREATE TABLE backup_troncons_sentiers AS ( @@ -5450,14 +5450,14 @@ Read all release notes carefully. a new line ``mailmanagers`` in ``etc/settings.ini``. See *Email settings* section in documentation. - * Just before upgrading, delete the following folders :: + * Just before upgrading, delete the following folders :: rm -rf lib/src/django-modeltranslation lib/src/mapentity :notes: * After upgrading, load the default permissions of the previous groups, otherwise - users won't have access to their modules :: + users won't have access to their modules:: bin/django loaddata geotrek/authent/fixtures/minimal.json bin/django loaddata geotrek/authent/fixtures/basic.json @@ -5465,13 +5465,13 @@ Read all release notes carefully. * After upgrading, make sure *Active* is checked for the user *__internal__* otherwise screenshotting won't work. - * After upgrading, load basic data for the new module :: + * After upgrading, load basic data for the new module:: bin/django loaddata geotrek/feedback/fixtures/basic.json * After upgrading, make sure the user specified in *Geotrek-rando* is in the group *Geotrek-rando*, or has at least the following permissions - in the AdminSite : + in the AdminSite: - ``paperclip | attachment | Can read attachments`` - ``trekking | Trek | Can read Trek`` @@ -5711,12 +5711,12 @@ Installation script 0.20.8 (2013-10-22) ------------------- -* Public trek export : Fix various layout regressions (ref #848) -* Public trek export : Show POI theme pictogram (fixes #858) -* Public trek export : full width for information desk frame (fixes #856) -* Public trek export : add footer with trek title and page numbers (fixes #861) -* Public trek export : add floating picture in POI detail (fixes #860) -* Public trek export : fix POI thumbnails missing (fixes #869) +* Public trek export: Fix various layout regressions (ref #848) +* Public trek export: Show POI theme pictogram (fixes #858) +* Public trek export: full width for information desk frame (fixes #856) +* Public trek export: add footer with trek title and page numbers (fixes #861) +* Public trek export: add floating picture in POI detail (fixes #860) +* Public trek export: fix POI thumbnails missing (fixes #869) * Fix point offset lost on path update (fixes #867) * Fix reconnect point topologies with offset to closest path (fixes #868) @@ -5724,12 +5724,12 @@ Installation script ------------------- * Fix topology geometry 3D being draped twice (fixes #863) -* Altimetric profile : Show max distance and round values (fixes #853) -* Altimetric profile : Add settings for colors (fixes #854) -* Public trek export : POIs list in two columns (fixes #855) -* Public trek export : POIs details without column break (fixes #857) -* Public trek export : Show pictures attributions (fixes #859) -* Public trek export : Use 10pt fonts in every text blocks (fixes #848) +* Altimetric profile: Show max distance and round values (fixes #853) +* Altimetric profile: Add settings for colors (fixes #854) +* Public trek export: POIs list in two columns (fixes #855) +* Public trek export: POIs details without column break (fixes #857) +* Public trek export: Show pictures attributions (fixes #859) +* Public trek export: Use 10pt fonts in every text blocks (fixes #848) :notes: diff --git a/docs/conf.py b/docs/conf.py index 898591e6f4..25f52dce5f 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -1,7 +1,4 @@ import datetime -import os - -root = os.path.abspath(os.path.dirname(os.path.dirname(__file__))) extensions = [ 'sphinx.ext.todo', @@ -115,3 +112,6 @@ 'Makina Corpus', 'Geotrek-admin', 'One line description of project.', 'Miscellaneous'), ] + +locale_dirs = ['locale'] # path is example but recommended. +gettext_compact = False # optional. \ No newline at end of file diff --git a/docs/contribute/contributing.rst b/docs/contribute/contributing.rst index 47a37182bc..5b19cec4d3 100644 --- a/docs/contribute/contributing.rst +++ b/docs/contribute/contributing.rst @@ -39,7 +39,7 @@ Check TODO in the source tree: Pull requests ------------- -Before creating a pull request, ensure you follow thoses rules : +Before creating a pull request, ensure you follow those rules : * Follow the guidelines of this page * Self-review your code @@ -103,12 +103,12 @@ Release On master branch: -* Update files *VERSION*, *docs/conf.py* and *docs/changelog.rst* to remove ``+dev`` suffix and increment version (please use semver rules) +* Update files *VERSION* and *docs/changelog.rst* to remove ``+dev`` suffix and increment version (please use semver rules) * Run ``dch -r -D RELEASED``, update version in the same way and save * Commit with message 'Release x.y.z' and push to ``master`` * Create new release on Github, with tag X.Y.Z, click on "Generate release notes" * Wait for release to be published through CI -* Update files *VERSION*, *docs/conf.py* and *docs/changelog.rst* to add ``+dev`` suffix +* Update files *VERSION* and *docs/changelog.rst* to add ``+dev`` suffix * Run ``dch -v +dev --no-force-save-on-release`` and save * Commit with message 'Back to development' and push to ```master`` diff --git a/docs/contribute/translating.rst b/docs/contribute/translating.rst index 66f5342212..5ecab95c15 100644 --- a/docs/contribute/translating.rst +++ b/docs/contribute/translating.rst @@ -80,7 +80,7 @@ Translation features Weblate shows all translation by language and by module. Errors and left to translate can be displayed easily. -Weblate can identify problematic translations as chains between projects, punctuation inconsistancy. +Weblate can identify problematic translations as chains between projects, punctuation inconsistency. .. figure:: ../images/translating/weblate-check.png :alt: image diff --git a/docs/install/advanced-configuration.rst b/docs/install/advanced-configuration.rst index bb61962197..8d6017caa0 100644 --- a/docs/install/advanced-configuration.rst +++ b/docs/install/advanced-configuration.rst @@ -19,6 +19,7 @@ In order to check your configuration of spatial extents, a small tool is available at http://server/tools/extents/. .. note:: + Administrator privileges are required. @@ -72,12 +73,15 @@ Swagger API documentation In order to enable swagger module to auto-document API, in the custom settings file, add the following code : - Enable API V2 documentation:: + Enable API V2 documentation: + +.. code-block:: python INSTALLED_APPS += ('drf_yasg', ) + Then run ``sudo dpkg-reconfigure -u geotrek-admin``. -The API swagger documentation is now availaible here : ``/api/v2`` +The API swagger documentation is now available here : ``/api/v2`` Share services between several Geotrek instances ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -128,8 +132,8 @@ To control those values, edit and fix your ``docker-compose.yml`` file in web an To know how many workers you should set, please refer to `gunicorn documentation `_. -External authent -~~~~~~~~~~~~~~~~ +External authentication +~~~~~~~~~~~~~~~~~~~~~~~ You can authenticate user against a remote database table or view. @@ -161,6 +165,7 @@ Expected columns in table/view are : * ``lang`` : string (language code) .. note:: + - The schema used in ``AUTHENT_TABLENAME`` must be in the user search_path (``ALTER USER $geotrek_db_user SET search_path=public,userschema;``) - User management will be disabled from Administration backoffice. - In order to disable remote login, just comment *AUTHENTICATION_BACKENDS* line in settings file, and restart instance (see paragraph above). @@ -282,6 +287,7 @@ Map layers zoom .. note:: + It can be interesting when your tiles can't go to a zoom. For example OpenTopoMap is 17. @@ -301,6 +307,7 @@ Map layers colors and style MAPENTITY_CONFIG['MAP_STYLES']['city']['opacity'] = 0.8 .. note:: + It can be interesting when your tiles can't go to a zoom. For example OpenTopoMap is 17. @@ -350,7 +357,8 @@ Color of the different layers on the map : Color of the different layers on the top right for landing. -.. note:: +.. note:: + - For land, physical, competence, signagemanagement, workmanagement should have 5 values. - For restricted Area: add as many color as your number of restricted area type - **Restart** the application for changes to take effect. @@ -401,6 +409,7 @@ Geographical CRUD PATH_SNAPPING_DISTANCE = 2.0 .. note:: + - Change the distance. Better to keep it like this. - Not used when ``TREKKING_TOPOLOGY_ENABLED = True`` @@ -421,6 +430,7 @@ Geographical CRUD PATH_MERGE_SNAPPING_DISTANCE = 2 .. note:: + - Change the distance. Should be higher or the same as ``PATH_SNAPPING_DISTANCE``. - Used when ``TREKKING_TOPOLOGY_ENABLED = True``. @@ -438,7 +448,7 @@ Geographical CRUD .. envvar:: OUTDOOR_COURSE_POINTS_OF_REFERENCE_ENABLED - Points of reference are enabled on form of otudoor courses. + Points of reference are enabled on form of outdoor courses. Example:: @@ -461,6 +471,7 @@ Geographical CRUD TOPOLOGY_STATIC_OFFSETS = {'land': -7, 'physical': 0, 'competence': 7, 'signagemanagement': -14, 'workmanagement': 14} .. note:: + You should not change it to avoid overlay except if you want to have more overlays. **All settings used to generate altimetric profile :** @@ -481,6 +492,7 @@ Geographical CRUD ALTIMETRIC_AREA_MARGIN = 0.15 .. note:: + - All these settings can be modified but you need to check the result every time - The only one modified most of the time is ``ALTIMETRIC_PROFILE_COLOR`` @@ -520,6 +532,7 @@ Map screenshots MAP_CAPTURE_SIZE = 800 .. note:: + - Size in pixels of the capture. - Be careful with your pdfs. - If you change this value, pdfs will be rendered differently @@ -614,6 +627,7 @@ In order to remove zoning combo-boxes on list map: True .. note:: + - By doing so, some software upgrades may not be as smooth as usual. - Never forget to mention this customization if you ask for community support. @@ -661,6 +675,7 @@ Paths True .. note:: + Email configuration takes place in ``/opt/geotrek-admin/var/conf/custom.py``, where you control recipients emails (``ADMINS``, ``MANAGERS``) and email server configuration. @@ -681,6 +696,7 @@ Signage and Blade BLADE_CODE_TYPE = INT .. note:: + - It can be string or integer - If you have an integer code : ``int`` - If you have an string code : ``str`` @@ -695,6 +711,7 @@ Signage and Blade BLADE_CODE_FORMAT = "{signagecode}-{bladenumber}" .. note:: + - If you want to change : move information under bracket - You can also remove one element between bracket - You can do for exemple : ``"CD99.{signagecode}.{bladenumber}"`` @@ -712,6 +729,7 @@ Signage and Blade LINE_CODE_FORMAT = "{signagecode}-{bladenumber}-{linenumber}" .. note:: + - Similar with above - You can do for example : ``"CD99.{signagecode}-{bladenumber}.{linenumber}"`` - It will display : ``CD99.XIDNZEIU-01.02`` (second line of the first blade of XIDNZEIU) @@ -798,6 +816,7 @@ You can also insert Outdoor minimal data: After installing Outdoor module, you have to add permissions to your user groups on outdoor sites and courses. .. note:: + - Outdoor module is not compatible with PostGIS <= 2.4 that is included in Ubuntu 18.04. - You should either upgrade to Ubuntu 20.04 or upgrade postGIS to 2.5 with https://launchpad.net/~ubuntugis/+archive/ubuntu/ppa @@ -807,7 +826,8 @@ Sensitive areas ~~~~~~~~~~~~~~~ .. note:: - The sensitivity module was developed as part of the Biodiv'Sports project to provide a central platform for sensitive areas. + + The sensitivity module was developed as part of the Biodiv'Sports project to provide a central platform for sensitive areas. The official address of the Geotrek instance of the Biodiv'Sports project is: https://biodiv-sports.fr, and is the base URL for the following API URLs. @@ -863,6 +883,74 @@ The following settings are related to sensitive areas: see :ref:`import-sensitive-areas` to import data. +Import from https://biodiv-sports.fr +'''''''''''''''''''''''''''''''''''''' + +In user interface, in the top-right menu, clic on "Imports" and choose "Biodiv'Sports". + +On command line, run + +.. code-block :: bash + + sudo geotrek import geotrek.sensitivity.parsers.BiodivParser + + +Import from shapefile +''''''''''''''''''''''' + +In user interface, in the top-right menu, go to Imports and choose "Shapefile zone sensible espèce" +or "Shapefile zone sensible réglementaire". + +.. note:: + The file must be a zip containing all the shapefile extensions (.shp, .shx, .prj, .dbf, .cpg) + +.. figure:: ../images/advanced-configuration/import_shapefile.png + :alt: Import shapefile in user interface + :align: center + + Import shapefile in user interface + + +On command line, run: + +.. code-block :: bash + + sudo geotrek import geotrek.sensitivity.parsers.SpeciesSensitiveAreaShapeParser + +or: + +.. code-block :: bash + + sudo geotrek import geotrek.sensitivity.parsers.RegulatorySensitiveAreaShapeParser . + +Attributes for "zones espèces sensibles" are: + +* ``espece`` : species name. Mandatory. A species with this name must have been previously created. +* ``contact`` : contact (text or HTML format). Optional. +* ``description`` : description (text or HTML format). Optional. + +Attributes for "zones sensibles réglementaires" are: + +* ``name``: zone name. +* ``contact`` : contact (text or HTML format). Optional. +* ``description`` : description (text or HTML format). Optional. +* ``periode`` : month numbers of zone occupation, separated by comas, without spaces (ex. « 6,7,8 » for june, july and august) +* ``pratiques`` : sport practices names, separated by comas, without spaces (ex. « Terrestre,Aérien »). A sport practice with this name must have been previously created. +* ``url`` : card url. Optional. + + +Sync to Geotrek-rando +''''''''''''''''''''''' + +Just run: + +.. code-block :: bash + + sudo geotrek sync_rando + +If sensitivity module is enabled, sensitive areas will be automatically synchronized. + + Feedback reports settings ------------------------- @@ -1068,7 +1156,8 @@ Load alerts from Suricate (located in your bounding box) : - create predefined emails (`/admin/feedback/predefinedemail/`) to notify Suricate Sentinels and Administrators. You can use `##intervention_end_date##` and `##supervisor##` in the messages' body to automatically replace with the report's linked Intervention date and author. The Extended Username field will be dsiplayed (see User Profile under `/admin/auth/user/`). - Make sure Users involved in the workflow have proper permissions to create and update Reports and Interventions (`/admin/auth/user/`) -.. note:: +.. note:: + - Be aware that, when enabling Suricate Management mode, Suricate becomes the master database for reports. This means **reports created in Geotrek-admin will not be saved to the database, they will only be sent to Suricate**. - Reports are only saved when synchronized back from Suricate, when the synchronization command is run. @@ -1254,7 +1343,8 @@ It will verify that the mimetype of the file matches the extension. PAPERCLIP_ALLOWED_EXTENSIONS = None -.. note:: +.. note:: + These two settings will also not allow downloading images from the parsers. @@ -2682,6 +2772,7 @@ An exhaustive list of form fields hideable in each module. ] .. note:: + ``assigned_user`` is hidden by default in ``HIDDEN_FORM_FIELDS["report"]``, it is possible to force it to appear using ``HIDDEN_FORM_FIELDS["report"] = []``. @@ -2732,6 +2823,7 @@ Its configuration can be customized using advanced settings (see above paragraph } .. note:: + - This will apply to all text fields. - For more information on configuration entries available, please refer to the official documentation of *TinyMCE version 3*. @@ -2745,14 +2837,15 @@ Max characters count Example:: - MAPENTITY_CONFIG['MAX_CHARACTERS_BY_FIELD'] = { + MAPENTITY_CONFIG['MAX_CHARACTERS_BY_FIELD'] = { "tourism_touristicevent": [{'field': 'description_teaser_fr', 'value': 50}, {'field': 'accessibility_fr', 'value': 25}], "trekking_trek": [{'field': 'description_teaser_fr', 'value': 150}], } .. note:: - - This will apply field by field, language by language. - - See `this issue `_ for details. + + - This will apply to all text fields. + - See `this issue `_ for details. Copyright on pictures @@ -2768,6 +2861,7 @@ Copyright on pictures THUMBNAIL_COPYRIGHT_FORMAT = "{title} {author}" .. note:: + - This will apply to all text fields. - For more information on configuration entries available, please refer to the official documentation of *TinyMCE version 3*. @@ -2846,7 +2940,7 @@ Override the translations that you want in these files. "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" - "Project-Id-Verésion: PACKAGE VERSION\n" + "Project-Id-Version: PACKAGE VERSION\n" "Plural-Forms: nplurals=2; plural=(n > 1);\n" "Project-Id-Version: \n" "X-Generator: Poedit 1.5.4\n" @@ -2912,6 +3006,7 @@ The template for a specific portal will use the modification made on the overrid ( except if you change specific block) .. note:: + This modification is not mandatory, if you have multiple portal and you want to modify the template of only one portal, you create one folder for this specific portal **You might need to use your own images in the PDF templates.** @@ -2936,6 +3031,7 @@ Example of a customised template (``/opt/geotrek-admin/var/conf/extra_templates/ {% endblock url %} .. note:: + The default template may change in the future versions. You will be in charge of porting the modification to your copy. Test your modifications by exporting a trek or a content to PDF from Geotrek-admin application. @@ -2956,7 +3052,8 @@ PDF as booklet False -.. note:: +.. note:: + - During the synchro, pois details will be removed, and the pages will be merged. - It is possible to customize the pdf, with trek_public_booklet_pdf.html. @@ -3008,7 +3105,8 @@ Primary color in PDF templates PRIMARY_COLOR = "#7b8c12" -.. note:: +.. note:: + Beware of contrast, white colour is used for text so we advise you to avoid light colour. @@ -3069,7 +3167,8 @@ Limits TREK_EXPORT_POI_LIST_LIMIT = 14 -.. note:: +.. note:: + ``14`` is already a huge amount of POI, but it's possible to add more .. envvar:: TREK_EXPORT_INFORMATION_DESK_LIST_LIMIT @@ -3080,7 +3179,8 @@ Limits TREK_EXPORT_INFORMATION_DESK_LIST_LIMIT = 14 -.. note:: +.. note:: + You can put ``-1`` if you want all the information desks Categories @@ -3098,7 +3198,8 @@ Categories True -.. note:: +.. note:: + Field order for each practices in admin will be taken in account .. envvar:: SPLIT_TREKS_CATEGORIES_BY_ACCESSIBILITY @@ -3251,7 +3352,8 @@ Settings for Geotrek-mobile {"id": 4, "name": "> 50 km", "interval": [50000, 999999]} ] -.. note:: +.. note:: + - Interval key is in meters. - You can add new intervals @@ -3268,7 +3370,8 @@ Settings for Geotrek-mobile {"id": 4, "name": "> 1000 m", "interval": [1000, 9999]} ] -.. note:: +.. note:: + Do the same as above .. envvar:: MOBILE_DURATION_INTERVALS @@ -3285,7 +3388,8 @@ Settings for Geotrek-mobile {"id": 5, "name": "> 9h", "interval": [9, 9999999]} ] -.. note:: +.. note:: + Check ``MOBILE_LENGTH_INTERVALS`` section to use it, here interval correspond to 1 unit of hour .. envvar:: ENABLED_MOBILE_FILTERS diff --git a/docs/install/configuration.rst b/docs/install/configuration.rst index 47631332a6..f5cd365e75 100644 --- a/docs/install/configuration.rst +++ b/docs/install/configuration.rst @@ -154,7 +154,7 @@ Languages of your project. It will be used to generate fields for translations. Spatial extents ~~~~~~~~~~~~~~~ -Boundingbox of your project : x minimum , y minimum , x max, y max:: +Bounding box of your project : x minimum , y minimum , x max, y max:: 4 ^ | @@ -198,8 +198,7 @@ With *pgAdmin*, you can create database users like this: :: - CREATE ROLE lecteur LOGIN; - ALTER USER lecteur PASSWORD 'passfacile'; + CREATE USER lecteur WITH ENCRYPTED PASSWORD 'passfacile'; GRANT CONNECT ON DATABASE geotrekdb TO lecteur; And give them permissions by schema : @@ -207,9 +206,7 @@ And give them permissions by schema : :: GRANT USAGE ON SCHEMA public TO lecteur; - GRANT USAGE ON SCHEMA geotrek TO lecteur; GRANT SELECT ON ALL TABLES IN SCHEMA public TO lecteur; - GRANT SELECT ON ALL TABLES IN SCHEMA geotrek TO lecteur; You can also create groups, etc. See PostgreSQL documentation. diff --git a/docs/install/import.rst b/docs/install/import.rst index 20ba9f909c..d15958f458 100644 --- a/docs/install/import.rst +++ b/docs/install/import.rst @@ -106,7 +106,7 @@ or `via QGis following this blog post ` - * **Good to know** : + * **Good to know** : * The default SRID code is 4326 * The default encoding is UTF-8 * Imported paths are unpublished by default @@ -258,7 +258,7 @@ When sensitive areas module is enabled, Geotrek provides 3 parsers to import dat * **Import sensitive areas from http://biodiv-sports.fr** (``geotrek.sensitivity.parsers.BiodivParser``). By default this parser imports all sensitive areas in configured spatial extent. * **Import species sensitive areas from a zipped shapefile**. - Imported field names are: ``espece`` (required), ``contact`` and ``descriptio``. Species with corresponding names have to be created manually before import. + Imported field names are: ``espece`` (required), ``contact`` and ``description``. Species with corresponding names have to be created manually before import. * **Import regulatory sensitive areas from a zipped shapefile**. Imported field names are: ``nom`` (required), ``contact``, ``descriptio``, ``periode`` (month numbers separated with comas), ``pratiques`` (separated with comas), and ``url``. Practices with corresponding names have to be created manually before import. You can start imports from "Import" menu or from command line. You can override them in your ``var/conf/parsers.py`` @@ -296,7 +296,7 @@ If you need to cancel the aggregation of portals, remove param ``m2m_aggregate_f Importing from multiple sources with deletion --------------------------------------------- -When importing data for the same model using two (or more) different sources, the ``provider`` field should be used to differenciate between sources, allowing to enable object deletion with ``delete = True`` without causing the last parser to delete objects created by preceeding parsers. +When importing data for the same model using two (or more) different sources, the ``provider`` field should be used to differentiate between sources, allowing to enable object deletion with ``delete = True`` without causing the last parser to delete objects created by preceding parsers. In the following example, ``Provider_1Parser`` and ``Provider_2Parser`` will each import their objects, set the ``provider`` field on these objects, and only delete objects that disappeared from their respective source since last parsing. @@ -316,7 +316,7 @@ In the following example, ``Provider_1Parser`` and ``Provider_2Parser`` will eac .. danger:: - If a parser does not have a ``provider`` value, it will not take providers into account, meaning that it could delete objects from preceeding parsers even if these other parsers do have a ``provider`` themselves. + If a parser does not have a ``provider`` value, it will not take providers into account, meaning that it could delete objects from preceding parsers even if these other parsers do have a ``provider`` themselves. The following example would cause ``NoProviderParser`` to delete objects from ``Provider_2Parser`` and ``Provider_1Parser``. @@ -339,7 +339,7 @@ The following example would cause ``NoProviderParser`` to delete objects from `` Generic settings for your parser -------------------------------- -This settings may be overriden when you define a new parser: +This settings may be overridden when you define a new parser: - ``label`` parser display name (default: ``None``) - ``model`` import content with this model (default: ``None``) @@ -348,7 +348,7 @@ This settings may be overriden when you define a new parser: - ``simplify_tolerance`` (default: ``0``) # meters - ``update_only`` don't create new contents (default: ``False``) - ``delete`` (default: ``False``) -- ``duplicate_eid_allowed`` if True, allows differents contents with same eid (default: ``False``) +- ``duplicate_eid_allowed`` if True, allows different contents with same eid (default: ``False``) - ``fill_empty_translated_fields`` if True, fills empty translated fields with same value (default: ``False``) - ``warn_on_missing_fields`` (default: ``False``) - ``warn_on_missing_objects`` (default: ``False``) @@ -390,7 +390,7 @@ Import data from a remote Geotrek instance ========================================== Importing from a Geotrek instance works the same way as from SIT. -A usecase for this is to aggregate data from several Geotrek-admin instance. +A use-case for this is to aggregate data from several Geotrek-admin instance. .. danger:: Importing data from a remote Geotrek instance does not work with dynamic segmentation, your instance where you import data @@ -448,17 +448,17 @@ It is also possible to import sensitive areas through command line: sudo geotrek import geotrek.sensitivity.parsers.BiodivParser -.. warning:: - If you don't see any data in your area, it means that Biodiv'Sports does not contains data for your territory. - Then it is widely recommended to add your data directly into Biodiv'Sports, as it will be available for - multiple users, and then retrieve them into your Geotrek instance. To import data in Biodiv'Sports +.. warning:: + If you don't see any data in your area, it means that Biodiv'Sports does not contains data for your territory. + Then it is widely recommended to add your data directly into Biodiv'Sports, as it will be available for + multiple users, and then retrieve them into your Geotrek instance. To import data in Biodiv'Sports go visit its website: https://biodiv-sports.fr Import from shapefile --------------------- -Imported data must be in standard ESRI shapefile format. +Imported data must be in standard ESRI shapefile format. The various Shapefile files (``.shp``, ``.shx``, ``.dbf``, ``.prj``, *etc*.) must be assembled in a zip archive. .. warning:: @@ -468,7 +468,7 @@ Attribute data for sensitive areas species - ``espece``: Species name. Mandatory. A species with this name must first have been created in Biodiv'sports. Otherwise, import of the line will fail. - ``contact``: Contact in text or HTML format. *Optional*. -- ``descriptio``: Description in text or HTML format. *Optional*. +- ``descriptio``: Description in text or HTML format. *Optional*. .. warning:: Species name must strictly respect the species name string (accentuation, case and punctuation). @@ -512,7 +512,7 @@ or: sudo geotrek import geotrek.sensitivity.parsers.RegulatorySensitiveAreaShapeParser . -.. warning:: +.. warning:: Relaunching an import **with the same file** will create duplicates. @@ -671,7 +671,7 @@ Import POIs * **Geometric type** : Point * **Expected formats** (supported by GDAL) : Shapefile, Geojson, Geopackage * **Template** : :download:`poi.geojson <../files/import/poi.geojson>` - * **Good to know** : + * **Good to know** : * The SRID must be 4326 * The default encoding is UTF-8 * Imported POIs are unpublished by default @@ -801,7 +801,7 @@ Import Infrastructure * **Geometric type** : Point * **Expected formats** (supported by GDAL) : Shapefile, Geojson, Geopackage * **Template** : :download:`infrastructure.geojson <../files/import/infrastructure.geojson>` - * **Good to know** : + * **Good to know** : * The SRID must be 4326 * The default encoding is UTF-8 * Imported infrastructures are unpublished by default @@ -834,7 +834,7 @@ New parameterized values are created and added to Geotrek Admin if necessary. Th - label <- value of `type` import field - type <- value of `cat` import field - - optionnally if `--use-structure`: structure <- the structure value (import field or default) + - optionally if `--use-structure`: structure <- the structure value (import field or default) For InfrastructureCondition the check uses the `condition` argument. @@ -845,7 +845,7 @@ For InfrastructureCondition the check uses the `condition` argument. **Selected or added InfrastructureCondition value :** - label <- value of `cond` field - - optionnally if `--use-structure`: structure <- the structure value (import field or default) + - optionally if `--use-structure`: structure <- the structure value (import field or default) **Import command example :** @@ -980,7 +980,7 @@ Import Signage * **Geometric type** : Point * **Expected formats** (supported by GDAL) : Shapefile, Geojson, Geopackage * **Template** : :download:`signage.geojson <../files/import/signage.geojson>` - * **Good to know** : + * **Good to know** : * The default SRID code is 4326 * The default encoding is UTF-8 * Imported signage are unpublished by default @@ -1058,7 +1058,7 @@ Import Cities * **Geometric type** : Polygon * **Expected formats** (supported by GDAL) : Shapefile, Geojson, Geopackage * **Template** : :download:`cities.geojson <../files/import/cities.geojson>` - * **Good to know** : + * **Good to know** : * The default SRID code is 4326 * The default encoding is UTF-8 * Imported cities are unpublished by default @@ -1145,7 +1145,7 @@ Import Districts * **Geometric type** : Polygon * **Expected formats** (supported by GDAL) : Shapefile, Geojson, Geopackage * **Template** : :download:`districts.geojson <../files/import/districts.geojson>` - * **Good to know** : + * **Good to know** : * The default SRID code is 4326 * The default encoding is UTF-8 * Imported districts are unpublished by default @@ -1219,7 +1219,7 @@ Import Restricted areas * **Geometric type** : Polygon * **Expected formats** (supported by GDAL) : Shapefile, Geojson, Geopackage * **Template** : :download:`restrictedareas.geojson <../files/import/restrictedareas.geojson>` - * **Good to know** : + * **Good to know** : * The default SRID code is 4326 * The default encoding is UTF-8 * Imported restricted areas are unpublished by default @@ -1343,7 +1343,7 @@ You have to run ``sudo geotrek unset_structure`` You can't chose for each choice which set of category you want to unset structures, it will happen for all categories -Firstly, if a categroy is linked to a structure, it creates the same category but with no structure associated. +Firstly, if a category is linked to a structure, it creates the same category but with no structure associated. Secondly, every element with this old category gets assigned to this new category. Finally all old categories are removed. @@ -1366,7 +1366,7 @@ only one Linestring from start to end. It stays as close as possible to the corr when the order is not well managed during topologies' display. .. danger:: - It can happen that this algorithm can't find any solution and will genereate a MultiLineString. + It can happens that this algorithm can't find any solution and will generate a MultiLineString. This will be displayed at the end of the reorder diff --git a/docs/install/installation.rst b/docs/install/installation.rst index 69b31f5fbc..d76e1f288c 100644 --- a/docs/install/installation.rst +++ b/docs/install/installation.rst @@ -18,7 +18,7 @@ Lastly, for a developer instance, please follow :ref:`the dedicated procedure `_ : apt install clamav -Prepare quarantine folder for suspicious files : +Prepare quarantine folder for suspicious files: :: @@ -111,7 +111,7 @@ Prepare quarantine folder for suspicious files : chmod 700 /var/lib/clamav/quarantine/ -Configure ClamAV via cron, to scan the folder once a day, put suspicious files in quarantine, and raise email alerts, by creating file ``/etc/cron.daily/clamscan`` with the following content : +Configure ClamAV via cron, to scan the folder once a day, put suspicious files in quarantine, and raise email alerts, by creating file ``/etc/cron.daily/clamscan`` with the following content: :: @@ -126,7 +126,7 @@ Configure ClamAV via cron, to scan the folder once a day, put suspicious files i find /var/log/clamav/ -type f -name "scan-report.*" -mtime +365 -delete -Make sure to change alert recepient (``admin@example.com`` above) and make this cron file executable : +Make sure to change alert recepient (``admin@example.com`` above) and make this cron file executable: :: @@ -150,13 +150,13 @@ Media files will be left in ``/opt/geotrek-admin/var`` directory. To remove them apt-get purge geotrek-admin -To remove dependencies (convertit, screamshooter…), run: +To remove dependencies (convertit, screamshoter…), run: :: apt-get autoremove -.. note:: +.. warning:: PostgreSQL and its database will not be removed by these commands. If need be, remove them manually. @@ -169,7 +169,7 @@ Docker Docker is an alternative installation method, recommended for experts only. It allows to install several instances of Geotrek-admin on the same serveur, -and to install it on other distributions than Ubuntu Linux 18.04. +and to install it on other distributions than Ubuntu. 1. Install Docker and Docker Compose, either from your distribution or from upstream packages diff --git a/docs/install/loading-data.rst b/docs/install/loading-data.rst index 063f301df1..67d6d75817 100644 --- a/docs/install/loading-data.rst +++ b/docs/install/loading-data.rst @@ -11,14 +11,14 @@ Loading data Prerequisites for your data --------------------------- -Layers -~~~~~~ +External Layers +~~~~~~~~~~~~~~~ * WMTS protocol * WebMercator Projection -Core -~~~~ +Paths +~~~~~ * Only LineString geometries * Simple geometries @@ -26,19 +26,20 @@ Core If possible: -* Connex graph +* Clean topologies * Name column * Data source -Formats: Shapefile or pure SQL dump (CREATE TABLE + INSERT) +Formats: Geographic file or pure SQL dump (CREATE TABLE + INSERT) + +Zoning +~~~~~~ -Land -~~~~ +* Cities: Geographic file or SQL, simple and valid MultiPolygon +* Districts: Geographic file ou SQL, simple and valid MultiPolygon +* Restricted Areas: Geographic file ou SQL, simple and valid MultiPolygon -* Cities polygons (Shapefile or SQL, simple and valid Multi-Polygons) -* Districts (Shapefile ou SQL, simple and valid Multi-Polygons) -* Restricted Areas (Shapefile ou SQL, simple and valid Multi-Polygons) Extras ~~~~~~ @@ -47,14 +48,14 @@ Extras * Structures list (and default one) -Load MNT raster +Load DEM raster --------------- In `QGIS `_, you can visualize your DEM, or merge several tiles together (in *Raster* > *Misc* > *Merge*). Generate a GeoTIFF, and upload both files (``.tif`` + ``.tfw``) on the server. -And use the Geotrek-admin command to load it into PostGIS : +And use the Geotrek-admin command to load it into PostGIS: :: @@ -67,11 +68,11 @@ And use the Geotrek-admin command to load it into PostGIS : therefore supports all GDAL raster input formats. You can list these formats with the command ``raster2pgsql -G``. -.. note:: +.. warning:: The elevation data of DEM must be integer values. If the elevation data are floating numbers, you can convert them in integer values with the Raster calculator processing - of `SAGA in QGis `_ + of `SAGA in QGis `_ (Processing > Toolbox > SAGA > Raster calculus > Raster calculator) with formula parameter set to ``int(a)``. .. note:: @@ -81,4 +82,4 @@ And use the Geotrek-admin command to load it into PostGIS : .. note:: - If you want to update the altimetry of the topologies you need to use the option : --update-altimery + If you want to update the altimetry of the topologies you need to use the option : --update-altimery diff --git a/docs/install/maintenance.rst b/docs/install/maintenance.rst index 66c7a72fee..990c2073c0 100644 --- a/docs/install/maintenance.rst +++ b/docs/install/maintenance.rst @@ -6,8 +6,8 @@ Maintenance :local: :depth: 2 -Application backup ------------------- +Backup +------ Database @@ -28,25 +28,25 @@ Configuration tar -zcvf `date +%Y%m%d%H%M`-conf.tar.gz /opt/geotrek-admin/var/conf/ -Application restore -------------------- +Restore +------- If you restore Geotrek-admin on a new server, you will have to install PostgreSQL and PostGIS and create a database user first. Otherwise go directly to the database creation step. -Example for Ubuntu 18: +Example for Ubuntu: .. code-block:: bash - sudo apt install postgresql-10 postgresql-10-postgis-2.5 - sudo -u postgres psql -c "CREATE USER geotrek PASSWORD 'geotrek';" + sudo apt install postgis + sudo -u postgres psql -c "CREATE USER geotrek WITH ENCRYPTED PASSWORD 'geotrek';" Create an empty database (``geotrekdb`` in this example): .. code-block:: bash - sudo -u postgres psql -c "CREATE DATABASE geotrekdb OWNER geotrek;" + sudo -u postgres psql -c "CREATE DATABASE geotrekdb WITH OWNER geotrek;" sudo -u postgres psql -d geotrekdb -c "CREATE EXTENSION postgis;" sudo -u postgres psql -d geotrekdb -c "CREATE EXTENSION postgis_raster;" sudo -u postgres psql -d geotrekdb -c "CREATE EXTENSION pgcrypto;" @@ -79,6 +79,8 @@ PostgreSQL optimization * Use `pg activity `_ for monitoring +* Use `pgtune `_ to optimize your configuration + Access your database securely on your local machine (QGIS) ---------------------------------------------------------- diff --git a/docs/install/upgrade.rst b/docs/install/upgrade.rst index eb515a4ee9..e71cef58af 100644 --- a/docs/install/upgrade.rst +++ b/docs/install/upgrade.rst @@ -10,7 +10,7 @@ Upgrade From Geotrek-admin >= 2.33 ~~~~~~~~~~~~~~~~~~~~~~~~~~ -Beforehand you shoud update your system's catalog: +Beforehand you should update your system's catalog: :: diff --git a/docs/locale/fr/LC_MESSAGES/about/geotrek.po b/docs/locale/fr/LC_MESSAGES/about/geotrek.po new file mode 100644 index 0000000000..456f028ab5 --- /dev/null +++ b/docs/locale/fr/LC_MESSAGES/about/geotrek.po @@ -0,0 +1,313 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2013-2024, Makina Corpus +# This file is distributed under the same license as the Geotrek package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Geotrek \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-11-13 11:25+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: fr\n" +"Language-Team: fr \n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../about/geotrek.rst:3 +msgid "Geotrek" +msgstr "" + +#: ../../about/geotrek.rst:12 +msgid "Qu'est ce que Geotrek ?" +msgstr "" + +#: ../../about/geotrek.rst:14 +msgid "" +"Geotrek est un ensemble d'outils web dédiés à la **gestion et la " +"valorisation** des activités de randonnées, de sports de pleine nature et" +" des informations touristiques." +msgstr "" + +#: ../../about/geotrek.rst:16 +msgid "" +"Ils sont open source et peuvent ainsi être déployés librement par les " +"structures et territoires qui le souhaitent, mais aussi les faire " +"évoluer, ou bénéficier des évolutions réalisées par d'autres structures " +"sans avoir à les re-financer." +msgstr "" + +#: ../../about/geotrek.rst:18 +msgid "" +"Ces outils permettent la gestion de **nombreuses pratiques sportives** " +"liées à des linéaires (randonnée pédestre, à vélo, en VTT, à cheval, avec" +" poussette, etc.) mais également à des **contenus outdoor** non linéaires" +" (escalade, vol libre, sports d’eau vive, etc.)." +msgstr "" + +#: ../../about/geotrek.rst:20 +msgid "" +"C’est l’**application de référence** des parcs naturels, mais aussi de " +"nombreuses structures publiques (conseils départementaux, communautés de " +"communes, comités régionaux du tourisme, offices du tourisme, etc.)." +msgstr "" + +#: ../../about/geotrek.rst:22 +msgid "**Utiliser Geotrek vous permettra** :" +msgstr "" + +#: ../../about/geotrek.rst:24 +msgid "d’intégrer une **communauté de gestionnaires de randonnées très active**" +msgstr "" + +#: ../../about/geotrek.rst:25 +msgid "" +"de **bénéficier de l’ensemble des évolutions** réalisées par les autres " +"utilisateurs. Le projet est vivant et les outils s’améliorent sans cesse" +msgstr "" + +#: ../../about/geotrek.rst:26 +msgid "" +"de disposer d’une **offre complète** qui pourra également être utilisée " +"par d’autres acteurs du territoire" +msgstr "" + +#: ../../about/geotrek.rst:27 +msgid "" +"de facilement pouvoir **accéder à d’autres fonctionnalités** quand le " +"besoin s’en fera ressentir : site web, impression de fiches de parcours, " +"gestion de la signalétique, organisation des travaux…" +msgstr "" + +#: ../../about/geotrek.rst:28 +msgid "" +"d’exporter facilement vos contenus valorisables (itinéraires, POIs, " +"contenus touristiques …) vers d’autres **plateformes touristiques " +"nationales** (IGNrando', Visorando, Outdooractive, Apidae, Cirkwi, etc.)" +msgstr "" + +#: ../../about/geotrek.rst:31 +msgid "Les quatre briques" +msgstr "" + +#: ../../about/geotrek.rst:33 +msgid "" +"La suite logicielle Geotrek dispose de quatre briques à la fois distincts" +" et complémentaires :" +msgstr "" + +#: ../../about/geotrek.rst:35 +msgid "" +":ref:`Geotrek-admin `: outil de gestion et de " +"saisie de l’ensemble des informations, intégrant les données des Systèmes" +" d’Informations Touristiques (SIT) et pouvant être connecté à votre SIG " +"ou à des systèmes d’information transport" +msgstr "" + +#: ../../about/geotrek.rst:36 +msgid "" +"`Geotrek-rando `_ : site web, reprenant les " +"informations saisies dans Geotrek-admin, à destination des internautes " +"grand public" +msgstr "" + +#: ../../about/geotrek.rst:37 +msgid "" +"`Geotrek-mobile `_ : application mobile fonctionnant sous Android et iOS, " +"reprenant des informations saisies dans Geotrek-admin et optimisées pour " +"l’usage mobile (volume, impact sur la batterie, hors-ligne, " +"géolocalisation…)" +msgstr "" + +#: ../../about/geotrek.rst:38 +msgid "" +"`Geotrek-rando-widget `_ : " +"nouveau composant web permettant de valoriser une offre de contenus " +"touristiques et de randonnées auprès des usagers du territoire, en " +"l'intégrant dans un site internet existant" +msgstr "" + +#: ../../about/geotrek.rst:40 +msgid "Note" +msgstr "" + +#: ../../about/geotrek.rst:41 +msgid "" +"Cette documentation ne traite que de **Geotrek-Admin**, chaque brique " +"ayant sa propre documentation." +msgstr "" + +#: ../../about/geotrek.rst:44 +msgid "Utilisateurs" +msgstr "" + +#: ../../about/geotrek.rst:46 +msgid "" +"L’application Geotrek, **destinée à deux types de public**, est une " +"solution web qui apporte :" +msgstr "" + +#: ../../about/geotrek.rst:48 +msgid "" +"des fonctionnalités de gestion des informations (itinéraires, sites " +"outdoor, points d’intérêts, description, interprétation, médias…) et de " +"gestion des infrastructures (signalétique, aménagements, travaux, " +"réglementation…) pour les utilisateurs gérant un territoire (**Geotrek-" +"admin**)" +msgstr "" + +#: ../../about/geotrek.rst:49 +msgid "" +"des fonctionnalités simples et ludiques de recherche et de consultation " +"d’itinéraires pour les internautes et les mobinautes (**Geotrek-rando " +"V3**, **Geotrek-mobile** et **Geotrek-rando-widget**)." +msgstr "" + +#: ../../about/geotrek.rst:51 +msgid "" +"Pour retrouver plus d'informations sur la suite applicative Geotrek, " +"rendez-vous sur `geotrek.fr `_." +msgstr "" + +#: ../../about/geotrek.rst:54 +msgid "A qui appartient Geotrek ?" +msgstr "" + +#: ../../about/geotrek.rst:56 +msgid "" +"Geotrek est un produit libre et open source avec une importante " +"communauté d'utilisateurs." +msgstr "" + +#: ../../about/geotrek.rst:58 +msgid "" +"Retrouvez toutes les infos sur la genèse du produit, son modèle " +"communautaire ainsi que les principales structures contributrices sur le " +"`site geotrek.fr `_." +msgstr "" + +#: ../../about/geotrek.rst:61 +msgid "Comment rejoindre la communauté ?" +msgstr "" + +#: ../../about/geotrek.rst:63 +msgid "" +"Rejoignez la `mailing list `_! Envoyez un mail à ``geotrek-" +"fr+subscribe@googlegroups.com`` et vous recevrez automatiquement une " +"invitation." +msgstr "" + +#: ../../about/geotrek.rst:64 +msgid "" +"`Ouvrir un ticket `_ lorsqu'un bug est détecté" +msgstr "" + +#: ../../about/geotrek.rst:65 +msgid "" +"`Ouvrir un ticket `_ pour proposer une suggestion ou une nouvelle " +"fonctionnalité" +msgstr "" + +#: ../../about/geotrek.rst:66 +msgid "" +"Rejoindre le `canal de discussion Matrix " +"`_ afin d'échanger directement " +"avec des membres de la communauté Geotrek" +msgstr "" + +#: ../../about/geotrek.rst:69 +msgid "Composants libres" +msgstr "" + +#: ../../about/geotrek.rst:71 +msgid "L’application Geotrek utilise les technologies open source suivantes :" +msgstr "" + +#: ../../about/geotrek.rst:74 +msgid "Geotrek-admin" +msgstr "" + +#: ../../about/geotrek.rst:76 +msgid "" +"**Python / Django**, l'épine dorsale de l'application qui prend en charge" +" les principales fonctionnalités comme le module de configuration, " +"l'exploitation de la base de données, la gestion des utilisateurs et de " +"leurs droits ou l'intégration avec les bibliothèques cartographiques. La " +"richesse de son écosystème permet de concevoir des applications aux " +"possibilités infinies, en favorisant la production d'applications " +"sécurisées, solides (tests automatiques) et robustes (Python)." +msgstr "" + +#: ../../about/geotrek.rst:77 +msgid "" +"**PostgreSQL / PostGIS** pour la base de données. La totalité des données" +" de l'application est stockée dans une instance PostgreSQL avec " +"l'extension spatiale PostGIS :" +msgstr "" + +#: ../../about/geotrek.rst:79 +msgid "attributs, comptes utilisateurs…," +msgstr "" + +#: ../../about/geotrek.rst:80 +msgid "géométries," +msgstr "" + +#: ../../about/geotrek.rst:81 +msgid "raster (Modèle Numérique Terrain)." +msgstr "" + +#: ../../about/geotrek.rst:84 +msgid "Geotrek-rando" +msgstr "" + +#: ../../about/geotrek.rst:86 +msgid "**Next.js** (*React, Typescript*)," +msgstr "" + +#: ../../about/geotrek.rst:87 ../../about/geotrek.rst:93 +msgid "**Leaflet**, utilisé comme librairie cartographique" +msgstr "" + +#: ../../about/geotrek.rst:90 +msgid "Geotrek-rando-widget" +msgstr "" + +#: ../../about/geotrek.rst:92 +msgid "" +"**Stencil**, framework permettant de créer des composants web " +"personnalisables et légers." +msgstr "" + +#: ../../about/geotrek.rst:96 +msgid "Geotrek-mobile" +msgstr "" + +#: ../../about/geotrek.rst:98 +msgid "**Angular**, framework utilisé pour l'application Geotrek-mobile." +msgstr "" + +#: ../../about/geotrek.rst:99 +msgid "**Ionic**, composant UI" +msgstr "" + +#: ../../about/geotrek.rst:100 +msgid "" +"**Capacitor**, boîte à outils nécessaires à la création d'applications " +"mobiles" +msgstr "" + +#: ../../about/geotrek.rst:101 +msgid "**MapLibre**, utilisé comme librairie cartographique" +msgstr "" + diff --git a/docs/locale/fr/LC_MESSAGES/contribute/contributing.po b/docs/locale/fr/LC_MESSAGES/contribute/contributing.po new file mode 100644 index 0000000000..791cb007de --- /dev/null +++ b/docs/locale/fr/LC_MESSAGES/contribute/contributing.po @@ -0,0 +1,569 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2013-2024, Makina Corpus +# This file is distributed under the same license as the Geotrek package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Geotrek \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-03-14 11:31+0100\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: fr\n" +"Language-Team: fr \n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.14.0\n" + +#: ../../contribute/contributing.rst:3 +msgid "Contributing" +msgstr "" + +#: ../../contribute/contributing.rst:10 +msgid "Conventions" +msgstr "" + +#: ../../contribute/contributing.rst:12 +msgid "" +"Before contributing, open an issue and discuss about it with community " +"(is it a bug or a feature ? What is the best way to achieve my goal ?)" +msgstr "" + +#: ../../contribute/contributing.rst:13 +msgid "Use flake8" +msgstr "" + +#: ../../contribute/contributing.rst:14 +msgid "KISS & DRY as much as possible" +msgstr "" + +#: ../../contribute/contributing.rst:15 +msgid "Elegant and generic is good, simple is better" +msgstr "" + +#: ../../contribute/contributing.rst:16 +msgid "Separate bug fixes and new features in several pull requests." +msgstr "" + +#: ../../contribute/contributing.rst:17 +msgid "" +"Open a new Pull Request in \"Draft\" status until tests passed. Use at " +"least 'bug', 'improvement' or 'feature' label." +msgstr "" + +#: ../../contribute/contributing.rst:18 +msgid "" +"Commits messages are explicit and mention issue number (``(ref #12)`` or " +"``(fixes #23)``), they should contains corresponding tag (see below)" +msgstr "" + +#: ../../contribute/contributing.rst:19 +msgid "Features are developed in a branch and merged from Github pull-requests." +msgstr "" + +#: ../../contribute/contributing.rst:22 +msgid "Definition of done" +msgstr "" + +#: ../../contribute/contributing.rst:24 +msgid "``docs/changelog.rst`` is up-to-date" +msgstr "" + +#: ../../contribute/contributing.rst:25 +msgid "An explicit unit-test covers the bugfix or the new feature." +msgstr "" + +#: ../../contribute/contributing.rst:26 +msgid "" +"A frontend test (:path:jstests/nav-\\*.js) covers the navigation bug fix " +"or feature" +msgstr "" + +#: ../../contribute/contributing.rst:27 +msgid "" +"A JS *Mocha* test (:path:jstests/tests.\\*.js) covers the JavaScript bug " +"fix or feature" +msgstr "" + +#: ../../contribute/contributing.rst:28 +#, python-format +msgid "" +"Unit-tests total coverage is above or at least equal with previous " +"commits. Patch coverage is 100% on new lines." +msgstr "" + +#: ../../contribute/contributing.rst:29 +msgid "Settings have default value in ``settings/base.py``" +msgstr "" + +#: ../../contribute/contributing.rst:30 +msgid "Installation instructions and documentation are up-to-date" +msgstr "" + +#: ../../contribute/contributing.rst:32 +msgid "Check TODO in the source tree:" +msgstr "" + +#: ../../contribute/contributing.rst:40 +msgid "Pull requests" +msgstr "" + +#: ../../contribute/contributing.rst:42 +msgid "Before creating a pull request, ensure you follow those rules :" +msgstr "" + +#: ../../contribute/contributing.rst:44 +msgid "Follow the guidelines of this page" +msgstr "" + +#: ../../contribute/contributing.rst:45 +msgid "Self-review your code" +msgstr "" + +#: ../../contribute/contributing.rst:46 +msgid "Add comments in your code, particularly in hard-to-understand areas" +msgstr "" + +#: ../../contribute/contributing.rst:47 +msgid "Make corresponding changes to the documentation" +msgstr "" + +#: ../../contribute/contributing.rst:48 +msgid "There is tests that prove my fix is effective or that my feature works." +msgstr "" + +#: ../../contribute/contributing.rst:49 +msgid "All new lines of code are tested" +msgstr "" + +#: ../../contribute/contributing.rst:50 +msgid "" +"There is an entry in the changelog file (with the corresponding issue " +"referenced)" +msgstr "" + +#: ../../contribute/contributing.rst:52 +msgid "" +"It is important to add a label to the pull request corresponding to the " +"perimeter. Release notes are generated according to labels of pull " +"requests. This is the list of available labels for pull requests:" +msgstr "" + +#: ../../contribute/contributing.rst:55 ../../contribute/contributing.rst:91 +msgid "Tag" +msgstr "" + +#: ../../contribute/contributing.rst:55 +msgid "Branch prefix" +msgstr "" + +#: ../../contribute/contributing.rst:55 ../../contribute/contributing.rst:91 +msgid "Emoji code" +msgstr "" + +#: ../../contribute/contributing.rst:55 ../../contribute/contributing.rst:91 +msgid "Unicode" +msgstr "" + +#: ../../contribute/contributing.rst:57 +msgid "Improvements" +msgstr "" + +#: ../../contribute/contributing.rst:57 +msgid "impr\\_" +msgstr "" + +#: ../../contribute/contributing.rst:57 +msgid "dizzy" +msgstr "" + +#: ../../contribute/contributing.rst:57 +msgid "💫" +msgstr "" + +#: ../../contribute/contributing.rst:59 +msgid "Bug fixes" +msgstr "" + +#: ../../contribute/contributing.rst:59 +msgid "bug\\_" +msgstr "" + +#: ../../contribute/contributing.rst:59 +msgid "bug" +msgstr "" + +#: ../../contribute/contributing.rst:59 +msgid "🐛" +msgstr "" + +#: ../../contribute/contributing.rst:61 +msgid "Features" +msgstr "" + +#: ../../contribute/contributing.rst:61 +msgid "feat\\_" +msgstr "" + +#: ../../contribute/contributing.rst:61 +msgid "sparkles" +msgstr "" + +#: ../../contribute/contributing.rst:61 +msgid "✨" +msgstr "" + +#: ../../contribute/contributing.rst:63 +msgid "Documentation" +msgstr "" + +#: ../../contribute/contributing.rst:63 +msgid "doc\\_" +msgstr "" + +#: ../../contribute/contributing.rst:63 +msgid "memo" +msgstr "" + +#: ../../contribute/contributing.rst:63 +msgid "📝" +msgstr "" + +#: ../../contribute/contributing.rst:65 +msgid "Maintenance" +msgstr "" + +#: ../../contribute/contributing.rst:65 +msgid "maint\\_" +msgstr "" + +#: ../../contribute/contributing.rst:65 +msgid "building_construction" +msgstr "" + +#: ../../contribute/contributing.rst:65 +msgid "🏗" +msgstr "" + +#: ../../contribute/contributing.rst:67 +msgid "Refactor" +msgstr "" + +#: ../../contribute/contributing.rst:67 +msgid "ref\\_" +msgstr "" + +#: ../../contribute/contributing.rst:67 +msgid "recycle" +msgstr "" + +#: ../../contribute/contributing.rst:67 +msgid "♻" +msgstr "" + +#: ../../contribute/contributing.rst:69 +msgid "Dependencies" +msgstr "" + +#: ../../contribute/contributing.rst:69 +msgid "dep\\_" +msgstr "" + +#: ../../contribute/contributing.rst:69 +msgid "arrow_up" +msgstr "" + +#: ../../contribute/contributing.rst:69 +msgid "⬆" +msgstr "" + +#: ../../contribute/contributing.rst:71 +msgid "CI/CD" +msgstr "" + +#: ../../contribute/contributing.rst:71 +msgid "cicd\\_" +msgstr "" + +#: ../../contribute/contributing.rst:71 +msgid "construction_worker" +msgstr "" + +#: ../../contribute/contributing.rst:71 +msgid "👷" +msgstr "" + +#: ../../contribute/contributing.rst:73 +msgid "Performances" +msgstr "" + +#: ../../contribute/contributing.rst:73 +msgid "perf\\_" +msgstr "" + +#: ../../contribute/contributing.rst:73 +msgid "zap" +msgstr "" + +#: ../../contribute/contributing.rst:73 +msgid "⚡" +msgstr "" + +#: ../../contribute/contributing.rst:75 +msgid "UI/UX" +msgstr "" + +#: ../../contribute/contributing.rst:75 +msgid "uiux\\_" +msgstr "" + +#: ../../contribute/contributing.rst:75 +msgid "lipstick" +msgstr "" + +#: ../../contribute/contributing.rst:75 +msgid "💄" +msgstr "" + +#: ../../contribute/contributing.rst:77 +msgid "Security" +msgstr "" + +#: ../../contribute/contributing.rst:77 +msgid "sec\\_" +msgstr "" + +#: ../../contribute/contributing.rst:77 +msgid "lock" +msgstr "" + +#: ../../contribute/contributing.rst:77 +msgid "🔒" +msgstr "" + +#: ../../contribute/contributing.rst:79 +msgid "Translations" +msgstr "" + +#: ../../contribute/contributing.rst:79 +msgid "trans\\_" +msgstr "" + +#: ../../contribute/contributing.rst:79 +msgid "globe_with_meridians" +msgstr "" + +#: ../../contribute/contributing.rst:79 +msgid "🌐" +msgstr "" + +#: ../../contribute/contributing.rst:81 +msgid "Hotfix" +msgstr "" + +#: ../../contribute/contributing.rst:81 +msgid "hot\\_" +msgstr "" + +#: ../../contribute/contributing.rst:81 +msgid "ambulance" +msgstr "" + +#: ../../contribute/contributing.rst:81 +msgid "🚑" +msgstr "" + +#: ../../contribute/contributing.rst:83 +msgid "Breaking change" +msgstr "" + +#: ../../contribute/contributing.rst:83 +msgid "break\\_" +msgstr "" + +#: ../../contribute/contributing.rst:83 +msgid "boom" +msgstr "" + +#: ../../contribute/contributing.rst:83 +msgid "💥" +msgstr "" + +#: ../../contribute/contributing.rst:86 +msgid "" +"Commits in pull requests are following a naming convention in order to " +"easily establish their perimeter. Commit is formated as ``emoji [tag] " +"description of commit``." +msgstr "" + +#: ../../contribute/contributing.rst:88 +msgid "" +"You can use one of the above prefix for your commits but also one of the " +"following (tags used only for commits, not for pull requests):" +msgstr "" + +#: ../../contribute/contributing.rst:93 +msgid "Codestyle" +msgstr "" + +#: ../../contribute/contributing.rst:93 +msgid "art" +msgstr "" + +#: ../../contribute/contributing.rst:93 +msgid "🎨" +msgstr "" + +#: ../../contribute/contributing.rst:94 +msgid "Clean" +msgstr "" + +#: ../../contribute/contributing.rst:94 +msgid "fire" +msgstr "" + +#: ../../contribute/contributing.rst:94 +msgid "🔥" +msgstr "" + +#: ../../contribute/contributing.rst:95 +msgid "Tests" +msgstr "" + +#: ../../contribute/contributing.rst:95 +msgid "white_check_mark" +msgstr "" + +#: ../../contribute/contributing.rst:95 +msgid "✅" +msgstr "" + +#: ../../contribute/contributing.rst:96 ../../contribute/contributing.rst:102 +msgid "Release" +msgstr "" + +#: ../../contribute/contributing.rst:96 +msgid "bookmark" +msgstr "" + +#: ../../contribute/contributing.rst:96 +msgid "🔖" +msgstr "" + +#: ../../contribute/contributing.rst:97 +msgid "Merge" +msgstr "" + +#: ../../contribute/contributing.rst:97 +msgid "twisted_rightwards_arrows" +msgstr "" + +#: ../../contribute/contributing.rst:97 +msgid "🔀" +msgstr "" + +#: ../../contribute/contributing.rst:104 +msgid "On master branch:" +msgstr "" + +#: ../../contribute/contributing.rst:106 +msgid "" +"Update files *VERSION* and *docs/changelog.rst* to remove ``+dev`` suffix" +" and increment version (please use semver rules)" +msgstr "" + +#: ../../contribute/contributing.rst:107 +msgid "Run ``dch -r -D RELEASED``, update version in the same way and save" +msgstr "" + +#: ../../contribute/contributing.rst:108 +msgid "Commit with message 'Release x.y.z' and push to ``master``" +msgstr "" + +#: ../../contribute/contributing.rst:109 +msgid "" +"Create new release on Github, with tag X.Y.Z, click on \"Generate release" +" notes\"" +msgstr "" + +#: ../../contribute/contributing.rst:110 +msgid "Wait for release to be published through CI" +msgstr "" + +#: ../../contribute/contributing.rst:111 +msgid "Update files *VERSION* and *docs/changelog.rst* to add ``+dev`` suffix" +msgstr "" + +#: ../../contribute/contributing.rst:112 +msgid "Run ``dch -v +dev --no-force-save-on-release`` and save" +msgstr "" + +#: ../../contribute/contributing.rst:113 +msgid "Commit with message 'Back to development' and push to ```master``" +msgstr "" + +#: ../../contribute/contributing.rst:115 +msgid "" +"When creating a new release 'x.y.z' on github, Github actions will " +"generate the .deb package file, and publish it on " +"https://packages.geotrek.fr (see ``.github/workflows/test.yml`` file for " +"details)" +msgstr "" + +#: ../../contribute/contributing.rst:118 +msgid "Other ways to contribute" +msgstr "" + +#: ../../contribute/contributing.rst:120 +msgid "" +"Help the users and answers questions on the `mailing-list " +"`_ ;" +msgstr "" + +#: ../../contribute/contributing.rst:121 +msgid "" +"`Open a ticket `_ " +"when you encounter a bug ;" +msgstr "" + +#: ../../contribute/contributing.rst:122 +msgid "" +"`Open a ticket `_ " +"when you have a suggestion or feature idea ;" +msgstr "" + +#: ../../contribute/contributing.rst:123 +msgid "Translate the documentation ;" +msgstr "" + +#: ../../contribute/contributing.rst:124 +msgid "" +"Translate the menus, buttons and labels (we use `Weblate `_) ;" +msgstr "" + +#: ../../contribute/contributing.rst:125 +msgid "" +"Maintain the installation script for different Linux distributions " +"(*requires some basic Linux skills*) ;" +msgstr "" + +#: ../../contribute/contributing.rst:126 +msgid "Fix bugs or improve layout and apparence (*requires Webmaster skills*) ;" +msgstr "" + +#: ../../contribute/contributing.rst:127 +msgid "Fix bugs or improve core modules (*requires python/Django skills*)." +msgstr "" + +#: ../../contribute/contributing.rst:129 +msgid "" +"Join the `mailing list `_! Send an email to ``geotrek-fr+subscribe@googlegroups.com`` and you" +" will receive an invitation automatically." +msgstr "" + diff --git a/docs/locale/fr/LC_MESSAGES/contribute/design.po b/docs/locale/fr/LC_MESSAGES/contribute/design.po new file mode 100644 index 0000000000..2d5b33e738 --- /dev/null +++ b/docs/locale/fr/LC_MESSAGES/contribute/design.po @@ -0,0 +1,230 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2013-2024, Makina Corpus +# This file is distributed under the same license as the Geotrek package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Geotrek \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-03-14 11:31+0100\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: fr\n" +"Language-Team: fr \n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.14.0\n" + +#: ../../contribute/design.rst:5 +msgid "Design" +msgstr "" + +#: ../../contribute/design.rst:12 +msgid "Architecture" +msgstr "" + +#: ../../contribute/design.rst:17 +msgid "**Geotrek-admin**, the web application" +msgstr "" + +#: ../../contribute/design.rst:18 +msgid "" +"**Convertit**, a Web API to convert document and image formats (*.odt to " +".doc*, *.svg to .png*)" +msgstr "" + +#: ../../contribute/design.rst:19 +msgid "" +"**Screamshotter**, a Web API to perform Web pages screenshots (*map image" +" exports*)." +msgstr "" + +#: ../../contribute/design.rst:23 +msgid "Main components" +msgstr "" + +#: ../../contribute/design.rst:25 +msgid "" +"The whole project is built on top of *mapentity*, a generic application " +"in charge of:" +msgstr "" + +#: ../../contribute/design.rst:27 +msgid "Menus and models registry" +msgstr "" + +#: ../../contribute/design.rst:28 +msgid "List/Detail/Create/Update/Delete views" +msgstr "" + +#: ../../contribute/design.rst:29 +msgid "Filtering" +msgstr "" + +#: ../../contribute/design.rst:30 +msgid "Map images exports" +msgstr "" + +#: ../../contribute/design.rst:31 +msgid "File attachment" +msgstr "" + +#: ../../contribute/design.rst:32 +msgid "Document export" +msgstr "" + +#: ../../contribute/design.rst:33 +msgid "Shapefile/GPX/CSV serializers" +msgstr "" + +#: ../../contribute/design.rst:35 +msgid "For a Django model, we use the registry to activate all views and menus:" +msgstr "" + +#: ../../contribute/design.rst:40 +msgid "" +"Business specific notions are implemented in Geotrek-admin respective " +"applications:" +msgstr "" + +#: ../../contribute/design.rst:42 +msgid "" +"**common**: shared concepts between all applications (*Organism*, " +"*utils*, ...)" +msgstr "" + +#: ../../contribute/design.rst:43 +msgid "" +"**authent**: groups, user, profile and structure notions. Optional " +"external authent backend." +msgstr "" + +#: ../../contribute/design.rst:44 +msgid "**core**: paths, snapping, spatial referencing (topologies)" +msgstr "" + +#: ../../contribute/design.rst:45 +msgid "**land**: physical types, competence, signage and work management" +msgstr "" + +#: ../../contribute/design.rst:46 +msgid "**infrastructure**: buildings" +msgstr "" + +#: ../../contribute/design.rst:47 +msgid "**signage**: signages and blades related content" +msgstr "" + +#: ../../contribute/design.rst:48 +msgid "" +"**maintenance**: interventions (on paths or on infrastructures) and " +"projects" +msgstr "" + +#: ../../contribute/design.rst:49 +msgid "**trekking**: POIs and treks" +msgstr "" + +#: ../../contribute/design.rst:50 +msgid "**outdoor**: outdoor sites and courses" +msgstr "" + +#: ../../contribute/design.rst:51 +msgid "**zoning**: static cities/districts/restricted areas layers" +msgstr "" + +#: ../../contribute/design.rst:52 +msgid "**altimetry**: elevation, DEM" +msgstr "" + +#: ../../contribute/design.rst:53 +msgid "**api**: manage all external communications interfaces (api v2, mobile)" +msgstr "" + +#: ../../contribute/design.rst:54 +msgid "**cirkwi**: implementation of cirkwi related api" +msgstr "" + +#: ../../contribute/design.rst:55 +msgid "**feedback**: feedbacks content, implementation of suricate workflow" +msgstr "" + +#: ../../contribute/design.rst:56 +msgid "" +"**flatpages**: flatpages models, used for publishing content on rando and" +" mobile apps" +msgstr "" + +#: ../../contribute/design.rst:57 +msgid "" +"**sensitivity**: sensitive areas and species related content, link with " +"Biodiv'Sport" +msgstr "" + +#: ../../contribute/design.rst:58 +msgid "" +"**tourism**: touristic contents and events, links with SIT (apidae, " +"tourinsoft)" +msgstr "" + +#: ../../contribute/design.rst:62 +msgid "Django conventions twists" +msgstr "" + +#: ../../contribute/design.rst:64 +msgid "We have a couple of Django conventions infringements:" +msgstr "" + +#: ../../contribute/design.rst:66 +msgid "" +"SQL triggers everywhere: since Geotrek-admin database is to become the " +"central storage component of all territory organisation data, it has to " +"behave consistently whether data is modified through the Web application " +"or raw access tools (pgadmin, QGIS). (For example, insertion & update " +"timestamps, geometry computation or DEM wrapping.)" +msgstr "" + +#: ../../contribute/design.rst:70 +msgid "" +"Safe delete: update field ``deleted = True`` instead of performing actual" +" delete in table. Requires every querysets to be filtered on deleted. " +"(**TODO**: use dango-safedelete, `issue 813 `_)" +msgstr "" + +#: ../../contribute/design.rst:75 +msgid "Main roles of PostgreSQL triggers" +msgstr "" + +#: ../../contribute/design.rst:77 +msgid "Automatic computation of fields :" +msgstr "" + +#: ../../contribute/design.rst:79 +msgid "Date insert/update" +msgstr "" + +#: ../../contribute/design.rst:80 +msgid "Geometry computation of linear referencing (topologies)" +msgstr "" + +#: ../../contribute/design.rst:81 +msgid "DEM elevation wrapping (3D length, slope, etc.)" +msgstr "" + +#: ../../contribute/design.rst:83 +msgid "Topological path network :" +msgstr "" + +#: ../../contribute/design.rst:85 +msgid "Split paths at intersection" +msgstr "" + +#: ../../contribute/design.rst:86 +msgid "Snap paths extremities" +msgstr "" + diff --git a/docs/locale/fr/LC_MESSAGES/contribute/development.po b/docs/locale/fr/LC_MESSAGES/contribute/development.po new file mode 100644 index 0000000000..4780ea9c8b --- /dev/null +++ b/docs/locale/fr/LC_MESSAGES/contribute/development.po @@ -0,0 +1,433 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2013-2024, Makina Corpus +# This file is distributed under the same license as the Geotrek package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Geotrek \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-11-13 11:25+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: fr\n" +"Language-Team: fr \n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../contribute/development.rst:5 +msgid "Development" +msgstr "Développement" + +#: ../../contribute/development.rst:11 +msgid "Quickstart" +msgstr "Démarrage rapide" + +#: ../../contribute/development.rst:13 +msgid "Download or git clone the source code of Geotrek-admin." +msgstr "" + +#: ../../contribute/development.rst:25 +msgid "Edit ``/etc/hosts`` file to add ``geotrek.local`` alias to ``127.0.0.1``" +msgstr "" + +#: ../../contribute/development.rst:27 +msgid "Go to ``http://geotrek.local:8000`` in your browser" +msgstr "" + +#: ../../contribute/development.rst:29 +msgid "" +"PDF generation might not work unless you use this domain and is correctly" +" set to ``SERVER_NAME`` variable in your ``.env`` file." +msgstr "" + +#: ../../contribute/development.rst:33 +msgid "Install git hooks" +msgstr "" + +#: ../../contribute/development.rst:35 +msgid "" +"Several git hooks are available to prevent pushing to master branch or " +"launch quality tests before committing. Install them with following " +"commands:" +msgstr "" + +#: ../../contribute/development.rst:44 +msgid "Adding or upgrade dependencies" +msgstr "" + +#: ../../contribute/development.rst:46 +msgid "Consider using pip-tools to manage dependencies." +msgstr "" + +#: ../../contribute/development.rst:48 +msgid "" +"add your dependencies in ``setup.py`` for general dependencies, ``dev-" +"requirements.in`` for dev dependencies, then run:" +msgstr "" + +#: ../../contribute/development.rst:54 ../../contribute/development.rst:146 +#: ../../contribute/development.rst:174 ../../contribute/development.rst:188 +msgid "or" +msgstr "" + +#: ../../contribute/development.rst:63 +msgid "Model modification" +msgstr "" + +#: ../../contribute/development.rst:70 +msgid "Note" +msgstr "" + +#: ../../contribute/development.rst:72 +msgid "Add migration file to source control." +msgstr "" + +#: ../../contribute/development.rst:75 +msgid "Definition of Done for new model fields" +msgstr "" + +#: ../../contribute/development.rst:77 +msgid "" +"When updating or adding a new field ``my_field`` to a model ``MyModel``, " +"please proceed with the following changes to ensure this field is " +"included in existing functionalities." +msgstr "" + +#: ../../contribute/development.rst:79 +msgid "**In** ``MyModel`` **class** :" +msgstr "" + +#: ../../contribute/development.rst:81 +msgid "If ``my_field`` is a ``ForeignKey``:" +msgstr "" + +#: ../../contribute/development.rst:83 +msgid "make sure to override ``related_name`` with an explicit set name" +msgstr "" + +#: ../../contribute/development.rst:85 +msgid "" +"if ``my_field`` causes cascading deletion (argument " +"``on_delete=models.CASCADE``), make sure to log potential deletions (see " +"example ``log_cascade_deletion_from_sector_practice`` in " +"``geotrek/outdoor/models.py``)" +msgstr "" + +#: ../../contribute/development.rst:87 +msgid "" +"Make sure to set ``verbose_name`` on the field and add proper " +"translations in ``.po`` files" +msgstr "" + +#: ../../contribute/development.rst:89 +msgid "**Outside of model class** :" +msgstr "" + +#: ../../contribute/development.rst:91 +msgid "" +"To display ``my_field`` in detail views, add a row in template " +"``mymodel_detail_attributes.html``" +msgstr "" + +#: ../../contribute/development.rst:93 +msgid "Look for form class ``MyModelForm(CommonForm)`` :" +msgstr "" + +#: ../../contribute/development.rst:95 +msgid "" +"If it exists, and field needs to be included in form, add ``my_field`` to" +" form attributes (``fields`` on the ``Meta`` class, sometimes " +"``fieldslayout`` as well)." +msgstr "" + +#: ../../contribute/development.rst:97 +msgid "" +"If field is added to the form **and is optional**, please add " +"``my_field`` to the documentation for hideable form fields : in ``docs" +"/advanced-configuration.rst`` look for ``HIDDEN_FORM_FIELDS['mymodel']`` " +"and add your field to the list." +msgstr "" + +#: ../../contribute/development.rst:99 +msgid "" +"Look for list view class ``MyModelList(CustomColumnsMixin, " +"MapEntityList)`` :" +msgstr "" + +#: ../../contribute/development.rst:101 +msgid "" +"If it exists, please add ``my_field`` to the documentation for custom " +"list view columns : in ``docs/advanced-configuration.rst`` look for " +"``COLUMNS_LISTS['mymodel_view']`` and add your field to the list." +msgstr "" + +#: ../../contribute/development.rst:103 +msgid "" +"If it exists, and if you wish to display a column for ``my_field`` in the" +" list view for this model by default, simply add ``my_field`` to " +"``default_extra_colums`` on this class." +msgstr "" + +#: ../../contribute/development.rst:105 +msgid "" +"Look for exports view class ``MyModelFormatList(MapEntityFormat, " +"MyModelList)`` :" +msgstr "" + +#: ../../contribute/development.rst:107 +msgid "" +"If it exists, please add ``my_field`` to the documentation for custom " +"list exports columns : in ``docs/advanced-configuration.rst`` look for " +"``COLUMNS_LISTS['mymodel_export']`` and add your field to the list." +msgstr "" + +#: ../../contribute/development.rst:109 +msgid "" +"If it exists, and if you wish to display a column for ``my_field`` in " +"CSV/SHP exports for this model by default, simply add ``my_field`` to " +"``default_extra_colums`` on this class." +msgstr "" + +#: ../../contribute/development.rst:111 +msgid "" +"Follow the documentation you just edited to test that custom columns and " +"hideable fields do work properly with your new field." +msgstr "" + +#: ../../contribute/development.rst:113 +msgid "" +"Look for sql file defaults " +"``geotrek/{app_name}/sql/post_90_defaults.sql`` :" +msgstr "" + +#: ../../contribute/development.rst:115 +msgid "" +"If it exists find your modelname in the list and depending on the default" +" value alter column ``my_field`` or add ``-- my_field``" +msgstr "" + +#: ../../contribute/development.rst:117 +msgid "" +"If the modelname doesn't exist, create a new section (even if you don't " +"need to alter column)" +msgstr "" + +#: ../../contribute/development.rst:119 +msgid "" +"Look for sql view file ``geotrek/{app_name}/sql/post_20_views.sql`` and " +"update the view for your model with an alias for the new field" +msgstr "" + +#: ../../contribute/development.rst:122 +msgid "**In API v2** :" +msgstr "" + +#: ../../contribute/development.rst:124 +msgid "" +"If ``MyModel`` is served by APIv2, make sure to add a serializer for the " +"new field in ``geotrek/api/v2/serializers.py`` and if you wish to filter " +"on this field, create a new filter and add it to the right ``ViewSet`` " +"under ``geotrek/api/v2/views``, using attribute ``filter_backends``." +msgstr "" + +#: ../../contribute/development.rst:127 +msgid "" +"When updating a field ``my_field`` in a model ``MyModel`` for " +"``new_field``, check if this field is translated in " +"``geotrek/{app}/translation.py``." +msgstr "" + +#: ../../contribute/development.rst:129 +msgid "" +"If so, you need to add a migration just after the migration generated by " +"Django. This migration should rename the old fields generated by " +"modeltranslation ``my_field_en`` by ``new_field_en`` (example : " +"``geotrek/trekking/migrations/0014_auto_20200228_2127.py``)" +msgstr "" + +#: ../../contribute/development.rst:135 +msgid "Check quality" +msgstr "" + +#: ../../contribute/development.rst:137 +msgid "**Flake8**" +msgstr "" + +#: ../../contribute/development.rst:139 ../../contribute/development.rst:158 +msgid "run:" +msgstr "" + +#: ../../contribute/development.rst:154 +msgid "Run tests" +msgstr "" + +#: ../../contribute/development.rst:156 +msgid "**Django tests :**" +msgstr "" + +#: ../../contribute/development.rst:165 +msgid "To run all test suites and report global coverage" +msgstr "" + +#: ../../contribute/development.rst:168 +msgid "To run a specific test suite, run:" +msgstr "" + +#: ../../contribute/development.rst:181 +msgid "And" +msgstr "" + +#: ../../contribute/development.rst:196 +msgid "**Cypress tests :**" +msgstr "" + +#: ../../contribute/development.rst:198 +msgid "Create an empty project with Docker :" +msgstr "" + +#: ../../contribute/development.rst:206 +msgid "Install elements for the cypress tests" +msgstr "" + +#: ../../contribute/development.rst:215 +msgid "Move in cypress folder and install" +msgstr "" + +#: ../../contribute/development.rst:223 +msgid "Launch tests" +msgstr "" + +#: ../../contribute/development.rst:230 +msgid "" +"Pictures of the problem and videos are generated in ``cypress/videos`` " +"and ``cypress/screenshots``." +msgstr "" + +#: ../../contribute/development.rst:234 +msgid "Setup to use screamshotter-related features locally" +msgstr "" + +#: ../../contribute/development.rst:236 +msgid "" +"Use the domain defined in ``SERVER_NAME`` in your ``.env`` to reach your " +"local Geotrek-admin web instance. By default the address is " +"``http://geotrek.local:8000``." +msgstr "" + +#: ../../contribute/development.rst:240 +msgid "Database reset" +msgstr "" + +#: ../../contribute/development.rst:242 +msgid "Data only:" +msgstr "" + +#: ../../contribute/development.rst:249 +msgid "Restore existing Database" +msgstr "" + +#: ../../contribute/development.rst:251 +msgid "Assuming a dump of your database is located in your project directory:" +msgstr "" + +#: ../../contribute/development.rst:257 +msgid "" +"Restore your ``./var/conf/`` project files, and data files into " +"``./var/media``." +msgstr "" + +#: ../../contribute/development.rst:259 +msgid "Then run a synchronization." +msgstr "" + +#: ../../contribute/development.rst:262 +msgid "Mapentity development" +msgstr "" + +#: ../../contribute/development.rst:264 +msgid "" +"See `Django-Mapentity documentation `_" +msgstr "" + +#: ../../contribute/development.rst:268 +msgid "UML diagrams of data model" +msgstr "" + +#: ../../contribute/development.rst:270 +msgid "" +"UML diagrams of Geotrek-admin data models are available in ``docs/data-" +"model`` directory. To regenerate them from PostgreSQL, install " +"postgresql-autodoc and graphviz Ubuntu packages and run ``make uml``." +msgstr "" + +#~ msgid "Go to http://geotrek.localhost:8000" +#~ msgstr "" + +#~ msgid "" +#~ "PDF generation might not work unless " +#~ "you use this domain and is " +#~ "correctly set to SERVER_NAME variable in" +#~ " your .env file." +#~ msgstr "" + +#~ msgid "" +#~ "add your dependency in setup.py for " +#~ "general dependency, dev-requirements.in for" +#~ " dev dependency, then run:" +#~ msgstr "" + +#~ msgid "" +#~ "If so, you need to add a " +#~ "migration just after the migration " +#~ "generated by django. This migration " +#~ "should rename the old fields generated" +#~ " by modeltranslation ``my_field_en`` by " +#~ "``new_field_en`` (example : " +#~ "``geotrek/trekking/migrations/0014_auto_20200228_2127.py``)" +#~ msgstr "" + +#~ msgid "``ENV`` variable must be set to run tests:" +#~ msgstr "" + +#~ msgid "Test without dynamic segmentation:" +#~ msgstr "" + +#~ msgid "Create an empty project with docker :" +#~ msgstr "" + +#~ msgid "" +#~ "Pictures of the problem and videos " +#~ "are generated in cypress/videos and " +#~ "cypress/screenshots" +#~ msgstr "" + +#~ msgid "Setup to run rando synchronization locally" +#~ msgstr "" + +#~ msgid "(sync rando is only relevant for an admin paired with geotrek rando v2)" +#~ msgstr "" + +#~ msgid "" +#~ "In your django settings you must " +#~ "set the 'url' key of SYNC_RANDO_OPTIONS" +#~ " to use the same domain as " +#~ "defined by SERVER_NAME in your .env." +#~ msgstr "" + +#~ msgid "For instance with SERVER_NAME=geotrek.localhost (default value)" +#~ msgstr "" + +#~ msgid "" +#~ "Use the domain defined in SERVER_NAME" +#~ " in your .env to reach your " +#~ "local geotrek admin web instance. By " +#~ "default the address is " +#~ "`http://geotrek.localhost:8000`." +#~ msgstr "" + diff --git a/docs/locale/fr/LC_MESSAGES/contribute/documentation.po b/docs/locale/fr/LC_MESSAGES/contribute/documentation.po new file mode 100644 index 0000000000..6a726a4617 --- /dev/null +++ b/docs/locale/fr/LC_MESSAGES/contribute/documentation.po @@ -0,0 +1,69 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2013-2024, Makina Corpus +# This file is distributed under the same license as the Geotrek package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Geotrek \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-11-13 11:25+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: fr\n" +"Language-Team: fr \n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../contribute/documentation.rst:2 +msgid "Documentation" +msgstr "" + +#: ../../contribute/documentation.rst:7 +msgid "We use sphinx doc and sphinx-rtd-theme. Requirements are included." +msgstr "" + +#: ../../contribute/documentation.rst:9 +msgid "" +"A container based on sphinx image is created using ``docker-compose-" +"dev.yml``, documentation is built in watch mode thanks to sphinx-" +"autobuild." +msgstr "" + +#: ../../contribute/documentation.rst:12 +msgid "To compile and test documentation on local environment, run:" +msgstr "" + +#: ../../contribute/documentation.rst:19 +msgid "Access to documentation built in html : http://0.0.0.0:8800" +msgstr "" + +#: ../../contribute/documentation.rst:23 +msgid "Translate documentation" +msgstr "" + +#: ../../contribute/documentation.rst:25 +msgid "Generate ``.pot`` files if needed" +msgstr "" + +#: ../../contribute/documentation.rst:31 +msgid "Generate ``.po`` files" +msgstr "" + +#~ msgid "" +#~ "A container based on sphinx image " +#~ "is created using docker-compose-dev.yml," +#~ " documentation is built in watch mode" +#~ " thanks to sphinx-autobuild." +#~ msgstr "" + +#~ msgid "Generate .pot if needed" +#~ msgstr "" + +#~ msgid "Generate .po files" +#~ msgstr "" + diff --git a/docs/locale/fr/LC_MESSAGES/contribute/translating.po b/docs/locale/fr/LC_MESSAGES/contribute/translating.po new file mode 100644 index 0000000000..dedf2a51bd --- /dev/null +++ b/docs/locale/fr/LC_MESSAGES/contribute/translating.po @@ -0,0 +1,222 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2013-2024, Makina Corpus +# This file is distributed under the same license as the Geotrek package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Geotrek \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-11-13 11:25+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: fr\n" +"Language-Team: fr \n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../contribute/translating.rst:3 +msgid "Translating" +msgstr "" + +#: ../../contribute/translating.rst:9 +msgid "" +"Geotrek-admin can be translated online on `Makina Corpus Weblate instance" +" `_" +msgstr "" + +#: ../../contribute/translating.rst:13 +msgid "Getting started" +msgstr "" + +#: ../../contribute/translating.rst:15 ../../contribute/translating.rst:20 +msgid "Create an account" +msgstr "" + +#: ../../contribute/translating.rst:16 ../../contribute/translating.rst:39 +msgid "Browse by project" +msgstr "" + +#: ../../contribute/translating.rst:17 ../../contribute/translating.rst:57 +msgid "Browse by language" +msgstr "" + +#: ../../contribute/translating.rst:22 +msgid "Click on \"Register\"" +msgstr "" + +#: ../../contribute/translating.rst:24 +msgid "Fill the register form" +msgstr "" + +#: ../../contribute/translating.rst:-1 ../../contribute/translating.rst +#: ../../contribute/translating.rst:95 +msgid "image" +msgstr "" + +#: ../../contribute/translating.rst:29 +msgid "Validate your email" +msgstr "" + +#: ../../contribute/translating.rst:31 +msgid "Fill the password" +msgstr "" + +#: ../../contribute/translating.rst:33 +msgid "Then connect to weblate" +msgstr "" + +#: ../../contribute/translating.rst:35 +msgid "" +"`Official documentation " +"`__ to create an " +"account and manage your profile." +msgstr "" + +#: ../../contribute/translating.rst:41 +msgid "Go to “Project > Browse all projects”" +msgstr "" + +#: ../../contribute/translating.rst:46 +msgid "Select Geotrek-admin project" +msgstr "" + +#: ../../contribute/translating.rst:48 +msgid "Click on tab “Languages”" +msgstr "" + +#: ../../contribute/translating.rst:50 +msgid "Choose the language to translate" +msgstr "" + +#: ../../contribute/translating.rst:59 +msgid "You could also choose language first" +msgstr "" + +#: ../../contribute/translating.rst:61 +msgid "Go to “Languages > Browse all languages”" +msgstr "" + +#: ../../contribute/translating.rst:62 +msgid "Choose the language you want to translate" +msgstr "" + +#: ../../contribute/translating.rst:63 +msgid "Select the project to translate" +msgstr "" + +#: ../../contribute/translating.rst:67 +msgid "Select a component to translate" +msgstr "" + +#: ../../contribute/translating.rst:69 +msgid "Select a component (a module or a piece of documentation)" +msgstr "" + +#: ../../contribute/translating.rst:70 +msgid "Click on \"Translate\" to start translating" +msgstr "" + +#: ../../contribute/translating.rst:72 +msgid "And let's go!" +msgstr "" + +#: ../../contribute/translating.rst:74 +msgid "" +"`Weblate official documentation " +"`__ for " +"translation." +msgstr "" + +#: ../../contribute/translating.rst:78 +msgid "Translation features" +msgstr "" + +#: ../../contribute/translating.rst:80 +msgid "" +"Weblate shows all translation by language and by module. Errors and left " +"to translate can be displayed easily." +msgstr "" + +#: ../../contribute/translating.rst:83 +msgid "" +"Weblate can identify problematic translations as chains between projects," +" punctuation inconsistency." +msgstr "" + +#: ../../contribute/translating.rst:88 +msgid "Other occurrences in all components allows to check consistency." +msgstr "" + +#: ../../contribute/translating.rst:93 +msgid "Each translation generate a permalink (picto |image|)." +msgstr "" + +#: ../../contribute/translating.rst:97 +msgid "Weblate has a \"Zen mode\" showing only chains to translate." +msgstr "" + +#: ../../contribute/translating.rst:100 +msgid "Release translations (only for github repository managers)" +msgstr "" + +#: ../../contribute/translating.rst:102 +msgid "" +"Weblate send new translations to `translations` branch in Github, " +"dedicated to translations. When new translations chains are validated, " +"manager has to send them manually to Github." +msgstr "" + +#: ../../contribute/translating.rst:105 +msgid "" +"For each release, `translations` branch must be merged into master before" +" building the release." +msgstr "" + +#: ../../contribute/translating.rst:108 +msgid "Send modifications to Github repository" +msgstr "" + +#: ../../contribute/translating.rst:110 +msgid "In component, click \"Manage > Repository maintenance\"" +msgstr "" + +#: ../../contribute/translating.rst:111 +msgid "Click \"Commit\" to save translation in local repository" +msgstr "" + +#: ../../contribute/translating.rst:112 +msgid "" +"Click \"Push\" to send local commits to `translations` branch in Github " +"repository" +msgstr "" + +#: ../../contribute/translating.rst:115 +msgid "Add translations to next release" +msgstr "" + +#: ../../contribute/translating.rst:117 +msgid "" +"In **Github**, merge `translations` branch into `master`, and update " +"changelog." +msgstr "" + +#: ../../contribute/translating.rst:119 +msgid "After releasing, in **Weblate**, rebase the branch:" +msgstr "" + +#: ../../contribute/translating.rst:121 +msgid "In the component, click \"Manage > Repository maintenance\"" +msgstr "" + +#: ../../contribute/translating.rst:122 +msgid "Click \"Rebase\" to rebase `translations` branch onto `master`" +msgstr "" + +#~ msgid "After releasing, in **Weblate**, rebase the branche :" +#~ msgstr "" + diff --git a/docs/locale/fr/LC_MESSAGES/index.po b/docs/locale/fr/LC_MESSAGES/index.po new file mode 100644 index 0000000000..04aab35299 --- /dev/null +++ b/docs/locale/fr/LC_MESSAGES/index.po @@ -0,0 +1,50 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2013-2024, Makina Corpus +# This file is distributed under the same license as the Geotrek package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Geotrek\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-11-13 11:25+0000\n" +"PO-Revision-Date: 2024-03-14 11:33+0100\n" +"Last-Translator: Jean-Etienne Castagnede \n" +"Language: fr\n" +"Language-Team: fr \n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../index.rst:6 +msgid "💡 About" +msgstr "💡 À propos" + +#: ../../index.rst:12 +msgid "🚀 User manual" +msgstr "🚀 Manuel utilisateur" + +#: ../../index.rst:26 +msgid "🔧 Installation & configuration" +msgstr "🔧 Installation & configuration" + +#: ../../index.rst:39 +msgid "✨ Contribute" +msgstr "✨ Contribuer" + +#: ../../index.rst:49 +msgid "📝 Others" +msgstr "📝 Autres" + +#: ../../index.rst:2 +msgid "Geotrek-admin's documentation" +msgstr "Documentation de Geotrek-admin" + +#: ../../index.rst:4 +msgid "" +"Geotrek-admin is backend management data for Geotrek-rando, Geotrek-" +"mobile and Geotrek-widget." +msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/install/advanced-configuration.po b/docs/locale/fr/LC_MESSAGES/install/advanced-configuration.po new file mode 100644 index 0000000000..2c5421e75c --- /dev/null +++ b/docs/locale/fr/LC_MESSAGES/install/advanced-configuration.po @@ -0,0 +1,2436 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2013-2024, Makina Corpus +# This file is distributed under the same license as the Geotrek package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Geotrek \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-11-13 11:25+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: fr\n" +"Language-Team: fr \n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../install/advanced-configuration.rst:5 +msgid "Advanced configuration" +msgstr "" + +#: ../../install/advanced-configuration.rst:13 +msgid "Application settings" +msgstr "" + +#: ../../install/advanced-configuration.rst:16 +msgid "Spatial extents" +msgstr "" + +#: ../../install/advanced-configuration.rst:18 +msgid "" +"In order to check your configuration of spatial extents, a small tool is " +"available at http://server/tools/extents/." +msgstr "" + +#: ../../install/advanced-configuration.rst:21 +#: ../../install/advanced-configuration.rst:63 +#: ../../install/advanced-configuration.rst:167 +#: ../../install/advanced-configuration.rst:274 +#: ../../install/advanced-configuration.rst:289 +#: ../../install/advanced-configuration.rst:309 +#: ../../install/advanced-configuration.rst:360 +#: ../../install/advanced-configuration.rst:411 +#: ../../install/advanced-configuration.rst:432 +#: ../../install/advanced-configuration.rst:473 +#: ../../install/advanced-configuration.rst:494 +#: ../../install/advanced-configuration.rst:534 +#: ../../install/advanced-configuration.rst:629 +#: ../../install/advanced-configuration.rst:677 +#: ../../install/advanced-configuration.rst:698 +#: ../../install/advanced-configuration.rst:713 +#: ../../install/advanced-configuration.rst:731 +#: ../../install/advanced-configuration.rst:818 +#: ../../install/advanced-configuration.rst:828 +#: ../../install/advanced-configuration.rst:904 +#: ../../install/advanced-configuration.rst:1159 +#: ../../install/advanced-configuration.rst:1346 +#: ../../install/advanced-configuration.rst:2774 +#: ../../install/advanced-configuration.rst:2825 +#: ../../install/advanced-configuration.rst:2845 +#: ../../install/advanced-configuration.rst:2863 +#: ../../install/advanced-configuration.rst:3008 +#: ../../install/advanced-configuration.rst:3033 +#: ../../install/advanced-configuration.rst:3055 +#: ../../install/advanced-configuration.rst:3108 +#: ../../install/advanced-configuration.rst:3143 +#: ../../install/advanced-configuration.rst:3170 +#: ../../install/advanced-configuration.rst:3182 +#: ../../install/advanced-configuration.rst:3201 +#: ../../install/advanced-configuration.rst:3290 +#: ../../install/advanced-configuration.rst:3306 +#: ../../install/advanced-configuration.rst:3355 +#: ../../install/advanced-configuration.rst:3373 +#: ../../install/advanced-configuration.rst:3391 +#: ../../install/advanced-configuration.rst:3414 +msgid "Note" +msgstr "" + +#: ../../install/advanced-configuration.rst:23 +msgid "Administrator privileges are required." +msgstr "" + +#: ../../install/advanced-configuration.rst:27 +msgid "Email settings" +msgstr "" + +#: ../../install/advanced-configuration.rst:29 +msgid "Geotrek-admin will send emails:" +msgstr "" + +#: ../../install/advanced-configuration.rst:31 +msgid "to administrators when internal errors occur" +msgstr "" + +#: ../../install/advanced-configuration.rst:32 +msgid "to managers when a feedback report is created" +msgstr "" + +#: ../../install/advanced-configuration.rst:34 +#: ../../install/advanced-configuration.rst:679 +msgid "" +"Email configuration takes place in ``/opt/geotrek-" +"admin/var/conf/custom.py``, where you control recipients emails " +"(``ADMINS``, ``MANAGERS``) and email server configuration." +msgstr "" + +#: ../../install/advanced-configuration.rst:37 +msgid "" +"Set configuration settings in ``geotrek/settings/custom.py.dist`` " +"template file." +msgstr "" + +#: ../../install/advanced-configuration.rst:39 +msgid "" +"You can test your configuration with the following command. A fake email " +"will be sent to the managers:" +msgstr "" + +#: ../../install/advanced-configuration.rst:49 +msgid "API" +msgstr "" + +#: ../../install/advanced-configuration.rst:53 +msgid "" +"Set to ``True`` if you want the API V2 to be available for everyone " +"without authentication." +msgstr "" + +#: ../../install/advanced-configuration.rst:55 +#: ../../install/advanced-configuration.rst:284 +#: ../../install/advanced-configuration.rst:301 +#: ../../install/advanced-configuration.rst:318 +#: ../../install/advanced-configuration.rst:380 +#: ../../install/advanced-configuration.rst:407 +#: ../../install/advanced-configuration.rst:420 +#: ../../install/advanced-configuration.rst:428 +#: ../../install/advanced-configuration.rst:441 +#: ../../install/advanced-configuration.rst:453 +#: ../../install/advanced-configuration.rst:465 +#: ../../install/advanced-configuration.rst:507 +#: ../../install/advanced-configuration.rst:530 +#: ../../install/advanced-configuration.rst:562 +#: ../../install/advanced-configuration.rst:575 +#: ../../install/advanced-configuration.rst:597 +#: ../../install/advanced-configuration.rst:609 +#: ../../install/advanced-configuration.rst:621 +#: ../../install/advanced-configuration.rst:642 +#: ../../install/advanced-configuration.rst:656 +#: ../../install/advanced-configuration.rst:669 +#: ../../install/advanced-configuration.rst:694 +#: ../../install/advanced-configuration.rst:709 +#: ../../install/advanced-configuration.rst:727 +#: ../../install/advanced-configuration.rst:749 +#: ../../install/advanced-configuration.rst:764 +#: ../../install/advanced-configuration.rst:803 +#: ../../install/advanced-configuration.rst:839 +#: ../../install/advanced-configuration.rst:858 +#: ../../install/advanced-configuration.rst:871 +#: ../../install/advanced-configuration.rst:964 +#: ../../install/advanced-configuration.rst:1180 +#: ../../install/advanced-configuration.rst:1241 +#: ../../install/advanced-configuration.rst:1256 +#: ../../install/advanced-configuration.rst:1280 +#: ../../install/advanced-configuration.rst:1334 +#: ../../install/advanced-configuration.rst:1342 +#: ../../install/advanced-configuration.rst:1376 +#: ../../install/advanced-configuration.rst:2469 +#: ../../install/advanced-configuration.rst:2789 +#: ../../install/advanced-configuration.rst:2797 +#: ../../install/advanced-configuration.rst:2818 +#: ../../install/advanced-configuration.rst:2838 +#: ../../install/advanced-configuration.rst:2859 +#: ../../install/advanced-configuration.rst:2875 +#: ../../install/advanced-configuration.rst:2895 +#: ../../install/advanced-configuration.rst:3047 +#: ../../install/advanced-configuration.rst:3090 +#: ../../install/advanced-configuration.rst:3104 +#: ../../install/advanced-configuration.rst:3135 +#: ../../install/advanced-configuration.rst:3150 +#: ../../install/advanced-configuration.rst:3166 +#: ../../install/advanced-configuration.rst:3178 +#: ../../install/advanced-configuration.rst:3193 +#: ../../install/advanced-configuration.rst:3209 +#: ../../install/advanced-configuration.rst:3221 +#: ../../install/advanced-configuration.rst:3234 +#: ../../install/advanced-configuration.rst:3247 +#: ../../install/advanced-configuration.rst:3260 +#: ../../install/advanced-configuration.rst:3272 +#: ../../install/advanced-configuration.rst:3302 +#: ../../install/advanced-configuration.rst:3314 +#: ../../install/advanced-configuration.rst:3326 +#: ../../install/advanced-configuration.rst:3346 +#: ../../install/advanced-configuration.rst:3364 +#: ../../install/advanced-configuration.rst:3381 +#: ../../install/advanced-configuration.rst:3399 +msgid "Example::" +msgstr "" + +#: ../../install/advanced-configuration.rst:59 +#: ../../install/advanced-configuration.rst:445 +#: ../../install/advanced-configuration.rst:457 +#: ../../install/advanced-configuration.rst:511 +#: ../../install/advanced-configuration.rst:566 +#: ../../install/advanced-configuration.rst:579 +#: ../../install/advanced-configuration.rst:601 +#: ../../install/advanced-configuration.rst:613 +#: ../../install/advanced-configuration.rst:625 +#: ../../install/advanced-configuration.rst:646 +#: ../../install/advanced-configuration.rst:660 +#: ../../install/advanced-configuration.rst:673 +#: ../../install/advanced-configuration.rst:753 +#: ../../install/advanced-configuration.rst:862 +#: ../../install/advanced-configuration.rst:875 +#: ../../install/advanced-configuration.rst:968 +#: ../../install/advanced-configuration.rst:1184 +#: ../../install/advanced-configuration.rst:1245 +#: ../../install/advanced-configuration.rst:1260 +#: ../../install/advanced-configuration.rst:1380 +#: ../../install/advanced-configuration.rst:3051 +#: ../../install/advanced-configuration.rst:3139 +#: ../../install/advanced-configuration.rst:3154 +#: ../../install/advanced-configuration.rst:3197 +#: ../../install/advanced-configuration.rst:3213 +#: ../../install/advanced-configuration.rst:3225 +#: ../../install/advanced-configuration.rst:3238 +#: ../../install/advanced-configuration.rst:3251 +#: ../../install/advanced-configuration.rst:3264 +#: ../../install/advanced-configuration.rst:3276 +#: ../../install/advanced-configuration.rst:3318 +msgid "Default::" +msgstr "" + +#: ../../install/advanced-configuration.rst:64 +msgid "" +"This API provides access to promotion content (Treks, POIs, Touristic " +"Contents ...)." +msgstr "" + +#: ../../install/advanced-configuration.rst:65 +msgid "" +"Set to ``False`` if Geotrek is intended to be used only for managing " +"content and not promoting them." +msgstr "" + +#: ../../install/advanced-configuration.rst:66 +msgid "" +"This setting does not impact the Path endpoints, which means that the " +"Paths informations will always need authentication to be display in the " +"API, regardless of this setting." +msgstr "" + +#: ../../install/advanced-configuration.rst:70 +msgid "Swagger API documentation" +msgstr "" + +#: ../../install/advanced-configuration.rst:74 +msgid "" +"In order to enable swagger module to auto-document API, in the custom " +"settings file, add the following code :" +msgstr "" + +#: ../../install/advanced-configuration.rst:76 +msgid "Enable API V2 documentation:" +msgstr "" + +#: ../../install/advanced-configuration.rst:83 +msgid "" +"Then run ``sudo dpkg-reconfigure -u geotrek-admin``. The API swagger " +"documentation is now available here : ``/api/v2``" +msgstr "" + +#: ../../install/advanced-configuration.rst:87 +msgid "Share services between several Geotrek instances" +msgstr "" + +#: ../../install/advanced-configuration.rst:89 +msgid "" +"As explained :ref:`in the design section `, *Geotrek-" +"admin* relies on several services. They are generic and reusable, and can" +" thus be shared between several instances, in order to save system " +"resources for example." +msgstr "" + +#: ../../install/advanced-configuration.rst:93 +msgid "" +"A simple way to achieve this is to install one instance with everything " +"as usual (*standalone*), and plug the other instances on its underlying " +"services." +msgstr "" + +#: ../../install/advanced-configuration.rst:98 +msgid "Capture and conversion" +msgstr "" + +#: ../../install/advanced-configuration.rst:100 +msgid "" +"If you want to use external services, in ``.env``, add following " +"variables:" +msgstr "" + +#: ../../install/advanced-configuration.rst:109 +msgid "" +"Then, you can delete all screamshotter and convertit references in " +"``docker-compose.yml``." +msgstr "" + +#: ../../install/advanced-configuration.rst:113 +msgid "Shutdown useless services" +msgstr "" + +#: ../../install/advanced-configuration.rst:115 +msgid "" +"Now that your instances point the shared server. You can shutdown the " +"useless services on each instance." +msgstr "" + +#: ../../install/advanced-configuration.rst:118 +msgid "Start by stopping everything:" +msgstr "" + +#: ../../install/advanced-configuration.rst:126 +msgid "Control number of workers and request timeouts" +msgstr "" + +#: ../../install/advanced-configuration.rst:128 +msgid "" +"By default, the application runs on 4 processes, and timeouts after 30 " +"seconds." +msgstr "" + +#: ../../install/advanced-configuration.rst:130 +msgid "" +"To control those values, edit and fix your ``docker-compose.yml`` file in" +" web and api section." +msgstr "" + +#: ../../install/advanced-configuration.rst:132 +msgid "" +"To know how many workers you should set, please refer to `gunicorn " +"documentation `_." +msgstr "" + +#: ../../install/advanced-configuration.rst:136 +msgid "External authentication" +msgstr "" + +#: ../../install/advanced-configuration.rst:138 +msgid "You can authenticate user against a remote database table or view." +msgstr "" + +#: ../../install/advanced-configuration.rst:140 +msgid "" +"To enable this feature, fill these fields in ``/opt/geotrek-" +"admin/var/conf/custom.py``:" +msgstr "" + +#: ../../install/advanced-configuration.rst:156 +msgid "Expected columns in table/view are :" +msgstr "" + +#: ../../install/advanced-configuration.rst:158 +msgid "``username`` : string (*unique*)" +msgstr "" + +#: ../../install/advanced-configuration.rst:159 +msgid "``first_name`` : string" +msgstr "" + +#: ../../install/advanced-configuration.rst:160 +msgid "``last_name``: string" +msgstr "" + +#: ../../install/advanced-configuration.rst:161 +msgid "" +"``password`` : string (simple md5 encoded, or full hashed and salted " +"password)" +msgstr "" + +#: ../../install/advanced-configuration.rst:162 +msgid "``email`` : string" +msgstr "" + +#: ../../install/advanced-configuration.rst:163 +msgid "" +"``level`` : integer (1: readonly, 2: redactor, 3: path manager, 4: " +"trekking manager, 5: management and trekking editor, 6: administrator)" +msgstr "" + +#: ../../install/advanced-configuration.rst:164 +msgid "``structure`` : string" +msgstr "" + +#: ../../install/advanced-configuration.rst:165 +msgid "``lang`` : string (language code)" +msgstr "" + +#: ../../install/advanced-configuration.rst:169 +msgid "" +"The schema used in ``AUTHENT_TABLENAME`` must be in the user search_path " +"(``ALTER USER $geotrek_db_user SET search_path=public,userschema;``)" +msgstr "" + +#: ../../install/advanced-configuration.rst:170 +msgid "User management will be disabled from Administration backoffice." +msgstr "" + +#: ../../install/advanced-configuration.rst:171 +msgid "" +"In order to disable remote login, just comment *AUTHENTICATION_BACKENDS* " +"line in settings file, and restart instance (see paragraph above)." +msgstr "" + +#: ../../install/advanced-configuration.rst:172 +msgid "" +"Geotrek-admin can support many types of users authentication (LDAP, " +"oauth, ...), contact us for more details." +msgstr "" + +#: ../../install/advanced-configuration.rst:175 +msgid "Custom SQL" +msgstr "" + +#: ../../install/advanced-configuration.rst:177 +msgid "" +"Put your custom SQL in a file name ``/opt/geotrek-" +"admin/var/conf/extra_sql//
_