Home

Geotrek Documentation Release 2.4.4 Makina

Contents

1. sim GU OS ES 8 FREQUENTLY ASKED QUESTIONS 8 1 How 3D informations are obtained 9 sp s e ocea mara dd eR ages 8 2 Howtheascentiscomputedontreks ELLE es 8 3 How POIS are related to Ju sn dame ie de ue UR date e 8 4 have overlapping districts 8 5 Why Makina Corpus sells Geotrek released under an Open Source license 86 How help and contribute mo Rogo 9 USER MANUAL EE ISI DETTO 902 Module y saiia i hp Re de o ode doeet ER dede ses 9 3 Fiches d tails 3 s uses Ga DAS ns ono Ro ow VOS y e omo Y wor RN 94 Edition d un objet 2 ue Bae Bed die MORE cR dre Qus UP AC IR d a 10 DESIGN Architecte 46 ecu de DRE E EUR ROS ER es RUN NIRE RU se NE 10 2 Main components n de eU xe gio dide us DIR die Oe Ate as DOME t um ee 10 3 Django conventions twists s ook RR RR E EX EORR RUE e dU ERE SOROR E 10 4 Mainxroles of PostereSQOL triggers oec door ede E Sox S MGE mars dos 10 5 Why buildout 7 s REC SEDE A elem XAR Rn A Boni mit 106 install Sh Sept e s 45 ms Xo 9 Ra Lea REREAD Sh we ck Roe aR EE eR ODE 10 7 ete SetHDBSDI di
2. notes 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 13 Geotrek Documentation Release 2 4 4 4 3 WYSIWYG editor configuration Text form fields are enhanced using TinyMCE Its configuration can be customized using advanced settings see above paragraph For example in order to control which buttons are to be shown and which tags are to be kept when cleaning up add this bloc TINYMCE DEFAULT CONFIG theme advanced buttons1 bold italic forecolor separator code valid elements img p a em i strong b This will apply to all text fields For more information on configuration entries available please refer to the official documentation of TinyMCE version 3 4 4 View attachments in the browser Attached files are downloaded by default by browser with the following line files will be opened in the browser MAPENTITY CONFIG SERVE MEDIA AS ATTACHMENT False 4 5 Using Google Maps projection in the Web interface Your data will still be stored using the SRID you specified in the settings ini file but the maps in the Web interface will be using the Google Mercator projection EPSG 3857 It allows you to use IGN Geoportail WMTS or OpenStreetMap tiles for example Start by adding this line in your custom Django setting file LEAF
3. er 23 2 Application backup ion ee Se AA Bottin ie Sew 2 9 Application restore voie cw x SUN E E IN Oe Se ee oS ee ee de Of Cleanupaoe ewe x wad Ba ee he ewe es Ried Rows RAD he ENCORE NW ee b ALS da 5 9 PostereSQL optimization s oos ioo 88594 jou uns AGERE See ee doe LE 5 6 Access your database securely on your local machine QGis 6 SYNCHRONIZATION 6 1 Manual synchronization sos e sess a RR CRUS Re honte 6 2 Automatic synchronization e 6 oem e eR ot Eom mm m oh Red Gh b d AR OR sde 6 3 Synchronization Options 5 GR hor Re XAR ee RR RC E 64 Synchronization filtered Eo SX Roo Re US np Res 6 5 Synchronization filtered by touristic content categories 6 6 Synchronization with a distant Geotrek Rando serveur 7 TROUBLESHOOTING 7 1 Installation outputs lot of database FATAL ERROR 7 2 Installation script hangs syncdb migrate 7 3 No paths in list where table contains records TA Nobackground tes he m RES GR RE ee din E RU E BOXE du 7 9 Emoratlodding DEM ox OK M ADEM Re eue es Sas 7 6 502 Bad Gateways 4 426 64
4. Geotrek Documentation Release 2 4 4 3 7 Advanced Configuration See advanced configuration 3 7 Advanced Configuration 11 Geotrek Documentation Release 2 4 4 12 Chapter 3 CONFIGURATION CHAPTER 4 ADVANCED CONFIGURATION 4 1 Custom setting file Geotrek configuration is currently restricted to values present in etc settings ini However it is still possible to write a custom Django setting file Create your a file in geotrek settings custom py with the following content from prod import My custom value HIDDEN OPTION 3 14 e Add this etc settings ini to specify the newly created setting django settings settings custom e As for any change in settings re run env standalone deploy 4 2 Disable modules and components In order to disable a full set of features in the custom settings file add the following code Disable infrastructure and maintenance INSTALLED APPS list INSTALLED APPS INSTALLED APPS remove geotrek infrastructure _INSTALLED_APPS remove geotrek maintenance INSTALLED APPS INSTALLED APPS In order to remove notion of trails TRAIL MODEL ENABLED False In order to remove zoning combo boxes on list map LAND BBOX CITIES ENABLED True LAND BBOX DISTRICTS ENABLED True LAND BBOX AREAS ENABLED False
5. NODE 13 5 22 50 2015 ia tre ue ee MS Eis dU REN AE Me BLESSE 13 6 2 3 0 2018 11 09 senes NUR RU 13 7 12 2 0 2015 10 09 amp exo oboe un EERE e Go veo e renum v SHES S 13 8 2 1 0 2015 09 29 55 tob m REO ede em eR Reo ee er SR ede Gah 13 9 2 0 0 2015507 20 Seer De OR SUR EUR ex Rue Goma y Ue 5 13 10 09 35 1 020 7520 TMT ao Rente RD SR CHR ee erp BP Rt ie eder 13 11 0 35 0 20155077 10 Ru ok ES m Din RUE RO y S PURUS Re SON RE dot RR A 13 12 0340 20152 05220 pren e DR RO SECURE 13 13 0 35 4 2015 04 07 s ss ous ae po eu 8 qs 13 14 0 39 5 2015304 0 D c RE SAREE Xe EEUU e 13 15 033 2 2015 04 01 RR passat hassan 13 16 03320150325 e Loi SE der es RENE CRE 13 17 0 38 0 2015 08 25 9 OX BUR ns dune E Ris 13180322 2015 05 06 mme one Gh eI He oD Mage ER te delai ane 13 19 032120150800 RR em PRE e ERST D be diei eee 13 20 0 320 2015 03 04 5 x oh ea pote uk ooo EEA 13 21 0 31 0 2015 03 02 see e ey
6. Rename mailadmintomailadminsinetc settings ini Permission systems has been refactored see below Bug fixes Force browser cache revalidation of geojson data fixes 843 Force browser cache revalidation for path graph fixes 1029 Fix deletion porblems in AdminSite fixes 1008 Trek advised parking and public transport are translatable fixes 1024 Fix missing translation no filters and current criterias fixes 884 Fix PDF versions of documents not being translated fixes 1028 New features 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 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 New permission to allow users or groups to bypass structure restrictions Add a setting to serve attached files as download default True fixes 976 Track objects creations changes and deletions fixes 300 Added a reader group fixes 495 Topologies are not recreated if user did not edit field fixes 833 Added static file for projection EPSG 32620 Show land objects in menu fixes 942 Documented configuration of custom projections fixes 1037 Buttons in the list menu to add ne
7. Uploaded files are now restricted to authenticated users fixes 729 notes Geotrek rando 1 23 or higher is required to synchronize content NEW features In list view click on map brings to detail page mouse over highlights in list Show path icon if intervention is not on infrastructure fixes 909 Add spanish translation Add photographie into default attachments filetype Map location combobox Cities Districts Areas are not shown if empty or disabled Several database views have been created fixes 934 Remove dots from path icon fixes 939 Intervention infrastructure and project filters list of years is now dynamic fixes 948 Application available languages english french italian spanish are now distinct from translated content lan guages languages value in settings ini Minor changes Improved apparence of map controls mproved apparence of path intermediary points Improved apparence of form validation buttons Add auto generated docs at admin doc Nicer installation script output Installation script Scan and ortho attributions can now be set using scan attributions and Propose to backup DB before Geotrek upgrade fixes 804 e Settings edition prompt only happens at first install ortho attributions in settings ini BUG fixes Fix convert urls behind reverse proxy with prefix Fix deployment problem if layercolor others not overidden in settings ini Fix topology kinds to be I
8. 13 41 0 25 1 2014 08 01 Bug fixes Fix Geotrek CSS not being deployed properly Fix trek relationships causing errors for PDF export 13 42 0 25 0 2014 08 01 New features e Added projection EPSG 32622 fixes 1 150 Now log addition and suppression of attachments in history Added notion of points of reference for treks fixes 1105 Can be disabled with TREK POINTS OF REFERENCE ENABLED False Edit the parking location directly on the trek map ref 387 Show enumeration of POIs in trek PDF exports fixes 871 BUG fixes e Fix permission check to see attachments fixes 1147 ref 1 146 Fix grouping of interventions in detail pages fixes 1145 Fix project total intervention cost fixes 958 Fix history entries not being saved when using formsets fixes 1139 Fix postal code being saved as integer fixes 1138 Existing records will have a leading zero when shorter than 5 charaters Fix bug when form of intervention on infrastracture is not valid Limit height of layer switcher on small screens fixes 1136 Get rid of next parameter when redirecting to login when permission missing fixes 1142 Fix apparence of main menu when permissions are missing to view logbook and admin ref 1 142 Internal changes Rework display of lists in detail pages better factorization Removed links in logbook list for certain models Display messages in login page too usef
9. pes Re DE Redo UR RE le 13 22 0 30 0 2015 02 19 dise SOR Hiver RUE OX RUE RU toe a AES ORO A LN 13 23 029 0120150209 sms ee De De Den n BAG EN EOE Re RR GS 13 24 0 28 8 2014 12 22 s 5 mn URS 13 25 0287 2014 12 22 NS SA BASS e ER SERRE 13 26 0 28 6 2014 12 18 RU me S RU aes 13527028 2014 12709 RAS MEHR 1e Nom 13 28 0 284 2014 11 21 og 13 29 0 283 2014 11 12 Bae OS di Sie SEA 13 30 0 28 2 2014 11 05 5 5 pes neo we Rd 310 281 2014 1105 RR ERA RR RUE OS RUE Ue one ee 5 13 32 9 28 0 2014 TD 04 hue e RR eR Se beo ec i e RR DR SR UR ins 13 33 0 27 2 2010 10 14 o RR EE PED EER Os ont ORE eon mmn 13 34 0 27 1 2010 10 13 kei m eomm Reim 8 R RECS ep mo n 13 35 0 27 0 2010 10 09 NORD RU D es o Rp RU deu 13 360 0 26 5 20T45095 5 amp e tee ee HE ede Gd howe Bite SR None 13 37 0 26 2 2014 08 22 EUR Pa RUM RE SOR ON ee eRe 13 38 0 20 1 2014 0872 T
10. previous version geotrek settings custom py geotrek settings custom py Deploy the new version Re run install install sh Empty cache sudo service memcached restart Check the version on the login page note Shutting down the current instance may not be necessary But this allows us to keep generic software update procedure If you don t want to interrupt the service skip the stop step at your own risk Check out the troubleshooting page for common problems 1 4 Server migration It is a new installation with an additional backup restore and a file transfert in between The commands below are examples to adapt to your actual configuration server names database configuration Backup files and database on the old server cd Geotrek sudo u postgres pg dump Fc geotrekdb geotrekdb backup tar cvzf data tgz geotrekdb backup var static var media paperclip var media upload Get and unzip Geotrek sources on the new server 4 Chapter 1 INSTALLATION Geotrek Documentation Release 2 4 4 wget https github com makinacorpus Geotrek archive 2 0 0 zip unzip 2 0 0 zip mv Geotrek 2 0 0 Geotrek cd Geotrek Restore files on the new server scp old server Geotrek data tgz tar xvzf data tgz Then edit etc settings ini to update host variable and geotrek settings custom py to update IGN key Install Geotrek on the new server instal
11. 13 35 0 27 0 2010 10 09 Breaking changes Attribute for single information desk was removed was used in Geotrek rando 1 29 e Renamed setting TREK_ PUBLISHED BY LANG to PUBLISHED BY LANG Renamed setting TREK EXPORT MAP IMAGE SIZE to EXPORT MAP IMAGE SIZE REK EXPORT HEADER IMAGE SIZE to EXPORT HEADER IMAGE SIZE and TREK COMPLETENESS FIELDS to COMPLETENESS FIELDS They are now a dictionnary by ob ject type see example New features POI publication is now controlled like treks POI now have a public PDF too 13 33 0 27 2 2010 10 14 53 Geotrek Documentation Release 2 4 4 Introduced VIEWPORT MARGIN setting to control list page viewport margin around spatial extent from settings ini default 0 1 degree notes 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 Bug fixes Add missing credit for main picture in trek PDF fixes 1178 Paths module is now removed from user interface in Geotrek light mode i e with TREKKING TOPOLOGY ENABLED False Make sure text fields are cleared fixes 1207 Intervention subcontracting was missing in detail pages fixes 1201 Make sure TLS is disabled when mailt1s i
12. A generic application in charge of Menus and models registry List Detail Create Update Delete views Filtering Map images exports File attachment Document export Shapefile GPX CSV serializers For a Django model we use the registry to activate all views and menus odt doc v5 pdf nd TA gt FORM EA Ea e feo e 7 CE Wwistery Y Jn 33 Geotrek Documentation Release 2 4 4 Business specific notions are implemented in Geotrek respective applications common shared concepts between all applications Organism utils authent groups user profile and structure notions Optional external authent backend core elevation paths snapping spatial referencing topologies land static cities districts restricted areas layers physical types competence signage and work management infrastructure buildings signages equipements maintenance interventions on paths or on infrastructures and projects trekking POIs and treks 10 3 Django conventions twists We have a couple of Django conventions infringements Buildout see DEPLOYMENT section SQL triggers everywhere since Geotrek database is to become the central storage component of all park or ganisation data it has to behave consistently whether data is modified through the Web application or raw access tools pgadmin QGIS For example insertion amp update timestamps geo
13. Fix mention of MAP STYLES ref 1226 Changes in experimental features e Renamed usage to type in touristic events fixes 1289 13 29 0 28 3 2014 11 12 Bug fixes Fix upload form author legend format fixes 1293 Fixes history list ref 1276 Prevent email to be sent twice on conversion error Use info instead Fix paperclip translations missing fixes 1294 Fix filetypes not being filtered by structure fixes 1292 Fix apparence of multiple choices in forms fixes 1295 13 30 0 28 2 2014 11 05 Bug fixes Fix upgrade of django leaflet to 0 15 0 overlay layers Fix apparence of overlay layers for tourism when experimental features are disabled Fix plural in tourism translation Fix unit tests Run this command to set the default information desk type with the original pictogram or select a pictogram from the adminsite cd Geotrek 0 28 2 curl https raw githubusercontent com makinacorpus Geotrek v0 27 2 geotrek trekking stiatic trekkimn 13 28 0 28 4 2014 11 21 51 Geotrek Documentation Release 2 4 4 13 31 0 28 1 2014 11 05 Bug fixes Fix deployment when tourism is not enabled Fix default duration when invalid value is filled fixes 1279 Fix year filters for intervention infrastructure and project fixes 1287 Fix list filters not being restored fixes 1236 13 32 0 28 0 2014 11 04 Breaking changes Before running install run this SQL comman
14. Start by stopping everything sudo stop geotrek Before you used to run make env_standalone deploy on every server Now you will have only one stan dalone and on the other ones the Geotrek application only To achieve this you will just have to run the prod environment instead of standalone in the deployment procedure or when settings are changed make env_prod deploy 4 16 Control number of workers and request timeouts By default the application runs on 4 processes and timeouts after 30 seconds To control those values add a section in etc settings ini for each running service See conf settings defaults cfg for exhaustive list 18 Chapter 4 ADVANCED CONFIGURATION Geotrek Documentation Release 2 4 4 gunicorn app conf workers 4 timeout 30 To know how many workers you should set please refer to gunicorn documentation 4 16 Control number of workers and request timeouts 19 Geotrek Documentation Release 2 4 4 20 Chapter 4 ADVANCED CONFIGURATION CHAPTER 5 MAINTENANCE 5 1 Operating system updates sudo apt get update sudo apt get dist upgrad 5 2 Application backup Give postgresql the right to write files in application folder sudo adduser postgres whoami Database sudo su postgres pg dump Fc geotrekdb gt home sentiers date Y m d H M database backup exit Medi
15. 2 eats Babee eee Eth et eee ee ed dese eoe eg 13 39 0 26 0 2014 08 21 as css eR OS EE DE 13 40 0 25 2 20 14085 14D poto er nan es s ENNEMIS TSAO EN et ton ec se BP Em Se aR Ge 13 42 0 25 0 2014 08 01 i EERE EEDA EES ee E Re 13 43 024 3 2014 06 27 ag ee e bon edem mcm coin pe poe ee 13 44 10 24 2 2014 06 27 aus SOURCE E e xU RU E RU Re em Ne de semer at ass TS AD OLZA 1 2014 06 2 524 08 GRR eR e ei eee 1346 0 24 0 2014 00 23 te A 57 13 47 0 23 52 2014506719 Lo do Een GE SR ewe EE EURE 59 13 48 0 23 4 2014 06 18 59 13 49 0 25 3 2014 06 18 i she mesures di DRE EURO Red E Rae 59 13 50 40 23 2 2014906 13 AO de RAS GUN NU US HA DDS 60 13 51 0 23 1 2014905322 JL US pet ore Audio Edere ie adeo o bep A 61 13 352 0 23 2014 05 22 ko dere ORO ee REA ROS S RO XO va te ROS doe S 61 13 53 0 22 6 20140452 7 9 me aug ame eR nue e RC e AR GONE RRS DEOR NEUE ON Rees 63 13 54 0 22 5 2014 0
16. 680 Run API urls on different workers ref 672 Fix redirect to root url after logout fixes 264 Fix redirect to next after login fixes 381 Switch to Memcached instead of local memory in production 13 75 0 18 2013 06 06 71 Geotrek Documentation Release 2 4 4 Move secret key to settings ini Relate paperclip File Type to Structure fixes 256 Relate PhysicalTypes to Structure fixes 255 Relate Organisms to Structure fixes 263 Compute max resolution automatically Fix creation and edition of interventions on infrastructures fixes 678 Change default objects color to yellow Restored Italian translations Fix regex for RAISE NOTICE fixes 673 Initial public version See project history in docs history rst French 72 Chapter 13 CHANGELOG CHAPTER 14 Indices and tables genindex modindex search 73
17. parking du Gioberney ol z Le vallon de Vaccivier 0 Aucun e Gioberney La boucle de Tiri re 3 5 Moyen Gioberney Le Clot 0 Aucun e La Chapelle en Valgaudemar aucune RAISSE n PA Des Auberts la Chapelle e 0 Aucun e Les Auberts wl f Chabourn ou Vallonpie 5 Moyen Parking du Cr pon La Chap Rando Test 4 Facile Testtersdirtretets 0 Aucun e testetestete 0 Aucun e LI L LI Exporter la liste Rechercher parmi 1 Parcourir les pages les r sultats de r sultats Au survol d un objet dans la liste celui ci est mis en surbrillance sur la carte Au survol d un objet sur la carte celui ci est mis en vidence dans la liste La liste des r sultats est filtr e en fonction de l tendue de la carte affich e C est aussi depuis un module qu il est possible d ajouter de nouveaux objets Un clic sur un objet dans la liste ou la carte permet d acc der la fiche d taill e de celui ci 9 3 Fiches d tails 9 4 Edition d un objet 32 Chapter 9 USER MANUAL CHAPTER 10 DESIGN 10 1 Architecture Geotrek the web application TileCache tile and cache remote WMS servers Convertit a Web API to convert document and image formats odt to doc svg to png Screamshotter a Web API to perform Web pages screenshots map image exports 10 2 Main components The whole project is built on top of mapentity
18. Camille Montchicourt for their patience on this 13 49 0 23 3 2014 06 18 Bug fixes Fix static files compression when using Google Mercator projection in maps Fix intermediary points order in topology de serialization and remove useless topology serialization optimiza tions fixes 1031 13 47 0 23 5 2014 06 19 59 Geotrek Documentation Release 2 4 4 13 50 0 23 2 2014 06 13 Bug fixes Fixed land records not shown in detail pages Fixed JSON DEM area extent for treks Fixed targets list for tourism datasources fixes 1091 Cache tourism datasources for one day setting CACHE TIMEOUT TOURISM DATASOURCES Fix crashes with TourInFrance sources Add link to OSM in feedback email fixes 1089 1093 Fix feedback email translation fixes 1087 Fix problem with permission check read attachment in detail page fixes 1092 Fix measure control appearing twice in forms fixes 1078 Fix 404 on download buttons from list views Fix POI translated fields not tabbed fixes 1065 Fix missing translation of Add a new POT fixes 1086 Fix invalid snapping when save path without editing geometry fixes 1099 Add missing properties in feedback report detail page Hide all modules information in report detail page Add missing translations of feedback module Show object type in ODT export fixes 1000 Internal changes Upgraded to Mapentity 1 4 0 Upgraded to
19. DEVELOPMENT Geotrek Documentation Release 2 4 4 Unit tests coverage is above or at least equal with previous commits e Settings have default value in settings base pyorconf settings default ini Installation instructions are up to date Check TODO min the source tree find geotrek xargs egrep n i TODO XXX temporary FIXME 11 7 Release Update VERSION file docs conf py e Pin fixed revision of eggs under development in buildout cfg Use semantic versioning Use zest releaser Add git tag vX Y Z Add release on Github copy paste CHANGES paragraph 11 8 Model modification bin django schemamigration lt appName gt auto bin django syncdb migrate notes Add migration file to source control 11 9 Database reset Data only bin django flush Everything dbname geotrekdb sudo n u postgres s psql c DROP DATABASE 5 amp amp sudo n u postgres s 11 10 Mapentity development To develop mapentity and Geotrek together add the following lines to etc settings ini sources mapentity git https github com makinacorpus django mapentity git branch develop buildout auto checkout mapentity Then run 11 7 Release 39 psql c ci Geotrek Documentation Release 2 4 4 make env_dev update cd lib src mapentity git submodule init git submodule update 40 C
20. ID ex with touristiccontent categories4 1 2 3 23 Geotrek Documentation Release 2 4 4 6 4 Synchronization filtered by source You can filter treks touristic contents touristic events and static pages by source s For example if you created 3 records sources named source source and source and you want only export data only from source and source B to your web public portal you can synchronize with bin django sync rando source source A source B dataAB Multiple sources are separated with comas without space before or after coma Do not forget to add double quotes after and before the parameter if there are spaces in source names You can run several commands to export several sources combinations into several directories and use them to publish several distinct web portals 6 5 Synchronization filtered by touristic content categories You can include touristic content per trek You must specify ID categories bin django sync rando with touristiccontent categories 1 3 Multiple categories are separated with comas without space before or after coma 6 6 Synchronization with a distant Geotrek Rando serveur If your server hosts both Geotrek Admin and Geotrek Rando you just have to configure Geotrek Rando so it uses the directory chosen above Be sure nginx or apache will have access rights to read these data If you have to separate servers you have to copy files f
21. a specific trek in REST API Consistent REST API typel type2 category for treks touristic contents and touristic events Bug fixes Ensure path snapping is done on the closest point and is idempotent Fix language of PNG elevation charts e Fix logo on login page Fix logs rotation Fix permissions creation 13 23 0 29 0 2015 02 04 New features GeoJSON API with all properties for Trek and Tourism Bug fixes Fix permissions required to sync static Web pages Fix geom computation on line topologies with offset 13 24 0 28 8 2014 12 22 Bug fixes Fix altimetry sampling for segment with 0 length rel 1337 13 22 0 30 0 2015 02 19 49 Geotrek Documentation Release 2 4 4 13 25 0 28 7 2014 12 22 Bug fixes Fix altimetry trigger when TREKKING TOPOLOGY ENABLED is set to False 13 26 0 28 6 2014 12 18 Bug fixes Fix 3D length shorter than 2D length run sql command UPDATE 1 t troncon 51 upgrade to update altimetry informations of existing geometries Fix translation of Information desks in public trek PDF ET geom geom after Fix prepare map images and prepare elevation charts commands failing for deleted objects and for objects without geom 13 27 0 28 5 2014 12 09 Bug fixes Fix DEM optimizations when minimum elevation is zero fixes 1291 Fix regression for translations of tourism fixes 1315 Fix duplicate entries with year filter fixes 1324 Docume
22. default permissions of these existing groups create new ones etc If you want to allow the users to access the AdminSite give them the staff status using the dedicated checkbox 3 5 Database users It is not safe to use the geot rek user in QGis or to give its password to many collaborators A wise approach is to create a read only user or with specific permissions With pgAdmin you can create database users like this CREATE ROLE lecteur LOGIN ALTER USER lecteur PASSWORD passfacile GRA CONNECT ON DATABASE geotrekdb TO lecteur 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 3 6 Email settings Geotrek will send emails to administrators when internal errors occur to managers when a feedback report is created Email configuration takes place in etc settings ini where you control recipients emails mailadmins mailmanagers as well as server parameters host user password You can test you configuration with the following command A fake email will be sent to the managers bin django test managers emails 10 Chapter 3 CONFIGURATION
23. file hao Re a ee ga BO ven 13 4 2 Disable modules and components 13 43 WYSIWYGeditor Configuration esis e eos be o gm eR ep buse ep ee 14 4 4 View attachments in the browser 14 4 5 Using Google Maps projection in the Web interface 14 46 Ext mmal authent s 5 4 opo aseo som de uox we de bey SOR RUE 14 41 Maplayerscolors andstyl RA X de ed ane dei d Y eS BS dug 15 4S8 ExternalTaster ldyets s doe Shee ow E 4 Bop ERROR EROR A 15 49 External vectorial layers oc dot es ie alain X uS 16 410 Disable darker map backgrounds o oee e 4 44 RR ERE 16 4 11 Override public document OpenOffice template 16 4 12 Custom font in public document OpenOffice template 17 4 13 Custom colors in public document OpenOffice template 17 4 04 Custom lobos so uode mens EAD aS RE here Duke 17 4 15 Share services between several Geotrek instances 17 4 16 Control number of workers and request timeouts 18 5 MAINTENANCE 3 Operating system updates 22 sae ORAS OE eae
24. re open if problem re appears Fix timeout on POI Shapefile and CSV exports fixes 672 Altimetric profiles are now computed in PostGIS fixes 778 779 Positive and negative ascents are now computed using more DEM resolution fixes 776 notes Setting PROFILE MAXSIZE was replaced by ALTIMETRIC PROFILE PRECISION which controls sampling precision in meters default 20 meters 13 69 0 20 3 2013 09 30 69 Geotrek Documentation Release 2 4 4 Altimetric profiles were removed from object map images Altimetric profiles are now plotted using SVG Altimetric profiles are now inserted into path documents and trek public printouts ref 626 Fix deletion of associated interventions when editing infrastructures fixes 783 Latest record is updated touch when a DELETE is performed on table refreshs cache fixes 698 Reworked settings mechanism to follow Django best practices notes Replace all computed values from etc settings ini For example replace 60 60 by 3600 You can increase this value to several hours by the way Allow server host to capture pages fixes 733 Adjust map capture according to geometry aspect ratio fixes 627 Always show path layer in detail pages fixes 781 Fix restore of topology on loop paths fixes 760 Fix topology construction when loop is formed by two convergent paths fixes 768 Added small tool page at tools extents to visualize configured ext
25. spatial extents small tool is available at http server tools extents notes Administrator privileges are required 3 3 Custom spatial reference Geotrek comes with a few projection systems included EPSG 2154 EPSG 32600 EPSG 32620 EPSG 32632 In order to use a specific projection system Make sure the SRID is present in the spatial ref sys table See PostGIS documentation to add new ones e Download the JavaScript proj4js definition from http spatialreference org and save it to Geotrek static proj4js lt SRID gt js Using the command line curl http spatialreference org ref epsg SRID proj4js gt Geotrek static proj4js SRID js note Geotrek won t run if the spatial reference has not a metric unit It s possible to store your data using a specific SRID and use a classic Google Maps projection 3857 in the Web interface useful for WMTS or OpenStreetMap layers See advanced configuration Geotrek Documentation Release 2 4 4 3 4 Users management Geotrek relies on Django authentication and permissions system Users belong to groups and permissions can be assigned at user or group level The whole configuration of user groups and permissions is available in the AdminSite if you did not enable External authent see below By default four groups are created Readers Path managers Trek managers Editor Once the application is installed it is possible to modify the
26. travaux Chantiers groupe d interventions Valorisation de l offre touristique tin raires randonn es POI points d int r t patrimoniaux Objets touristiques activit s de pleine nature mus es produits labellis s Ev nements animations expositions sorties Signalements probl mes signal s par les internautes sur un itin raire depuis Geotrek rando 31 Geotrek Documentation Release 2 4 4 Chaque module est accessible depuis le bandeau vertical Tous les modules sont construits de la m me fa on une liste pagin e des objets du module la possibilit de filtrer la liste ou de faire une recherche libre e Ja possibilit d exporter les r sultats en CSV pour EXCEL ou CALC en SHAPEFILE pour QGIS ou ArcGIS et en GPX pour l importer dans un GPS une carte dans laquelle il est possible de naviguer d placer zoomer d afficher en plein cran de mesurer une longueur d exporter une image de la carte de r initialiser l tendue de zommer sur une commune ou un secteur et de choisir les couches afficher Modules Liste Carte Nombre de r sultats Navigation Zoomer sur une commune Gestion des couches Filtrer ou un secteur Ajouter un nouvel objet x 5 2 Dur e Difficult D part Le refuge des Bans 3 Facile Entre les Aygues Vallouise f I d lac du Lauzon 3 Facile Gioberney La Chapelle en 7 I Boucle du Pigeonnier d 525 Moyen
27. 20 3 2013 09 30 BUG fixes Fix typo in french translation of Properties fixes 815 Fix missing description from infrastructure signage detail page fixes 816 Fix Cities Districts Restricted Areas in project detail page fixes 817 Fix only deleted topology can have geom NULL fixes 818 Fix geometries not editable in QGis by switching path and topologies geometries to 2D fixes 688 Fix altimetric sampling precision setting not taken in account in SQL ref 776 13 70 0 20 2 2013 08 27 Fix convert urls behind reverse proxy with prefix Fix Trek public print conversion Fix display of trek length in public document one decimal only Fix altimetric graph delaying map display in detail pages notes Empty maps captures cache rm rf var media maps trek 13 71 0 20 1 2013 08 26 Add DB index for start and end columns Merge gunicorn logs with respective applications logs Lower logging level in production WARNING INFO BUG fixes Fix deployment error with application s TITLE Fix deployment errors with mandatory external authent values Fix trek export layout fit map image and altimetric profile in one page 13 72 0 20 2013 08 23 Edit difficulty id in Admin site mainly used to order difficulty levels fixes 771 Use explicit list of fields in forms instead of excluding model fields fixes 736 Issue 712 was closed too since most suspected cause was field listings Please
28. 3 19 We OG PARURE XU SUR SA E ES RR 63 13 55 0 22 4 2014 03 00 iuo kon e RO RE ESO eC Rum Re Ge RO RR 63 13 5640 22 3 20 14509 ST iis LR Eee REGE Web o e UR ve E 64 13 97 0222 2014 02 14 epo e oe RO RRL A d Re Ro bel Je Es RR A e ede 64 13 98 0 22 51 201420213 dom wc eA kom Le Re ASS URGE SUR 64 13 59 022 2014 02 12 x gem Boe OR Re CUR d c EE LE d e RAD 5 64 13 060 0 21 2 2014209 04D ore dose ee US Ru UU Er as ee Ee ae se doe ede de S us 66 13 61 0 221 4 2013 12 11 2 24 4 n4 46 22454 2440 we he Y Oo v Y Yo ER ESSER 66 18 62 021 ECOLES NE Re eI DENON RE LAN es 66 13 63 0 20 9 2013 10230 2 orbs xxxv das pee de ne slots RS 67 13 64 0 20 8 2013 10522Y e sa vou be SUR E ua RR ee Be s 67 1365 0207 2013 1016 RIS EE HL SOR SR TRS Ta RUE P 68 13 66 0 20 6 2013 10 14 m REOR LR ee LE elt hy 5 68 13 67 0205 2013 10 09 a a sa a ah ee ESA es AUS SR REN E NA 68 13 68 0 20 4 2013 10 00 die Bee AUR RO RD EU 68 13 69 0 203 013 09 30 wba X S E Rue EGA ee LEA SUR x RUE
29. AR 69 13 70 0 20 2 2013 08 27 i rur Reste mean Se Sec ok Gis 69 13 71 O20 2013208226 s ue net SR CRUS EUR RRS MR NEMO A Ies 69 13 72 0 20 2013 08 23 onc cs e x OE Yo EE due ape WE APR des 69 13 730 19 2013 078153 LIN Se Re Re 70 13 74 0 19 2013 07 12 424 548 045 X ERU ERE LUN 70 13 75 018120150606 FAR Pr d Xe Ge GS Route Nec DAMES 71 12015930521 7 t ab i NS Ae amp wc Wo S 71 14 Indices and tables 73 Geotrek Documentation Release 2 4 4 Contents Contents 1 Geotrek Documentation Release 2 4 4 2 Contents CHAPTER 1 INSTALLATION These instructions will install Geotrek on a dedicated server for production For a developer instance please follow the dedicated procedure 1 1 Requirements Ubuntu Server 12 04 Precise Pangolin http releases ubuntu com 12 04 or Ubuntu Server 14 04 Trusty Tahr http releases ubuntu com 14 04 A first estimation on system resources is Go RAM 10 Go disk space 1 2 Installation Once the OS is installed basic installation with OpenSSH server install the last version with the following commands curl https raw githubuserconte
30. Alpes From the Administration backoffice create datasources using a name an URL and a pictogram You can choose if this layer should be displayed in the different Geotrek modules or published to the public Website Geotrek rando notes For SITRA to work with multilang make sure that the different locales are in the query query apiKey locales fr en 4 9 1 Expected properties For GeoJSON files you can provide the following properties e title string description string website string phone string pictures list of objects with url and copyright attributes category object with id and label attributes 4 10 Disable darker map backgrounds Since IGN map backgrounds are very dense and colourful a dark opacity is applied In order to disable change this MapEntity setting MAPENTITY CONFIG MAP BACKGROUND FOGGED False 4 11 Override public document OpenOffice template Copy the file geotrek trekking templates trekking trek public odt to var media templates trekking trek public odt Edit the copy using OpenOffice Note The default template may change in the future versions You will be in charge of porting the modification to your copy 16 Chapter 4 ADVANCED CONFIGURATION Geotrek Documentation Release 2 4 4 4 12 Custom font in public document OpenOffice template In order to use custom fonts in trek PDF it is necessary to install the font files
31. Geotrek Documentation Release 2 4 4 Makina Corpus December 02 2015 Contents 1 INSTALLATION 3 lel R GUTEMENIS SEM RNA eet sk S Aa dog ee sued 3 12 H stallatlOH As EA E Met Y JEDE 3 LS Sottware update rex SWS eed ee ee CEE RAR eS 4 LA 3ServeriniprallOD Aa ses ae URL DE RS RE RS SA he eos 4 1 Tupsiatid Ticks o ocos lex Do is aient dune stages 5 2 LOADING DATA 7 24 Data eet SUR aide Mare Date 7 2 2 Prerequisites Tor VOUrdAtd dog RUR ee 5 7 2 3 Load MNT faster uu aono ben e eM S ce Ron Ne hae ei diee 8 3 CONFIGURATION 9 3 1 Configuration Update oom He En dre nan te GR ea 9 3 2 Spatial extents lm go eo no m d RE ba Re Eh Wok E e EUR Red E b S Rs 9 3 3 Custom spatial references i use does e mde E Regu e eed 8 9 34 Users management 2 04 cx pe moe vem oec pog e AU 10 3 5 Database Users oz or dou cerdo a Altos aos di diee apti utt qvin iie ue tg 10 3 0 EMA SEUNES 2 4 5 Les re de le Ge Re DNS MR 10 34 Advanced Contpuration 54 20062355 M AUREUS ded oed d 11 4 ADVANCED CONFIGURATION 13 4l Custom seting
32. 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 bin django loaddata geotrek authent fixtures minimal json bin django loaddata geotrek authent fixtures basic json e 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 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 paperclip attachment Can read attachments trekking Trek Can read Trek 62 Chapter 13 CHANGELOG Geotrek Documentation Release 2 4 4 trekking Trek Can export Trek trekking POI Can read POI trekking POI Can export POI feedback Report Can add report After upgrading compare visually the resulting migrated trails using QGis by opening both layers 1 v sentier and backup sentiers 13 53 0 22 6 2014 04 27 Remove hard coded mentions of EPSG 2154 in database initial migrations fixes 1020 Fix version download and unzip in installation script Thanks No l Martinon from Guadeloupe National Park for reporting b
33. LET CONFIG SRID 3857 And specify the tiles URLs this way LEAFLET CONFIG TILES Scan http s tile osm org z x y png c OpenStreetMap Contributors Ortho http s tiles mapbox com v3 openstreetmap map 4wvf9101 z x y jpq c MapB 4 6 External authent You can authenticate user against a remote database table or view To enable this feature fill authent_dbname and other fields in etc settings ini Expected columns in table view are username string unique first name string 14 Chapter 4 ADVANCED CONFIGURATION Geotrek Documentation Release 2 4 4 last name string password string simple md5 encoded or full hashed and salted password email string level integer 1 readonly 2 redactor 3 path manager 4 trekking manager 6 administrator structure string lang string language code notes User management will be disabled from Administration backoffice In order to disable remote login just remove authent dbname value in settings file and update instance see paragraph above Geotrek can support many types of users authentication LDAP oauth contact us for more details 4 7 Map layers colors and style layers colors can be customized from the settings See Leaflet reference for vectorial layer style To apply these style changes re run bin supervisorctl restart all MAP ST
34. Leaflet 0 7 3 Installation Fixed content types migration of land to zoning apps Thanks No l Martinon UbuntuGIS stable maintainers have upgraded sic GDAL to 1 10 0 Upgrading GDAL is painful and PostGIS packages may have to be reinstalled data shouldn t be lost though Remember it was recommended to run PostGIS on a different server notes On June 2th 2014 the Ubuntu GIS stable repository switched from 1ibgdall to libgdallh It broke the deployment script of many projects including Geotrek 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 Regarding Geotrek such upgrades of Ubuntu packages is not supposed to be covered by its installa tion script If you face any problems please refer to the community or commercial support such as Makina Corpus for example 60 Chapter 13 CHANGELOG Geotrek Documentation Release 2 4 4 13 51 0 23 1 2014 05 22 Bug fixes Fixed regression when editing topologies without modification Fixed widget for Trails to allow linear topologies only 13 52 0 23 2014 05 22 Breaking changes Read all release notes carefully Trails are now managed as topologies fixes 370 Existing trails geometries are likely to be LOST see below
35. NTERVENTION for intervention without signage infrastructure Fix restricted areas types display in admin fixes 943 Fix list ordering of trek relationships and web links fixes 929 Fix nginx log files being already empty after logrotate fixes 932 Fix project add button when no permission notes List of restricted areas is not shown on map by default anymore Restore previous behaviour with advanced setting LAND BBOX AREAS ENABLED as True Internal changes Upgrade to Django 1 6 fixes 938 Upgrade to Leaflet 0 7 Upgrade a great number to python and JavaScript libraries 13 59 0 22 2014 02 12 65 Geotrek Documentation Release 2 4 4 An internal user with login permission is used to authenticate the Conversion and Capture services Installation script is modular standalone geotrek only Developement server now listens on all interfaces by default Database migrations were resetted no postgres FATAL ERROR message will be emitted on fresh install anymore fixes 937 See Troubleshooting in documentation 13 60 0 21 2 2014 02 04 BUG fixes Warn on tiling landscape portrait spatial extent only if map with local projection Safety check on thumbnailing if images are missing from disk useful for troubleshooting when importing existing dumps Fix overlapping filter if no records present fixes 931 13 61 0 21 1 2013 12 11 Improvements e Smooth DEM drapping improving altimet
36. PI 13 21 0 31 0 2015 03 02 New features Add support of Ubuntu 14 04 to installer Public PDF for touristic contents events fixes 1206 Add treks close to other treks in REST API Add pictograms for trek accessibilities touristic content types and touristic event types Bug fixes Show edit button when having bypass structure permission Export missing fields in list exports fixes 1167 Fix formating of float and boolean values in list exports fixes 1366 1380 Fix french translation Allow anonymous access to altimetry API for public objects Hide not published and deleted items in public REST API 48 Chapter 13 CHANGELOG Geotrek Documentation Release 2 4 4 13 22 0 30 0 2015 02 19 Breaking changes Trek practice formerly usage is no single valued so if a trek has multiple usages only will be kept after upgrade Others will be lost e After upgrade run make 1oad data to load fixtures for accessibilities or create them by hand You should clean up the list of practices by hand Don t forget to set up permissions to administrate practices and accessibilities New features Split trek usage field into practice and accessibility Treks and POIs are now structure related Allow anonymous access to media related to published items Check model read permission to give access to media Add a settings to set up CORS cross origin resource sharing Allow to get POIs for
37. S and to grant user privileges by schema It is also easier to browse objects in pgAdmin and QGis Caution if you created additional database users you may have to change their search path and or their USAGE privilege 52 Chapter 13 CHANGELOG Geotrek Documentation Release 2 4 4 Experimental features We introduced models for touristic contents and events In order to load example values for categories and types run the following commands bin django loaddata geotrek tourism fixtures basic json cp geotrek tourism fixtures upload var media upload We introduced models for static pages allowing edition of public static Web pages from Geotrek adminsite In order to enable those features under construction add experimental Trueinetc settings ini Note that none of them are used in Geotrek rando yet notes Give related permissions to the managers group in order to allow edition f latpage change flatpage delete flatpage add touristiccontent 13 33 0 27 2 2010 10 14 Bug fixes Fix elevation info not being computed when intervention is created ref 1221 Fix list of values for infrastructure and signage types fixes 1223 Signages can now be lines if setting SIGNAGE LINE ENABLED is True fixes 1141 Fix HTML tags in PDF exports fixes 1235 Fix regression with Geotrek light 13 34 0 27 1 2010 10 13 Bug fixes Fix problems in forms prevent Javascript errors
38. YLES path color red weight 5 Or change just one parameter the opacity for example MAP STYLES city opacity 0 8 Regarding colors that depend from database content such as land layers physical types work management or restricted areas We use a specific setting that receives a list of colors COLORS POOL restrictedarea ff00ff red ddddd See the default values in geot rek settings base py for the complete list of available styles Restart the application for changes to take effect 4 8 External raster layers It is possible to add overlay tiles layer on maps For example it can be useful to Get the cadastral parcels on top of satellite images Home made layers with Tilemill or QGisMapserver for example Like the park center borders traffic maps IGN BDTopo or even the Geotrek paths that are marked as invisible in the database In custom py just add the following lines LEAFLET CONFIG OVERLAYS Coeur de parc http serveur coeur parc z x y png amp copy PNF 4 7 Map layers colors and style 15 Geotrek Documentation Release 2 4 4 4 9 External vectorial layers In order to display vectorial layers in Geotrek and Geotrek rando it is possible to define external datasources So far the following formats are supported GeoJSON TIF TourInFrance SITRA SIT Rhone
39. a files cd Geotrek vX Y Z tar zcvf home sentiers date Y m d H M media tar gz var media Configuration Folder Geotrek vX Y Z tar zcvf home sentiers date Y m d H M conf tar gz etc geotrek settings custom py 5 3 Application restore Create empty database sudo su pos psql c CR tgres psql d geotrekdb c CREATE FATE DATABASE dbname ENCODING UTF8 T EXT ENSION postgis EMPLAT E template0 Restore backup 21 Geotrek Documentation Release 2 4 4 pg_restor d geotrekdb 20140610 geotrekdb backup exit Extract media and configuration files cd Geotrek vX Y Z tar zxvf 20140610 media tar gz tar zxvf 20140610 conf tar gz Re run install sh 5 4 Cleanup When an attachment is deleted the attached file is not deleted from disk From time to time you can run these com mands to list and clean these files Jbin django deleteorphaned info bin django deleteorphaned 5 5 PostgreSQL optimization ncrease shared buffers and work mem according to your RAM Log long queries Use pg activity for monitoring 5 6 Access your database securely on your local machine QGis Instead of opening your database to the world by opening the port 5432 for example you can use SSH tunnels 22 Chapter 5 MAINTENANCE CHAPTER 6 SYNCHRONIZATION 6 1 Manua
40. at import raise exception to browser 13 5 2 4 0 2015 11 18 New features 43 Geotrek Documentation Release 2 4 4 Paths can be merged Add trek parents to API Allow to sync public web site from web interface Add begin and end dates to touristic events list Filter conmpleted touristic events by default Bug fixes Prevent concurrent imports and or synchronization Fix rendering of HTML markup in weasyprint templates Fix missing publication field in some cases 13 6 2 3 0 2015 11 09 New features e Sync rando now synchronizes touristic contents and events Sync rando now exports only future events based on current date Sync rando now synchronizes touristic content categories Bug fixes Added a custom validation to accept url only contribution in flatpages without content e Sync rando now handles crashes when it calls django views 13 7 2 2 0 2015 10 09 New features Added normalisation for altimetry s json export Clarify 2D 3D lengths fixes 1400 Bug fixes Change plural on accessibility label for admin filter 13 8 2 1 0 2015 09 29 Breaking changes Instead of storing the parent of a trek Geotrek now stores the children of a trek This allows to use the same trek in several parents and to order them WARNING Existing parent child relation are lost You will have to set them again after upgrade Fixes 1479 New features Add trek infos aka services for now Add ema
41. ay want to force their restart bin supervisorctl restart all If they don t stay alive check the log files in the var 1og folder It might come from a configuration problem 26 Chapter 7 TROUBLESHOOTING CHAPTER 8 FREQUENTLY ASKED QUESTIONS 8 1 How 3D informations are obtained paths geometries are draped on a Digital Elevation Model when created or updated All linear objects that defined using topologies treks take their 3D informations from their related paths instead of reading the DEM 8 2 How the ascent is computed on treks We compute the cumulative elevation gain We sample the DEM every 25m by defaut see ALTIMETRIC PROFILE PRECISION setting and we add some smoothing to avoid noise For more details The smoothing explanation The piece of code to compute positive and negative accumulations Draping lines with PostGIS or french version 8 3 How POIs are related to treks POIs are considered as an editorial information and are created carefully along treks When a POI is created it is attached to the closest path A trek is defined by a serie of paths and some POIs are associated to them notes There is currently no way to manually control the association between treks and POIs This was discussed among the first Geotrek users come and argue on the mailing list If TREKKING TOPOLOGY ENABLED is set to False there are no paths involv
42. c settings ini takes place in settings default py only This means that other settings management can be derived from base py Production settings settings prod py contains tweaks that are relevant in production only 10 6 install sh script 35 Geotrek Documentation Release 2 4 4 36 Chapter 10 DESIGN CHAPTER 11 DEVELOPMENT This documentation is dedicated to code contributors in order to run a development instance Developers are advice to run their Geotrek instance in an isolated environment however it is not an absolute prerequi site More details below 11 1 Isolated environment If you use virtual machines or containers Vagrant LXC this will install all the necessary components for devel opment install sh dev 11 2 Directly on your host The most minimal components required to run an instance are PostGIS 2 server GDAL GEOS libproj gettext libfreetype libxml2 libxslt Usual Python dev stuff See the list of minimal packages on Debian Ubuntu If you already have all these components installed your OS probably because you re already a python GIS developer then just jump to the next section 11 3 Run Start local instance make env dev update serve 37 Geotrek Documentation Release 2 4 4 Note Running dev and update is recommended after pull of new source code but is not mandatory make serve 15 enough most
43. d to add a column for file attachments ALTER TABLE fl t fichier ADD COLUMN marque boolean DEFAULT false New features Information desks now have a type Maison du parc Tourist office with the ability to set dedicated pic tograms fixes 1192 Ability to control which picture will be used in trek using clicks on stars in attachments list fixes 1117 Ability to edit attachments from detail pages directly fixes 177 the 5th oldest issue Add missing columns in intervention exports fixes 1167 Add ability for super admin to add change delete zoning objects in Adminsite ref 1246 Add ability to have paths records in database that will not appear in Geotrek lists and maps Just set column visible to false in 1 t troncon table Add ability to add external overlay tile layers fixes 1203 Bug fixes Fix position of attachment upload form on small screens Clearer action message in object history table Prevent image ratio warning from disappearing fixes 1225 Touristic contents Touristic events Internal changes Upgraded Chosen library for dropdown form fields Set valide column default value to false on paths table 1_t_t roncon fixes 1217 e All information desks are now available in GeoJSON will be useful to show them all at once on Geotrek rando All tables and functions are now stored in different schemas It allows to distinguish Geotrek objects from postgreSQL and PostGI
44. e fixes 900 Fix project constraints not being displayed in details fixes 893 Fix organism translation in project form fixes 892 Fix apparence of forms on small screen fixes 744 902 Fix modify button being hidden to editors fixes 901 Fix overlap between map controls and label fixes 883 Fix translation of district in list filters fixes 890 Fix integrity error on land intersection on path update fixes 897 Fix form layout problems fixes 712 879 13 63 0 20 9 2013 10 30 Fix altimetric profile if topology geometry is wrong fixes 875 Fix apparence of creation button in intervention list fixes 877 Fix topology geometries that were sampled like paths 3D geometry fixes 878 Fix topology lines geometries join in some situations ref 722 Fix topology not well displayed if start end on intersection fixes 874 13 64 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 4869 Fix point offset lost on path update fixes 867 Fix reconnect point topologies with offset to closest path fixes 868 13 63 0 20 9 2013 10 30 67 Geotrek Docu
45. e cde DOR CHR UR ARE EAN He ALTRI ed 11 DEVELOPMENT 11 1 Isolated environment 4 8 84 cs SO ee ROS Kor ROS die X 11 2 Directly Om your Ost s oou ee PRE She SEES Es 113 RUM EC TT 11 4 Developmentdata 0b hor RES GELS ROV S S xev e Ad S 11 9 CONVENTIONS x uie eoe bod ge eie ee ue ed de Red ete er he dede ems 11 6 Delimuonofdone low Ga nes a exe oe Y rox RSS ec e wor de ee Re DRI c r 21 21 21 21 22 22 22 23 23 23 23 24 24 24 25 25 25 25 25 25 26 27 27 27 27 28 28 28 31 31 31 32 32 33 33 33 34 34 34 35 35 11 8 Model modification TO Database reset ee we a ow Ee cb e d 11 10 Mapentity development o opce uix amp Gun ha ERR OR hem ee 12 AUTHORS 12 1 Makma Corpus 5 5 488 Bis ee eR ER Da eRe SOROR RO See SAME Rae 12 2 c beds TTL 13 CHANGELOG 13 1 19 02 A E pa oe Dean een ea die ec 13 2 24 3 20155112 a dan UR eben GRO Pee de a 13 3 222045 2 i Rok ee SY nee real eerie ers 13 4 2 44 2015 11 25 v pope RR UY Nom eU RU UE X
46. ed POIs are thus related to treks using a basic spatial intersection with a distance set in setting TREK POI INTERSECTION default to 500 meters 27 Geotrek Documentation Release 2 4 4 8 4 Can have overlapping districts Districts are a generic notion to qualify your territory They can be valleys mounts You can imagine using the districts table for all those different notions resulting in overlapping geometries Geotrek will associate them all to your objects 8 5 Why Makina Corpus sells Geotrek released under an Open Source license In the early years of the Free Software movement it was quite common to pay in order to receive a physical copy on floppy disks of some GNU programs and source code In the late nineties the IT industry was not confortable with the confusion introduced by the word Free in English free as freedom or free as costless and therefore started to spread the word Open Source instead Today those copies of Open Source software can be obtained on the Internet for free of course But yet the GNU Software Fundation still recommends to claim a financial contribution when distributing them in order to support the development and maintenance And note that nowadays many of the most important Open Source applications have their own fundation focused on collecting funds for development and maintenance The Geotrek fundation does not exist yet but the c
47. ents ref 732 Removed setting spatial extent wgs84 now computed automatically from spatial extent with a padding of 10 notes Have a look at conf settings ini sample to clean up unnecessary values from your set tings file Fix paths offset for portrait spatial extent fixes 732 Rely on Tilecache default max resolution formulae fixes 732 Due to bug in Leaflet Proj4Leaflet https github com kartena Proj4Leaflet issues 37 landscape spatial extents are not supported Please adjust spatial extent to be a portrait or square or application will raise Improperly ConfiguredError Reload map objects on zoom out too fixes 435 Fix computation of min elevation for point topologies fixes 808 notes In order to recompute all paths topologies altimetry information you can perform the follow ing query UPDATE e t evenement SET decallage decallage Reading infor mation from rasters is costly Be prepared to wait for a while 13 73 0 19 1 2013 07 15 Restore pk property in Trek GeoJSON layer 13 74 0 19 2013 07 12 ntervention length field readonly if geometry is line Fix apparence bug if no rights to add treks and pois fixes 713 Fix extremities snapping fixes 718 Show information desk in trek detail page fixes 719 70 Chapter 13 CHANGELOG Geotrek Documentation Release 2 4 4 Fix topology adjustments after path split fixes 720 On edition show global line orientation
48. etc settings ini adjustthe host and dbname sections of each instance 4 12 Custom font in public document OpenOffice template 17 Geotrek Documentation Release 2 4 4 4 15 2 Capture and conversion On the standalone server make sure the services will be available to others Add the following lines in its settings ini convertit host 0 0 0 0 screamshotter host 0 0 0 0 In custom py point the tiles URL to the shared services replace SERVER by the one you installed as standalone MAPENTITY CONFIG CONVERSION SERVER http SERVER 6543 MAPENTITY CONFIG CAPTURE SERVER http SERVER 8001 4 15 3 Tilecache Only if you use a WMS server you will have to share the Tilecache tile server In custom py point the tiles URL towards the shared LEAFLET CONFIG TILES Scan http SERVER tiles scan z x y png amp copy Attributions Ortho http SERVER tiles ortho z x y png amp copy Attributions notes This is a short tip it will only work if the spatial extent and projection srid is the same on all instances Otherwise configure Tilecache manually or simply use external tile services such as IGN Geoportail WMTS 4 15 4 Shutdown useless services Now that your instances point the shared server You can shutdown the useless services on each instance
49. fixes Remove HTTP calls to SoundCloud API at serialization Allow DEM to partially cover spatial extent 13 9 2 0 0 2015 07 20 45 Geotrek Documentation Release 2 4 4 13 10 0 35 1 2015 07 17 Bug fixes Fix installation on ubuntu 12 04 with recent updates 13 11 0 35 0 2015 07 10 New features Add an import framework Bug fixes Fix acrash in appy pod PDF generation Fix login with restricted access to some contents Fix buildout bootstrap arguments 13 12 0 34 0 2015 05 20 New features tinerancy parent children treks Allow to choose ordering of categories for Geotrek Rando Bootstrap grid editor for flatpages Approved touristic contents and events Option to split trek category by practice or accessibility Bug fixes Fix duration notation Flatten altimetry profiles Bug fixes Show accessibility in trek detail page fixes 1399 13 13 0 33 4 2015 04 07 Bug fixes Ensure trek duration is a positive number Fix cirkwi exports second try Fix public PDF templates 46 Chapter 13 CHANGELOG Geotrek Documentation Release 2 4 4 13 14 0 33 3 2015 04 01 Bug fixes Fix systematic crash in PDF conversions 13 15 0 33 2 2015 04 01 Bug fixes Remove italian from fixtures Fix crash when generating two PDF in parallel 13 16 0 33 1 2015 03 25 Bug fixes Fix flat pages crash N to source field rel 1354 13 17 0 33 0 2015 03 25 Brea
50. fixes 997 see advanced configuration in docs 58 Chapter 13 CHANGELOG Geotrek Documentation Release 2 4 4 Show POI name on hover instead of category in trek detail pages fixes 1004 Form tabs are now always visible while scrolling fixes 926 New URL to obtain the attached filelist of an object Remove float notation in altimetry altitude labels Control altimetry profiles font using ALTIMETRIC PROFILE FONT setting Add pictograms to routes and networks fixes 1102 Bug fixes Fixed Signage and Infrastructure year filter label fixes 4293 Fixed paths layers not always shown below other layers fixes 912 Clarify legend and title for attachments fixes 888 Fixed cannot clear trek fields in database fixes 1095 Fixed missing translation of Load local file fixes 1085 POI types are displayed as such in adminsite Fix duplicate authors in history list in detail pages Internal changes Added pictogram on difficulty useful for Geotrek mobile fixes 1109 Added experimental Geotrek light support ref 1019 13 47 0 23 5 2014 06 19 Bug fixes Fix crash when TourInFrance has malformed website or phone Fix translations not being installed 13 48 0 23 4 2014 06 18 Bug fixes Fix massive upgrade bug where new migrations were ignored Due to migration operation introduction in 0 22 installation script Special thanks to No l Martinon F lix Merzeau Gil Deluermoz and
51. hapter 11 DEVELOPMENT CHAPTER 12 AUTHORS 12 1 Makina Corpus Gilles Bassi re Sylvain Beorchia Mathieu Leplatre Ana s Peyrucq Satya Azemar Simon Th pot Chlo Morisset Fr d ric Bonifas C lian Garcia Ga l Utard Jean Etienne Castagnede 12 2 Credits Information desk by Alex Berkowitz from The Noun Project Calendar by Laurent Patain from The Noun Project Restaurant designed by Roberto Pinto from the Noun Project Kayak designed by johanna from the Noun Project Luggage designed by Luis Prado from the Noun Project Location designed by Jacob Lowe from the Noun Project Food designed by R my M dard from the Noun Project Climbing designed by Eric Milet from the Noun Project Box Office designed by Alessio Damiano from the Noun Project Steep Descent designed by Sergey Patutin from the Noun Project 41 Geotrek Documentation Release 2 4 4 42 Chapter 12 AUTHORS CHAPTER 13 CHANGELOG 13 1 2 4 4 2015 12 02 Bug fixes Show pending import sync tasks Add a command to clean orphaned attached media 13 2 2 4 3 2015 11 27 Bug fixes Fix filtering by source in sync rando for flatpages and tiles too 13 3 2 4 2 2015 11 26 Bug fixes Fix permissions of sync rando output directory Fix filtering by source in sync rando 13 4 2 4 1 2015 11 25 Bug fixes Condition field of infrastructures is no more required Fix zipfile detection at import Fix error handling
52. il sent to reporting user after submit 44 Chapter 13 CHANGELOG Geotrek Documentation Release 2 4 4 Handle multiple reservation systems fixes 41488 Add an option to sync rando to filter by source fixes 1480 Add add condition field to infrastructure table fixes 41494 New Geotrek logo Bug fixes Reload supervisor configuration after Geotrek upgrade Fix projection of waypoints in GPX exports Prevent unnecessary save for geom fields if they are not updated This prevents triggering geom recalculation in postgres Fix crash in case of missing or invalid picture Fix feedback API Unzip eggs to fix templates not found error Various parsers import system fixes and improvements Documentation Document server migration 13 9 2 0 0 2015 07 20 Breaking changes Rework API URL schemas New features Static API to disconnect Geotrek rando from Geotrek Admin fixes 1428 Build zip files for mobile application Trek Touristic content association distance depending on trek practice Option to hide published treks nearby topologies Add previous next treks and category slugs to geojson API Add external id in trekking tourism detail pages and exports Zip touristic contents as POI for mobile app v1 Add external id field on Path Order intersections in Geotrek light mode Add reservation id field for touristic contents Integration of WeasyPrint to generate PDF from HTML CSS instead of ODT Bug
53. in trek detail map anymore Pictograms fields were added to trek difficulty route network You can use the images provided in the trekking fixtures upload folder notes 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 UPDATE o t itineraire SET public fr TRUE UPDATE o t itineraire SET date publication now New features Public TREK export hide block label if value is empty fixes 873 13 44 0 24 2 2014 06 27 57 Geotrek Documentation Release 2 4 4 Add POIs on trek GPX fixes 774 Close list filter when click outside fixes 916 Rename recurrent field to subcontracting on intervention fixes 911 Rename comments field to description on intervention fixes 927 Show object type in ODT export fixes 1000 Show paths extremities on map fixes 355 Ability to reuse topology when adding objects from detail pages fixes 574 fixes 998 Command to generate all elevation charts fixes 799 SITRA support in Tourism datasources fixes 1064 Added status field on feedback reports fixes 1075 Show restricted areas by type in layer switcher fixes 961 Publication status 15 now controlled by language fixes 1003 Previous behaviour can restored by setting TREK PUBLISHED BY LANG to False Added publication date on trek
54. instead of individual paths fixes 679 Fix invalid topology if trek goes twice on same path fixes 671 Overlapping 15 now more precise fixes 710 Reworked trek print layout Fix topology building if paths are taken twice fixes 722 Fix tiling offset with horizontal bboxes Fix display of POI layer by default on list fixes 696 Fix translation of not validated paths fixes 730 Fix error if topology is required and empty fixes 745 Fix duplication of N N relations on path split fixes 738 Fix project map in detail page fixes 734 Fix project listed deleted interventions fixes 739 Fix project listed infrastructures through interventions fixes 740 Fix saving intervention form on infrastructure Repair serializing of properties after upgrade of django geojson fixes 755 Added public transport and advised parking to trek JSON detail API fixes 758 Repair land layers colors after upgrade of django geojson Upgraded to django geojson 2 0 Upgraded to Django 1 5 notes Specify allowed host server IP in etc settings ini for example 45 56 78 90 Empty object caches sudo etc init d memcached restart rm rf var cache x 13 75 0 18 2013 06 06 Add pretty trek duration in JSON Add information desk field in Trek fixes 624 13 76 0 17 2013 05 17 Show trek duration as human readable in minutes hours and days fixes 471 683 Fix hover on paths that interfered with clic for topology creation fixes
55. ive projection 2 2 2 Core Only LineString geometries Simple geometries Not overlapping If possible Connex graph Name column Geotrek Documentation Release 2 4 4 Data source Formats Shapefile or pure SQL dump SQL CREATE TABLE INSERT 2 2 3 Land 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 2 2 4 Extras Languages list Structures list and default one 2 3 Load MNT raster In QGIS you can visualize your DEM or merge several tiles together in Raster Misc Merge Generate GeoTIFF and upload both files t if t fw on the server And use the Geotrek command to load it into PostGIS bin django loaddem PATH dem tif note This command makes use of GDAL and raster2pgsql internally It therefore supports all GDAL raster input formats You can list these formats with the command raster2pgsql G 8 Chapter 2 LOADING DATA CHAPTER 3 CONFIGURATION 3 1 Configuration update After editing etc settings ini refresh the running instance with make env_standalone deploy There a few cases where running install sh would be necessary If you change the rootur1 or other parameters that affect nginx site configuration 3 2 Spatial extents In order to check your configuration of
56. king changes e A new permission Can publish is required to publish treks pois touristic contents and touristic events Grant it to your users and groups if need be e DB table 1_b_source is renamed as 1l b source troncon New features Publication workflow fixes 1018 Allow to add links to Youtube or Soundcloud media as attachment Make pictograms optional in some places when not required by Geotrek Rando Add source for treks touristic contents and touristic events fixes 1354 Add external id field for treks pois touristic contents and touristic events Group cirkwi matchings in admin site fixes 1402 Bug fixes Fix projection of OSM link in feedback email Fix language in cirkwi exports 13 14 0 33 3 2015 04 01 47 Geotrek Documentation Release 2 4 4 13 18 0 32 2 2015 03 06 Bug fixes Home now redirects to treks list in light version without topologies Fix Cirkwi export in light version Fix SRID in database migrations Add signage type filter again fixes 1352 Add missing date filters to touristic events list 13 19 0 32 1 2015 03 04 Bug fixes Fix creation of a loop topology with two paths fixes 1026 13 20 0 32 0 2015 03 04 New features Export to cirkwi espace loisirs IGN After upgrade run bin django loaddata cirkwi to load data cirkwi tags and categories Wysiwyg editor for static web pages Bug fixes Hide not published static pages in public REST A
57. l sh Restore database on the new server sudo service geotrek stop sudo u postgres psql c drop database geotrekdb sudo u postgres psql c create database geotrekdb owner geotrek sudo u postgres pg restor d geotrekdb geotrekdb backup make update deploy 1 5 Tips and Tricks Use symlinks for uploaded files and cached tiles to avoid duplicating them on disk mv var tiles tiles s tiles pwd var tiles mv var media media ln s media pwd var media Speed up upgrades by caching downloads mkdir downloads mkdir buildout Create home sentiers buildout default cfg with buildout download cache home sentiers downloads 1 5 Tips and Tricks 5 Geotrek Documentation Release 2 4 4 6 Chapter 1 INSTALLATION CHAPTER 2 LOADING DATA 2 1 Initial Data Load basic data make load data note This command will load default users groups default values for lists in French and English So you need to enable EN and FR at least etc settings ini If you do not load data you ll have to at least create a super user bin django createsuperuser username admin mail admin corp com or change its password bin django changepassword username admin password 2 2 Prerequisites for your data 2 2 1 Layers WMS scan ortho Projection Bounding box in nat
58. l synchronization To create data for Geotrek Rando web public portal and Geotrek Mobile mobile phone app just run this command bin django sync_rando where to generate data The parameter is the destination directory for synchronized data If Geotrek Admin is not accessible on localhost 80 you have to use the ur1 option To make output less or more verbose you can use the verbose option 6 2 Automatic synchronization You can set up automatic synchronization by creating a etc crond d geotrek sync that contains 0 3 x x root path to geotrek bin django sync rando where to generate data This will automatically synchronize data a 3 am every day 6 3 Synchronization options Options v VERBOSITY verbosity VERBOSITY Verbosity level O minimal output l normal output 2 verbose output u URL url URL Base url of Geotrek Admin eg http geotrek myorganization com s SOURCE source SOURCE Filter by source s p skip pdf Skip generation of PDF files t Skip tiles Skip generation of map tiles files for mobile app d skip dem Skip generation of Digital Elevation Model files for mobile app with touristicevents include touristic events by trek in global zip c CONTENT CATEGORIES with touristiccontent categories CONTENT CATEGORIES include touristic contents by trek in global zip filtered by category
59. mentation Release 2 4 4 Download it try it Open a ticket when you encounter a bug Open a ticket when you have a suggestion or feature idea Share your feedback spread the word inside your organization Write and talk about Geotrek at conferences workgroups forums Translate the documentation Translate the menus buttons and labels we use Transifex Maintain the installation script for different Linux distributions requires some basic Linux skills Fix bugs or improve layout and apparence requires Webmaster skills Fix bugs or improve core modules requires python Django skills Join us on the mailing list Send an email to geotrek fr subscribe googlegroups com and you will receive an invitation automatically 8 6 How can I help and contribute 29 Geotrek Documentation Release 2 4 4 30 Chapter 8 FREQUENTLY ASKED QUESTIONS CHAPTER 9 USER MANUAL 9 1 Screencasts In French Pr sentation de l interface Cr ation d un itin raire Cr ation d un POI Ajout de photos Administration 9 2 Modules Geotrek est compos de diff rents modules Gestion des sentiers Tron ons lin aire entre 2 intersections Sentiers groupe de tron ons Statuts physique foncier organismes ayant la comp tence sentiers gestionnaires des travaux et de la signal tique Am nagements ouvrages et quipements Signal tique nterventions
60. mentation Release 2 4 4 13 65 0 20 7 2013 10 16 Fix topology geometry 3D being draped twice fixes 863 Altimetric profile Altimetric profile Public trek export Public trek export Public trek export Public trek export Show max distance and round values fixes 853 Add settings for colors fixes 854 POIs list in two columns fixes 855 POIs details without column break fixes 857 Show pictures attributions fixes 859 Use 10pt fonts in every text blocks fixes 848 notes Empty profiles cache rm rf var media profiles 13 66 0 20 6 2013 10 14 Remove 3D from JS WKT serializer Safety check if path is less than 1m Remove mentions of 2154 projection in schema migrations Fix performance issues in altimetric JSON fixes 845 Fix filter forms missing from Trek and POI lists fixes 847 Fix empty Nginx log files fixes 846 13 67 0 20 5 2013 10 09 Fix migration of draping utility function 13 68 0 20 4 2013 10 09 Fix sort stake by id level fixes 835 Rename stake to maintenance stake fixes 834 Add validity to path filter fixes 836 Do not redrape topology geometries use path 3D geometry fixes 832 Fix document export of Trail objects fixes 839 Fix trail helpers for land layers fixes 838 ref 842 Fix install on fresh folder missing folder 1ib src fixes 844 68 Chapter 13 CHANGELOG Geotrek Documentation Release 2 4 4 13 69 0
61. metry computation or DEM wrapping 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 10 4 Main roles of PostgreSQL triggers Automatic computation of fields Date insert update Geometry computation of linear referencing topologies DEM elevation wrapping 3D length slope etc Topological path network Split paths at intersection Snap paths extremities 10 5 Why buildout Multiple sub projects under development mr developer GDAL installation include dirs Unique and simple file for user settings input etc settings ini Simple provisionning configuration templating Python dependencies versions consistency Multiple sets of dependencies dev tests prod 34 Chapter 10 DESIGN Geotrek Documentation Release 2 4 4 10 6 install sh script No need for multiple OS support Can be run just from the project archive Install system dependencies Single tenant on dedicated server dem potent used for both installation and upgrade 10 7 etc settings ini Centralize configuration values for both Django and system configuration files Easy syntax Default and overridable values conf settings default ini Regarding Django settings organisation application settings have a default working value in settings base py The mechanizm that uses et
62. nt com makinacorpus Geotrek master install sh gt install sh chmod x install sh install sh You will be prompt for editing the base configuration file settings ini using the default editor notes If you leave localhost for the database host dbhost value a Postgresql with PostGis will be installed locally In order to use a remote server recommended set the appropriate values for the connection The connection must be operational it will be tested during install To make sure the application runs well after a reboot try now sudo reboot And access the application http yourserver You will be prompted for login jump to loading data section to create the admin user and fill the database with your data Geotrek Documentation Release 2 4 4 1 3 Software update versions are published on the Github forge Download and extract the new version in separate folder recommended wget https github com makinacorpus Geotrek archive vX Y Z zip unzip vX Y Z zip cd Geotrek X Y Z Before upgrading READ CAREFULLY the release notes either from the docs changelog rst files or online Shutdown previous running version Shutdown previous version sudo stop geotrek Copy your old configuration and uploaded files to your new folder Configuration files Cp aR previous version etc Uploaded files cp aR previous version var If you have advanced settings cp
63. ntation French user manual first step about general interface New features Set PostgreSQL search path at user level fixes 1311 Show 3D and 2D length in detail pages fixes 1101 Show length and elevation infos in trail and all statuts detail pages fixes 1222 Show trail length in list and exports fixes 1282 Replace stake by length in path list fixes 956 fixes 1281 Add subcontracting in intervention filter fixes 1144 Add missing fields in project filter fixes 219 fixes 910 Show status in interventions table among detail pages fixes 1 193 Add missing field in projects exports ref 1167 Add length column to land module lists Number of workers and request timeout can be now configured in settings ini Various improvements on trek public template by Camille Monchicourt 50 Chapter 13 CHANGELOG Geotrek Documentation Release 2 4 4 13 28 0 28 4 2014 11 21 Bug fixes Fix mouse position indicator on tools extents page when map tiles have Google projection Fix missing filters in trails list fixes 1297 Fix infrastructure main type filter fixes 1096 Fix flatpage creation without external url in adminsite Fix path detail page where deleted objects were shown fixes 1302 Fix position of POIs on trek detail maps fixes 1209 Fix TinyMCE not preserving colors fixes 1170 Raise validation error instead of crashing when submitted topology is empty fixes 1272 Documentation
64. of the time Run unit tests make env_test update tests Run unit tests in verbose mode and without migrations make env_dev update tests For Capture server run an instance of screamshotter in a separate terminal bin django runserver settings screamshotter settings 8001 For PDF conversion server run an instance of Convertit in a separate terminal on http localhost 6543 bin convertit lib src convertit development ini 11 4 Development data make load data bin django loaddata development pn In order to get elevation data a DEM is necessary If you use the default extent as defined in conf settings ini sample you can load the following dataset wget http depot makina corpus org public geotrek mnt 0 ecrins zip unzip mnt O0 ecrins zip bin django loaddem mnt 0 ecrins w001001 adf 11 5 Conventions Use flake8 KISS amp DRY as much as possible Elegant and generic is good simple is better e Commits messages are explicit and mention issue number ref 12 or fixes 23 Features are developed in a branch and merged from Github pull requests 11 6 Definition of done docs changelog rst is up to date A unit test covers the bugfix or the new feature A frontend test path jstests nav js covers the navigation bug fix or feature A JS Mocha test path jstests tests js covers the JavaScript bug fix or feature 38 Chapter 11
65. ommunity is growing Makina Corpus is currently maintaining this Open Source application which implies the following responsabilities Maintain a public website with a fully working demo Write documentation Provide community support on the mailing list Promote the application at conferences social networks and communities Triage and investigate issues tickets on Github Fix bugs and regressions if any Contribute propose and argue code merge on external libraries Keep software dependencies up to date without regressions Make sure the application remains easy to install on latest Linux distributions Add some engineering to allow customization and pluggability when new specific features are planned Each of these tasks are often considered implicit but they consume energy and time which represents a substantial cost for a company like ours To conclude we don t really sell Geotrek since you can get it on Github and install it easily but we ask for a financial contribution regarding the above responsabilities It is not only legal but also recommended by the funders of the Free and Open Source Software movement 8 6 How can help and contribute There are many ways to contribute to a Free Software And modifying the source code is probably the least common action For example Help the users and answers questions on the mailing list 28 Chapter 8 FREQUENTLY ASKED QUESTIONS Geotrek Docu
66. on the server Microsoft fonts like Arial and Verdana can be installed via the package manager sudo apt get install ttf mscorefonts installer For specific fonts copy the or ot f files into the folder usr local share fonts custom as root and run the following command fc cache For more information check out Ubuntu documentation 4 13 Custom colors in public document OpenOffice template Trek export geometries are translucid red by default In order to control the apparence of objects in public trek exports use the following setting MAP STYLES print path weight 3 See Leaflet reference documentation for detail about layers apparence 4 14 Custom logos You might also need to deploy logo images in the following places var media upload favicon png var media upload logo login png var media upload logo header png 4 15 Share services between several Geotrek instances As explained in the design section Geotrek 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 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 4 15 1 Database Sharing your postgreSQL server is highly recommended Create several databases for each of your instances Then in
67. or example with rsync command rsync path of generated data other server path of generated data 24 Chapter 6 SYNCHRONIZATION CHAPTER 7 TROUBLESHOOTING 7 1 Installation outputs a lot of database FATAL ERROR Data schema migrations code do not inspect the database before executing commands When appropriate errors are skipped in python code but PostgreSQL error output still remains http south aeracode org ticket 1247 7 2 Installation script hangs on syncdb migrate This command is in charge of changing the database schema 1 Make sure you close every pgADMIN session on the database while upgrading 1 http south aeracode org ticket 209 7 3 No paths in list where table contains records Check that the projection of your data is correct Check that the extent of the map covers your data using the extents tool at hitp server tools extents 7 4 No background tiles Check the values of your WMS settings server name should end with layers names should exist on server Check the values in the generated TileCache configuration in etc tilecache cfg 7 5 Error at loading DEM Check that your extent spatial extent is completely contained in your DEM 25 Geotrek Documentation Release 2 4 4 7 6 502 Bad Gateway If the application does not show up 502 Bad Gateway make sure the Geotrek services run with the following commands bin supervisorctl status You m
68. oth issues 13 54 0 22 5 2014 03 19 Fix compilation of translations ref 970 Fix distinction between languages and translated languages fixes 968 Fix history tabs not being shown after upgrade to Django 1 6 fixes 975 Fix regression on land layer label colors fixes 980 Fix attached files not shown after file upload delete fixes 933 Fix links being removed from trek descriptions fixes 981 Fix missing thumbnail in trek and POI detail pages Fix black background on map captures fixes 979 Increased scale text size on map captures fixes 850 Show map attributions on map captures fixes 852 Fix aspect ratios of map in trek public documents fixes 849 Fix objects list not being filtered on map extent fixes 982 Fix coherence of map layer when text search in objects list fixes 702 Fix number of results not refresh on text search fixes 865 Added north arrow in map image exports fixes 851 Removed darker effect on backgrounds for map image exports and added internal advanced setting MAPENTITY CONFIG MAP BACKGROUND FOGGED True 13 55 0 22 4 2014 03 06 Fix install sh not compiling locale messages fixes 965 e Moved trek completeness fields to setting TREK COMPLETENESS FIELDS Duration and difficulty were added arrival was removed fixes 967 13 53 0 22 6 2014 04 27 63 Geotrek Documentation Release 2 4 4 Fix regression about source locale messages fixe
69. ref 1003 Ability to see a trek in the different published languages ref 1003 A trek can now have several information desks fixes 1001 Information desks are now shown in trek detail map fixes 1001 Information desks now have optional photo and position as well as some additional fields fixes 1001 Disabled marker cluster in trek detail map Remove background and halo effect on POI icons Added 3 new settings to control trek detail map icons size TREK ICON SIZE POI TREK ICON SIZE PARKING ICON SIZE INFORMATION DE SK Minor features Intervention disorders is not mandatory anymore fixes 661 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 and a small icon is shown fixes 735 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 Close calendar after date choice in intervention form fixes 928 Renamed Attachment submit button fixes 925 Added a new setting PATH SNAPPING DISTANCE to control paths snapping distance in database default 1m Allow to disable trails notion
70. ric information and profiles fixes 840 ref 776 BUG fixes Signage forms are now restricted by structure fixes 917 Fix geometries computation when path split occurs on return topology fixes 899 Add title on links in list views fixes 913 Prevent horizontal scroll on forms caused by textareas fixes 914 Fix empty 3d geometry of point topologies with offset fixes 918 notes In order to recompute all paths topologies altimetry information you can perform the following queries UPDATE 1 t troncon SET geom geom UPDATE e t evenement SET decallage decallage Reading information from rasters is costly Be prepared to wait for a while 13 62 0 21 2013 11 28 Improvements Increase height of multiple select fixes 891 Add project field in intervention filter fixes 896 Many minor improvements for infrastructures in adminsite fixes 886 Add category in intervention filter fixes 887 BUG fixes 66 Chapter 13 CHANGELOG Geotrek Documentation Release 2 4 4 Fix KML coordinates not being in 3D GPX now has trek description fixes 775 Order overlapping topologies by order of progression fixes 777 Improved TinyMCE configuration for resize and cleanup fixes 351 711 Changed trek duration interval for notion of days fixes 880 Show city departure in trek public export fixes 881 Document customization of TinyMCE config fixes 882 Fix 404 error on path delet
71. s 970 Fix regression link Back to application lost from adminsite fixes 971 Serve uploaded files as attachments fixes 972 Remove help texts being shown from filter forms fixes 966 Fix form pills for translated languages fixes 968 13 56 0 22 3 2014 02 17 Fix install sh help not being shown Fix screenshots being empty if deployed behind reverse proxy with rool url fixes 687 Fix GPX file layer circle marker size fixes 930 Remove JS libraries from login page Fix install log being removed during installation Fix execution characters being shown during DB backup prompt Fix PhantomJS and CasperJS installation and deployment Added more automatic frontend tests Default allowed hosts is now 13 57 0 22 2 2014 02 14 Fix secured media URLs when using a non empty rooturl setting Fix proxy errors by disabling keep alive fixes 906 13 58 0 22 1 2014 02 13 Prevent install script to delete existing media files from disk in some situations 13 59 0 22 2014 02 12 Before upgrade Backup your database If you upgrade in the same application folder first delete the geotrek sub folder Use install sh to upgrade make deploy won t be enough After upgrade make sure the following query returns only 23 results SELECT COUNT FROM south migrationhistory BREAKING changes For upgrades Geotrek 0 21 is required 64 Chapter 13 CHANGELOG Geotrek Documentation Release 2 4 4
72. s False in settings Fix list of POIs in path detail pages fixes 1213 Fix highlight from map for project list page fixes 1180 Internal changes Extracted the trek publication to a generic and reusable notion Complete refactor of Trek JSON now taking advantage of Django REST framework instead of custom code Added read write REST API on all entities Refactored URLs declaration for altimetry and publishable entities Change editable status of topology paths in Django forms since it was posing problems with Django rest framework Add elevation profile SVG URL in trek detail JSON fixes 1205 Simplified upgrade commands for et c and var and mention advanced configuration file 13 36 0 26 3 2014 09 15 Bug fixes Fix pretty trek duration when duration is between 24 and 48H fixes 1188 Invalidate projet maps captures when interventions change and treks maps when POIs change fixes 1181 13 37 0 26 2 2014 08 22 Bug fixes Fix search among attached files in Adminsite fixes 1172 54 Chapter 13 CHANGELOG Geotrek Documentation Release 2 4 4 13 38 0 26 1 2014 08 21 Bug fixes Upgrade django mapentity for bug fix in ODT export and list of values in detail pages 13 39 0 26 0 2014 08 21 New features Interventions in project detail page is now shown as a simple table ref 214 generic system for interaction between objects attributes and details map was developped It work
73. s with project interactions topologies paths etc ref 214 Show enumeration of interventions in project PDF exports fixes 960 Number of POIs in now limited to 14 items in trek export ref 1120 Number of information desks in now limited to 2 items in trek export ref 1120 See settings TREK EXPORT INFORMATION DESK LIST LIMIT and TREK EXPORT POI LIST LIMIT Justify texts of POIs in trek export now converted to plain text Trek export geometries are now translucid red by default see STYLES setting ref 1120 Paths apparence in trek exports are now controlled by MAP STYLES setting too Images attachments are now resized to 800x800 for publication instead of 500x500 Clarify intervention cost by function and mandays fixes 1169 Bug fixes Fix paths layer not being shown in detail pages fixes 1161 Fix position of point topologies when closest path is not perpendicular fixes 1156 Prevent parking to be cropped on map exports fixes 1006 Upgrades notes Since the map export have changed empty the cache rm rf var media maps x 13 40 0 25 2 2014 08 14 Bug fixes Fix translation of Job in intervention form fixes 1090 Fix form error when no geometry is provided fixes 1082 Show attachments in adminsite fixes 41162 Fix JSON formatting of object attachment lists in API 13 38 0 26 1 2014 08 21 55 Geotrek Documentation Release 2 4 4
74. ul for redirections Support edition of several fields on the same map via django leaflet new feature fixes 53 13 43 0 24 3 2014 06 27 BUG fixes Fix cursor not removed when terminating topology fixes 1134 Fix information desk geometry hard coded SRID 56 Chapter 13 CHANGELOG Geotrek Documentation Release 2 4 4 13 44 0 24 2 2014 06 27 BUG fixes Fix EPSG 32620 projection file Fix JS error when path layer is not on map Fix start and end markers not shown as snapped on path edition fixes 1116 Fix groups not shown in Adminsite with external authent fixes 1118 Use markers as mouse icons for topology creation use resize cursors as fallback only fixes 1100 Minor changes in trek print template ref 1120 13 45 0 24 1 2014 06 26 BUG fixes Fix SVG files for difficulty pictograms Fix group fixtures for R dacteurs fixes 1128 Fix tab None in list view fixes 1127 Fix external datasources icons in Admin fixes 1132 Fix information desk maps in Admin forms fixes 1130 Fix topology edition when two forced passages on same path fixes 1131 Minor changes Ordered log entries by date descending ref 1123 Renamed Data sources by External data sources fixes 1125 Renamed Foncier to Statuts fixes 1126 13 46 0 24 0 2014 06 23 Breaking changes POI icons shall now have a solid background since no background is added
75. w objects easily Add fullscreen button on maps fixes 904 13 51 0 23 1 2014 05 22 61 Geotrek Documentation Release 2 4 4 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 Internal changes Enabled database connection pooling in production An error is raised if SRID has not unit in meters fixes 921 Zoning and land modules are now splitted fixes 954 Complete refactor of geographical form fields Now uses django mapentity from its own repository instead of internal orphan branch Complete refactor of maps initialization without inline preprocessed JavaScript Rely on Django permissions to control access to detail list and exports fixes 675 Core and altimetry modules are now splitted fixes 4996 Renamed treks POIs GeoJSON properties notes Before upgrading backup your trail records and geometries using pgAdmin CREATE TABLE backup sentiers AS SELECT FROM 1 v sentier CREATE TABLE backup troncons sentiers AS SELECT 1 t troncon id AS troncon 1 t sentier id 1 t sentier nom FROM 1 t troncon 1 t sentier WHERE 1 t sentier id 1 t troncon sentier Before upgrade rename mailadmin to mailadmins and add a new line mailmanagers inetc settings ini See Email settings section in documentation

Download Pdf Manuals

Related Search

Related Contents

15721 TH powertech IQ it:TH A4 - EnerSys  PDFダウンロード  Sandwich Preparation Bench User Manual  IFU - DRG International  User manual Atlantic  absolute rotary encoder with canopen interface user manual  Hampton Bay 51332 Troubleshooting Guide  

Copyright © All rights reserved. Failed to retrieve file