Merge branch 'master' of https://github.com/mthh/magrit

riatelab · Oct 10, 2017 · 5476263 · 5476263
2 parents 872a020 + d6a184b
commit 5476263
Show file tree

Hide file tree

Showing 67 changed files with 3,812 additions and 2,087 deletions.
diff --git a/CHANGES.rst b/CHANGES.rst
@@ -1,12 +1,19 @@
 Changes
 =======
 
-0.5.4 (2017-xx-xx)
+
+0.5.4 (2017-10-01)
 ------------------
 
-- Change again the default font used in text/tspan SVG elements (in favor of 'verdana'). Should fix (for real this time?) the bug occuring while trying to open the resulting SVG file with some software on systems where the font in use is not available (notably Adobe Illustrator v16.0 CS6 on MacOSX).
+- Change the default font used in text/tspan SVG elements (in favor of verdana). Should fix (for real this time?) the bug occuring while trying to open the resulting SVG file with some software on systems where the font in use is not available (notably Adobe Illustrator v16.0 CS6 on MacOSX).
+
+- Disable the ability to use sphere and graticule with lambert conic conformal projection (the generated path, which is currently not clipped when using Proj4 projections, could be very heavy due to the conical nature of the projection).
+
+- Allow to cancel the ongoing addition of a layout item by pressing Esc (and so inform the user about that in the notification).
+
+- Improve the legend for proportionnal symbols (only for "single color" ones) by also using the stroke color of the result layer in the legend.
 
-- Deactivate the "sphere" and the "graticule" layers when using a "conic conformal" projection (the generated path is pretty huge as it seems to tend towards the infinite).
+- Add "Bertin 1953" projection to the list of available projections.
 
 
 0.5.3 (2017-09-22)

diff --git a/documentation/doc_book/mdbook32 b/documentation/doc_book/mdbook32
diff --git a/documentation/doc_book/src/FAQ_fr.md b/documentation/doc_book/src/FAQ_fr.md
@@ -1,10 +1,11 @@
 # FAQ
 
-### Pourquoi Magrit émet un message d'avertissement lorsque la géométrie de certaines entités d'une couche est nulle ?
 
+### Pourquoi Magrit émet un message d'avertissement lorsque la géométrie de certaines entités d'une couche est nulle ?
 
-### Pourquoi un nombre trop important de couleurs peut nuire à la lisibilité de la carte ?
 
+### Pourquoi un nombre trop important de couleurs dans une palette peut nuire à la lisibilité de la carte ?
+L'oeil humain ne distingue correctement qu'un nombre de couleurs limité. L'utilisation d'un nombre de couleurs élevé lors de la conception d'une palette pour une carte choroplèthe empêche de percevoir avec précision les limites entre les classes et rend ainsi difficile de trouver la classe d'appartenance d'une entité.
 
 ### Pourquoi certains fond de cartes posent un problème lors de certains traitement ? Qu'est-ce que la "topologie" d'un fond de carte ?
 
@@ -13,3 +14,10 @@
 
 La taille maximale des fichiers pouvant être importés dans Magrit est limitée à 20Mo. Plusieurs raisons ont motivé ce choix et visent essentiellement à éviter des ralentissements indésirables dans le navigateur de l'utilisateur.
  D'une part le temps d'envoi d'un fichier volumineux peut être non-néligeable en fonction de la qualité de la connexion (un fichier de 20Mo prend en moyenne xx secondes avec une connexion xyz). D'autre part Magrit utilise la technologie SVG pour effectuer le rendu des cartes dans le navigateur. Cette technologie est performante mais se prête difficilement à l'affichage des couches contenant un nombre très élevé d'entitées.
+Ce type de limite permet également de s'interroger sur l'intéret d'une carte thématique contenant un nombre d'entités très élevé ou contenant des géométrie très détaillées. En effet, en fonction du type de données ou de l'échelle de travail, il peut être utile de faire appel au préalable à certaines techniques de préparation des données (aggrégation dans le cas d'un semi de points très important par exemple) ou de préparation du fond de carte (généralisation des géométries utilisées par exemple).
+
+### Pourquoi le rendu de certains exports SVG n'est pas le même dans Inkscape/Adobe Illustrator que lors de l'affichage de la carte dans Magrit ?
+// TODO: Parler des fonts/ Dire d'ouvrir le fichier svg dans un navigateur pour vérifier le résultat/ Evoquer exports svg spéciaux AI ?
+
+
+### Pourquoi n'est-il pas possible d'afficher un fond type "OpenStreetMap" lors de la réalisation d'une carte avec Magrit ?
diff --git a/documentation/doc_book/src/licenses_fr.md b/documentation/doc_book/src/licenses_fr.md
@@ -40,5 +40,6 @@ Différentes librairies et applications sont utilisées :
 | [uvloop](https://github.com/MagicStack/uvloop)        |         | MIT/Apache-2.0 |
 | [xlrd](https://github.com/python-excel/xlrd)          |         | BSD-like       |
 
-Cette application contient des schémas de couleurs deveoppés par Cynthia Brewer.
-Cette application contient des composants *(xlrd)* developpés par [David Giffin]([email protected]).
+Cette application contient des [schémas de couleurs developpés par Cynthia Brewer](http://colorbrewer2.org).  
+Cette application contient des composants *(xlrd)* developpés par [David Giffin]([email protected]).  
+Cette application contient la projection *Bertin 1953*, contribuée à [d3-geo-projection](https://github.com/d3/d3-geo-projection) par [Philippe Rivière](https://visionscarto.net/).  
diff --git a/magrit_app/static/book/FAQ_fr.html b/magrit_app/static/book/FAQ_fr.html
@@ -2,15 +2,16 @@
 <html lang="en">
     <head>
         <meta charset="UTF-8">
-        <title>Les docs de Magrit</title>
+        <title>Questions fréquemment posées - Les docs de Magrit</title>
         <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
         <meta name="description" content="Documentation utilisateur de Magrit">
         <meta name="viewport" content="width=device-width, initial-scale=1">
 
         <base href="">
 
         <link rel="stylesheet" href="book.css">
-        <link href='https://fonts.googleapis.com/css?family=Open+Sans:300italic,400italic,600italic,700italic,800italic,400,300,600,700,800' rel='stylesheet' type='text/css'>
+        <link href="https://fonts.googleapis.com/css?family=Open+Sans:300italic,400italic,600italic,700italic,800italic,400,300,600,700,800" rel="stylesheet" type="text/css">
+        <link href="https://fonts.googleapis.com/css?family=Source+Code+Pro:500" rel="stylesheet" type="text/css">
 
         <link rel="shortcut icon" href="favicon.png">
 
@@ -19,9 +20,20 @@
 
         <link rel="stylesheet" href="highlight.css">
         <link rel="stylesheet" href="tomorrow-night.css">
+        <link rel="stylesheet" href="ayu-highlight.css">
 
-        <!-- MathJax -->
-        <script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
+        <!-- Custom theme -->
+
+
+
+
+        <!-- Fetch Clipboard.js from CDN but have a local fallback -->
+        <script src="https://cdn.jsdelivr.net/clipboard.js/1.6.1/clipboard.min.js"></script>
+        <script>
+            if (typeof Clipboard == 'undefined') {
+                document.write(unescape("%3Cscript src='clipboard.min.js'%3E%3C/script%3E"));
+            }
+        </script>
 
         <!-- Fetch JQuery from CDN but have a local fallback -->
         <script src="https://code.jquery.com/jquery-2.1.4.min.js"></script>
@@ -30,18 +42,25 @@
                 document.write(unescape("%3Cscript src='jquery.js'%3E%3C/script%3E"));
             }
         </script>
+
+        <!-- Fetch store.js from local - TODO add CDN when 2.x.x is available on cdnjs -->
+        <script src="store.js"></script>
+
+        <!-- Custom JS script -->
+
+
     </head>
     <body class="light">
         <!-- Set the theme before any content is loaded, prevents flash -->
         <script type="text/javascript">
-            var theme = localStorage.getItem('theme');
-            if (theme == null) { theme = 'light'; }
+            var theme = store.get('mdbook-theme');
+            if (theme === null || theme === undefined) { theme = 'light'; }
             $('body').removeClass().addClass(theme);
         </script>
 
         <!-- Hide / unhide sidebar before it is displayed -->
         <script type="text/javascript">
-            var sidebar = localStorage.getItem('sidebar');
+            var sidebar = store.get('mdbook-sidebar');
             if (sidebar === "hidden") { $("html").addClass("sidebar-hidden") }
             else if (sidebar === "visible") { $("html").addClass("sidebar-visible") }
         </script>
@@ -52,7 +71,7 @@
 
         <div id="page-wrapper" class="page-wrapper">
 
-            <div class="page">
+            <div class="page" tabindex="-1">
                 <div id="menu-bar" class="menu-bar">
                     <div class="left-buttons">
                         <i id="sidebar-toggle" class="fa fa-bars"></i>
@@ -62,28 +81,26 @@
                     <h1 class="menu-title">Les docs de Magrit</h1>
 
                     <div class="right-buttons">
-                        <i id="print-button" class="fa fa-print" title="Print this book"></i>
+                        <a href="print.html">
+                            <i id="print-button" class="fa fa-print" title="Print this book"></i>
+                        </a>
                     </div>
                 </div>
 
                 <div id="content" class="content">
-                    <h1>FAQ</h1>
-<h3>Pourquoi Magrit émet un message d'avertissement lorsque la géométrie de certaines entités d'une couche est nulle ?</h3>
-<h3>Pourquoi un nombre trop important de couleurs peut nuire à la lisibilité de la carte ?</h3>
-<h3>Pourquoi certains fond de cartes posent un problème lors de certains traitement ? Qu'est-ce que la &quot;topologie&quot; d'un fond de carte ?</h3>
-<h3>Pourquoi une limite de taille est-elle fixée lors de l'import d'un fond de carte ?</h3>
+                    <a class="header" href="./FAQ_fr.html#faq" id="faq"><h1>FAQ</h1></a>
 
                 </div>
 
                 <!-- Mobile navigation buttons -->
 
-                    <a href="./dataset_source_fr.html" class="mobile-nav-chapters previous">
+                    <a rel="prev" href="./dataset_source_fr.html" class="mobile-nav-chapters previous">
                         <i class="fa fa-angle-left"></i>
                     </a>
 
 
 
-                    <a href="./privacy.html" class="mobile-nav-chapters next">
+                    <a rel="next" href="./privacy.html" class="mobile-nav-chapters next">
                         <i class="fa fa-angle-right"></i>
                     </a>
 
@@ -115,6 +132,12 @@ <h3>Pourquoi une limite de taille est-elle fixée lors de l'import d'un fond de
         <!-- Livereload script (if served using the cli tool) -->
 
 
+
+
+
+
+
+
         <script src="highlight.js"></script>
         <script src="book.js"></script>
     </body>

diff --git a/magrit_app/static/book/ayu-highlight.css b/magrit_app/static/book/ayu-highlight.css
@@ -0,0 +1,71 @@
+/*
+Based off of the Ayu theme
+Original by Dempfi (https://github.com/dempfi/ayu)
+*/
+
+.hljs {
+  display: block;
+  overflow-x: auto;
+  background: #191f26;
+  color: #e6e1cf;
+  padding: 0.5em;
+}
+
+.hljs-comment,
+.hljs-quote,
+.hljs-meta {
+  color: #5c6773;
+  font-style: italic;
+}
+
+.hljs-variable,
+.hljs-template-variable,
+.hljs-attribute,
+.hljs-attr,
+.hljs-regexp,
+.hljs-link,
+.hljs-selector-id,
+.hljs-selector-class {
+  color: #ff7733;
+}
+
+.hljs-number,
+.hljs-builtin-name,
+.hljs-literal,
+.hljs-type,
+.hljs-params {
+  color: #ffee99;
+}
+
+.hljs-string,
+.hljs-bullet {
+  color: #b8cc52;
+}
+
+.hljs-title,
+.hljs-built_in,
+.hljs-section {
+  color: #ffb454;
+}
+
+.hljs-keyword,
+.hljs-selector-tag,
+.hljs-symbol {
+  color: #ff7733;
+}
+
+.hljs-name {
+    color: #36a3d9;
+}
+
+.hljs-tag {
+    color: #00568d;
+}
+
+.hljs-emphasis {
+  font-style: italic;
+}
+
+.hljs-strong {
+  font-weight: bold;
+}