tuxpaint-pencil-sharpener/docs/fr_FR.UTF-8/INSTALL.txt
2021-08-31 00:44:55 -07:00

617 lines
25 KiB
Text

Tux Paint
version 0.9.27
Documentation sur l'installation
Copyright &copie; 2002-2021 par divers contributeurs; voir AUTHORS.
http://www.tuxpaint.org/
août 31, 2021
----------------------------------------------------------------------
+----------------------------------------------------+
|Table des matières |
|----------------------------------------------------|
| * Requirements |
| * Simple DirectMedia Layer library (libSDL) |
| * Autres bibliothèques |
| * Compiling and Installation |
| * Utilisateurs de Windows |
| * Utilisateurs de Linux/Unix |
| * Debugging |
| * Uninstalling Tux Paint |
| * Windows |
| * Linux |
+----------------------------------------------------+
----------------------------------------------------------------------
Requirements
Simple DirectMedia Layer library (libSDL)
Tux Paint nécessite la bibliothèque de couches DirectMedia simple
(libSDL), une bibliothèque de programmation multimédia Open Source
disponible sous la Licence publique générale limitée GNU (LGPL).
Avec libSDL, Tux Paint dépend d'un certain nombre d'autres
bibliothèques SDL : SDL_Image (pour les fichiers graphiques), SDL_TTF
et (en option) SDL_Pango (pour la prise en charge des polices True
Type) et, éventuellement, SDL_Mixer (pour les effets sonores).
Utilisateurs de Linux/Unix :
Les bibliothèques SDL sont disponibles en tant que code source, ou
en tant que paquets RPM ou Debian pour diverses distributions de
Linux. Ils peuvent être téléchargés à partir de :
* libSDL: http://www.libsdl.org/
* SDL_Image: http://www.libsdl.org/projects/SDL_image/
* SDL_TTF: http://www.libsdl.org/projects/SDL_ttf/
* SDL_Pango: http://sourceforge.net/projects/sdlpango/ (optionnel)
* SDL_Mixer: http://www.libsdl.org/projects/SDL_mixer/ (optionnel)
Elles sont aussi parmi les paquets inclus dans votre distribution
(par ex. sur le media d'installation, ou via la maintenance de vos
logiciels comme la commande apt de Debian).
Remarque ;lors de l'installation à partir de packages, assurez-vous
d'installer AUSSI les versions de développement des paquets (Par ex.
installez les deux "SDL-1.2.4.rpm" et "SDL-1.2.4-devel.rpm".)
Autres bibliothèques
Tux Paint profite également d'un certain nombre d'autres bibliothèques
gratuites LGPL. Sous Linux, tout comme SDL, ils devraient être soit
déjà installées, soit facilement disponibles avec votre distribution
Linux.
libPNG
Tux Paint utilise le format PNG (Portable Network Graphics) pour ses
fichiers de données. SDL_image nécessitera l'installation de libPNG.
http://www.libpng.org/pub/png/libpng.html
gettext
Tux Paint utilise les paramètres régionaux de votre système avec la
bibliothèque "gettext" pour prendre en charge plusieurs langues (par
exemple, l'espagnol). Vous aurez besoin d'installer la bibliothèque
de gettext.
http://www.gnu.org/software/gettext/
libpaper (Linux/Unix uniquement)
Depuis Tux Paint 0.9.17, Tux Paint peut déterminer le format de
papier par défaut (par exemple, A4 ou Lettre), ou peut être invité à
utiliser un format particulier, ceci grâce à libpaper.
https://github.com/naota/libpaper
FriBiDi
Les outils "Texte" et "Étiquette" de Tux Paint supportent les
langues bidirectionnelles, grâce à la bibliothèque "FriBidi".
http://fribidi.org/
Support des graphismes SVG
À partir de Tux Paint 0.9.17, Tux Paint peut prendre en charge les
images SVG (Scalable Vector Graphics) pour les tampons. Deux
ensembles de bibliothèques sont pris en charge et le support SVG
peut être complètement désactivé (via "make SVG_LIB:==")
librsvg-2 & libCairo2 (nouvelles bibliothèques)
* libRSVG 2: http://librsvg.sourceforge.net/
* Cairo 2: http://www.cairographics.org/
* Celles-ci dépendent aussi de :
* GdkPixbuf & GLib: http://www.gtk.org/
* Pango: http://www.pango.org/
Anciennes bibliothèques
* libcairo1, libsvg1, & libsvg-cairo1:
http://www.cairographics.org/
* Celles-ci dépendent aussi de :
* libxml2: https://gitlab.gnome.org/GNOME/libxml2
Fonction d'exportation de GIF animés
Pour prendre en compte l'exportation de GIF animés (diaporama), la
bibliothèque "libimagequant" (issue du projet "pngquant" est
nécessaire.
https://github.com/ImageOptim/libimagequant
Outils NetPBM (optionnel) Ne sont plus utilisés, par défaut
Sous Linux et Unix, les anciennes versions de Tux Paint utilisaient
les outils NetPBM comme aide à l'impression. (Un PNG est généré par
TuxPaint et converti en PostScript en utilisant en ligne de commande
les outils NetPBM pngtopnm et pnmtops.)
http://netpbm.sourceforge.net/
----------------------------------------------------------------------
Compiling and Installation
Tux Paint est publié sous la licence publique générale GNU (GPL) (voir
"COPYING.txt" pour plus de détails), et donc le 'code source' du
programme est disponible gratuitement.
Utilisateurs de Windows
Compiling Set-Up
Depuis février 2005 (à partir de Tux Paint 0.9.15), le "Makefile"
inclut la prise en charge de la construction sur un système Windows
à l'aide de MinGW/MSYS (https://sourceforge.net/projects/msys2/).
Many tools and libraries are required to build Tux Paint. The
package management system "pacman" helps you install them
automatically solving complicated dependencies.
Download the latest MSYS2 environment from
https://sourceforge.net/projects/msys2/files/Base/ and install it
where you'd like (the default is
"https://sourceforge.net/projects/msys2/files/Base/")
Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" ->
"MSYS2 MSYS" and execute following command (press [Entrée] or
[Retour] to accept the defaults for all questions):
pacman -Syu
This will update core system and the window will close
automatically. Repeat the steps above one more time to finish the
remaining update process.
Within the MSYS2 shell, run the following command to install basic
development tools:
pacman -S base-devel msys2-devel git
Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip
to the "MinGW 32bit (i686) toolchains" section if you need only a
32bit build environment.
MinGW 64bit (x86_64) toolchains
Within the MSYS2 shell, run the following command to install basic
64bit development tools:
pacman -S mingw-w64-x86_64-toolchain
64bit (x86_64) dependency libraries for Tux Paint
You can install tools and libraries required for compiling Tux Paint
on MSYS2/MINGW using "pacman" except for SDL_Pango.
"ntldd" is a small tool which examine windows executable files to
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
packaging process for binary distribution uses it to find required
.dll files.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
You can skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-x86_64-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-x86_64-librsvg
$ pacman -S mingw-w64-x86_64-fribidi
$ pacman -S mingw-w64-x86_64-libimagequant
$ pacman -S mingw-w64-x86_64-fltk
$ pacman -S mingw64/mingw-w64-x86_64-ntldd-git
Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango and re-install SDL on the 64bit environment
SDL_Pango should be installed manually. In addition, you have to
re-install SDL from the source code or you will see unnecessary
blank window opens when starting Tux Paint.
This time, use the MinGW "64bit" shell. Open the shell from the
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit"
SDL_Pango
At first, you have to prepare source tar-ball and a required patch
in the same directory.
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
page on Sourceforge.net.
* Download a patch file from John Popplewell's "Tux Paint -
MinGW/MSYS build instructions" webpage. (This adds some extra
(required) functionality to SDL_Pango.)
Build and install SDL_Pango as follows.
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw64 && make && make install
SDL
Download source tar-ball of SDL_1.2.15 from libsdl.org.
Re-install SDL as follows.
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw64 && make && make install
Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip
to the "ImageMagick" section if you need only a 64bit build
environment.
MinGW 32bit (i686) toolchains
Within the MSYS2 shell, run the following command to install basic
32bit development tools:
pacman -S mingw-w64-i686-toolchain
32bit (i686) dependency libraries for Tux Paint
You can install tools and libraries required for compiling Tux Paint
on MSYS2/MINGW using "pacman" except for SDL_Pango.
"ntldd" is a small tool which examine windows executable files to
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
packaging process for binary distribution uses it to find required
.dll files.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
You can skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-i686-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-i686-librsvg
$ pacman -S mingw-w64-i686-fribidi
$ pacman -S mingw-w64-i686-libimagequant
$ pacman -S mingw-w64-i686-fltk
$ pacman -S mingw-w64-i686-ntldd-git
Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango and re-install SDL on the 32bit environment
SDL_Pango should be installed manually. In addition, you have to
re-install SDL from the source code or you will see unnecessary
blank window opens when starting Tux Paint.
This time, use the MinGW "32bit" shell. Open the shell from the
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit"
SDL_Pango
At first, you have to prepare source tar-ball and a required patch
in the same directory.
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
page on Sourceforge.net.
* Download a patch file from John Popplewell's "Tux Paint -
MinGW/MSYS build instructions" webpage. (This adds some extra
(required) functionality to SDL_Pango.)
Build and install SDL_Pango as follows.
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw32 && make && make install
SDL
Download source tar-ball of SDL_1.2.15 from libsdl.org.
Re-install SDL as follows.
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw32 && make && make install
ImageMagick
ImageMagick is a compilation of command line tools to create, edit,
compose, or convert bitmap images supporting quite a large number of
image formats. Tux Paint uses two functions ("convert" and
"composite") in it to generate thumbnails for startar images and
templates during the build process.
Using official binary release available from "Windows Binary
Release" is recommended, due to the commands installed with "pacman"
on MinGW/MSYS not working as expected!
Do not forget to enable "Install legacy utilities (e.g. convert)"
while installing it, because Tux Paint's build process uses them.
Add the path to the directory in which ImageMagick is installed at
the top of your "PATH" environment variable. For example:
$ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH
You can make this permanent by adding the above to your the BASH
shell configuration file, "~/.bash_profile".
Tux Paint
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit
binaries using MSYS2 32bit shell, respectively.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start
Menu" to open the 64bit shell.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start
Menu" to open the 32bit shell.
Compile Tux Paint with the following command:
$ make bdist-win32
Note: At this point, you will want to build "Tux Paint Config." for
Windows, so it can be included along with "Tux Paint", if you're
making an official (or test) release. The build process will look
for it in a directory named "tuxpaint-config" (with no version
number, e.g., "tuxpaint-config-X.Y.Z"). See "Tux Paint Config."'s
INSTALL.txt documentation for details.
All the files needed for starting Tux Paint (and Tux Paint Config.)
are collected in the directory for binary distribution "bdist"
directory under "win32". You can start them by double-clicking their
executable (.exe) files in the "bdist" directory.
Building the Tux Paint Windows Installer:
Inno Setup is used to build executable installer for Tux Paint.
Therefore you have to install it in the first place.
Then, you can easily build an executable installer by right-clicking
on the "tuxpaint.iss" icon in the "win32" directory and selecting
"Compile" on the list. It will run for a while, and eventually you
will find a "tuxpaint-X.Y.Z-win32-installer.exe" file in the same
directory.
Running the Tux Paint Windows Installer:
Double-cliquez sur l'exécutable du programme d'installation de Tux
Paint (fichier .EXE) et Suivez les instructions.
Tout d'abord, il vous sera demandé d'accepter la licence. (Il s'agit
de la licence publique générale GNU (GPL), qui est également
disponible en tant que "COPYING.txt".)
Il vous sera ensuite demandé si vous souhaitez installer des
raccourcis à Tux Paint dans votre menu Démarrer de Windows et sur
votre bureau Windows.(Les deux options sont définies par défaut.)
Puis, il vous sera demandé où vous souhaitez installer Tux Paint. La
valeur par défaut devrait convenir, tant qu'il y a de l'espace
disponible. Sinon, choisissez un autre emplacement.
À ce stade, vous pouvez cliquer sur «Installer» pour installer Tux
Paint !
Modification des paramètres à l'aide du raccourci :
Pour modifier les paramètres du programme, cliquez avec le bouton
droit sur le raccourci TuxPaint et sélectionnez «Propriétés» (en
bas).
Assurez-vous que l'onglet "Raccourci" est sélectionné dans la
fenêtre qui apparaît et examinez le champ «Cible:». Vous devriez
voir quelque chose comme ceci :
"C:\Program Files\TuxPaint\TuxPaint.exe"
Vous pouvez maintenant ajouter des options de ligne de commande qui
seront activées lorsque vous double-cliquez sur l'icône.
Par exemple, pour faire fonctionner le jeu en mode plein écran, avec
des formes simples (pas d'option de rotation) et en français,
ajoutez les options (après 'TuxPaint.exe'), comme ceci :
"C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french
(Voir «README.txt» pour une liste complète des options de ligne de
commande disponibles.)
Si vous faites une erreur ou que tout disparaît, utilisez [Ctrl] +
[Z] pour annuler ou appuyez simplement sur la touche [Esc] et la
boîte se fermera sans aucune modification (sauf si vous avez appuyé
sur le bouton "Appliquer" !).
Quand vous avez fini, appuyez sur "OK".
Si quelque chose ne va pas :
Si, lorsque vous double-cliquez sur le raccourci pour lancer le jeu,
rien ne se passe, c'est probablement parce que certaines des options
en lignes de commande sont erronées. Ouvrez un explorateur comme
avant et recherchez un fichier appelé "stderr.txt" dans le dossier
TuxPaint.
Il contiendra une description de ce qui n'allait pas.
Habituellement, ce sera simplement dû à une casse de caractère
incorrecte (majuscule 'Z' à la place de 'z' minuscule) ou un '-'
(tiret) manquant (en trop).
Utilisateurs de Linux/Unix
Compilation :
Remarque :Tux Paint n'utilise pas autoconf/automake, dès lors il n'y
a pas de script "./configure" à lancer. La compilation devrait aller
cependant aller toute seule, en supposant que Tux Paint ait tout ce
dont il a besoin.
Pour compiler le programme à partir des sources, lancez simplement
la commande suivante après une invite shell (par ex. "$") :
$ make
Désactivation du support SVG (donc des dépendances Cairo, libSVG, et
svg-cairo)
Pour désactiver le support de SVG (par ex. si votre système n'a pas
de bibliothèque Cairo, ou d'autres choses dont SVG est dépendan),
vous pouvez exécuter "make" avec SVG_LIB= SVG_CFLAGS=
NOSVGFLAG=NOSVG :
$ make SVG_LIB= SVG_CFLAGS=
Désactivation du support Pango (donc des dépendances Pango, Cairo, etc ...)
Avant la version 0.9.18, Tuxpaint utilisait la bibliothèque
libSDL_ttf pour gérer les fichiers utilisant les fontes True Type.
Depuis la 09.18 libSDL_Pango est utilisée, car il permet un meilleur
support pour l'internationalisation. Cependant, si vous voulez
désactiver l'utilisation de SDL_Pango, vous pouvez le faire en
exécutant "make" avec "SDL_PANGO_LIB=" :
$ make SDL_PANGO_LIB=
Désactiver le son lors de la compilation :
Si vous n'avez pas de carte son ou si vous préférez créer le
programme sans support sonore (et donc sans dépendance SDL_mixer),
vous pouvez exécuter "make" avec "SDL_MIXER_LIB=" comme paramètre :
$ make SDL_MIXER_LIB=
Autres options :
Diverses autres options (par exemple, les dossiers d'installation)
peuvent être remplacées; voir dans "Makefile" pour plus de détails.
Si vous obtenez des erreurs :
Si vous avez des erreurs lors de la compilation, assurez-vous
d'avoir les bibliothèques adéquates installées (voir ci-dessus). Si
vous utilisez les versions issues des paquets des bibliothèques (par
exemple, les RPM sous RedHat ou les DEB sous Debian), assurez-vous
d'avoir choisi également les packages "-dev" ou "-devel"
correspondants, sinon vous ne pourrez pas compiler Tux Paint (et
d'autres programmes) provenant des sources !
Installation :
En supposant qu'aucune erreur fatale ne s'est produite, vous pouvez
maintenant installer le programme afin qu'il puisse être exécuté par
les utilisateurs du système. Par défaut, cela doit être effectué par
l'utilisateur "root" ("superutilisateur"). Passer à "root" en tapant
la commande :
$ su
Entrez le mot de passe de "root" à l'invite. Vous devriez maintenant
être "root" (avec une invite comme "#"). Pour installer le programme
et ses fichiers de données, tapez :
# make install
Pour finir, vous pouvez revenir sur votre compte utilisateur en
sortant du compte superutilisateur :
# exit
Autre manière : vous faites simplement utilisation de la commande
"sudo" (par ex. sur Ubuntu) :
$ sudo make install
Remarque :Par défaut, "tuxpaint, le programme exécutable, est placé
en "/usr/local/bin/". Les données (images, sons, etc ...) sont dans
"/usr/local/share/tuxpaint/".
Changer où vont les fichiers
Vous pouvez changer où iront les fichiers en définissant des
variables pour "Makefile" sur la ligne de commande. "DESTDIR" est
utilisé pour indiquer la sortie des résultats de la compilation.
"PREFIX" est la base où tous les autres fichiers iront et est
définie par défaut comme "/usr/local".
Les autres variables sont :
BIN_PREFIX
Où le binaire "tuxpaint" sera installé. (Par défaut
"$(PREFIX)/bin", par ex. "/usr/local/bin")
DATA_PREFIX
Où les fichiers de données (sons, graphiques, pinceaux,
tampons, fontes) iront, et où Tux Paint ira les chercher
pour tourner (Réglé à "$(PREFIX)/share/tuxpaint")
DOC_PREFIX
Où sera mise la documentation (les répertoires "docs".
'Réglé à "$(PREFIX)/share/doc/tuxpaint")
MAN_PREFIX
Où ira la page de manuel de Tuxpaint (Réglé à
"$(PREFIX)/share/man")
ICON_PREFIX — $(PREFIX)/share/pixmaps
X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps
GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics
KDE_PREFIX — $(PREFIX)/share/applnk/Graphics
Où iront les icônes et les lanceurs (pour GNOME et KDE)
LOCALE_PREFIX
Où iront les fichiers de traduction, et où Tux Paint ira
les chercher. (Réglé à "$(PREFIX)/share/locale/") (la
destination finale de la traduction sera dans le
répertoire de la locale (par ex "es" pour l'espagnol, dans
le sous-répertoire "LC_MESSAGES").
Remarque : Cette liste est obsolète. Voir "Makefile" et
"Makefile-i18n" pour une liste complète.
----------------------------------------------------------------------
Debugging
Le débogage (vers "STDOUT", par exemple le terminal, ou vers un fichier
"stdout.txt", sous Windows) peut être activé en définissant "DEBUG" (et,
si un mode verbeux est souhaité, "VERBOSE") # define dans "src/debug.h.
----------------------------------------------------------------------
Uninstalling Tux Paint
Windows
Utilisation du désinstalleur
Si vous avez installé les raccourcis du menu Démarrer (par défaut),
accédez au dossier TuxPaint et sélectionnez "Désinstaller". Une
boîte s'affichera qui confirme que vous êtes sur le point de
désinstaller Tux Paint et, si vous en êtes certain et que vous
souhaitez supprimer définitivement Tux Paint, cliquez sur le bouton
'Désinstaller'.
Quand c'est fini, cliquez sur "Fermer".
En utilisant le panneau de configuration
Il est également possible d'utiliser l'entrée "TuxPaint (supprimer
uniquement)" dans la Section Ajout / Suppression de programmes du
Panneau de configuration.
Linux
Dans le répertoire source de Tux Paint (où vous avez compilé Tux
Paint), vous pouvez utiliser une cible "make uninstall" pour
désinstaller Tux Paint. Par défaut, cela doit être fait par
l'utilisateur "root" ("superutilisateur"), mais si vous avez installé
Tux Paint à un autre endroit (par ex. en mettant "PREFIX=..." à "make"
et "make install", vous ne pourrez pas, et il faudra fournier les
mêmes réglages ici. (Voir les instructions d'installation ci-dessus
pour plus d'informations.)