Sync docs: macOS build info & French translation

h/t Mark & Jacques
This commit is contained in:
Bill Kendrick 2023-08-20 09:27:15 -07:00
parent 89a8cc5efe
commit d570f12f0b
133 changed files with 1094 additions and 1400 deletions

View file

@ -2,7 +2,7 @@
version 0.9.31
Documentation sur l'installation
Copyright © 2002-2023 by divers contributeurs; see AUTHORS.txt.
Copyright © 2002-2023 by divers contributeurs; voir AUTHORS.txt.
https://tuxpaint.org/
mai 13, 2023
@ -34,10 +34,11 @@ Tux Paint nécessite la bibliothèque de couches DirectMedia simple (libSDL), un
bibliothèque de programmation multimédia Open Source disponible sous la Licence
publique générale limitée GNU (LGPL).
Along with libSDL, Tux Paint depends on a number of other SDL 'helper'
libraries: SDL_Image (for graphics files), SDL_gfx (for some graphical
functions, like rotation), SDL_TTF and SDL2_Pango (for True Type Font support)
and, optionally, SDL_Mixer (for sound effects).
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 SDL_Pango (pour
la prise en charge des polices True Type) et, éventuellement, SDL_Mixer (pour
les effets sonores).
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
@ -55,9 +56,9 @@ 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).
💡 Note: When installing libraries from packages, be sure to ALSO install the
development versions of the packages. (For example, install both
"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".)
💡 Remarque :Lors de l'installation à partir de paquets, assurez-vous
d'installer AUSSI les versions de développement des paquets (Par ex. installez
les deux "SDL2-2.24.0.rpm" et "SDL2-2.24.0-devel.rpm".)
Autres bibliothèques
@ -137,7 +138,7 @@ Fonction d'exportation de GIF animés
Outils NetPBM (optionnel) ne sont plus utilisés par défaut
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
@ -176,14 +177,14 @@ MYSYS2
Téléchargez le dernier environnement MSYS2 à partir de https://www.msys2.org/
et installez-le où vous voulez (par défaut "C:\msys64")
Open the MSYS2 shell from the "Start Menu" → "MSYS2 64bit" → "MSYS2 MSYS" and
execute following command:
Ouvrez le shell MSYS2 via le "Menu de Démarrage" →;"MSYS2 64bit" -→ "MSTS2
MSYS" et exécutez la commande suivante :
$ yes "" | pacman -Syu
This will update core system and the window will close automatically. Open the
msys2 shell again and execute following command to finish remaining updating
process.
Ceci mettra à jour tout le système et la fenêtre se fermera automatiquement.
Ouvrez le shell msys2 de nouveau et exécutez la commande suivante pour
finaliser le process restant de mise à jour.
$ yes "" | pacman -Syu
@ -199,10 +200,10 @@ environnement de travail 32bit.
-----------------------------------------------------------
MinGW 64bit (x86_64) compiler and tools
Compilateur MinGW 64bit (x86_64) et outils
Sous le shell MSYS2, exécutez la commande suivante pour installer 64bit
compiler and basic development tools :
Sous le shell MSYS2, exécutez la commande suivante pour installer compilateur
64bit et outils basiques de développement :
$ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
@ -211,7 +212,7 @@ vue de lister les fichiers DLL (.dll) qui leur sont nécessaires. Le process de
fabrication de Tux Paint pour fournir des fichiers binaires s'en sert pour
trouver les fichiers .dll requis.
64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config
bibliothèques de dépendance 64bit (x86_64) pour Tux Paint et Tux Paint Config
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@ -258,10 +259,10 @@ environnement de travail 64bit.
-----------------------------------------------------------
MinGW 32bit (i686) compiler and tools
Compilateur MinGW 32bit (i686) et outils
Sous le shell MSYS2, exécutez la commande suivante pour installer 32bit
compiler and basic development tools :
Sous le shell MSYS2, exécutez la commande suivante pour installer compilateur
32bit et outils basiques de développement :
$ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
@ -270,7 +271,7 @@ vue de lister les fichiers DLL (.dll) qui leur sont nécessaires. Le process de
fabrication de Tux Paint pour fournir des fichiers binaires s'en sert pour
trouver les fichiers .dll requis.
32bit (i686) dependency libraries for Tux Paint and Tux Paint Config
bibliothèques de dépendance 32bit (i686) pour Tux Paint et Tux Paint Config
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@ -353,21 +354,22 @@ want to have it included in your package.
You can use either (a) a stable tar-ball release, or (b) the developing source
tree.
a. Using stable tar-ball release:
+ Download a source tar-ball
a. Utiliser une version tar-ball stable :
+ Télécharger l'ensemble des fichiers sources
+ Expand the tar-ball and change the directory name so that the final
packaging process can find related files.
$ tar zxvf tuxpaint-config-A.B.C.tar.gz
$ mv tuxpaint-config-A.B.C tuxpaint-config
b. Using the developing source tree:
+ Fetch the developing source tree from git repository:
b. Utiliser l'arborescence source en développement :
+ Aller chercher l'arborescence source en développement via le dépôt git
:
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config
tuxpaint-config
Now you can build Tux Paint Config. as follows:
Maintenant vous pouvez faire Tux Paint Config. comme suit :
$ cd tuxpaint-config
$ make win32
@ -377,20 +379,21 @@ Tux Paint
You can use either (a) a stable tar-ball release, or (b) the developing source
tree.
a. Using stable tar-ball release:
+ Download a source tar-ball
a. Utiliser une version tar-ball stable :
+ Télécharger l'ensemble des fichiers sources
+ Expand the tar-ball and change the directory name so that the final
packaging process can find related files.
$ tar zxvf tuxpaint-A.B.C.tar.gz
$ mv tuxpaint-A.B.C tuxpaint
b. Using the developing source tree:
+ Fetch the developing source tree from git repository:
b. Utiliser l'arborescence source en développement :
+ Aller chercher l'arborescence source en développement via le dépôt git
:
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint
Now you can build Tux Paint as follows:
Maintenant vous pouvez faire Tux Paint comme suit :
$ cd tuxpaint
$ make bdist-win32
@ -400,7 +403,7 @@ sont rassemblés dans le répertoire de la distribution binaire "bdist",
répertoire situé sous "win323. Vous pouvez les démarrer en double-cliquant
leurs fichiers exéctutables (.exe) dans le répertoire "bdist".
Building the Tux Paint Windows Installer
Construire l'installateur de Tux Paint sous Windows
Inno Setup est utilisé pour construire l'installeur exécutable de Tux Paint.
Vous devez donc l'installer en premier.
@ -414,9 +417,9 @@ Translations". Vous devez télécharger les fichiers de traduction (.isl) qui
sont requis et les mettre dans le répertoire "Languages" sous le répertoire
dans lequel Inno Setup est installé.
Before building an installer, edit the "tuxpaint.iss" file and enable one of
the lines starting with "#define BuildTarget=", depending on the architecture
of the installer you want to create.
Avant de construire un programme d'installation, éditez le fichier
"tuxpaint.iss" et activez l'une des lignes commençant par "#define BuildTarget=
", en fonction de l'architecture du programme que vous voulez créer.
Alors, vous pouvez facilement construire un installateur exécutable en
cliquant-droit sur l'icône "tuxpaint.iss" du répertoires "win32" et
@ -424,7 +427,7 @@ sélectionner "Compile" dans la liste. Cela prendra un certain temps, et
éventuellement vous obtiendrez un fichier "tuxpaint-X.Y.Z-windows-<arch>
-installer.exe" dans le même répertoire.
Running the Tux Paint Windows Installer
Utiliser l'installateur de Tux Paint sous Windows
Double-cliquez sur l'exécutable du programme d'installation de Tux Paint
(fichier .EXE) et suivez les instructions.
@ -442,7 +445,7 @@ choisissez un autre emplacement.
À ce stade, vous pouvez cliquer sur «Installer» pour installer Tux Paint !
Changing the Settings Using the Shortcut
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).
@ -471,7 +474,7 @@ aucune modification (sauf si vous avez appuyé sur le bouton "Appliquer" !).
Quand vous avez fini, appuyez sur "OK".
If Something Goes Wrong
Si quelque chose ne va pas
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it
is probably because some of these command-line options are wrong. Open an
@ -506,7 +509,7 @@ exécuter "make" avec "SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG" :
$ make SVG_LIB= SVG_CFLAGS=
Disabling Sound at Compile-time
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"
@ -514,12 +517,12 @@ avec "SDL_MIXER_LIB=" comme paramètre :
$ make SDL_MIXER_LIB=
Other options
Autres options
Diverses autres options (par exemple, les dossiers d'installation) peuvent être
remplacées; voir dans "Makefile" pour plus de détails.
If you get errors
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
@ -528,7 +531,7 @@ 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 !
Installng
Installation
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
@ -677,11 +680,11 @@ Tapez simplement :
% make install
... to create the TuxPaint.app application bundle that can be run in-place or
copied to /Applications. To create the DMG file for distribution, use 'make
TuxPaint.dmg'.
copied to /Applications. Pour créer le fichier DMG pour la distribution, faites
'make TuxPaint.dmg'.
Additional steps may be required when building for the Apple Silicon. See
"Building for Apple Silicon" below.
Additional steps are required when building a Unviersal Binary. See "Building a
Universal Binary" below.
Problèmes connus
@ -744,7 +747,7 @@ d'installation des outils de commande en terminal (ne pas exécuter
"xcode-select --install") mais alors vous compilez Tux Paint en utilisant les
mêmes étapes décrites auparavant dans ce document.
Recompiling MacPorts
Recompiler MacPorts
To recompile MacPorts to be usable on older versions of macOS, set the
following options in /opt/local/etc/macports/macports.conf:
@ -752,7 +755,7 @@ following options in /opt/local/etc/macports/macports.conf:
buildfromsource always
macosx_deployment_target 10.10
Then uninstall all MacPorts packages:
Ensuite désinstaller tous les paquets MacPorts :
$ sudo port -fp uninstall installed
@ -768,49 +771,16 @@ 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.
Building for Apple Silicon
macOS for Apple 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.^* However, the Tux Paint
compilation process modifies the libraries to be modular (using
install_name_tool) 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:
$ codesign -s - TuxPaint.app
$ make TuxPaint.dmg
^* For more information on the code signing requirements on the Apple Silicon,
see 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.
If you get an error that the application bundle is already signed, remove it
before signing:
$ codesign --remove-signature TuxPaint.app
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.
Building a Universal Binary
Créer un Binaire Universel
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 build-universal.sh 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:
two application bundles as below. The DMG file can be built afterwards:
$ macos/build-universal.sh
$ codesign -s - TuxPaint.app
$ make TuxPaint.dmg
-----------------------------------------------------------------------
@ -826,7 +796,7 @@ Detailed instructions are there; this acts as an overview.
Prérequis
You will need recent versions of:
Vous avez besoin des versions récentes de :
* Gradle — build automation tool
* Android Studio (Software Development Kit (SDK)) — to support Android app
@ -849,7 +819,7 @@ one another, and the script in the directory containing both.
Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint
&& ./mkzip_assets.sh
Building
Construire
The Gradle build generates some variants: PlayStore, debugPlayStore,
offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able
@ -886,14 +856,14 @@ Prérequis
Install the required develop packages in Terminal:
32-bit:
32-bit :
pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel
libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl
libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel
libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel
sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel
64-bit:
64-bit :
pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel
libimagequant_devel gettext_libintl libpaper_devel pango_devel
libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel
@ -903,11 +873,11 @@ Install the required develop packages in Terminal:
For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with
setarch x86
Building
Construire
make PREFIX=/boot/home/config/non-packaged
Tux Paint Stamps
Tampons pour Tux Paint
make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/
@ -941,7 +911,7 @@ macOS
Enlevez "TuxPaint.app" du dossier "Applications". Les fichiers de données les
fichiers de configuration, les tampons et les images sauvegardées peuvent être
trouvées dans "/Library/Application Support/TuxPaint" (pour tous les
trouvées dans "/Bibliothèque/Support d'Application/Tux Paint" (pour tous les
utilisateurs) et "/Users/USERNAME/Library/Application Support/TuxPaint" pour
les utilisateurs individuels.