1231 lines
65 KiB
HTML
1231 lines
65 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<title>
|
|
Documentation sur l'installation de Tux Paint </title>
|
|
<meta http-equiv="Content-Type"
|
|
content="text/html; charset=utf-8">
|
|
<style>
|
|
body { font-size: large; }
|
|
table { font-size: large; }
|
|
div.screenshot-center {
|
|
text-align: center;
|
|
}
|
|
div.screenshot-right {
|
|
float: right;
|
|
margin-left: 1em;
|
|
margin-bottom: 1em;
|
|
}
|
|
div.screenshot-right-after {
|
|
clear: both;
|
|
}
|
|
div.keeptogether { page-break-inside: avoid; }
|
|
section h1 { font-size: 2em; }
|
|
h1, h2, h3, h4, h5 { font-family: sans; }
|
|
h1 { color: #800; page-break-before: always; break-before: always; }
|
|
h2 { color: #440; page-break-after: avoid; break-after: avoid; }
|
|
h3 { color: #080; page-break-after: avoid; break-after: avoid; }
|
|
h4 { color: #008; page-break-after: avoid; break-after: avoid; }
|
|
h5 { color: #808; page-break-after: avoid; break-after: avoid; }
|
|
h1 + p { page-break-inside: avoid; }
|
|
h2 + p { page-break-inside: avoid; }
|
|
h3 + p { page-break-inside: avoid; }
|
|
h4 + p { page-break-inside: avoid; }
|
|
h5 + p { page-break-inside: avoid; }
|
|
dt {
|
|
font-size: large;
|
|
color: #404;
|
|
font-family: sans;
|
|
margin-top: 1em;
|
|
margin-bottom: 0.25em;
|
|
}
|
|
dd, blockquote {
|
|
border-left: 1px solid #888;
|
|
padding-left: 1em;
|
|
border-radius: 0 0 0 1em;
|
|
}
|
|
p.note {
|
|
border: 1px solid #000;
|
|
background-color: #eee;
|
|
border-radius: 0.5em;
|
|
padding: 0.5em;
|
|
display: inline-block;
|
|
margin-right: 3em;
|
|
}
|
|
section.outer {
|
|
padding-bottom: 1em;
|
|
border-bottom: 2px solid #000;
|
|
}
|
|
section.indent p,dl {
|
|
margin-left: 2em;
|
|
}
|
|
section.indent dl p {
|
|
margin-left: 0;
|
|
}
|
|
p + ul {
|
|
margin-left: 2em;
|
|
}
|
|
|
|
@media print {
|
|
p {
|
|
orphans: 3;
|
|
widows: 3;
|
|
}
|
|
}
|
|
</style>
|
|
</head>
|
|
<body bgcolor="#FFFFFF"
|
|
text="#000000"
|
|
link="#0000FF"
|
|
vlink="#FF0000"
|
|
alink="#FF00FF">
|
|
<section class="outer">
|
|
<header>
|
|
<center>
|
|
<h1>
|
|
<img src="../../html/images/tuxpaint-title.png"
|
|
width="205"
|
|
height="210"
|
|
alt="Tux Paint"><br>
|
|
version 0.9.29<br/>
|
|
Documentation sur l'installation </h1>
|
|
|
|
<p>
|
|
Copyright © 2002-2022 by divers contributeurs; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
|
|
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
|
|
</p>
|
|
|
|
<p>
|
|
juin 4, 2022 </p>
|
|
</center>
|
|
</header>
|
|
|
|
<table border="2"
|
|
cellspacing="0"
|
|
cellpadding="2"
|
|
summary="Table des matières"
|
|
align="center"
|
|
style="page-break-inside: avoid;">
|
|
<tr>
|
|
<th>
|
|
Table des matières </th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>
|
|
<ul>
|
|
<li><a href="#requirements">Exigences</a> <ul>
|
|
<li><a href="#req-libsdl">Biliothèque Simple DirectMedia Layer (libSDL)</a></li> <li><a href="#req-other-libs">Autres bibliothèques</a></li> </ul>
|
|
</li>
|
|
<li><a href="#compiling">Compilation et installation</a> <ul>
|
|
<li><a href="#compiling-windows">Windows</a></li> <li><a href="#compiling-linux">Linux/Unix</a></li> <li><a href="#compiling-macos">macOS</a></li> </ul>
|
|
</li>
|
|
<li><a href="#debugging">Débogage</a></li> <li><a href="#uninstalling">Désinstallation de Tux Paint</a> <ul>
|
|
<li><a href="#uninstalling-windows">Windows</a></li> <li><a href="#uninstalling-macOS">macOS</a></li> <li><a href="#uninstalling-linux">Linux</a></li> </ul>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</section>
|
|
|
|
<section class="outer indent"><!-- H1: Requirements -->
|
|
<header>
|
|
<h1>
|
|
<a name="requirements" id="requirements">
|
|
Exigences </a>
|
|
</h1>
|
|
</header>
|
|
|
|
<section class="indent"><!-- H2: Simple DirectMedia Layer library (libSDL) -->
|
|
<header>
|
|
<h2>
|
|
<a name="req-libsdl" id="req-libsdl">
|
|
Biliothèque Simple DirectMedia Layer (libSDL) </a>
|
|
</h2>
|
|
</header>
|
|
|
|
<p>
|
|
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). </p>
|
|
|
|
<p>
|
|
Avec libSDL, Tux Paint dépend d'un certain nombre d'autres bibliothèques 'd'aide' SDL : SDL_Image (pour les fichiers graphiques), SDL_gfx (pour certaines fonctions graphiques, comme la rotation), SDL_TTF et (en option) SDL_Pango (pour la prise en charge des polices True Type) et, éventuellement, SDL_Mixer (pour les effets sonores). </p>
|
|
|
|
<dl>
|
|
<dt><strong>Linux/Unix</strong></dt>
|
|
<dd>
|
|
<p>
|
|
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 : </p>
|
|
<ul>
|
|
<li>libSDL: <a href="http://www.libsdl.org/">http://www.libsdl.org/</a></li>
|
|
<li>SDL_Image: <a href="http://www.libsdl.org/projects/SDL_image/">http://www.libsdl.org/projects/SDL_image/</a></li>
|
|
<li>SDL_gfx: <a href="https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/">https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/</a> (<a href="https://sourceforge.net/projects/sdlgfx/">https://sourceforge.net/projects/sdlgfx/</a>)</li>
|
|
<li>SDL_TTF: <a href="http://www.libsdl.org/projects/SDL_ttf/">http://www.libsdl.org/projects/SDL_ttf/</a></li>
|
|
<li>SDL_Pango: <a href="http://sourceforge.net/projects/sdlpango/">http://sourceforge.net/projects/sdlpango/</a> (optionnel)</li>
|
|
<li>SDL_Mixer: <a href="http://www.libsdl.org/projects/SDL_mixer/">http://www.libsdl.org/projects/SDL_mixer/</a> (optionnel)</li>
|
|
</ul>
|
|
|
|
<p>
|
|
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 <code>apt</code> de Debian). </p>
|
|
|
|
<p class="note">
|
|
<span title="Information">💡</span> <strong>Note:</strong> When installing libraries from packages, be sure to ALSO install the development versions of the packages. (For example, install both "<code>SDL-1.2.4.rpm</code>" <em>and</em> "<code>SDL-1.2.4-devel.rpm</code>".) </p>
|
|
</dd>
|
|
</dl>
|
|
</section><!-- H2: Simple DirectMedia Layer library (libSDL) -->
|
|
|
|
<section class="indent"><!-- H2: Other Libraries -->
|
|
<header>
|
|
<h3>
|
|
<a name="req-other-libs" id="req-other-libs">
|
|
Autres bibliothèques </a>
|
|
</h3>
|
|
</header>
|
|
|
|
<p>
|
|
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. </p>
|
|
|
|
<dl>
|
|
<dt><strong>libPNG</strong></dt>
|
|
<dd>
|
|
<p>
|
|
Tux Paint utilise le format PNG (Portable Network Graphics) pour ses fichiers de données. SDL_image nécessitera l'installation de libPNG. </p>
|
|
|
|
<p>
|
|
<a href="http://www.libpng.org/pub/png/libpng.html">http://www.libpng.org/pub/png/libpng.html</a>
|
|
</p>
|
|
</dd>
|
|
|
|
<dt><strong>gettext</strong></dt>
|
|
<dd>
|
|
<p>
|
|
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. </p>
|
|
|
|
<p>
|
|
<a href="http://www.gnu.org/software/gettext/">http://www.gnu.org/software/gettext/</a>
|
|
</p>
|
|
</dd>
|
|
|
|
<dt><strong>libpaper (Linux/Unix uniquement)</strong></dt>
|
|
<dd>
|
|
<p>
|
|
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. </p>
|
|
|
|
<p>
|
|
<a href="https://github.com/naota/libpaper">https://github.com/naota/libpaper</a>
|
|
</p>
|
|
</dd>
|
|
|
|
<dt><strong>FriBiDi</strong></dt>
|
|
<dd>
|
|
<p>
|
|
Les outils "Texte" et "Étiquette" de Tux Paint supportent les langues bidirectionnelles, grâce à la bibliothèque "FriBidi". </p>
|
|
|
|
<p>
|
|
<a href="http://fribidi.org/">http://fribidi.org/</a>
|
|
</p>
|
|
</dd>
|
|
|
|
<dt><strong>Support des graphismes SVG</strong></dt>
|
|
<dd>
|
|
<p>
|
|
À 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 "<code style="white-space: nowrap;">make SVG_LIB:=</code>=") </p>
|
|
|
|
<dl>
|
|
<dt>librsvg-2 & libCairo2 (nouvelles bibliothèques)</dt>
|
|
<dd>
|
|
<ul>
|
|
<li>libRSVG 2: <a href="http://librsvg.sourceforge.net/">http://librsvg.sourceforge.net/</a></li>
|
|
<li>Cairo 2: <a href="http://www.cairographics.org/">http://www.cairographics.org/</a></li>
|
|
<li>Celles-ci dépendent aussi de : <ul>
|
|
<li>GdkPixbuf & GLib: <a href="http://www.gtk.org/">http://www.gtk.org/</a></li>
|
|
<li>Pango: <a href="http://www.pango.org/">http://www.pango.org/</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
|
|
<dt>Anciennes bibliothèques</dt>
|
|
<dd>
|
|
<ul>
|
|
<li>libcairo1, libsvg1, & libsvg-cairo1: <a href="http://www.cairographics.org/">http://www.cairographics.org/</a></li>
|
|
<li>Celles-ci dépendent aussi de : <ul>
|
|
<li>libxml2: <a href="https://gitlab.gnome.org/GNOME/libxml2">https://gitlab.gnome.org/GNOME/libxml2</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
|
|
<dt><strong>Fonction d'exportation de GIF animés</strong></dt>
|
|
<dd>
|
|
<p>
|
|
Pour prendre en compte l'exportation de GIF animés (diaporama), la bibliothèque "libimagequant" (issue du projet "pngquant" est nécessaire. </p>
|
|
|
|
<p>
|
|
<a href="https://github.com/ImageOptim/libimagequant">https://github.com/ImageOptim/libimagequant</a>
|
|
</p>
|
|
</dd>
|
|
|
|
<dt><strong>Outils NetPBM (optionnel) ne sont plus utilisés par défaut</strong></dt>
|
|
<dd>
|
|
<p class="note">
|
|
<span title="Version variation">📜</span> 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 <code>pngtopnm</code> et <code>pnmtops</code>.) </p>
|
|
|
|
<p>
|
|
<a href="http://netpbm.sourceforge.net/">http://netpbm.sourceforge.net/</a>
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</section>
|
|
</section>
|
|
|
|
<section class="outer indent"><!-- H1: Compiling and Installation -->
|
|
<header>
|
|
<h1>
|
|
<a name="compiling" id="compiling">
|
|
Compilation et installation </a>
|
|
</h1>
|
|
</header>
|
|
|
|
<p>
|
|
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. </p>
|
|
|
|
<section class="indent"><!-- H2: Windows -->
|
|
<header>
|
|
<h2>
|
|
<a name="compiling-windows" id="compiling-windows">
|
|
Windows </a>
|
|
</h2>
|
|
|
|
<p style="font-size: small;">
|
|
<em>
|
|
mai 16, 2022 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp <<a href="mailto:dolphin6k@wmail.plala.or.jp">dolphin6k@wmail.plala.or.jp</a>>
|
|
</em>
|
|
</p>
|
|
</header>
|
|
|
|
<section class="indent"><!-- H3: Compiling Set-Up -->
|
|
<header>
|
|
<h3>Réglages pour compilation</h3>
|
|
</header>
|
|
|
|
<p>
|
|
Depuis février 2005 (à partir de Tux Paint 0.9.15), le "<code>Makefile</code>" inclut la prise en charge de la construction sur un système Windows à l'aide de MinGW/MSYS (<a href="https://sourceforge.net/projects/msys2/">https://sourceforge.net/projects/msys2/</a>). </p>
|
|
|
|
<p>
|
|
Beaucoup d'outils et de bibliothèques sont nécessaires pour élaborer Tux Paint. Le système de gestion de paquet "<code>pacman</code>" apporte une aide pour installer automatiquement, en résolvant les dépendances nombreuses. </p>
|
|
|
|
<p>
|
|
Téléchargez le dernier environnement MSYS2 à partir de <a href="https://sourceforge.net/projects/msys2/files/Base/">https://sourceforge.net/projects/msys2/files/Base/</a> et installez-le où vous voulez (par défaut "<code>C:\msys64</code>") </p>
|
|
<p>
|
|
Ouvrez le shell MSYS2 via le "Menu de Démarrage" ->"MSYS2 64bit" -> "MSTS2 MSYS" et exécutez la commande suivante (pressez <b><code>[Entrée]</code></b> ou <b><code>[Retour]</code></b> pour accepter par défaut toutes les questions) :
|
|
<blockquote>
|
|
<code>
|
|
pacman -Syu
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
|
|
<p>
|
|
Ceci mettra à jour tout le système et la fenêtre de se fermera automatiquement. Répétez les étapes précédentes encore une fois pour finaliser le process restant de mise à jour. </p>
|
|
|
|
<p>
|
|
Sous le shell MSYS2, exécutez la commande suivante pour installer outils basiques pour le développement : <blockquote>
|
|
<code>
|
|
pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch gperf
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
|
|
<p>
|
|
<i>
|
|
Allez à la prochaine section "<a href="#64bit">chaînes d'outils MinGW 64bit (x86_64) </a>", ou bien à la section "<a href="#32bit">chaînes d'outils MinGW 32bit (i686)</a>" si vous ne voulez qu'un environnement de travail 32bit. </i>
|
|
</p>
|
|
|
|
<hr size="1" noshade width="75%" />
|
|
<section class="indent"><!-- H4: MinGW...compiler and tools -->
|
|
<header>
|
|
<h4>
|
|
<a name="64bit" id="64bit">
|
|
MinGW 64bit (x86_64) compiler and tools </a>
|
|
</h4>
|
|
</header>
|
|
|
|
<p>
|
|
Sous le shell MSYS2, exécutez la commande suivante pour installer 64bit compiler and basic development tools : <blockquote>
|
|
<code>
|
|
pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
<p>
|
|
"<code>ntldd</code>" est un petit outil qui examine les fichiers exécutables de windows en vue de lister les fichiers DLL (<code>.dll</code>) qui leur sont nécessaires. Le process de fabrication de Tux Paint pour fournir des fichiers binaires s'en sert pour trouver les fichiers <code>.dll</code> requis. </p>
|
|
</section><!-- H4: MinGW...toolchains -->
|
|
|
|
<section class="indent"><!-- H4: ...dependency libraries for Tux Paint -->
|
|
<header>
|
|
<h4>
|
|
64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config </h4>
|
|
</header>
|
|
|
|
<p>
|
|
You can install tools and libraries required for compiling Tux Paint and Tux Paint Config on MSYS2/MINGW using "<code>pacman</code>" except for SDL_mixer, SDL_Pango and libunibreak. </p>
|
|
<p>
|
|
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip installing it if you are <em>only</em> building "Tux Paint". </p>
|
|
<p>
|
|
<blockquote>
|
|
<code>
|
|
$ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx}<br/>
|
|
$ pacman -S mingw-w64-x86_64-libvorbis<br/>
|
|
$ pacman -S mingw-w64-x86_64-librsvg<br/>
|
|
$ pacman -S mingw-w64-x86_64-fribidi<br/>
|
|
$ pacman -S mingw-w64-x86_64-libimagequant<br/>
|
|
$ pacman -S mingw-w64-x86_64-fltk<br/>
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
<p class="note">
|
|
<span title="Information">💡</span> <strong>Nota : </strong>Fermez l'interpréteur de commandes avant de passer à la suite. </p>
|
|
</section><!-- H4: ...dependency libraries for Tux Paint -->
|
|
|
|
<section class="indent"><!-- H4: Install SDL_Pango... -->
|
|
<header>
|
|
<h4>
|
|
Install SDL_mixer, SDL_Pango and libunibreak on the 64bit environment </h4>
|
|
</header>
|
|
|
|
<p>
|
|
SDL_mixer, SDL_Pango and libunibreak should be installed manually. </p>
|
|
<p>
|
|
Cette fois-ci, utilisez le shell MinGW "64bit". Ouvrez le shell depuis le "Menu de Démarrage" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" </p>
|
|
|
|
<section class="indent"><!-- H5: SDL_mixer -->
|
|
<header>
|
|
<h5>SDL_mixer</h5>
|
|
</header>
|
|
|
|
<p>
|
|
Télécharger <a href="https://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.12.tar.gz">fichier source de SDL_mixer-1.2.12</a> depuis <a href="https://www.libsdl.org/projects/SDL_mixer/">SDL_mixer's page</a>. </p>
|
|
<p>
|
|
Build and install SDL_mixer as follows. <blockquote>
|
|
<code>
|
|
$ tar zxvf SDL_mixer-1.2.12.tar.gz<br/>
|
|
$ cd SDL_mixer-1.2.12/<br/>
|
|
$ ./configure --prefix=/mingw64 && make && make install
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
</section><!-- H5: SDL_mixer -->
|
|
|
|
<section class="indent"><!-- H5: SDL_Pango -->
|
|
<header>
|
|
<h5>SDL_Pango</h5>
|
|
</header>
|
|
|
|
<p>
|
|
Tout d'abord, vous devrez préparer l'archive source et un patch qui est requis, dans le même répertoire. <ul>
|
|
<li>
|
|
Télécharger <a href="https://sourceforge.net/projects/sdlpango/files/SDL_Pango/0.1.2/SDL_Pango-0.1.2.tar.gz/download">fichier source de SDL_Pango-0.1.2</a> depuis <a href="https://sourceforge.net/projects/sdlpango/">La page SDL_Pango sur Sourceforge.net</a>. </li>
|
|
<li>
|
|
Télécharger <a href="http://johnnypops.co.uk/tuxpaint/SDL_Pango-configure-extra-api.patch">un fichier patch</a> depuis <a href="http://www.johnnypops.co.uk/tuxpaint/">La page web de John Popplewell traitant des "instructions pour la compilation de Tux Paint - MinGW/MSYS"</a>. (Ceci ajoute une fonctionnalité supplémentaire (requise) à SDL_Pango.) </li>
|
|
</ul>
|
|
</p>
|
|
<p>
|
|
Compiler et installer SDL_Pango comme suit. <blockquote>
|
|
<code>
|
|
$ tar zxvf SDL_Pango-0.1.2.tar.gz<br/>
|
|
$ cd SDL_Pango-0.1.2/<br/>
|
|
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch<br/>
|
|
$ ./configure --prefix=/mingw64 && make && make install
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
</section><!-- H5: SDL_Pango -->
|
|
|
|
<section class="indent"><!-- H5: libunibreak -->
|
|
<header>
|
|
<h5>libunibreak</h5>
|
|
</header>
|
|
|
|
<p>
|
|
libunibreak is required for compiling Tux Paint Config. You can skip installing it if you are <em>only</em> building "Tux Paint". </p>
|
|
<p>
|
|
You can fetch the source code from the git repositry and compile it as follows. <blockquote>
|
|
<code>
|
|
$ git clone https://github.com/adah1972/libunibreak libunibreak<br/>
|
|
$ cd libunibreak<br/>
|
|
$ ./augogen.sh --prefix=/mingw64 && make && make install
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
</section><!-- H5: libunibreak -->
|
|
|
|
<p>
|
|
<i>
|
|
Aller à la prochaine section "<a href="#32bit">chaines d'outils MinGW 32bit (i686)</a>", ou bien aller directement à la section "<a href="#imagemagick">ImageMagick</a>" si vous n'avez besoin que d'un environnement de travail 64bit. </i>
|
|
</p>
|
|
|
|
</section><!-- H4: Install SDL_Pango... -->
|
|
|
|
<hr size="1" noshade width="75%" />
|
|
<section class="indent"><!-- H4: MinGW...compiler and tools -->
|
|
<header>
|
|
<h4>
|
|
<a name="32bit" id="32bit">
|
|
MinGW 32bit (i686) compiler and tools </a>
|
|
</h4>
|
|
</header>
|
|
|
|
<p>
|
|
Sous le shell MSYS2, exécutez la commande suivante pour installer 32bit compiler and basic development tools : <blockquote>
|
|
<code>
|
|
pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
<p>
|
|
"<code>ntldd</code>" est un petit outil qui examine les fichiers exécutables de windows en vue de lister les fichiers DLL (<code>.dll</code>) qui leur sont nécessaires. Le process de fabrication de Tux Paint pour fournir des fichiers binaires s'en sert pour trouver les fichiers <code>.dll</code> requis. </p>
|
|
</section><!-- H4: MinGW...toolchains -->
|
|
|
|
<section class="indent"><!-- H4: ...dependency libraries for Tux Paint -->
|
|
<header>
|
|
<h4>
|
|
32bit (i686) dependency libraries for Tux Paint and Tux Paint Config </h4>
|
|
</header>
|
|
|
|
<p>
|
|
You can install tools and libraries required for compiling Tux Paint and Tux Paint Config on MSYS2/MINGW using "<code>pacman</code>" except for SDL_mixer, SDL_Pango and libunibreak. </p>
|
|
<p>
|
|
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip installing it if you are <em>only</em> building "Tux Paint". </p>
|
|
<p>
|
|
<blockquote>
|
|
<code>
|
|
$ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}<br/>
|
|
$ pacman -S mingw-w64-i686-libvorbis<br/>
|
|
$ pacman -S mingw-w64-i686-librsvg<br/>
|
|
$ pacman -S mingw-w64-i686-fribidi<br/>
|
|
$ pacman -S mingw-w64-i686-libimagequant<br/>
|
|
$ pacman -S mingw-w64-i686-fltk<br/>
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
<p class="note">
|
|
<span title="Information">💡</span> <strong>Nota : </strong>Fermez l'interpréteur de commandes avant de passer à la suite. </p>
|
|
</section><!-- H4: ...dependency libraries for Tux Paint -->
|
|
|
|
<section class="indent"><!-- H4: Install SDL_Pango... -->
|
|
<header>
|
|
<h4>
|
|
Install SDL_mixer, SDL_Pango and libunibreak on the 32bit environment </h4>
|
|
</header>
|
|
|
|
<p>
|
|
SDL_mixer, SDL_Pango and libunibreak should be installed manually. </p>
|
|
<p>
|
|
Cette fois-ci, utilisez le shell MinGW "32bit". Ouvrez le shell depuis le "Menu de Démarrage" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" </p>
|
|
|
|
<section class="indent"><!-- H5: SDL_mixer -->
|
|
<header>
|
|
<h5>SDL_mixer</h5>
|
|
</header>
|
|
|
|
<p>
|
|
Télécharger <a href="https://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.12.tar.gz">fichier source de SDL_mixer-1.2.12</a> depuis <a href="https://www.libsdl.org/projects/SDL_mixer/">SDL_mixer's page</a>. </p>
|
|
<p>
|
|
Build and install SDL_mixer as follows. <blockquote>
|
|
<code>
|
|
$ tar zxvf SDL_mixer-1.2.12.tar.gz<br/>
|
|
$ cd SDL_mixer-1.2.12/<br/>
|
|
$ ./configure --prefix=/mingw32 && make && make install
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
</section><!-- H5: SDL_mixer -->
|
|
|
|
<section class="indent"><!-- H5: SDL_Pango -->
|
|
<header>
|
|
<h5>SDL_Pango</h5>
|
|
</header>
|
|
|
|
<p>
|
|
Tout d'abord, vous devrez préparer l'archive source et un patch qui est requis, dans le même répertoire. <ul>
|
|
<li>
|
|
Télécharger <a href="https://sourceforge.net/projects/sdlpango/files/SDL_Pango/0.1.2/SDL_Pango-0.1.2.tar.gz/download">fichier source de SDL_Pango-0.1.2</a> depuis <a href="https://sourceforge.net/projects/sdlpango/">La page SDL_Pango sur Sourceforge.net</a>. </li>
|
|
<li>
|
|
Télécharger <a href="http://johnnypops.co.uk/tuxpaint/SDL_Pango-configure-extra-api.patch">un fichier patch</a> depuis <a href="http://www.johnnypops.co.uk/tuxpaint/">La page web de John Popplewell traitant des "instructions pour la compilation de Tux Paint - MinGW/MSYS"</a>. (Ceci ajoute une fonctionnalité supplémentaire (requise) à SDL_Pango.) </li>
|
|
</ul>
|
|
</p>
|
|
<p>
|
|
Compiler et installer SDL_Pango comme suit. <blockquote>
|
|
<code>
|
|
$ tar zxvf SDL_Pango-0.1.2.tar.gz<br/>
|
|
$ cd SDL_Pango-0.1.2/<br/>
|
|
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch<br/>
|
|
$ ./configure --prefix=/mingw32 && make && make install
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
</section><!-- H5: SDL_Pango -->
|
|
|
|
<section class="indent"><!-- H5: libunibreak -->
|
|
<header>
|
|
<h5>libunibreak</h5>
|
|
</header>
|
|
|
|
<p>
|
|
libunibreak is required for compiling Tux Paint Config. You can skip installing it if you are <em>only</em> building "Tux Paint". </p>
|
|
<p>
|
|
You can fetch the source code from the git repositry and compile it as follows. <blockquote>
|
|
<code>
|
|
$ git clone https://github.com/adah1972/libunibreak libunibreak<br/>
|
|
$ cd libunibreak<br/>
|
|
$ ./augogen.sh --prefix=/mingw32 && make && make install
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
</section><!-- H5: libunibreak -->
|
|
|
|
|
|
</section><!-- H4: Install SDL_Pango... -->
|
|
|
|
</section><!-- H3: Compiling Set-Up -->
|
|
|
|
<section class="indent"><!-- H3: ImageMagick -->
|
|
<header>
|
|
<h3>
|
|
<a name="imagemagick" id="imagemagick">ImageMagick</a>
|
|
</h3>
|
|
</header>
|
|
|
|
<p>
|
|
<a href="https://imagemagick.org">ImageMagick</a> est un ensemble d'outils en ligne de commande pour créer, éditer, composer ou convertir des images bitmap, et qui supporte un grand nombre de formats d'image. Tux Paint utilise deux fonctions ("convert" et "composite") pour générer des vignettes pour les images de démarrage et des modèles durant le process de compilation. </p>
|
|
<p>
|
|
L'utilisation des binaires officiels tirés de "<a href="https://imagemagick.org/script/download.php#windowsand">Versions binaires pour Windows</a>" est recommandée car les commandes installées avec "<code>pacman</code>" sur MinGW/MSYS ne fonctionnent pas comme elles devraient ! </p>
|
|
<p>
|
|
N'oubliez pas de cocher "Installer les utilitaires hérités (par ex. convert)" pour l'installation, car le processus de compilation de Tux Paint les utilise. </p>
|
|
<p>
|
|
Ajoutez le chemin où ImageMagick est installé au début de votre variable d'environnement "PATH". Par exemple : <blockquote>
|
|
<code>
|
|
$ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
<p>
|
|
Vous pouvez rendre ceci permanent en ajoutant ce qui précède à votre fichier de configuration du shell BASH, "<code>~/.bash_profile</code>". </p>
|
|
</section><!-- H3: ImageMagick -->
|
|
|
|
<section class="indent"><!-- H3: Tux Paint -->
|
|
<header>
|
|
<h3>Tux Paint</h3>
|
|
</header>
|
|
|
|
<p>
|
|
Vous pouvez compiler des binaires 64bit en utilisant le shell MSYS2 64bit, et des binaires 32bit en utilisant le shell MSYS2 32bit. </p>
|
|
<ul>
|
|
<li>
|
|
Choisissez "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" dans le "Menu de Démarrage" pour ouvrir le shell 64bit. </li>
|
|
<li>
|
|
Choisissez "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" dans le "Menu de Démarrage" pour ouvrir le shell 32bit. </li>
|
|
</ul>
|
|
<p>
|
|
Compilez Tux Paint avec la commande suivante : <blockquote>
|
|
<code>
|
|
$ make bdist-win32
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
<p class="note">
|
|
<span title="Information">💡</span> <strong>Nota : </strong>À ce stade, vous voudrez compiler "Tux Paint Config". Pour Windows, il peut être ainsi inclus avec "Tux Paint", si vous faites une version officielle (ou de test).La compilation ira chercher un répertoire nommé "<code>tuxpaint-config</code>" (sans numéro de version, par ex voir "<code>tuxpaint-config-X.Y.Z</code>"). Voir le fichier INSTALL.txt de "Tux Paint Config" pour les détails. </p>
|
|
<p>
|
|
Tous les fichiers nécessaires pour démarrer Tux Paint (et Tux Paint Config) sont rassemblés dans le répertoire de la distribution binaire "<code>bdist</code>", répertoire situé sous "<code>win32</code>3. Vous pouvez les démarrer en double-cliquant leurs fichiers exéctutables (<code>.exe</code>) dans le répertoire "<code>bdist</code>". </p>
|
|
</section><!-- H3: Tux Paint -->
|
|
|
|
<section class="indent"><!-- H3: Building the Tux Paint Windows Installer -->
|
|
<header>
|
|
<h3>
|
|
Building the Tux Paint Windows Installer </h3>
|
|
</header>
|
|
|
|
<p>
|
|
<a href="https://jrsoftware.org/isinfo.php">Inno Setup</a> est utilisé pour construire l'installeur exécutable de Tux Paint. Vous devez donc l'installer en premier. </p>
|
|
<p>
|
|
Officiellement Inno Setup prend en compte des traductions dans environ 20 langues. Cependant, un des points majeurs de Tux Paint est qu'il supporte beaucoup de langues. Aussi, le script de mise au point "<code>tuxpaint.iss</code>" qui sert pour construire le programme d'installation est écrit en beaucoup plus de langues, y compris des non-officielles qui sont disponibles sur "<a href="https://jrsoftware.org/files/istrans/">Inno Setup Translations</a>". Vous devez télécharger les fichiers de traduction (<code>.isl</code>) qui sont requis et les mettre dans le répertoire "Languages" sous le répertoire dans lequel Inno Setup est installé. </p>
|
|
<p>
|
|
Before building an installer, edit the "<code>tuxpaint.iss</code>" file and enable one of the lines starting with "<code>#define BuildTarget=</code>", depending on the architecture of the installer you want to create. </p>
|
|
<p>
|
|
Alors, vous pouvez facilement construire un installateur exécutable en cliquant-droit sur l'icône "<code>tuxpaint.iss</code>" du répertoires "<code>win32</code>" et sélectionner "Compile" dans la liste. Cela prendra un certain temps, et éventuellement vous obtiendrez un fichier "<code>tuxpaint-<i>X.Y.Z</i>-windows-<arch>-installer.exe</code>" dans le même répertoire. </p>
|
|
</section><!-- H3: Building the Tux Paint Windows Installer -->
|
|
|
|
<section class="indent"><!-- H3: Running the Tux Paint Windows Installer -->
|
|
<header>
|
|
<h3>
|
|
Running the Tux Paint Windows Installer </h3>
|
|
</header>
|
|
|
|
<p>
|
|
Double-cliquez sur l'exécutable du programme d'installation de Tux Paint (fichier .EXE) et suivez les instructions. </p>
|
|
|
|
<p>
|
|
First, you will be asked to read the license. (It is the GNU General Public License (GPL), which is also available as "COPYING.txt".) </p>
|
|
|
|
<p>
|
|
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.) </p>
|
|
|
|
<p>
|
|
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. </p>
|
|
|
|
<p>
|
|
À ce stade, vous pouvez cliquer sur «Installer» pour installer Tux Paint ! </p>
|
|
</section><!-- H3: Running the Tux Paint Windows Installer -->
|
|
|
|
<section class="indent"><!-- H3: Changing the Settings Using the Shortcut -->
|
|
<header>
|
|
<h3>
|
|
Changing the Settings Using the Shortcut </h3>
|
|
</header>
|
|
|
|
<p>
|
|
Pour modifier les paramètres du programme, cliquez avec le bouton droit sur le raccourci TuxPaint et sélectionnez «Propriétés» (en bas). </p>
|
|
|
|
<p>
|
|
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 : </p>
|
|
|
|
<blockquote>
|
|
<code>
|
|
"C:\Program Files\TuxPaint\TuxPaint.exe"
|
|
</code>
|
|
</blockquote>
|
|
|
|
<p>
|
|
Vous pouvez maintenant ajouter des options de ligne de commande qui seront activées lorsque vous double-cliquez sur l'icône. </p>
|
|
|
|
<p>
|
|
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 : </p>
|
|
|
|
<blockquote>
|
|
<code>
|
|
"C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french
|
|
</code>
|
|
</blockquote>
|
|
|
|
<p>
|
|
(Voir «README.txt» pour une liste complète des options de ligne de commande disponibles.) </p>
|
|
|
|
<p>
|
|
Si vous faites une erreur ou que tout disparaît, utilisez <b><code>[Control]</code></b> + <b><code>[Z]</code></b> pour annuler ou appuyez simplement sur la touche <b><code>[Esc]</code></b> et la boîte se fermera sans aucune modification (sauf si vous avez appuyé sur le bouton "Appliquer" !). </p>
|
|
|
|
<p>
|
|
Quand vous avez fini, appuyez sur "OK". </p>
|
|
</section><!-- H3: Changing the Settings Using the Shortcut -->
|
|
|
|
<section class="indent"><!-- H3: If Something Goes Wrong -->
|
|
<header>
|
|
<h3>
|
|
If Something Goes Wrong </h3>
|
|
</header>
|
|
|
|
<p>
|
|
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é "<code>stderr.txt</code>" dans le dossier TuxPaint. </p>
|
|
|
|
<p>
|
|
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). </p>
|
|
</section><!-- H3: If Something Goes Wrong -->
|
|
</section><!-- H2: Windows -->
|
|
|
|
<section class="indent"><!-- H2: Linux/Unux -->
|
|
<header>
|
|
<h2>
|
|
<a name="compiling-linux" id="compiling-linux">
|
|
Linux/Unix </a>
|
|
</h2>
|
|
</header>
|
|
|
|
<section class="indent"><!-- H3: Compiling -->
|
|
<header>
|
|
<h3>
|
|
Compilation : </h3>
|
|
</header>
|
|
|
|
<p class="note">
|
|
<span title="Information">💡</span> <strong>Note:</strong> Tux Paint does not use <code>autoconf</code>/<code>automake</code>, so there is no "<code>./configure</code>" script to run. Compiling should be straight-forward though, assuming everything Tux Paint needs is installed. </p>
|
|
|
|
<p>
|
|
Pour compiler le programme à partir des sources, lancez simplement la commande suivante après une invite shell (par ex. "$") : </p>
|
|
|
|
<blockquote>
|
|
<code>
|
|
$ make
|
|
</code>
|
|
</blockquote>
|
|
</section><!-- H3: Compiling -->
|
|
|
|
<section class="indent"><!-- H3: Disabling SVG support... -->
|
|
<header>
|
|
<h3>
|
|
Désactivation du support SVG (donc des dépendances Cairo, libSVG, et svg-cairo) </h3>
|
|
</header>
|
|
|
|
<p>
|
|
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épendant), vous pouvez exécuter "<code>make</code>" avec "<code style="white-space: nowrap;">SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG</code>" :
|
|
<blockquote>
|
|
<code>
|
|
$ make SVG_LIB= SVG_CFLAGS=
|
|
</code>
|
|
</blockquote>
|
|
</section><!-- H3: Disabling SVG support... -->
|
|
|
|
<section class="indent"><!-- H3: Disabling Pango support... -->
|
|
<header>
|
|
<h3>
|
|
Désactivation du support Pango (donc des dépendances Pango, Cairo, etc ...) </h3>
|
|
</header>
|
|
|
|
<p class="note">
|
|
<span title="Version variation">📜</span> Avant la version 0.9.18, Tuxpaint utilisait la bibliothèque <code>libSDL_ttf</code> pour gérer les fichiers utilisant les fontes True Type. Depuis la 09.18 <code>libSDL_Pango</code> 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 "<code>make</code>" avec "<code>SDL_PANGO_LIB=</code>" : </p>
|
|
<blockquote>
|
|
<code>
|
|
$ make SDL_PANGO_LIB=
|
|
</code>
|
|
</blockquote>
|
|
</section><!-- H3: Disabling Pango support... -->
|
|
|
|
<section class="indent"><!-- H3: Disabling Sound at Compile-time -->
|
|
<header>
|
|
<h3>
|
|
Disabling Sound at Compile-time </h3>
|
|
</header>
|
|
|
|
<p>
|
|
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 <code>SDL_mixer</code>), vous pouvez exécuter "<code>make</code>" avec "<code>SDL_MIXER_LIB=</code>" comme paramètre : </p>
|
|
<blockquote>
|
|
<code>
|
|
$ make SDL_MIXER_LIB=
|
|
</code>
|
|
</blockquote>
|
|
</section><!-- H3: Disabling Sound at Compile-time -->
|
|
|
|
<section class="indent"><!-- H3: Other options -->
|
|
<header>
|
|
<h3>
|
|
Other options </h3>
|
|
</header>
|
|
|
|
<p>
|
|
Diverses autres options (par exemple, les dossiers d'installation) peuvent être remplacées; voir dans "<code>Makefile</code>" pour plus de détails. </p>
|
|
</section><!-- H3: Other options -->
|
|
|
|
<section class="indent"><!-- H3: If you get errors -->
|
|
<header>
|
|
<h3>
|
|
If you get errors </h3>
|
|
</header>
|
|
|
|
<p>
|
|
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 "<code>-dev</code>" ou "<code>-devel</code>" correspondants, sinon vous ne pourrez pas compiler Tux Paint (et d'autres programmes) provenant des sources ! </p>
|
|
</section><!-- H3: If you get errors -->
|
|
|
|
<section class="indent"><!-- H3: Installing -->
|
|
<header>
|
|
<h3>
|
|
Installng </h3>
|
|
</header>
|
|
|
|
<p>
|
|
En supposant qu'aucune erreur fatale ne se soit 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 : </p>
|
|
|
|
<blockquote>
|
|
<code>
|
|
$ su
|
|
</code>
|
|
</blockquote>
|
|
|
|
<p>
|
|
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 : </p>
|
|
|
|
<blockquote>
|
|
<code>
|
|
# make install
|
|
</code>
|
|
</blockquote>
|
|
|
|
<p>
|
|
Pour finir, vous pouvez revenir sur votre compte utilisateur en sortant du compte superutilisateur : </p>
|
|
|
|
<blockquote>
|
|
<code>
|
|
# exit
|
|
</code>
|
|
</blockquote>
|
|
|
|
<p>
|
|
Autre manière : vous faites simplement utilisation de la commande "sudo" (par ex. sur Ubuntu) : </p>
|
|
|
|
<blockquote>
|
|
<code>
|
|
$ sudo make install
|
|
</code>
|
|
</blockquote>
|
|
|
|
<p class="note">
|
|
<span title="Information">💡</span> <strong>Note:</strong> By default, "<code>tuxpaint</code>", the executable program, is placed in "<code>/usr/local/bin/</code>". The data files (images, sounds, etc.) are placed in "<code>/usr/local/share/tuxpaint/</code>". </p>
|
|
|
|
<section class="indent"><!-- H4: Changing Where Things Go -->
|
|
<header>
|
|
<h4>
|
|
Changer où vont les fichiers </h4>
|
|
</header>
|
|
|
|
<p>
|
|
Vous pouvez changer où iront les fichiers en définissant des variables pour "<code>Makefile</code>" sur la ligne de commande. "<code>DESTDIR</code>" est utilisé pour indiquer la sortie des résultats de la compilation. "<code>PREFIX</code>" est la base où tous les autres fichiers iront et est définie par défaut comme "<code>/usr/local</code>". </p>
|
|
|
|
<p>
|
|
Les autres variables sont : </p>
|
|
<dl>
|
|
<dt><code>BIN_PREFIX</code></dt>
|
|
<dd>
|
|
Où le binaire "<code>tuxpaint</code>" sera installé. (Par défaut "<code>$(PREFIX)/bin</code>", par ex. "<code>/usr/local/bin</code>") </dd>
|
|
|
|
<dt><code>DATA_PREFIX</code></dt>
|
|
<dd>
|
|
Où les fichiers de données (sons, graphiques, pinceaux, tampons, fontes) iront, et où Tux Paint ira les chercher pour tourner (Réglé à "<code>$(PREFIX)/share/tuxpaint</code>") </dd>
|
|
|
|
<dt><code>DOC_PREFIX</code></dt>
|
|
<dd>
|
|
Où sera mise la documentation (les répertoires "<code>docs</code>". 'Réglé à "<code>$(PREFIX)/share/doc/tuxpaint</code>") </dd>
|
|
|
|
<dt><code>MAN_PREFIX</code></dt>
|
|
<dd>
|
|
Où ira la page de manuel de Tuxpaint (Réglé à "<code>$(PREFIX)/share/man</code>") </dd>
|
|
|
|
<dt><code>ICON_PREFIX</code> — <code>$(PREFIX)/share/pixmaps</code></dt>
|
|
<dt><code>X11_ICON_PREFIX</code> — <code>$(PREFIX)/X11R6/include/X11/pixmaps</code></dt>
|
|
<dt><code>GNOME_PREFIX</code> — <code>$(PREFIX)/share/gnome/apps/Graphics</code></dt>
|
|
<dt><code>KDE_PREFIX</code> — <code>$(PREFIX)/share/applnk/Graphics</code></dt>
|
|
<dd>
|
|
Où iront les icônes et les lanceurs (pour GNOME et KDE) </dd>
|
|
|
|
<dt><code>LOCALE_PREFIX</code></dt>
|
|
<dd>
|
|
Où iront les fichiers de traduction, et où Tux Paint ira les chercher. (Réglé à "<code>$(PREFIX)/share/locale/</code>") (la destination finale de la traduction sera dans le répertoire de la locale (par ex "<code>es</code>" pour l'espagnol, dans le sous-répertoire "<code>LC_MESSAGES</code>"). </dd>
|
|
</dl>
|
|
|
|
<p class="note">
|
|
<span title="Information">💡</span> <strong>Note:</strong> This list is out of date. See "<code>Makefile</code>" and "<code>Makefile-i18n</code>" for a complete list. </p>
|
|
</section class="indent"><!-- H4: Changing Where Things Go -->
|
|
</section><!-- H3: Installing -->
|
|
</section><!-- H2: Linux/Unux -->
|
|
|
|
<section class="indent"><!-- H2: macOS -->
|
|
<header>
|
|
<h2>
|
|
<a name="compiling-macos" id="compiling-macos">
|
|
macOS </a>
|
|
</h2>
|
|
<p style="font-size: small;">
|
|
<em>
|
|
juin 5, 2022 Mark Kim <<a href="mailto:markuskimius@gmail.com">markuskimius@gmail.com</a>>
|
|
</em>
|
|
</p>
|
|
</header>
|
|
|
|
<p>
|
|
Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were a Linux application. </p>
|
|
|
|
<section class="indent"><!-- H3: Prerequisites -->
|
|
<header>
|
|
<h3>
|
|
Prérequis </h3>
|
|
</header>
|
|
|
|
<p>
|
|
Bien Tux Paint puisse être construit sans Xcode IDE, ce dernier est toujours nécessaire. <a href="https://developer.apple.com/xcode/ide/">Téléchargez le = partir de l' the App Store</a>, et lancez le une fois pour accepter ses accords de licence. Vous pouvez aussi installer les outils de ligne de commande de Xcode en tapant la commande : <blockquote>
|
|
<code>
|
|
xcode-select --install
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
|
|
<p>
|
|
Construire Tux Paint nécessite plusieurs bibliothèques. Nous les installons à partir de MacPorts quand c'est possible, sinon à partir du code source. Installez MacPorts avec le chemin par défaut <code>/opt/local</code> suivant les instructions données sur leur site : <a href="https://www.macports.org/">https://www.macports.org/</a> <ul>
|
|
<li><code>ImageMagick</code></li>
|
|
<li><code>cairo</code></li>
|
|
<li><code>fribidi</code></li>
|
|
<li><code>lbzip2</code></li>
|
|
<li><code>libimagequant</code><sup>*</sup></li>
|
|
<li><code>libpaper</code></li>
|
|
<li><code>libpng</code></li>
|
|
<li><code>librsvg</code></li>
|
|
<li><code>libsdl</code></li>
|
|
<li><code>libsdl2_image</code></li>
|
|
<li><code>libsdl2_mixer</code></li>
|
|
<li><code>libsdl2_pango</code><sup>*</sup></li>
|
|
<li><code>libsdl2_ttf</code></li>
|
|
<li><code>libsdl2_gfx</code></li>
|
|
<li><code>pkgconfig</code></li>
|
|
<li><code>zlib</code></li>
|
|
</ul>
|
|
... mais vous devriez installer tout paquet requis par la dernière version de Tux Paint.<br/>
|
|
<br/>
|
|
<sup>*</sup> Non disponible depuis MacPorts à ce moment, voir ci-dessous. </p>
|
|
|
|
<section class="indent"><!-- H4: libimagequant -->
|
|
<header>
|
|
<h4>
|
|
libimagequant
|
|
</h4>
|
|
</header>
|
|
|
|
<p>
|
|
<code>libimagequant</code> n'est pas disponible sur MacPorts à cette heure. Il peut être installé sur <code>/opt/local</code> (comme pour MacPorts) pour la bibliothèque devant être incluse dans <code>TuxPaint.dmg</code>. <blockquote>
|
|
<code>
|
|
$ sudo port install rust cargo<br/>
|
|
$ git clone https://github.com/ImageOptim/libimagequant.git<br/>
|
|
$ cd libimagequant/imagequant-sys<br/>
|
|
$ cargo build --release # Must use cargo from MacPorts<br/>
|
|
$ sudo make PREFIX=/opt/local install
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
</section><!-- H4: libimagequant -->
|
|
|
|
<section class="indent"><!-- H4: sdl2_pango -->
|
|
<header>
|
|
<h4>
|
|
sdl2_pango
|
|
</h4>
|
|
</header>
|
|
|
|
<p>
|
|
<code>sdl2_pango</code> is not available from MacPorts as of this writing. It can be installed from the source code as follows. It should be installed to <code>/opt/local</code> (same as MacPorts) for the library to be included in <code>TuxPaint.dmg</code>. <blockquote>
|
|
<code>
|
|
$ git clone https://github.com/markuskimius/SDL2_Pango.git<br/>
|
|
$ cd SDL2_Pango<br/>
|
|
$ ./configure --prefix=/opt/local && make && sudo make install
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
</section><!-- H4: sdl2_pango -->
|
|
|
|
<p>
|
|
<strong>ATTENTION :</strong>Posséder des outils Unix à côté de MacPorts et Xcode, tels que Fink ou Brew, vous empêchera de créer un programme portable. V"rifiez que Fink et Brew ne soient pas accessibles via votre environnement de travail. </p>
|
|
</section><!-- H3: Prerequisites -->
|
|
|
|
<section class="indent"><!-- H3: How to Build -->
|
|
<header>
|
|
<h3>
|
|
Comment construire </h3>
|
|
</header>
|
|
|
|
<p>
|
|
Tapez simplement : <blockquote>
|
|
<code>
|
|
% make<br/>
|
|
% make install
|
|
</code>
|
|
</blockquote>
|
|
... to create the <code>TuxPaint.app</code> application bundle that can be run in-place or copied to <code>/Applications</code>. To create the DMG file for distribution, use 'make TuxPaint.dmg'. </p>
|
|
|
|
<p>
|
|
Additional steps may be required when building for the Apple Silicon. See "Building for Apple Silicon" below. </p>
|
|
</section><!-- H3: How to Build -->
|
|
|
|
<section class="indent"><!-- H3: Known Issues -->
|
|
<header>
|
|
<h3>
|
|
Problèmes connus </h3>
|
|
</header>
|
|
|
|
<ul>
|
|
<li>
|
|
Un binaire macOS construit sur une version spécifique de macOS ne fonctionnera qu'avec cette version, ou une plus récente. Pour s'assurer que Tux Paint puisse tourner sur la plus vieille version de macOS possible, construisez le sur la plus vieille version de macOS disponible. Au moment où nous écrivons Tux Paint ne peut être construit pour tourner sur macOS 10.7 ou plus récent.<br/>
|
|
<br/>
|
|
Voyez "Vieilles Versions de macOS" ci-dessous pour les meilleures instructions pour obtenir, installer et construire Tux Paint sur des vieilles versions de macOS.<br/>
|
|
<br/>
|
|
Alternatively, Tux Paint and all of its library dependencies may be compiled with appropriate options to be runnable on older versions of macOS. These options are already set on Tux Paint, so only its dependencies (from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for the instructions. </li>
|
|
</ul>
|
|
</section><!-- H3: Known Issues -->
|
|
|
|
<section class="indent"><!-- H3: Old Versions of macOS -->
|
|
<header>
|
|
<h3>
|
|
Vieilles versions de macOS </h3>
|
|
</header>
|
|
|
|
<p>
|
|
Quelques vieilles versions de macOS peuvent être téléchargées sur la page d'aide d'Apple : <a href="https://support.apple.com/en-us/HT211683">https://support.apple.com/en-us/HT211683</a> </p>
|
|
|
|
<p>
|
|
macOS for Intel CPU does allow dual booting of multiple versions of the OS, but it's safer and easier to install the old macOS onto a flash drive. Wherever you're installing it, the target drive's partitioniong scheme and partition type must match what the old macOS expects, so use the Disk Utility to partition and format the flash drive accordingly. </p>
|
|
|
|
<p>
|
|
Dual booting multiple versions of macOS for Apple Silicon has been so far unsuccessful. Instead of installing an older version of macOS for Apple Silicon to build Tux Paint to run on the old version of macOS for Apple Silicon, use the instructions found in the "Recompiling MacPorts" section to build Tux Paint to run on older versions of macOS for Apple Silicon. </p>
|
|
|
|
<p>
|
|
À ce moment, l'ancienne version de macOS disponible sur le site d'Apple est la Yosemite 10.10, qui un partitionnement "GPT (GUID Partition Table)" au lieu de MBR, et "Mac OS Extended (Journalisé)" comme type de partition au lieu du nouveau type APFS. </p>
|
|
|
|
<p>
|
|
Au lancement de l'installateur, si vous avez un message disant que macOD est trop vieux ou trop récent pour être installé, un installateur bootable peut être créé en suivant les instructions données ici : <a href="https://support.apple.com/en-mide/HT201372">https://support.apple.com/en-mide/HT201372</a> </p>
|
|
|
|
<p>
|
|
Une fois l'ancienne version de macOS installée, vous pouvez trouver que le Xcode du App Store est trop récent pour tourner sur la version du vieux macOS. Des anciennes versions de Xcode peuvent être téléchargées sur le site des développeurs d'Apple dans une zone accessible après enregistrement gratuit : <a href="https://developer.apple.com/download/more/">https://developer.apple.com/download/more/</a> </p>
|
|
|
|
<p>
|
|
La liste des versions de macOS et de la dernière version de Xcode compatible avec celle-ci a été gentiment mise sur la page Wikipedia sur Xcode : <a href="https://en.wikipedia.org/wiki/Xcode#Version_comparison_table">https://en.wikipedia.org/wiki/Xcode#Table de comparaison des versions</a> </p>
|
|
|
|
<p>
|
|
Comme Xcode a été installé manuellement, vous pouvez sauter l'étape d'installation des outils de commande en terminal (ne pas exécuter "<code style="white-space: nowrap;">xcode-select --install</code>") mais alors vous compilez Tux Paint en utilisant les mêmes étapes décrites auparavant dans ce document. </p>
|
|
</section><!-- H3: Old Versions of macOS -->
|
|
|
|
<section class="indent"><!-- H3: Recompiling MacPorts -->
|
|
<header>
|
|
<h3>
|
|
Recompiling MacPorts </h3>
|
|
</header>
|
|
|
|
<p>
|
|
To recompile MacPorts to be usable on older versions of macOS, set the following options in <code style="white-space: nowrap;">/opt/local/etc/macports/macports.conf</code>: <blockquote>
|
|
<code>
|
|
buildfromsource always<br/>
|
|
macosx_deployment_target 10.10
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
|
|
<p>
|
|
Then uninstall all MacPorts packages: <blockquote>
|
|
<code>
|
|
$ sudo port -fp uninstall installed
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
|
|
<p>
|
|
Then reinstall all MacPorts packages needed by Tux Paint. Also rebuild libimagequant using the updated Cargo package from MacPorts. </p>
|
|
|
|
<p>
|
|
As of this writing, all libraries Tux Paint requires from MacPorts can be recompiled in this manner to run on macOS 10.10 Yosemite and later on Intel CPUs, and macOS 11.0 Big Sur and later on Apple Silicon. Unfortunately, although MacPorts has the option to enable the building of universal libraries, several libraries Tux Paint require cannot be built as universal libraries so they can only be built to run natively on the hardware on which they were built. See "Building a Universal Binary" below for instructions on how to build Tux Paint as a Universal Binary. </p>
|
|
</section><!-- H3: Recompiling MacPorts -->
|
|
|
|
<section class="indent"><!-- H3: Building for Apple Silicon -->
|
|
<header>
|
|
<h3>
|
|
Building for Apple Silicon </h3>
|
|
</header>
|
|
|
|
<p>macOS for Applie Silicon requires all native Apple Silicon applications be signed, even if it is signed "ad-hoc" (anonymously). Because of this, compilers that produce native Apple Silicon applications sign all produced binaries and libraries as a part of the compilation process.<sup>*</sup> However, the Tux Paint compilation process modifies the libraries to be modular (using <code>install_name_tool</code>) so they can be added into the application bundle, which has the unfortunate side effect of breaking the signature. This can be addressed by signing the application bundle ad-hoc (example below) or using your own Apple Developer Identity if you have one. The DMG file, if needed, must be created after signing the App Bundle so the DMG file is created with signed App Bundle: <blockquote>
|
|
<code>
|
|
$ codesign -s - TuxPaint.app<br/>
|
|
$ make TuxPaint.dmg
|
|
</code>
|
|
</blockquote>
|
|
<sup>*</sup> For more information on the code signing requirements on the Apple Silicon, see <a href="https://developer.apple.com/documentation/macos-release-notes/macos-big-sur-11_0_1-universal-apps-release-notes#:~:text=New%20in%20macOS,pass%20through%20Gatekeeper">https://developer.apple.com/documentation/macos-release-notes/macos-big-sur-11_0_1-universal-apps-release-notes#:~:text=New%20in%20macOS,pass%20through%20Gatekeeper</a>. </p>
|
|
<p>If you get an error that the application bundle is already signed, remove it before signing:: <blockquote>
|
|
<code>
|
|
$ codesign --remove-signature TuxPaint.app
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
<p>If you plan to combine the Apple Silicon bundle with the Intel CPU bundle to produce the Universal bundle, the code signing must be done after they are combined. See "Building a Universal Binary" below. </p>
|
|
</section><!-- H3: Building for Apple Silicon -->
|
|
|
|
<section class="indent"><!-- H3: Building a Universal Binary -->
|
|
<header>
|
|
<h3>
|
|
Building a Universal Binary </h3>
|
|
</header>
|
|
|
|
<p>
|
|
To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU and the Apple Silicon separately first. Then rename the app bundle for the Intel CPU to TuxPaint-x86_64.app, and the bundle for the Apple Silicon to TuxPaint-arm64.app, copy the app bundle from the Intel machine to the Apple Silicon machine, then use the provided <code>build-universal.sh</code> script to combine the two application bundles as below. The produced bundle must be signed (see "Building for Apple Silicon" above for more details). The DMG file, if required, must be built after the signing: <blockquote>
|
|
<code>
|
|
$ macos/build-universal.sh<br/>
|
|
$ codesign -s - TuxPaint.app <br/>
|
|
$ make TuxPaint.dmg
|
|
</code>
|
|
</blockquote>
|
|
</p>
|
|
</section><!-- H3: Building a Universal Binary -->
|
|
|
|
</section><!-- H2: macOS -->
|
|
|
|
</section><!-- H1: Compiling and Installation -->
|
|
|
|
<section class="outer indent"><!-- H1: Debugging -->
|
|
<header>
|
|
<h1>
|
|
<a name="debugging" id="debugging">
|
|
Débogage </a>
|
|
</h1>
|
|
</header>
|
|
|
|
<p class="note">
|
|
<span title="Configuration option">⚙</span> Le débogage — vers "STDOUT", avec Linux et Unix, vers un fichier "<code>stdout.txt</code>"avec Windows, et vers le fichier "<code>/tmp/tuxpaint.log</code>" avec macOS — peut être activé en définissant "<code>DEBUG</code>" (et, si un mode verbeux est souhaité, "<code>VERBOSE</code>") <code># define</code> dans "<code>src/debug.h</code>, et en (re)compilant Tux Paint. </p>
|
|
</section><!-- H1: Debugging -->
|
|
|
|
<section class="outer indent"><!-- H1: Uninstalling Tux Paint -->
|
|
<header>
|
|
<h1>
|
|
<a name="uninstalling" id="uninstalling">
|
|
Désinstallation de Tux Paint </a>
|
|
</h1>
|
|
</header>
|
|
|
|
<section class="indent"><!-- H2: Windows -->
|
|
<header>
|
|
<h2>
|
|
<a name="uninstalling-windows" id="uninstalling-windows">
|
|
Windows </a>
|
|
</h2>
|
|
</header>
|
|
|
|
<section class="indent"><!-- H3: Using the Uninstaller -->
|
|
<header>
|
|
<h3>
|
|
Utilisation du désinstalleur </h3>
|
|
</header>
|
|
|
|
<p>
|
|
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'. </p>
|
|
|
|
<p>
|
|
Quand c'est fini, cliquez sur "Fermer". </p>
|
|
</section><!-- H3: Using the Uninstaller -->
|
|
|
|
<section class="indent"><!-- H3: Using the Control Panel -->
|
|
<header>
|
|
<h3>
|
|
En utilisant le panneau de configuration </h3>
|
|
</header>
|
|
|
|
<p>
|
|
Il est également possible d'utiliser l'entrée "TuxPaint (supprimer uniquement)" dans la Section Ajout / Suppression de programmes du Panneau de configuration. </p>
|
|
</section><!-- H3: Using the Control Panel -->
|
|
</section><!-- H2: Windows -->
|
|
|
|
<section class="indent"><!-- H2: macOS -->
|
|
<header>
|
|
<h2>
|
|
<a name="uninstalling-macos" id="uninstalling-macos">
|
|
macOS </a>
|
|
</h2>
|
|
</header>
|
|
|
|
<p>
|
|
Enlevez "<code>TuxPaint.app</code>" du dossier "Applications". Les fichiers de données les fichiers de configuration, les tampons et les images sauvegardées peuvent être trouvées dans "<code style="white-space: nowrap;">/Library/Application Support/TuxPaint</code>" (pour tous les utilisateurs) et "<code style="white-space: nowrap;">/Users/<i>USERNAME</i>/Library/Application Support/TuxPaint</code>" pour les utilisateurs individuels. </p>
|
|
</section><!-- H2: macOS -->
|
|
|
|
<section class="indent"><!-- H2: Linux -->
|
|
<header>
|
|
<h2>
|
|
<a name="uninstalling-linux" id="uninstalling-linux">
|
|
Linux </a>
|
|
</h2>
|
|
</header>
|
|
|
|
<p>
|
|
Dans le répertoire source de Tux Paint (où vous avez compilé Tux Paint), vous pouvez utiliser une cible "<code style="white-space: nowrap;">make uninstall</code>" 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 "<code>PREFIX=...</code>" à "<code>make</code>" et "<code style="white-space: nowrap;">make install</code>", vous ne pourrez pas, et il faudra fournir les mêmes réglages ici. (Voir <a href="#compiling-linux>les instructions d'installation ci-dessus</a> pour plus d'informations.) </p>
|
|
</section><!-- H2: Linux -->
|
|
</section><!-- H1: Uninstalling Tux Paint -->
|
|
</body>
|
|
</html>
|