added script to add ghostscript location to system path in windows

j4321 · Jan 15, 2017 · 9df2331 · 9df2331
1 parent fdc752a
commit 9df2331
Show file tree

Hide file tree

Showing 18 changed files with 1,164 additions and 566 deletions.
diff --git a/BraceletGenerator/about.py b/BraceletGenerator/about.py
@@ -23,7 +23,7 @@
 
 from tkinter import Text, Toplevel
 from tkinter.ttk import Button, Label, Style
-from BraceletGenerator.constantes import open_image, BG_COLOR, STYLE, VERSION, IM_ICON48, set_icon, LANG, webOpen
+from BraceletGenerator.constantes import open_image, BG_COLOR, STYLE, VERSION, IM_ICON48, set_icon, webOpen
 
 
 class About(Toplevel):

diff --git a/BraceletGenerator/bracelet.py b/BraceletGenerator/bracelet.py
@@ -32,7 +32,6 @@
 from BraceletGenerator.couleurs import Couleurs
 from BraceletGenerator.bicolore import Bicolore
 from BraceletGenerator.about import About
-from subprocess import Popen
 
 
 BRACELET_LOG = os.path.join(LOCAL_PATH, "BraceletGenerator%i.log")
@@ -1507,6 +1506,7 @@ def export(self, event=None):
             im = Image.open(TMP_PS)
             im.load(scale=6)
             im.save(fichier)
+            im.close()
             os.remove(TMP_PS)
         elif fichier:
             showerror(_("Error"),

diff --git a/BraceletGenerator/constantes.py b/BraceletGenerator/constantes.py
@@ -48,12 +48,14 @@
     # the app has been installed
     IMAGES_LOCATION = '/usr/share/bracelet-generator/images'
     PATH_LOCALE = "/usr/share/locale"
-    PATH_DOC = '/usr/share/doc/bracelet-generator'
+    DOC = '/usr/share/doc/bracelet-generator/doc_install_linux.html'
+    DOC_FR = '/usr/share/doc/bracelet-generator/doc_fr_install_linux.html'
 else:
     PATH = os.path.split(__file__)[0]
     IMAGES_LOCATION = os.path.join(PATH, 'images')
     PATH_LOCALE = os.path.join(PATH, "locale")
-    PATH_DOC = os.path.join(PATH, "doc")
+    DOC = os.path.join(PATH, "doc", "doc.html")
+    DOC_FR = os.path.join(PATH, "doc", "doc_fr.html")
 
 LOCAL_PATH = os.path.expanduser("~")
 LOCAL_PATH = os.path.join(LOCAL_PATH, "BraceletGenerator")
@@ -209,9 +211,9 @@ def save_config():
 def help(event=None):
     """ ouvre l'aide en .html dans la langue de l'interface """
     if LANGUE[:2] == "fr":
-        webOpen(os.path.join(PATH_DOC, "doc_fr.html"))
+        webOpen(DOC_FR)
     else:
-        webOpen(os.path.join(PATH_DOC, "doc.html"))
+        webOpen(DOC)
 
 
 def help_web(event=None):

diff --git a/BraceletGenerator/doc/doc.html b/BraceletGenerator/doc/doc.html
@@ -1,6 +1,10 @@
 <!DOCTYPE html>
 <html>
     <header>
+
+
+
+
         <div id="langues">
             English / <a href="doc_fr.html">Français</a>
         </div>
@@ -13,8 +17,17 @@
 
     </head>
 
-
+
+
+
+
+
+
+
+
+
     <body>
+
         <h1> <img src="../images/icon128.png" alt="Bracelet Generator's logo" width=60px id="logo"/>
             Documentation
             <img src="../images/icon128.png" alt="Bracelet Generator's logo" width=60px id="logo"/>
@@ -51,7 +64,7 @@ <h2> Content </h2>
 
         <div id="licence">
             <p>
-                Copyright © 2014-2016 Juliette Monsel.
+                Copyright © 2014-2017 Juliette Monsel.
             </p>
             <p>
                 This program is free software: you can redistribute it and/or modify 
@@ -75,7 +88,8 @@ <h2> Content </h2>
 
         <div>
             <p>
-                Visit <a href="https://sourceforge.net/projects/braceletgenerator/" target="_blank"> Bracelet Generator project page at Sourceforge </a> for the latest updates.
+                Visit <a href="https://sourceforge.net/projects/braceletgenerator/" target="_blank"> Bracelet Generator project page at Sourceforge </a> 
+				for the latest updates.
             </p>
 
             <h2 id="pre"> Prerequisites </h2>
@@ -88,7 +102,7 @@ <h2 id="pre"> Prerequisites </h2>
 
                 <h3 id="download"> Download </h3>
 
-                    See the <a href="download.html">download</a> page.
+                    See the <a href="https://braceletgenerator.sourceforge.io/download.html">download</a> page.
 
             <h2 id="start"> Install </h2>
 
@@ -133,7 +147,7 @@ <h3 id="py"> With the Source Code </h3>
                             <li>Tkinter pour Python 3</li>
                             <li>Pillow (Python Imaging Library)</li>
                             <li>Ghostscript</li>
-                            <li>Zenity (optional, recommended for linux)</li>
+                            <li>Zenity (optional, recommended for Linux)</li>
                         </ul>
                     </p>
 
@@ -143,7 +157,7 @@ <h4> Linux </h4>
                             the packages vary between distributions. Here are the package names for:
                             <ul>
                                 <li><b>Ubuntu :</b> python3-tk, python3-pil, ghostscript, zenity</li>
-                                <li><b>Archlinux :</b> tk, python-pillow, ghostscript, zenity</li>
+                                <li><b>ArchLinux :</b> tk, python-pillow, ghostscript, zenity</li>
                             </ul>
                         </p>
                         You can also use pip to install Pillow (requires superuser rights):
@@ -159,7 +173,7 @@ <h4> Linux </h4>
                             $ python3 bracelet-generator.py
                         </p>
                         </p>
-                        You can also install Bracelet Generator (need superuser rights) with
+                        You can also install Bracelet Generator (requires superuser rights) with
                         <p class="code">
                             $ python3 setup.py install
                         </p>
@@ -169,12 +183,6 @@ <h4> Linux </h4>
                         <p class="code">
                             $ bracelet-generator
                         </p>
-                        <p>
-                            If your distribution uses .desktop files to create menu entries, you can edit 
-                            the bracelet-generator.desktop file of the main folder. Replace <tt>path_to_bracelet-generator-x.y.z-src</tt>
-                            by the actual path of the folder and move the file to <tt>/.local/share/applications </tt> (work at
-                            least for Debian-based distributions and Archlinux).
-                        </p>
 
                     <h4> Windows </h4>
                         <p>
@@ -202,19 +210,14 @@ <h4> Windows </h4>
                             </li>
                         </ul>
                         <p>
-                            Unzip the archive and double click on bracelet-generator.py. <br />
-                            If nothing appends, you can try to define python as the default software to use to open it.
-
-                        </p>
-                        <p>
-                            The first time, the program will ask you what is the path leading to the function convert of
-                            ImageMagick. It will enable you to export the patterns in .png and .jpg. Usually, this path is very
-                            similar to <tt>C:\Program Files\ImageMagick\convert.exe</tt>.
+                            Unzip the archive and run add_gs_to_path.py to add Ghostscript location to the system path 
+                            variable so that Bracelet Generator can find it. Then, launch bracelet-generator.py.
                         </p>
+
 
                     <h4> Other Operating Systems </h4>
                         <p>
-                            I have only tested Bracelet Generator under Ubuntu (16.04 LTS), Archlinux and Windows (7 and
+                            I have only tested Bracelet Generator under Ubuntu (16.04 LTS), ArchLinux and Windows (7 and
                             10) and Mac OS X (El Capitan), so I do not know which problems you might encounter on other operating systems.
                         </p>
                         <ul>
@@ -377,10 +380,13 @@ <h2 id="pb"> Troubleshooting </h2>
                     <p>
                         If you encounter errors when trying to export a pattern in .png or .jpg, or if no file is created, 
                         check whether Ghostscript is installed on your computer. If it is not the case, install it and export
-                        should work.
+                        should work. If you are using Windows, run <tt>C:\Program Files\Bracelet Generator\add_gs_to_path.exe</tt> 
+                        (or add_gs_to_path.py if you are using the source code) to add Ghostscript location to the system path variable.
                     </p>
                     <p>
-                        If you encounter other problems, bugs or if you have comments, write me an email at <a href="mailto:j 4321@sfr.fr">j 4321@sfr.fr</a>.
+                        If you encounter other problems, bugs or if you have comments, open a ticket on the 
+                        <a href="https://sourceforge.net/p/braceletgenerator/_list/tickets">project page</a> 
+                        or write me an email at <a href="mailto:j_4321@protonmail.com">j_4321@protonmail.com</a>.
                     </p>
         </div>
     </body>

diff --git a/BraceletGenerator/doc/doc_fr.html b/BraceletGenerator/doc/doc_fr.html
@@ -1,6 +1,10 @@
 <!DOCTYPE html>
 <html>
     <header>
+
+
+
+
         <div id="langues">
             <a href="doc.html">English</a> / Français
         </div>
@@ -13,14 +17,22 @@
 
     </head>
 
+
+
+
+
+
+
+
+
+
     <body>
 
         <h1> <img src="../images/icon128.png" alt="Bracelet Generator's logo" width=60px id="logo"/>
             Documentation
             <img src="../images/icon128.png" alt="Bracelet Generator's logo" width=60px id="logo"/>
         </h1>
 
-
          <!-- Table of contents -->
         <div id="tableofcontent">
             <h2> Contenu </h2>
@@ -52,7 +64,7 @@ <h2> Contenu </h2>
 
         <div id="licence">
             <p>
-                Copyright © 2014-2016 Juliette Monsel.
+                Copyright © 2014-2017 Juliette Monsel.
             </p>
             <p>
                 Ce programme est un logiciel libre ; vous pouvez le diffuser et/ou
@@ -61,16 +73,17 @@ <h2> Contenu </h2>
                 soit (à votre convenance) une version ultérieure.
             </p>
             <p>
-                Ce programme est diffusé dans l'espoir qu'il sera utile, mais SANS AUCUNE GARANTIE ;
-                sans même une garantie implicite de COMMERCIALISATION ou d'ADÉQUATION À UN USAGE PARTICULIER.
+                Ce programme est diffusé dans l'espoir qu'il sera utile, 
+				mais SANS AUCUNE GARANTIE ; sans même une garantie implicite 
+				de COMMERCIALISATION ou d'ADÉQUATION À UN USAGE PARTICULIER.
                 Voyez la Licence Publique Générale GNU pour plus de détails.
             </p>
             <p>
                 Vous devriez avoir reçu une copie de la Licence Publique Générale GNU avec ce programme.
                 Sinon, consultez <a href="http://www.gnu.org/licenses/">http://www.gnu.org/licenses/</a>.
             </p>
         </div>
-
+        
         <!-- Content -->
 
         <div>
@@ -84,10 +97,12 @@ <h2 id="pre"> Prérequis </h2>
                     Le but de ce logiciel n'est pas de vous apprendre à faire des bracelets brésiliens mais de rendre la création de patrons
                     plus facile. Donc, si vous ne savez pas faire les quatre types de nœuds, reportez vous à un tutoriel sur internet comme
                     <a href="http://friendship-bracelets.net/tutorials.php" target="_blank"> friendship-bracelets.net </a> (en anglais), par exemple.
-                </p>
+
+				</p>
 
                 <h3 id="download"> Téléchargement </h3>
-                     Voir la page dédiée aux <a href="download_fr.html">téléchargements</a>.
+
+                     Voir la page dédiée aux <a href="https://braceletgenerator.sourceforge.io/download_fr.html">téléchargements</a>.
 
             <h2 id="start"> Installation </h2>
 
@@ -112,11 +127,6 @@ <h3 id="deb"> Avec la version pour Ubuntu/Debian </h3>
                     <p class="code">
                         $ sudo dpkg -i bracelet-generator-x.y.z_all.deb
                     </p>
-                    <p>
-                        Toutes les dépendances seront installées automatiquement. <br>
-                        Si tout c’est bien passé, un raccourci se trouve maintenant dans la catégorie Graphisme du menu.
-                        Vous pouvez aussi lancer le programme depuis le terminal en tapant bracelet-generator.
-                    </p>
 
                 <h3 id="mac">Avec la version pour Mac OS X</h3>
                     <p>
@@ -138,7 +148,7 @@ <h3 id="py">Avec le code source</h3>
                             <li>Tkinter pour Python 3</li>
                             <li>Pillow (Python Imaging Library)</li>
                             <li>Ghostscript</li>
-                            <li>Zenity (optionnel, recommandé sous linux)</li>
+                            <li>Zenity (optionnel, recommandé sous Linux)</li>
                         </ul>
                     </p>
 
@@ -149,7 +159,7 @@ <h4> Linux </h4>
                             Voici les noms des paquets pour :
                             <ul>
                                 <li><b>Ubuntu :</b> python3-tk, python3-pil, ghostscript, zenity</li>
-                                <li><b>Archlinux :</b> tk, python-pillow, ghostscript, zenity</li>
+                                <li><b>ArchLinux :</b> tk, python-pillow, ghostscript, zenity</li>
                             </ul>
                         </p>
                         Vous pouvez aussi utiliser pip pour installer Pillow (requiert les droits de superutilisateur) :
@@ -174,12 +184,7 @@ <h4> Linux </h4>
                         <p class="code">
                             $ bracelet-generator
                         </p>
-                        <p>
-                            Si votre distribution linux utilise des fichier .desktop pour créer les entrées du menu, vous pouvez
-                            éditer le fichier bracelet-generator.desktop dans le dossier principal. Remplacez <i>path_to_bracelet-generator-x.y.z-src</i>
-                            par le chemin réel menant au dossier et placez le fichier dans <tt>/.local/share/applications</tt>
-                            (fonctionne au moins pour les distributions basées sur Debian et pour Archlinux).
-                        </p>
+
                     <h4> Windows </h4>
                         <p>
                             Tkinter sera installé automatiquement avec Python.
@@ -205,13 +210,14 @@ <h4> Windows </h4>
                         </ul>
 
                         <p>
-                            Décompressez l'archive et lancez bracelet-generator.py.
-                            Si rien ne se passe, vous pouvez essayer de définir python comme le logiciel par défaut pour le lancer.
+                            Décompressez l'archive et exécutez add_gs_to_path.py pour ajouter l'emplacement de Ghostscript 
+                            à la variable path du système afin que Bracelet Générateur puisse le trouver.
+                            Vous pouvez maintenant lancer bracelet-generator.py.
                         </p>
 
                     <h4> Autres systèmes d'exploitation </h4>
                         <p>
-                            Je n'ai testé Bracelet Générateur que sous que sous Ubuntu (16.04 LTS), Archlinux et Windows (7 et 10),
+                            Je n'ai testé Bracelet Générateur que sous que sous Ubuntu (16.04 LTS), ArchLinux et Windows (7 et 10),
                             donc je ne sais pas quels problèmes vous pourriez rencontrer sous d’autres OS.
                         </p>
                         <ul>
@@ -376,10 +382,15 @@ <h2 id="pb"> Résolution de problèmes </h2>
                     <p>
                         Si vous rencontrez des erreurs lors de lors de l'export des patrons en .png ou .jpg, 
                         ou si aucune image n'est créée, vérifiez que Ghostscript est bien installé sur votre ordinateur. 
-                        Si ce n'est pas le cas, installez le; l'export devrait alors fonctionner.
+                        Si ce n'est pas le cas, installez le, l'export devrait alors fonctionner. Si vous êtes sous Windows, 
+                        lancez <tt>C:\Program Files\Bracelet Generator\add_gs_to_path.exe</tt> (ou add_gs_to_path.py si vous
+                        utilisez le code source) pour ajouter l'emplacement de Ghostscript à la variable path du système.
+
                     </p>
                     <p>
-                        Si vous rencontrez d’autres problèmes ou si vous avez des commentaires, envoyez-moi un email à <a href="mailto:j 4321@sfr.fr">j 4321@sfr.fr</a>.
+                        Si vous rencontrez d’autres problèmes ou si vous avez des commentaires, créez un ticket sur 
+                        <a href="https://sourceforge.net/p/braceletgenerator/_list/tickets">la page du projet</a> 
+                        ou envoyez-moi un email à <a href="mailto:j_4321@protonmail.com">j_4321@protonmail.com</a>.
                     </p>
         </div>
     </body>