Skip to content
This repository has been archived by the owner on Nov 27, 2021. It is now read-only.

Commit

Permalink
Merge pull request #154 from wwwouaiebe/v2.1.0-doc
Browse files Browse the repository at this point in the history
V2.1.0 doc
  • Loading branch information
wwwouaiebe committed Jan 22, 2021
2 parents e50c90a + 91c84ce commit 5793c3a
Show file tree
Hide file tree
Showing 19 changed files with 351 additions and 415 deletions.
266 changes: 68 additions & 198 deletions README.md

Large diffs are not rendered by default.

266 changes: 68 additions & 198 deletions TravelNotesGuides/README.md

Large diffs are not rendered by default.

8 changes: 3 additions & 5 deletions TravelNotesGuides/en/InstallationGuideEN.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,8 @@ Travel & Notes will automatically create the map and all necessary controls.
See the [JS code documentation](https://github.com/wwwouaiebe/leaflet.TravelNotes/blob/gh-pages/TechDoc/index.html )
for more information.

Note, however, that only the TravelNotes object is accessible from additional JS code (via window.L.TravelNotes).
Note, however, that only the TravelNotes object is accessible from additional JS code
(via windoww.TaN - window.L.TravelNotes is deprecated but continues to work currently).

If you want to use other objects, you need to download the sources and import them into your code
as EcmaScript modules.
Expand Down Expand Up @@ -196,8 +197,6 @@ for smoothing the elevation. Default value: 0.25
( -1 = always ).
- __note.theDevil.addButton__ : when this value is true, a button "theDevil" is added
to the notes dialog box


- __note.theDevil.noteZoom__ : le zoom for "theDevil" button
- __note.osmSearchNoteDialog__ : when this value is true, the notes edit box is displayed
when creating a note from 'Search OpenstreetMap'
Expand Down Expand Up @@ -227,6 +226,7 @@ in the roadbook
- __note.svgAnleMaxDirection.sharpRight__ : the maximum angle of the direction to follow for the indication
"Turn sharp right" in the tooltip of the SVG icons
- __note.svgZoom__ : the zoom value used to make the SVG icons
- __note.svgRcnRefDistance__ : the maximal acceptable distance between the note and the rcn_ref tag
- __note.svgAngleDistance__ : the minimum distance to use between the center of the SVG icon and
the point used to calculate the rotation of the icon
- __note.svgHamletDistance__ : the maximum distance between the center of the SVG icon and a point
Expand All @@ -238,8 +238,6 @@ with the tag place = city in OSM for this tag to be used in the address of the i
- __note.svgTownDistance__ : the maximum distance between the center of the SVG icon and a point
with the tag place = town in OSM for this tag to be used in the address of the icon
- __note.svgTimeOut__ : the duration of the timeout sent with the request to create the SVG icon


- __note.maxManeuversNotes__: the maximum number of notes that can be created with the command
"Create a note for each route maneuver".
- __noteDialog.toggleIconDimension__: when this value is false, the dimension controls
Expand Down
1 change: 0 additions & 1 deletion TravelNotesGuides/en/UserGuideEN.md
Original file line number Diff line number Diff line change
Expand Up @@ -638,7 +638,6 @@ Only the following html tags and attributes can be used:
- the tag <figure> (figure)
- the tag <figcaption> (legend for the figure tag)
- the tag <img> with the attributes src, alt width and height (image)
- the tag <br> (new line)
- the tag <a> with the attributes href end target
- the tag <del> (deleted text)
- the tag <ins> (added text)
Expand Down
98 changes: 98 additions & 0 deletions TravelNotesGuides/en/WhatsNew.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
## What's new

### What's new in release 1.6.0

- The management of access keys has been completely revised. This is now done via a dialog box and it is possible to
read / save these access keys from / to a file protected by password.
- Error display has been improved
- A toolbar allowing to manage the background maps was added
- A light viewer has been created. This allows viewing a travel on an old device that does not understand all the new JavaScript

Many technical modifications have also been made:
- All code has been migrated to ES6 and uses ES6 modules instead of nodeJS modules
- eslint is used to check the quality of the code
- All dialogs are based on the use of Promise
- Updates to the user interface and the map are made via events, which greatly reduces dependencies in the code.

### What's new in release 1.7.0

- When OpenRouteService or GraphHopper are used as route providers, it is also possible to display the route profile.
- When a route between two points is made with leaflet.TravelNotesPolyline this route is no longer represented as a straight line,
but in the form of a segment of a great circle. See [leaflet.TravelNotesPolyline](https://github.com/wwwouaiebe/leaflet.TravelNotesPolyline/blob/master/README.md) documentation.
- It is also possible to draw circles with leaflet.TravelNotesPolyline. See [leaflet.TravelNotesPolyline](https://github.com/wwwouaiebe/leaflet.TravelNotesPolyline/blob/master/README.md) documentation.

### What's new in release 1.8.0

- Adding a waypoint to a route has been improved. Now just move the mouse over the route to see a temporary waypoint appear. Then by dragging and dropping it, the waypoint is added to the route.

### What's new in release 1.9.0

- it's now possible to print maps of a route.

### What's new in release 1.10.0

- A new service provider, based on Mapzen Valhalla, has been added: Stadia Maps
- A button to reload the access keys has been added to the access key management dialog
- An error message is displayed when a problem occurs while reading the access keys file
- Some bugs are fixed

### What's new in release 1.11.0

- The predefined route notes "Icon SVG from OSM" have been improved for entries and exits from roundabouts
- It is possible to create a note for all the maneuvers of a route in one operation
- The display of errors when reading the "APIKeys" file has been improved
- Some bugs are fixed ( Issues #113, #115, #116, #117 and #118)

### What's new in release 1.12.0

- The user interface has been changed. Consult the [User guide - en ](https://github.com/wwwouaiebe/leaflet.TravelNotes/blob/gh-pages/TravelNotesGuides/en/UserGuideEN.md).
- All commands are standardized. Each object (map, route, note, waypoint, maneuver) is created, modified or deleted via commands in context menus that are available on the map or in the user interface.
- Performance is improved. Memory usage has been greatly reduced and load times reduced. This is particularly noticeable for long travels.
- [All code is documented](https://wwwouaiebe.github.io/leaflet.TravelNotes/TechDoc/)

### What's new in release 1.13.0

- It is possible to search for points of interest in OpenStreetMap.
- Notes can be created from search results in OpenStreetMap.
- New predefined notes have been added. There are now over 70 predefined notes.
- The background of the notes can be transparent.
- All predefined note icons are now in svg.

### What's new in release 2.0.0

To avoid [xss attacks](https://en.wikipedia.org/wiki/Cross-site_scripting), especially when exchanging files, all the security
of the app has been reviewed, which leads to a certain number of limitations and modifications:
- [Content Security Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP) is enabled by default via a <meta> tag in the index.html file.
Thanks to this, it is no longer possible to run javascript from a site other than the one where Travel & Notes is installed,
to run scripts inline in the html or to download images or files from another site.
If you have the possibility, however, it is preferable to activate Content Securty Policy via a header installed by the server rather than via a<meta> tag.
- the html tags that can be used when creating notes are restricted, as are the attributes attached to these html tags.
Consult the [User guide - en ](https://github.com/wwwouaiebe/leaflet.TravelNotes/blob/gh-pages/TravelNotesGuides/en/UserGuideEN.md#AddHtmltext).
- when opening a travel file made with an earlier version, all unauthorized tags and attributes are deleted.
- in order to avoid an xss attack via a link sent by email, it is no longer possible to automatically open a travel file
via the app url when this travel file comes from another site, even if Content Security Policy is completely disabled.
- it is no longer possible to define styles in inline. If you want to create a custom style, you have to create it in a css
file and import it with a tag <link>
- it is obviously no longer possible to use a <script> nor any event handler attached to an html tag (onmouseover, onclick ...).
- the links present in the href and src attributes must be correct and complete. In an src attribute, the protocol can only
be https: (and http: if the app is installed on an http: site). In the href attributes, the protocol must be http:,
https:, mailto:, sms: or tel:. In addition, sms: and tel: links must start with a + and can only include the
characters #, * space and numbers 0-9.
- it is no longer possible to enter the API keys of service providers via url parameters.

In addition, the following improvements have been made:
- the SVG icons from OSM contain the number of the node-point when the icon is on this node-point and the route is
calculated for a bicycle (NB the points-nodes are a particularity of the bicycle routes in Belgium, Netherlands
and partially in Germany).
- it is necessary to name the travel before being able to save it in a file.
- a temporary solution was created to work around the errors of city names returned by Nominatim.
- a preview of the note being edited has been added to the note edit box.
- it is possible to hide or activate certain parts of this same edit box.

### What's new in release 2.1.0

Version 2.1.0. is primarily a version containing changes for developers:
- all plugin repositories have been merged into TravelNotes and there is therefore only one repository. Thanks to that,
the sizes of some plugins have been reduced considerably.
- @mapbox\polyline is no longer used for data compression and has been replaced by an internal development
which also greatly reduces the size of the data files.
4 changes: 3 additions & 1 deletion TravelNotesGuides/fr/GuideInstallationFR.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,8 @@ Travel & Notes créera automatiquement la carte et tous les contrôles nécessai
Voyez la [documentation du code JS](https://github.com/wwwouaiebe/leaflet.TravelNotes/blob/gh-pages/TechDoc/index.html )
pour plus d'informations.

Notez cependant que seul l'objet TravelNotes est accessible depuis du code JS additionnel (via window.L.TravelNotes).
Notez cependant que seul l'objet TravelNotes est accessible depuis du code JS additionnel
(via windoww.TaN - window.L.TravelNotes est déprécié mais continue à fonctionner pour l'instant).

Si vous désirez utiliser d'autres objets, vous devez télécharger les sources et les importer dans votre code comme
des modules EcmaScript.
Expand Down Expand Up @@ -227,6 +228,7 @@ dans le roadbook
- __note.svgAnleMaxDirection.sharpRight__ : l'angle maximum de la direction à suivre por l'indication
"Tourner fortement à droite" dans le tooltip des icones SVG
- __note.svgZoom__ : la valeur du zoom utilisé pour réaliser les icônes SVG
- __note.svgRcnRefDistance__ : la plus grande distance acceptable entre la note et le noeud rcn_ref
- __note.svgAngleDistance__ : la distance minimale à utiliser entre le centre de l'icône SVG et le point
utilisé pour calculer la rotation de l'icône
- __note.svgHamletDistance__ : la distance maximum entre le centre de l'icône SVG et un point avec le
Expand Down
1 change: 0 additions & 1 deletion TravelNotesGuides/fr/GuideUtilisateurFR.md
Original file line number Diff line number Diff line change
Expand Up @@ -665,7 +665,6 @@ Seules les balises html et attributs suivantes peuvent être utilisé·e·s:
- la balise <figure> (figure)
- la balise <figcaption> (légende pour la balise figure)
- la balise <img> avec les attributs src, alt width et height (image)
- la balise <br> (passage à la ligne)
- la balise <a> avec les attributs href et target
- la balise <del> (texte supprimé)
- la balise <ins> (texte ajouté)
Expand Down
100 changes: 100 additions & 0 deletions TravelNotesGuides/fr/QuoiDeNeuf.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@
## Quoi de neuf

### Quoi de neuf dans la version 1.6.0

- La gestion des clefs d'accès a été entièrement revue. Celle-ci se fait maintenant via une boite de dialogue et il est
possible de lire / sauver ces clefs d'accès depuis / vers un fichier protégé par mot de passe.
- L'affichage des erreurs a été amélioré
- Une barre d'outils permettant des gérer les fonds de cartes a été ajoutée.
- Un viewer léger a été créé. Celui-ci permet la visualisation d'un voyage sur un appareil ancien qui ne comprend pas
toutes les nouveautés de JavaScript

De nombreuses modifications techniques ont également été faites:
- Tout le code a été migré vers ES6 et utilise les modules ES6 au lieu de modules nodeJS
- eslint est utilisé pour vérifier la qualité du code
- toutes les boites de dialogue sont basées sur l'utilisation de Promise
- les mises à jour de l'interface utilisateur et de la carte se font via des events, ce qui réduit fortement
les dépendances dans le code.

### Quoi de neuf dans la version 1.7.0

- Lorsque OpenRouteService ou GraphHopper sont utilisés comme fournisseurs d'itinéraire, il est également possible d'afficher le profil de la route.
- Lorsque un trajet entre deux points est fait avec leaflet.TravelNotesPolyline ce trajet n'est plus représente sous forme de ligne droite,
mais bien sous forme d'un segment de grand cercle. Voir la documentation de [leaflet.TravelNotesPolyline](https://github.com/wwwouaiebe/leaflet.TravelNotesPolyline/blob/master/README.md)
- Il est également possible de tracer des cercles avec leaflet.TravelNotesPolyline. Voir la documentation de [leaflet.TravelNotesPolyline](https://github.com/wwwouaiebe/leaflet.TravelNotesPolyline/blob/master/README.md)

### Quoi de neuf dans la version 1.8.0

- Ajouter un point de passage à un trajet a été amélioré. Il suffit maintenant d'amener la souris sur le trajet pour voir apparaître un point de passage temporaire.
En faisant ensuite un glisser / déposer de celui-ci, le point de passage est ajouté au trajet.

### Quoi de neuf dans la version 1.9.0

- Il est maintenant possible d'imprimer les cartes d'un trajet.

### Quoi de neuf dans la version 1.10.0

- Un nouveau fournisseur de service, basé sur Mapzen Valhalla, a été ajouté: Stadia Maps
- Un bouton permettant de recharger les clefs d'accès a été ajouté dans la boite de dialogue de gestion des clefs d'accès
- Un message d'erreur est affiché quand un problème survient lors de la lecture du fichier des clefs d'accès
- Quelques bugs sont corrigés

### Quoi de neuf dans la version 1.11.0

- Les notes de trajet prédéfinie "Icône SVG depuis OSM" ont été améliorées pour les entrées et sorties des rond-points
- Il est possible de créer une note pour toutes les manoeuvres d'un trajet en une opération
- L'affichage des erreurs lors de la lecture du fichier "APIKeys" a été amélioré
- Quelques bugs sont corrigés ( Issues #113, #115, #116, #117 et #118)

### Quoi de neuf dans la version 1.12.0

- L'interface utilisateur a été modifiée. Consultez le [guide pour les utilisateurs - fr ](https://github.com/wwwouaiebe/leaflet.TravelNotes/blob/gh-pages/TravelNotesGuides/fr/GuideUtilisateurFR.md).
- Toutes les commandes sont uniformisées. Chaque objet (carte, route, note, point de passage, manoeuvre) est créé, modifié ou supprimé via des commandes
dans des menus contextuels qui sont disponibles sur la carte ou dans l'interface utilisateur.
- Les performances sont améliorées. L'utilisation de la mémoire a fortement diminué et les temps de chargement réduits. Cela est particulièrement sensible pour de longs voyages.
- [Tout le code est documenté](https://wwwouaiebe.github.io/leaflet.TravelNotes/TechDoc/)

### Quoi de neuf dans la version 1.13.0

- Il est possible de rechercher des points d'intérêt dans OpenStreetMap.
- Des notes peuvent être créées à partir des résultats de recherche dans OpenStreetMap.
- De nouvelles notes prédéfinies ont été ajoutées. Il y a maintenant plus de 70 notes prédéfinies.
- L'arrière-plan des notes peut être transparent.
- Toutes les icônes des notes prédéfinies sont désormais en svg.

### Quoi de neuf dans la version 2.0.0

Pour éviter des [attaques xss](https://fr.wikipedia.org/wiki/Cross-site_scripting), notamment lors de l'échange de fichiers, toute la sécurité de l'apps a été revue,
ce qui entraine un certain nombre de limitations et de modifications:
- [Content Security Policy](https://developer.mozilla.org/fr/docs/Web/HTTP/CSP) est activé par défaut via une balise <meta> dans le fichier index.html.
Grâce à cela, il n'est plus possible d'exécuter du javascript depuis un autre site que celui où est installé Travel & Notes, d'exécuter des scripts en inline
dans le html ni de télécharger des images ou des fichiers depuis un autre site.
Si vous en avez la possibilité, il est cependant préférable d'activer Content Securty Policy via un header installé par le serveur plutôt que via une balise <meta>.
- les balises html pouvant être utilisées lors de la création des notes sont restreintes, de même que les attributs attachés à ces balises html.
Consultez le [guide pour les utilisateurs - fr ](https://github.com/wwwouaiebe/leaflet.TravelNotes/blob/gh-pages/TravelNotesGuides/fr/GuideUtilisateurFR.md#AddHtmltext).
- lors de l'ouverture d'un fichier de voyage réalisé avec une version antérieure, toutes les balises et les attributs non autorisés sont effacé·e·s.
- afin d'éviter une attaque xss via un lien envoyé par mail, il n'est plus possible d'ouvrir automatiquement un fichier de voyage via l'url de l'apps quand ce fichier
de voyage provient d'un autre site, même si Content Security Policy est complètement désactivé.
- il n'est plus possible de définir des styles en inline. Si vous désirez créer un style personnalisé, il faut le créer dans un fichier css et importer celui-ci
avec une balise <link>
- il n'est évidemment plus possible d'utiliser une balise <script> ni aucun gestionnaire d'événements attaché à une balise html (onmouseover, onclick...).
- les liens présents dans les attributs href et src doivent être corrects et complets. Dans un attribut src, le protocole ne peut être que https: (et http: si l'apps
est installée sur un site http:). Dans les attributs href, le protocole doit être http:, https:, mailto:, sms: ou tel:. En outre, les liens sms: et tel: doivent commencer par
un + et ne peuvent comprendre que les caractères #, * espace et des chiffres de 0 à 9.
- il n'est plus possible d'entrer les clefs API des fournisseurs de service via des paramètres de l'url.

En outre, les améliorations suivantes on été apportées:
- les icônes SVG depuis OSM contiennent le numéro du point-noeud lorsque l'icône se trouve sur ce point-noeud et que l'itinéraire est calculé pour un vélo (N.B. les
points-noeuds sont une particularité des itinéraires vélo en Belgique, aux Pays-Bas et partiellement en Allemagne).
- il est nécessaire de nommer le voyage avant de pouvoir sauver celui-ci dans un fichier
- une solution temporaire a été créée pour contourner les erreurs de noms de commune retournés par Nominatim.
- une prévisualisation de la note en cours d'édition a été ajoutée à la boite d'édition des notes.
- il est possible de cacher ou activer certaines parties de cette même boite d'édition.

### Quoi de neuf dans la version 2.1.0

La version 2.1.0. est avant tout une version contenant des changements pour les dévelopeurs:
- tous les repositories de plugins on été fusionnés dans TravelNotes et il n'y a donc plus qu'un seul repository. Grâce à celà,
les tailles de certains plugins ont été considérablement réduites.
- @mapbox\polyline n'est plus utilisé pour la compression des données et a été remplacé par un dévelopement
interne, ce qui permet également de réduire fortement la taille des fichiers de donnée..
2 changes: 1 addition & 1 deletion buildNumber.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{ "buildNumber" : "00425"}
{ "buildNumber" : "00427"}
2 changes: 1 addition & 1 deletion dist/TravelNotes.min.js

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion dist/TravelNotesProviders/GraphHopperRouteProvider.min.js

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading

0 comments on commit 5793c3a

Please sign in to comment.