Documentation

Contenu

• Prérequis
• Installation
• Windows
• Ubuntu
• Archlinux
• Mac OS X
• Code source
• Langage
• Guide d'utilisation
• Fenêtre principale
• Éditeur de motifs bicolores
• Exemples
• Résolution de problèmes

Copyright © 2014-2017 Juliette Monsel.

Ce programme est un logiciel libre ; vous pouvez le diffuser et/ou le modifier suivant les termes de la Licence Publique Générale GNU telle que publiée par la Free Software Foundation ; soit la version 3 de cette licence, soit (à votre convenance) une version ultérieure.

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.

Vous devriez avoir reçu une copie de la Licence Publique Générale GNU avec ce programme. Sinon, consultez http://www.gnu.org/licenses/.

Allez voir la page du projet Bracelet Générateur sur Github pour les dernières mises à jour.

Prérequis

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 friendship-bracelets.net (en anglais), par exemple.

Téléchargement

Voir la page dédiée aux téléchargements.

Installation

Windows

Lancez bracelet-generator-x.y.z.exe et suivez les instructions de l’installateur (il est nécessaire d’avoir les droits d’administrateur pour effectuer l’installation).

Ubuntu

Bracelet Generator est disponible dans le PPA ppa:j-4321-i/ppa.

$ sudo add-apt-repository ppa:j-4321-i/ppa
$ sudo apt-get update
$ sudo apt-get install bracelet-generator

Archlinux

Bracelet Generator est disponible dans AUR.

Mac OS X

La version pour Mac n'est plus à jour, pour bénéficier de la dernière version, il faut utiliser le code source .

Décompresser l'archive. Placez BraceletGenerator.app dans le dossier /Applications. Pour pouvoir exporter les patrons en .png ou .jpg, il faut installer Ghostscript. Il est possible de le faire avec brew :

$ brew install ghostscript

Sinon, allez voir le site de Ghostscript.

Code source

Tout d’abord, il faut installer les dépendances manquantes parmi :

• Python 3
• Tkinter pour Python 3
• Pillow (Python Imaging Library)
• Ghostscript
• Zenity (optionnel, pour Linux uniquement)

Linux

Python 3 est certainement déjà installé, mais il faut peut-être installer les autres. Les noms des paquets varient selon les distributions. Voici les noms des paquets pour :

• Ubuntu : python3-tk, python3-pil, ghostscript, zenity
• ArchLinux : tk, python-pillow, ghostscript, zenity

Vous pouvez aussi utiliser pip pour installer Pillow (requiert les droits de superutilisateur) :

$ pip3 install pillow

Décompressez l’archive et lancez bracelet-generator.py. S’il ne se passe rien, éditez les propriétés du fichier pour le rendre exécutable ou lancez le avec Python : ouvrez un terminal dans le dossier extrait et tapez

$ python3 bracelet-generator.py

Vous pouvez aussi installer Bracelet Générateur (requiert les droits de superutilisateur) avec

$ python3 setup.py install

Ensuite le logiciel peut être lancé depuis un terminal avec

$ bracelet-generator

Windows

Tkinter sera installé automatiquement avec Python. Mais il faudra installer le module Pillow séparément. Il faudra aussi installer Ghostscript.

• Python 3 : rendez-vous sur le site de Python et installez la dernière version de Python 3 (attention, n'installez pas Python 2.x).
• Pillow : rendez-vous sur la page de Pillow sur PyPI et téléchargez la version correspondant à l'architecture de votre OS et à la version de Python que vous avez installé. Par exemple, si vous avez un Windows 64 bits (ce qui est le plus probable) et si vous avez installé Python 3.5.x, vous devez télécharger Pillow-3.3.1.win-amd64-py3.5.exe.
• Ghostscript : rendez-vous sur le site de Ghostscript et téléchargez la version correspondant à l'architecture de votre OS.

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.

Autres systèmes d'exploitation

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.

• Python 3 : rendez-vous sur le site de Python et installez la dernière version de Python 3 (attention, n'installez pas Python 2.x).
• Pillow : rendez-vous sur la page de Pillow sur PyPI et téléchargez la version correspondant à votre OS et à la version de Python que vous avez installé. Si vous ne la trouvez pas, allez voir la documentation de Pillow.
• Ghostscript : rendez-vous sur le site de Ghostscript et téléchargez la version correspondant à votre OS. Vous aurez peut-être besoin de télécharger le code source et de le compiler vous-même. Sous OS X, Ghostscript peut être installé avec brew :

  $ brew install ghostscript

Tkinter est parfois inclus dans la distribution Python standard ou est disponible sous la forme d'un paquet binaire (pour Linux ou BSD). Si vous utilisez Mac OS X , vous pouvez vous référer à https://www.python.org/download/mac/tcltk.

Décompressez l'archive et lancez bracelet-generator.py.
S'il ne se passe rien, essayez de définir Python comme programme par défaut pour lancer cette application. Vous pouvez aussi le lancer depuis un terminal en tapant une commande similaire à :

$ python3 bracelet-generator.py

Langue

Le logiciel est en Français et en Anglais. J'ai utilisé gettext pour le traduire donc, si vous voulez ajouter ou améliorer une traduction, n'hésitez pas, le fichier BraceletGenerator.pot est disponible dans le dossier po/ du code source.

Guide d'utilisation

Fenêtre principale

• Pour changer la couleur d'un fil, cliquez sur le petit carré situé juste au-dessus. Un sélecteur de couleur s'ouvrira.
• Pour modifier un nœud, cliquez dessus. Les quatre types de nœuds défileront successivement (défilement inversé avec clic droit).
• Pour ajouter ou enlever des lignes / fils, il suffit d'utiliser les boutons ou . Vous pouvez également in- diquer directement le nombre de lignes / fils à côté des boutons .
• Ouvrir le gestionnaire de couleurs.

Barre d'outils

Créer un nouveau patron (le patron en cours sera effacé).
Ouvrir un fichier .bracelet (le patron en cours sera effacé).
Enregistrer le patron.
Enregistrer sous.
Exporter le patron en .png, .jpg or .ps file.
Ouvrir l'éditeur de motifs bicolores. Quand le patron sera généré, le patron précédent sera effacé.
Symétrie verticale du patron.
Symétrie horizontale du patron.
Quitter.

Gestionnaire de couleurs

Le gestionnaire de couleurs permet de changer la couleur par défaut des fils et de changer la couleur de tous les fils d’une couleur donnée.

Éditeur de motifs bicolores

L'éditeur de motifs bicolores vous permet de créer librement un motif bicolore, et ensuite, le patron correspondant sera automatiquement généré.

• Pour changer la couleur d'un carreau, cliquez dessus.
• Pour changer la couleur du fond / du motif, cliquez sur / .
• Pour ajouter ou supprimer des lignes / fils, utilisez les boutons ou . Vous pouvez également in- diquer directement le nombre de lignes / fils à côté des boutons .

Barre d'outils

Ouvrir un fichier .bicolor (efface le motif en cours).
Enregistrer le motif.
Générer le patron correspondant au motif qui sera alors détruit. Enregistrez le pour pouvoir le modifier plus tard.
Effacer le motif. Attention, vous ne pourrez pas revenir en arrière.
Ouvrir l’outil de translation.
Rotation du motif dans le sens anti-horaire.
Rotation du motif dans le sens horaire.
Symétrie verticale du motif.
Symétrie horizontale du motif.
Quitter l'éditeur.

Outil de translation

Cet outil permet de translater le motif de manière périodique dans les directions données par les flèches.

Exemples

Quelques exemples simples sont donnés dans le dossier examples/, (situé dans /usr/share/bracelet-generator si vous avez installé le paquet .deb, ou dans votre_dossier_utilisateur/BraceletGenerator si vous avez installé le logiciel depuis les sources ou avec le .exe), comme le bracelet à chevrons ci-dessous :

Bonne utilisation !

Résolution de problèmes

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 vous êtes sous Windows, lancez C:\Program Files\Bracelet Generator\add_gs_to_path.exe (ou add_gs_to_path.py si vous utilisez le code source) pour ajouter l'emplacement de Ghostscript à la variable path du système.

Si vous rencontrez d’autres problèmes ou si vous avez des commentaires, créez un ticket sur la page du projet ou envoyez-moi un email à j_4321@protonmail.com.