notgne2/tuxpaint-pencil-sharpener
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge branch 'master' into sdl2.0

Browse source
This commit is contained in:
Bill Kendrick 2022-07-08 23:44:54 -07:00
commit fe4d113c81
40 changed files with 1329 additions and 1120 deletions
Download patch file Download diff file Expand all files Collapse all files

186
docs/en/INSTALL.txt
View file

@ -5,7 +5,7 @@
Copyright © 2002-2022 by various contributors; see AUTHORS.txt. Copyright © 2002-2022 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/ https://tuxpaint.org/
June 4, 2022 July 8, 2022
+----------------------------------------------------+ +----------------------------------------------------+
|Table of Contents | |Table of Contents |
@ -144,8 +144,7 @@ Simple DirectMedia Layer library (libSDL)
Windows Windows
May 16, 2022 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp July 8, 2022 Shin-ichi TOYAMA <dolphin6k@wmail.plala.or.jp>
<dolphin6k@wmail.plala.or.jp>
Compiling Set-Up Compiling Set-Up
@ -153,29 +152,34 @@ Windows
includes support for building on a Windows system using MinGW/MSYS includes support for building on a Windows system using MinGW/MSYS
(https://sourceforge.net/projects/msys2/). (https://sourceforge.net/projects/msys2/).
💡 Note: This documentation relates to the SDL2.0 version of Tux Paint,
which became available starting with version 0.9.28 in June 2022.
Many tools and libraries are required to build Tux Paint. The package Many tools and libraries are required to build Tux Paint. The package
management system "pacman" helps you install them automatically solving management system "pacman" helps you install them automatically solving
complicated dependencies. complicated dependencies.
Download the latest MSYS2 environment from MYSYS2
https://sourceforge.net/projects/msys2/files/Base/ and install it where
you'd like (the default is "C:\msys64") Download the latest MSYS2 environment from https://www.msys2.org/ and
install it where you'd like (the default is "C:\msys64")
Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" -> "MSYS2 Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" -> "MSYS2
MSYS" and execute following command (press [Enter] or [Return] to accept MSYS" and execute following command:
the defaults for all questions):
pacman -Syu $ yes "" | pacman -Syu
This will update core system and the window will close automatically. This will update core system and the window will close automatically. Open
Repeat the steps above one more time to finish the remaining update the msys2 shell again and execute following command to finish remaining
process. updating process.
$ yes "" | pacman -Syu
Within the MSYS2 shell, run the following command to install basic Within the MSYS2 shell, run the following command to install basic
development tools: development tools:
pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git
gperf zip patch gperf dos2unix
Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip to 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 the "MinGW 32bit (i686) toolchains" section if you need only a 32bit build
@ -188,7 +192,7 @@ Windows
Within the MSYS2 shell, run the following command to install 64bit Within the MSYS2 shell, run the following command to install 64bit
compiler and basic development tools: compiler and basic development tools:
pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
"ntldd" is a small tool which examine windows executable files to list "ntldd" is a small tool which examine windows executable files to list
Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging
@ -197,53 +201,33 @@ Windows
64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config
You can install tools and libraries required for compiling Tux Paint and You can install tools and libraries required for compiling Tux Paint and
Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL_mixer, Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
SDL_Pango and libunibreak. libunibreak.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can
skip installing it if you are only building "Tux Paint". skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx}
$ pacman -S mingw-w64-x86_64-libvorbis $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk}
$ 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
💡 Note: Close the shell before proceeding to the remaining process. 💡 Note: Close the shell before proceeding to the remaining process.
Install SDL_mixer, SDL_Pango and libunibreak on the 64bit environment Install SDL2_Pango and libunibreak on the 64bit environment
SDL_mixer, SDL_Pango and libunibreak should be installed manually. SDL2_Pango and libunibreak should be installed manually.
This time, use the MinGW "64bit" shell. Open the shell from the "Start This time, use the MinGW "64bit" shell. Open the shell from the "Start
Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit"
SDL_mixer
Download source tar-ball of SDL_mixer-1.2.12 from SDL_mixer's page.
Build and install SDL_mixer as follows.
$ tar zxvf SDL_mixer-1.2.12.tar.gz
$ cd SDL_mixer-1.2.12/
$ ./configure --prefix=/mingw64 && make && make install
SDL_Pango SDL_Pango
At first, you have to prepare source tar-ball and a required patch in the Download a patch from z1.plala.jp, which enable SDL2_Pango to create dlls,
same directory. then build and install SDL2_Pango as follows.
* 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. $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch
$ git clone https://github.com/markuskimius/SDL2_Pango
$ tar zxvf SDL_Pango-0.1.2.tar.gz $ cd SDL2_Pango
$ cd SDL_Pango-0.1.2/ $ patch -p0 < ../SDL2_Pango-dll.patch
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw64 && make && make install $ ./configure --prefix=/mingw64 && make && make install
libunibreak libunibreak
@ -268,7 +252,7 @@ Windows
Within the MSYS2 shell, run the following command to install 32bit Within the MSYS2 shell, run the following command to install 32bit
compiler and basic development tools: compiler and basic development tools:
pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
"ntldd" is a small tool which examine windows executable files to list "ntldd" is a small tool which examine windows executable files to list
Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging
@ -277,53 +261,33 @@ Windows
32bit (i686) dependency libraries for Tux Paint and Tux Paint Config 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config
You can install tools and libraries required for compiling Tux Paint and You can install tools and libraries required for compiling Tux Paint and
Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL_mixer, Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
SDL_Pango and libunibreak. libunibreak.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can
skip installing it if you are only building "Tux Paint". skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}
$ pacman -S mingw-w64-i686-libvorbis $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk}
$ pacman -S mingw-w64-i686-librsvg
$ pacman -S mingw-w64-i686-fribidi
$ pacman -S mingw-w64-i686-libimagequant
$ pacman -S mingw-w64-i686-fltk
💡 Note: Close the shell before proceeding to the remaining process. 💡 Note: Close the shell before proceeding to the remaining process.
Install SDL_mixer, SDL_Pango and libunibreak on the 32bit environment Install SDL2_Pango and libunibreak on the 32bit environment
SDL_mixer, SDL_Pango and libunibreak should be installed manually. SDL2_Pango and libunibreak should be installed manually.
This time, use the MinGW "32bit" shell. Open the shell from the "Start This time, use the MinGW "32bit" shell. Open the shell from the "Start
Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit"
SDL_mixer
Download source tar-ball of SDL_mixer-1.2.12 from SDL_mixer's page.
Build and install SDL_mixer as follows.
$ tar zxvf SDL_mixer-1.2.12.tar.gz
$ cd SDL_mixer-1.2.12/
$ ./configure --prefix=/mingw32 && make && make install
SDL_Pango SDL_Pango
At first, you have to prepare source tar-ball and a required patch in the Download a patch from z1.plala.jp, which enable SDL2_Pango to create dlls,
same directory. then build and install SDL2_Pango as follows.
* 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. $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch
$ git clone https://github.com/markuskimius/SDL2_Pango
$ tar zxvf SDL_Pango-0.1.2.tar.gz $ cd SDL2_Pango
$ cd SDL_Pango-0.1.2/ $ patch -p0 < ../SDL2_Pango-dll.patch
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw32 && make && make install $ ./configure --prefix=/mingw32 && make && make install
libunibreak libunibreak
@ -361,27 +325,66 @@ Windows
You can make this permanent by adding the above to your the BASH shell You can make this permanent by adding the above to your the BASH shell
configuration file, "~/.bash_profile". configuration file, "~/.bash_profile".
Tux Paint Tux Paint & Tux Paint Config.
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit binaries You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit
using MSYS2 32bit shell, respectively. binaries using "MSYS2 32bit" shell, respectively.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start Menu" to * Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start Menu" to
open the 64bit shell. open the 64bit shell.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start Menu" to * Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start Menu" to
open the 32bit shell. open the 32bit shell.
Compile Tux Paint with the following command: Tux Paint Config.
"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's
behavior. You have to build this component before compiling Tux Paint if
you 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
* 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:
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config
tuxpaint-config
Now you can build Tux Paint Config. as follows:
$ cd tuxpaint-config
$ make win32
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
* 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-sdl2.tar.gz
$ mv tuxpaint-A.B.C-sdl2 tuxpaint-sdl2
b. Using the developing source tree:
* Fetch the developing source tree from git repository:
$ git clone -b sdl2.0
https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint-sdl2
Now you can build Tux Paint as follows:
$ cd tuxpaint-sdl2
$ make bdist-win32 $ 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 All the files needed for starting Tux Paint (and Tux Paint Config.) are
collected in the directory for binary distribution "bdist" directory under collected in the directory for binary distribution "bdist" directory under
"win32". You can start them by double-clicking their executable (.exe) "win32". You can start them by double-clicking their executable (.exe)
@ -407,7 +410,8 @@ Windows
Then, you can easily build an executable installer by right-clicking on Then, you can easily build an executable installer by right-clicking on
the "tuxpaint.iss" icon in the "win32" directory and selecting "Compile" 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 on the list. It will run for a while, and eventually you will find a
"tuxpaint-X.Y.Z-windows-<arch>-installer.exe" file in the same directory. "tuxpaint-X.Y.Z-windows-sdl2.0-<arch>-installer.exe" file in the same
directory.
Running the Tux Paint Windows Installer Running the Tux Paint Windows Installer
@ -604,7 +608,7 @@ macOS
once to accept its license agreements. You may also need to install the once to accept its license agreements. You may also need to install the
Xcode command line tools using the command: Xcode command line tools using the command:
xcode-select --install $ xcode-select --install
Building Tux Paint also requires various libraries. We install them from Building Tux Paint also requires various libraries. We install them from
MacPorts where possible, source code otherwise. Install MacPorts to the MacPorts where possible, source code otherwise. Install MacPorts to the

2
docs/en/html/EXTENDING.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

290
docs/en/html/INSTALL.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }
@ -96,7 +96,7 @@
</p> </p>
<p> <p>
June 4, 2022 </p> July 8, 2022 </p>
</center> </center>
</header> </header>
@ -301,7 +301,7 @@
<p style="font-size: small;"> <p style="font-size: small;">
<em> <em>
May 16, 2022 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp &lt;<a href="mailto:dolphin6k@wmail.plala.or.jp">dolphin6k@wmail.plala.or.jp</a>&gt; July 8, 2022 Shin-ichi TOYAMA &lt;<a href="mailto:dolphin6k@wmail.plala.or.jp">dolphin6k@wmail.plala.or.jp</a>&gt;
</em> </em>
</p> </p>
</header> </header>
@ -314,35 +314,48 @@
<p> <p>
As of February 2005 (starting with Tux Paint 0.9.15), the "<code>Makefile</code>" includes support for building on a Windows system using MinGW/MSYS (<a href="https://sourceforge.net/projects/msys2/">https://sourceforge.net/projects/msys2/</a>). </p> As of February 2005 (starting with Tux Paint 0.9.15), the "<code>Makefile</code>" includes support for building on a Windows system using MinGW/MSYS (<a href="https://sourceforge.net/projects/msys2/">https://sourceforge.net/projects/msys2/</a>). </p>
<p class="note">
<span title="Information">&#128161;</span> <strong>Note:</strong> This documentation relates to the SDL2.0 version of Tux Paint, which became available starting with version 0.9.28 in June 2022. </p>
<p> <p>
Many tools and libraries are required to build Tux Paint. The package management system "<code>pacman</code>" helps you install them automatically solving complicated dependencies. </p> Many tools and libraries are required to build Tux Paint. The package management system "<code>pacman</code>" helps you install them automatically solving complicated dependencies. </p>
<p> <section class="indent"><!-- H4: MSYS2 -->
Download the latest MSYS2 environment from <a href="https://sourceforge.net/projects/msys2/files/Base/">https://sourceforge.net/projects/msys2/files/Base/</a> and install it where you'd like (the default is "<code>C:\msys64</code>") </p> <header>
<p> <h4>MYSYS2</h4>
Open the MSYS2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command (press <b><code>[Enter]</code></b> or <b><code>[Return]</code></b> to accept the defaults for all questions): </header>
<blockquote>
<code>
pacman -Syu
</code>
</blockquote>
</p>
<p> <p>
This will update core system and the window will close automatically. Repeat the steps above one more time to finish the remaining update process. </p> Download the latest MSYS2 environment from <a href="https://www.msys2.org/">https://www.msys2.org/</a> and install it where you'd like (the default is "<code>C:\msys64</code>") </p>
<p>
<p> Open the MSYS2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command: <blockquote>
Within the MSYS2 shell, run the following command to install basic development tools: <blockquote> <code>
<code> $ yes "" | pacman -Syu
pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch gperf </code>
</code> </blockquote>
</blockquote> </p>
</p>
<p>
<p> 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. <blockquote>
<i> <code>
Proceed to the next "<a href="#64bit">MinGW 64bit (x86_64) toolchains</a>" section, or skip to the "<a href="#32bit">MinGW 32bit (i686) toolchains</a>" section if you need only a 32bit build environment. </i> $ yes "" | pacman -Syu
</p> </code>
</blockquote>
</p>
<p>
Within the MSYS2 shell, run the following command to install basic development tools: <blockquote>
<code>
$ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch gperf dos2unix
</code>
</blockquote>
</p>
<p>
<i>
Proceed to the next "<a href="#64bit">MinGW 64bit (x86_64) toolchains</a>" section, or skip to the "<a href="#32bit">MinGW 32bit (i686) toolchains</a>" section if you need only a 32bit build environment. </i>
</p>
</section>
<hr size="1" noshade width="75%" /> <hr size="1" noshade width="75%" />
<section class="indent"><!-- H4: MinGW...compiler and tools --> <section class="indent"><!-- H4: MinGW...compiler and tools -->
@ -356,7 +369,7 @@
<p> <p>
Within the MSYS2 shell, run the following command to install 64bit compiler and basic development tools: <blockquote> Within the MSYS2 shell, run the following command to install 64bit compiler and basic development tools: <blockquote>
<code> <code>
pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -371,18 +384,14 @@
</header> </header>
<p> <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> You can install tools and libraries required for compiling Tux Paint and Tux Paint Config on MSYS2/MINGW using "<code>pacman</code>" except for SDL2_Pango and libunibreak. </p>
<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> 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> <p>
<blockquote> <blockquote>
<code> <code>
$ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx}<br/> $ 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,fribidi,libimagequant,fltk}<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> </code>
</blockquote> </blockquote>
</p> </p>
@ -393,52 +402,27 @@
<section class="indent"><!-- H4: Install SDL_Pango... --> <section class="indent"><!-- H4: Install SDL_Pango... -->
<header> <header>
<h4> <h4>
Install SDL_mixer, SDL_Pango and libunibreak on the 64bit environment </h4> Install SDL2_Pango and libunibreak on the 64bit environment </h4>
</header> </header>
<p> <p>
SDL_mixer, SDL_Pango and libunibreak should be installed manually. </p> SDL2_Pango and libunibreak should be installed manually. </p>
<p> <p>
This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" </p> This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" </p>
<section class="indent"><!-- H5: SDL_mixer --> <section class="indent"><!-- H5: SDL2_Pango -->
<header>
<h5>SDL_mixer</h5>
</header>
<p>
Download <a href="https://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.12.tar.gz">source tar-ball of SDL_mixer-1.2.12</a> from <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 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</section><!-- H5: SDL_mixer -->
<section class="indent"><!-- H5: SDL_Pango -->
<header> <header>
<h5>SDL_Pango</h5> <h5>SDL_Pango</h5>
</header> </header>
<p> <p>
At first, you have to prepare source tar-ball and a required patch in the same directory. <ul> Download <a href="https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch">a patch</a> from <a href="https://z1.plala.jp/tuxpaint/buildwin.html">z1.plala.jp</a>, which enable SDL2_Pango to create dlls, then build and install SDL2_Pango as follows. <blockquote>
<li>
Download <a href="https://sourceforge.net/projects/sdlpango/files/SDL_Pango/0.1.2/SDL_Pango-0.1.2.tar.gz/download">source tar-ball of SDL_Pango-0.1.2</a> from <a href="https://sourceforge.net/projects/sdlpango/">SDL_Pango's page on Sourceforge.net</a>. </li>
<li>
Download <a href="http://johnnypops.co.uk/tuxpaint/SDL_Pango-configure-extra-api.patch">a patch file</a> from <a href="http://www.johnnypops.co.uk/tuxpaint/">John Popplewell's "Tux Paint - MinGW/MSYS build instructions" webpage</a>. (This adds some extra (required) functionality to SDL_Pango.) </li>
</ul>
</p>
<p>
Build and install SDL_Pango as follows. <blockquote>
<code> <code>
$ tar zxvf SDL_Pango-0.1.2.tar.gz<br/> $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch<br/>
$ cd SDL_Pango-0.1.2/<br/> $ git clone https://github.com/markuskimius/SDL2_Pango<br/>
$ patch -p0 &lt; ../SDL_Pango-configure-extra-api.patch<br/> $ cd SDL2_Pango<br/>
$ ./configure --prefix=/mingw64 &amp;&amp; make &amp;&amp; make install $ patch -p0 &lt; ../SDL2_Pango-dll.patch<br/>
$ ./configure --prefix=/mingw64 &amp;&amp; make &amp;&amp; make install<br/>
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -481,7 +465,7 @@
<p> <p>
Within the MSYS2 shell, run the following command to install 32bit compiler and basic development tools: <blockquote> Within the MSYS2 shell, run the following command to install 32bit compiler and basic development tools: <blockquote>
<code> <code>
pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -496,18 +480,14 @@
</header> </header>
<p> <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> You can install tools and libraries required for compiling Tux Paint and Tux Paint Config on MSYS2/MINGW using "<code>pacman</code>" except for SDL2_Pango and libunibreak. </p>
<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> 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> <p>
<blockquote> <blockquote>
<code> <code>
$ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}<br/> $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}<br/>
$ pacman -S mingw-w64-i686-libvorbis<br/> $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk}<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> </code>
</blockquote> </blockquote>
</p> </p>
@ -518,52 +498,27 @@
<section class="indent"><!-- H4: Install SDL_Pango... --> <section class="indent"><!-- H4: Install SDL_Pango... -->
<header> <header>
<h4> <h4>
Install SDL_mixer, SDL_Pango and libunibreak on the 32bit environment </h4> Install SDL2_Pango and libunibreak on the 32bit environment </h4>
</header> </header>
<p> <p>
SDL_mixer, SDL_Pango and libunibreak should be installed manually. </p> SDL2_Pango and libunibreak should be installed manually. </p>
<p> <p>
This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" </p> This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" </p>
<section class="indent"><!-- H5: SDL_mixer --> <section class="indent"><!-- H5: SDL2_Pango -->
<header>
<h5>SDL_mixer</h5>
</header>
<p>
Download <a href="https://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.12.tar.gz">source tar-ball of SDL_mixer-1.2.12</a> from <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 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</section><!-- H5: SDL_mixer -->
<section class="indent"><!-- H5: SDL_Pango -->
<header> <header>
<h5>SDL_Pango</h5> <h5>SDL_Pango</h5>
</header> </header>
<p> <p>
At first, you have to prepare source tar-ball and a required patch in the same directory. <ul> Download <a href="https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch">a patch</a> from <a href="https://z1.plala.jp/tuxpaint/buildwin.html">z1.plala.jp</a>, which enable SDL2_Pango to create dlls, then build and install SDL2_Pango as follows. <blockquote>
<li>
Download <a href="https://sourceforge.net/projects/sdlpango/files/SDL_Pango/0.1.2/SDL_Pango-0.1.2.tar.gz/download">source tar-ball of SDL_Pango-0.1.2</a> from <a href="https://sourceforge.net/projects/sdlpango/">SDL_Pango's page on Sourceforge.net</a>. </li>
<li>
Download <a href="http://johnnypops.co.uk/tuxpaint/SDL_Pango-configure-extra-api.patch">a patch file</a> from <a href="http://www.johnnypops.co.uk/tuxpaint/">John Popplewell's "Tux Paint - MinGW/MSYS build instructions" webpage</a>. (This adds some extra (required) functionality to SDL_Pango.) </li>
</ul>
</p>
<p>
Build and install SDL_Pango as follows. <blockquote>
<code> <code>
$ tar zxvf SDL_Pango-0.1.2.tar.gz<br/> $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch<br/>
$ cd SDL_Pango-0.1.2/<br/> $ git clone https://github.com/markuskimius/SDL2_Pango<br/>
$ patch -p0 &lt; ../SDL_Pango-configure-extra-api.patch<br/> $ cd SDL2_Pango<br/>
$ ./configure --prefix=/mingw32 &amp;&amp; make &amp;&amp; make install $ patch -p0 &lt; ../SDL2_Pango-dll.patch<br/>
$ ./configure --prefix=/mingw32 &amp;&amp; make &amp;&amp; make install<br/>
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -602,7 +557,7 @@
<p> <p>
<a href="https://imagemagick.org">ImageMagick</a> 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. </p> <a href="https://imagemagick.org">ImageMagick</a> 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. </p>
<p> <p>
Using official binary release available from "<a href="https://imagemagick.org/script/download.php#windowsand">Windows Binary Release</a>" is recommended, due to the commands installed with "<code>pacman</code>" on MinGW/MSYS not working as expected! </p> Using official binary release available from "<a href="https://imagemagick.org/script/download.php#windows">Windows Binary Release</a>" is recommended, due to the commands installed with "<code>pacman</code>" on MinGW/MSYS not working as expected! </p>
<p> <p>
Do not forget to enable "Install legacy utilities (e.g. convert)" while installing it, because Tux Paint's build process uses them. </p> Do not forget to enable "Install legacy utilities (e.g. convert)" while installing it, because Tux Paint's build process uses them. </p>
<p> <p>
@ -616,31 +571,114 @@
You can make this permanent by adding the above to your the BASH shell configuration file, "<code>~/.bash_profile</code>". </p> You can make this permanent by adding the above to your the BASH shell configuration file, "<code>~/.bash_profile</code>". </p>
</section><!-- H3: ImageMagick --> </section><!-- H3: ImageMagick -->
<section class="indent"><!-- H3: Tux Paint --> <section class="indent"><!-- H3: Tux Paint & Tux Paint Config. -->
<header> <header>
<h3>Tux Paint</h3> <h3>Tux Paint &amp; Tux Paint Config.</h3>
</header> </header>
<p> <p>
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit binaries using MSYS2 32bit shell, respectively. </p> You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries using "MSYS2 32bit" shell, respectively. </p>
<ul> <ul>
<li> <li>
Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" from the "Start Menu" to open the 64bit shell. </li> Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" from the "Start Menu" to open the 64bit shell. </li>
<li> <li>
Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" from the "Start Menu" to open the 32bit shell. </li> Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" from the "Start Menu" to open the 32bit shell. </li>
</ul> </ul>
<p>
Compile Tux Paint with the following command: <blockquote> <section class="indent"><!-- H4: Tux Paint Config. -->
<code> <header>
$ make bdist-win32 <h4>Tux Paint Config.</h4>
</code> </header>
</blockquote> <p>
</p> "Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's behavior. You have to build this component before compiling Tux Paint if you want to have it included in your package. </p>
<p class="note"> <p>
<span title="Information">&#128161;</span> <strong>Note:</strong> 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 "<code>tuxpaint-config</code>" (with no version number, e.g., "<code>tuxpaint-config-X.Y.Z</code>"). See "Tux Paint Config."'s INSTALL.txt documentation for details. </p> You can use either (a) a stable tar-ball release, or (b) the developing source tree. <ol type="a">
<li>
Using stable tar-ball release: <ul>
<li>
<a href="https://sourceforge.net/projects/tuxpaint/files/tuxpaint-config/">Download a source tar-ball</a>
</li>
<li>
Expand the tar-ball and change the directory name so that the final packaging process can find related files. <blockquote>
<code>
$ tar zxvf tuxpaint-config-A.B.C.tar.gz<br/>
$ mv tuxpaint-config-A.B.C tuxpaint-config<br/>
</code>
</blockquote>
</li>
</ul>
</li>
<li>
Using the developing source tree: <ul>
<li>
Fetch the developing source tree from git repository: <blockquote>
<code>
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config tuxpaint-config
</code>
</blockquote>
</li>
</ul>
</li>
</ol>
</p>
<p>
Now you can build Tux Paint Config. as follows: <blockquote>
<code>
$ cd tuxpaint-config<br/>
$ make win32<br/>
</code>
</blockquote>
</p>
</section><!-- H4: Tux Paint Config. -->
<section class="indent"><!-- H4: Tux Paint -->
<header>
<h4>Tux Paint</h4>
</header>
<p>
You can use either (a) a stable tar-ball release, or (b) the developing source tree. <ol type="a">
<li>
Using stable tar-ball release: <ul>
<li>
<a href="https://sourceforge.net/projects/tuxpaint/files/tuxpaint/">Download a source tar-ball</a>
</li>
<li>
Expand the tar-ball and change the directory name so that the final packaging process can find related files. <blockquote>
<code>
$ tar zxvf tuxpaint-A.B.C-sdl2.tar.gz<br/>
$ mv tuxpaint-A.B.C-sdl2 tuxpaint-sdl2<br/>
</code>
</blockquote>
</li>
</ul>
</li>
<li>
Using the developing source tree: <ul>
<li>
Fetch the developing source tree from git repository: <blockquote>
<code>
$ git clone -b sdl2.0 https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint-sdl2
</code>
</blockquote>
</li>
</ul>
</li>
</ol>
</p>
<p>
Now you can build Tux Paint as follows: <blockquote>
<code>
$ cd tuxpaint-sdl2<br/>
$ make bdist-win32<br/>
</code>
</blockquote>
</p>
</section><!-- H4: Tux Paint -->
<p> <p>
All the files needed for starting Tux Paint (and Tux Paint Config.) are collected in the directory for binary distribution "<code>bdist</code>" directory under "<code>win32</code>". You can start them by double-clicking their executable (<code>.exe</code>) files in the "<code>bdist</code>" directory. </p> All the files needed for starting Tux Paint (and Tux Paint Config.) are collected in the directory for binary distribution "<code>bdist</code>" directory under "<code>win32</code>". You can start them by double-clicking their executable (<code>.exe</code>) files in the "<code>bdist</code>" directory. </p>
</section><!-- H3: Tux Paint --> </section><!-- H3: Tux Paint & Tux Paint Config. -->
<section class="indent"><!-- H3: Building the Tux Paint Windows Installer --> <section class="indent"><!-- H3: Building the Tux Paint Windows Installer -->
<header> <header>
@ -655,7 +693,7 @@
<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> 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> <p>
Then, you can easily build an executable installer by right-clicking on the "<code>tuxpaint.iss</code>" icon in the "<code>win32</code>" directory and selecting "Compile" on the list. It will run for a while, and eventually you will find a "<code>tuxpaint-<i>X.Y.Z</i>-windows-&lt;arch&gt;-installer.exe</code>" file in the same directory. </p> Then, you can easily build an executable installer by right-clicking on the "<code>tuxpaint.iss</code>" icon in the "<code>win32</code>" directory and selecting "Compile" on the list. It will run for a while, and eventually you will find a "<code>tuxpaint-<i>X.Y.Z</i>-windows-sdl2.0-&lt;arch&gt;-installer.exe</code>" file in the same directory. </p>
</section><!-- H3: Building the Tux Paint Windows Installer --> </section><!-- H3: Building the Tux Paint Windows Installer -->
<section class="indent"><!-- H3: Running the Tux Paint Windows Installer --> <section class="indent"><!-- H3: Running the Tux Paint Windows Installer -->
@ -942,7 +980,7 @@
<p> <p>
Although Tux Paint is built without the Xcode IDE, Xcode itself is still required to build Tux Paint. <a href="https://developer.apple.com/xcode/ide/">Download it from the App Store</a>, and launch it once to accept its license agreements. You may also need to install the Xcode command line tools using the command: <blockquote> Although Tux Paint is built without the Xcode IDE, Xcode itself is still required to build Tux Paint. <a href="https://developer.apple.com/xcode/ide/">Download it from the App Store</a>, and launch it once to accept its license agreements. You may also need to install the Xcode command line tools using the command: <blockquote>
<code> <code>
xcode-select --install $ xcode-select --install
</code> </code>
</blockquote> </blockquote>
</p> </p>

2
docs/en/html/OPTIONS.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/en/html/PNG.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/en/html/README.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/en/html/SIGNALS.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/en/html/SVG.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

186
docs/es_ES.UTF-8/INSTALL.txt
View file

@ -5,7 +5,7 @@
Copyright © 2002-2022 by various contributors; see AUTHORS.txt. Copyright © 2002-2022 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/ https://tuxpaint.org/
junio 4, 2022 julio 8, 2022
+----------------------------------------------------+ +----------------------------------------------------+
|Table of Contents | |Table of Contents |
@ -144,8 +144,7 @@ Simple DirectMedia Layer library (libSDL)
Windows Windows
mayo 16, 2022 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp julio 8, 2022 Shin-ichi TOYAMA <dolphin6k@wmail.plala.or.jp>
<dolphin6k@wmail.plala.or.jp>
Compiling Set-Up Compiling Set-Up
@ -153,29 +152,34 @@ Windows
includes support for building on a Windows system using MinGW/MSYS includes support for building on a Windows system using MinGW/MSYS
(https://sourceforge.net/projects/msys2/). (https://sourceforge.net/projects/msys2/).
💡 Note: This documentation relates to the SDL2.0 version of Tux Paint,
which became available starting with version 0.9.28 in June 2022.
Many tools and libraries are required to build Tux Paint. The package Many tools and libraries are required to build Tux Paint. The package
management system "pacman" helps you install them automatically solving management system "pacman" helps you install them automatically solving
complicated dependencies. complicated dependencies.
Download the latest MSYS2 environment from MYSYS2
https://sourceforge.net/projects/msys2/files/Base/ and install it where
you'd like (the default is "C:\msys64") Download the latest MSYS2 environment from https://www.msys2.org/ and
install it where you'd like (the default is "C:\msys64")
Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" -> "MSYS2 Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" -> "MSYS2
MSYS" and execute following command (press [Enter] or [Return] to accept MSYS" and execute following command:
the defaults for all questions):
pacman -Syu $ yes "" | pacman -Syu
This will update core system and the window will close automatically. This will update core system and the window will close automatically. Open
Repeat the steps above one more time to finish the remaining update the msys2 shell again and execute following command to finish remaining
process. updating process.
$ yes "" | pacman -Syu
Within the MSYS2 shell, run the following command to install basic Within the MSYS2 shell, run the following command to install basic
development tools: development tools:
pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git
gperf zip patch gperf dos2unix
Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip to 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 the "MinGW 32bit (i686) toolchains" section if you need only a 32bit build
@ -188,7 +192,7 @@ Windows
Within the MSYS2 shell, run the following command to install 64bit Within the MSYS2 shell, run the following command to install 64bit
compiler and basic development tools: compiler and basic development tools:
pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
"ntldd" is a small tool which examine windows executable files to list "ntldd" is a small tool which examine windows executable files to list
Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging
@ -197,53 +201,33 @@ Windows
64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config
You can install tools and libraries required for compiling Tux Paint and You can install tools and libraries required for compiling Tux Paint and
Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL_mixer, Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
SDL_Pango and libunibreak. libunibreak.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can
skip installing it if you are only building "Tux Paint". skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx}
$ pacman -S mingw-w64-x86_64-libvorbis $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk}
$ 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
💡 Note: Close the shell before proceeding to the remaining process. 💡 Note: Close the shell before proceeding to the remaining process.
Install SDL_mixer, SDL_Pango and libunibreak on the 64bit environment Install SDL2_Pango and libunibreak on the 64bit environment
SDL_mixer, SDL_Pango and libunibreak should be installed manually. SDL2_Pango and libunibreak should be installed manually.
This time, use the MinGW "64bit" shell. Open the shell from the "Start This time, use the MinGW "64bit" shell. Open the shell from the "Start
Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit"
SDL_mixer
Download source tar-ball of SDL_mixer-1.2.12 from SDL_mixer's page.
Build and install SDL_mixer as follows.
$ tar zxvf SDL_mixer-1.2.12.tar.gz
$ cd SDL_mixer-1.2.12/
$ ./configure --prefix=/mingw64 && make && make install
SDL_Pango SDL_Pango
At first, you have to prepare source tar-ball and a required patch in the Download a patch from z1.plala.jp, which enable SDL2_Pango to create dlls,
same directory. then build and install SDL2_Pango as follows.
* 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. $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch
$ git clone https://github.com/markuskimius/SDL2_Pango
$ tar zxvf SDL_Pango-0.1.2.tar.gz $ cd SDL2_Pango
$ cd SDL_Pango-0.1.2/ $ patch -p0 < ../SDL2_Pango-dll.patch
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw64 && make && make install $ ./configure --prefix=/mingw64 && make && make install
libunibreak libunibreak
@ -268,7 +252,7 @@ Windows
Within the MSYS2 shell, run the following command to install 32bit Within the MSYS2 shell, run the following command to install 32bit
compiler and basic development tools: compiler and basic development tools:
pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
"ntldd" is a small tool which examine windows executable files to list "ntldd" is a small tool which examine windows executable files to list
Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging
@ -277,53 +261,33 @@ Windows
32bit (i686) dependency libraries for Tux Paint and Tux Paint Config 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config
You can install tools and libraries required for compiling Tux Paint and You can install tools and libraries required for compiling Tux Paint and
Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL_mixer, Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
SDL_Pango and libunibreak. libunibreak.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can
skip installing it if you are only building "Tux Paint". skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}
$ pacman -S mingw-w64-i686-libvorbis $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk}
$ pacman -S mingw-w64-i686-librsvg
$ pacman -S mingw-w64-i686-fribidi
$ pacman -S mingw-w64-i686-libimagequant
$ pacman -S mingw-w64-i686-fltk
💡 Note: Close the shell before proceeding to the remaining process. 💡 Note: Close the shell before proceeding to the remaining process.
Install SDL_mixer, SDL_Pango and libunibreak on the 32bit environment Install SDL2_Pango and libunibreak on the 32bit environment
SDL_mixer, SDL_Pango and libunibreak should be installed manually. SDL2_Pango and libunibreak should be installed manually.
This time, use the MinGW "32bit" shell. Open the shell from the "Start This time, use the MinGW "32bit" shell. Open the shell from the "Start
Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit"
SDL_mixer
Download source tar-ball of SDL_mixer-1.2.12 from SDL_mixer's page.
Build and install SDL_mixer as follows.
$ tar zxvf SDL_mixer-1.2.12.tar.gz
$ cd SDL_mixer-1.2.12/
$ ./configure --prefix=/mingw32 && make && make install
SDL_Pango SDL_Pango
At first, you have to prepare source tar-ball and a required patch in the Download a patch from z1.plala.jp, which enable SDL2_Pango to create dlls,
same directory. then build and install SDL2_Pango as follows.
* 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. $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch
$ git clone https://github.com/markuskimius/SDL2_Pango
$ tar zxvf SDL_Pango-0.1.2.tar.gz $ cd SDL2_Pango
$ cd SDL_Pango-0.1.2/ $ patch -p0 < ../SDL2_Pango-dll.patch
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw32 && make && make install $ ./configure --prefix=/mingw32 && make && make install
libunibreak libunibreak
@ -361,27 +325,66 @@ Windows
You can make this permanent by adding the above to your the BASH shell You can make this permanent by adding the above to your the BASH shell
configuration file, "~/.bash_profile". configuration file, "~/.bash_profile".
Tux Paint Tux Paint & Tux Paint Config.
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit binaries You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit
using MSYS2 32bit shell, respectively. binaries using "MSYS2 32bit" shell, respectively.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start Menu" to * Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start Menu" to
open the 64bit shell. open the 64bit shell.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start Menu" to * Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start Menu" to
open the 32bit shell. open the 32bit shell.
Compile Tux Paint with the following command: Tux Paint Config.
"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's
behavior. You have to build this component before compiling Tux Paint if
you 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
* 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:
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config
tuxpaint-config
Now you can build Tux Paint Config. as follows:
$ cd tuxpaint-config
$ make win32
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
* 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-sdl2.tar.gz
$ mv tuxpaint-A.B.C-sdl2 tuxpaint-sdl2
b. Using the developing source tree:
* Fetch the developing source tree from git repository:
$ git clone -b sdl2.0
https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint-sdl2
Now you can build Tux Paint as follows:
$ cd tuxpaint-sdl2
$ make bdist-win32 $ 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 All the files needed for starting Tux Paint (and Tux Paint Config.) are
collected in the directory for binary distribution "bdist" directory under collected in the directory for binary distribution "bdist" directory under
"win32". You can start them by double-clicking their executable (.exe) "win32". You can start them by double-clicking their executable (.exe)
@ -407,7 +410,8 @@ Windows
Then, you can easily build an executable installer by right-clicking on Then, you can easily build an executable installer by right-clicking on
the "tuxpaint.iss" icon in the "win32" directory and selecting "Compile" 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 on the list. It will run for a while, and eventually you will find a
"tuxpaint-X.Y.Z-windows-<arch>-installer.exe" file in the same directory. "tuxpaint-X.Y.Z-windows-sdl2.0-<arch>-installer.exe" file in the same
directory.
Running the Tux Paint Windows Installer Running the Tux Paint Windows Installer
@ -604,7 +608,7 @@ macOS
once to accept its license agreements. You may also need to install the once to accept its license agreements. You may also need to install the
Xcode command line tools using the command: Xcode command line tools using the command:
xcode-select --install $ xcode-select --install
Building Tux Paint also requires various libraries. We install them from Building Tux Paint also requires various libraries. We install them from
MacPorts where possible, source code otherwise. Install MacPorts to the MacPorts where possible, source code otherwise. Install MacPorts to the

2
docs/es_ES.UTF-8/html/EXTENDING.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

290
docs/es_ES.UTF-8/html/INSTALL.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }
@ -96,7 +96,7 @@
</p> </p>
<p> <p>
junio 4, 2022 </p> julio 8, 2022 </p>
</center> </center>
</header> </header>
@ -301,7 +301,7 @@
<p style="font-size: small;"> <p style="font-size: small;">
<em> <em>
mayo 16, 2022 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp &lt;<a href="mailto:dolphin6k@wmail.plala.or.jp">dolphin6k@wmail.plala.or.jp</a>&gt; julio 8, 2022 Shin-ichi TOYAMA &lt;<a href="mailto:dolphin6k@wmail.plala.or.jp">dolphin6k@wmail.plala.or.jp</a>&gt;
</em> </em>
</p> </p>
</header> </header>
@ -314,35 +314,48 @@
<p> <p>
As of February 2005 (starting with Tux Paint 0.9.15), the "<code>Makefile</code>" includes support for building on a Windows system using MinGW/MSYS (<a href="https://sourceforge.net/projects/msys2/">https://sourceforge.net/projects/msys2/</a>). </p> As of February 2005 (starting with Tux Paint 0.9.15), the "<code>Makefile</code>" includes support for building on a Windows system using MinGW/MSYS (<a href="https://sourceforge.net/projects/msys2/">https://sourceforge.net/projects/msys2/</a>). </p>
<p class="note">
<span title="Information">&#128161;</span> <strong>Note:</strong> This documentation relates to the SDL2.0 version of Tux Paint, which became available starting with version 0.9.28 in June 2022. </p>
<p> <p>
Many tools and libraries are required to build Tux Paint. The package management system "<code>pacman</code>" helps you install them automatically solving complicated dependencies. </p> Many tools and libraries are required to build Tux Paint. The package management system "<code>pacman</code>" helps you install them automatically solving complicated dependencies. </p>
<p> <section class="indent"><!-- H4: MSYS2 -->
Download the latest MSYS2 environment from <a href="https://sourceforge.net/projects/msys2/files/Base/">https://sourceforge.net/projects/msys2/files/Base/</a> and install it where you'd like (the default is "<code>C:\msys64</code>") </p> <header>
<p> <h4>MYSYS2</h4>
Open the MSYS2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command (press <b><code>[Enter]</code></b> or <b><code>[Return]</code></b> to accept the defaults for all questions): </header>
<blockquote>
<code>
pacman -Syu
</code>
</blockquote>
</p>
<p> <p>
This will update core system and the window will close automatically. Repeat the steps above one more time to finish the remaining update process. </p> Download the latest MSYS2 environment from <a href="https://www.msys2.org/">https://www.msys2.org/</a> and install it where you'd like (the default is "<code>C:\msys64</code>") </p>
<p>
<p> Open the MSYS2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command: <blockquote>
Within the MSYS2 shell, run the following command to install basic development tools: <blockquote> <code>
<code> $ yes "" | pacman -Syu
pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch gperf </code>
</code> </blockquote>
</blockquote> </p>
</p>
<p>
<p> 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. <blockquote>
<i> <code>
Proceed to the next "<a href="#64bit">MinGW 64bit (x86_64) toolchains</a>" section, or skip to the "<a href="#32bit">MinGW 32bit (i686) toolchains</a>" section if you need only a 32bit build environment. </i> $ yes "" | pacman -Syu
</p> </code>
</blockquote>
</p>
<p>
Within the MSYS2 shell, run the following command to install basic development tools: <blockquote>
<code>
$ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch gperf dos2unix
</code>
</blockquote>
</p>
<p>
<i>
Proceed to the next "<a href="#64bit">MinGW 64bit (x86_64) toolchains</a>" section, or skip to the "<a href="#32bit">MinGW 32bit (i686) toolchains</a>" section if you need only a 32bit build environment. </i>
</p>
</section>
<hr size="1" noshade width="75%" /> <hr size="1" noshade width="75%" />
<section class="indent"><!-- H4: MinGW...compiler and tools --> <section class="indent"><!-- H4: MinGW...compiler and tools -->
@ -356,7 +369,7 @@
<p> <p>
Within the MSYS2 shell, run the following command to install 64bit compiler and basic development tools: <blockquote> Within the MSYS2 shell, run the following command to install 64bit compiler and basic development tools: <blockquote>
<code> <code>
pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -371,18 +384,14 @@
</header> </header>
<p> <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> You can install tools and libraries required for compiling Tux Paint and Tux Paint Config on MSYS2/MINGW using "<code>pacman</code>" except for SDL2_Pango and libunibreak. </p>
<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> 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> <p>
<blockquote> <blockquote>
<code> <code>
$ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx}<br/> $ 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,fribidi,libimagequant,fltk}<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> </code>
</blockquote> </blockquote>
</p> </p>
@ -393,52 +402,27 @@
<section class="indent"><!-- H4: Install SDL_Pango... --> <section class="indent"><!-- H4: Install SDL_Pango... -->
<header> <header>
<h4> <h4>
Install SDL_mixer, SDL_Pango and libunibreak on the 64bit environment </h4> Install SDL2_Pango and libunibreak on the 64bit environment </h4>
</header> </header>
<p> <p>
SDL_mixer, SDL_Pango and libunibreak should be installed manually. </p> SDL2_Pango and libunibreak should be installed manually. </p>
<p> <p>
This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" </p> This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" </p>
<section class="indent"><!-- H5: SDL_mixer --> <section class="indent"><!-- H5: SDL2_Pango -->
<header>
<h5>SDL_mixer</h5>
</header>
<p>
Download <a href="https://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.12.tar.gz">source tar-ball of SDL_mixer-1.2.12</a> from <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 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</section><!-- H5: SDL_mixer -->
<section class="indent"><!-- H5: SDL_Pango -->
<header> <header>
<h5>SDL_Pango</h5> <h5>SDL_Pango</h5>
</header> </header>
<p> <p>
At first, you have to prepare source tar-ball and a required patch in the same directory. <ul> Download <a href="https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch">a patch</a> from <a href="https://z1.plala.jp/tuxpaint/buildwin.html">z1.plala.jp</a>, which enable SDL2_Pango to create dlls, then build and install SDL2_Pango as follows. <blockquote>
<li>
Download <a href="https://sourceforge.net/projects/sdlpango/files/SDL_Pango/0.1.2/SDL_Pango-0.1.2.tar.gz/download">source tar-ball of SDL_Pango-0.1.2</a> from <a href="https://sourceforge.net/projects/sdlpango/">SDL_Pango's page on Sourceforge.net</a>. </li>
<li>
Download <a href="http://johnnypops.co.uk/tuxpaint/SDL_Pango-configure-extra-api.patch">a patch file</a> from <a href="http://www.johnnypops.co.uk/tuxpaint/">John Popplewell's "Tux Paint - MinGW/MSYS build instructions" webpage</a>. (This adds some extra (required) functionality to SDL_Pango.) </li>
</ul>
</p>
<p>
Build and install SDL_Pango as follows. <blockquote>
<code> <code>
$ tar zxvf SDL_Pango-0.1.2.tar.gz<br/> $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch<br/>
$ cd SDL_Pango-0.1.2/<br/> $ git clone https://github.com/markuskimius/SDL2_Pango<br/>
$ patch -p0 &lt; ../SDL_Pango-configure-extra-api.patch<br/> $ cd SDL2_Pango<br/>
$ ./configure --prefix=/mingw64 &amp;&amp; make &amp;&amp; make install $ patch -p0 &lt; ../SDL2_Pango-dll.patch<br/>
$ ./configure --prefix=/mingw64 &amp;&amp; make &amp;&amp; make install<br/>
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -481,7 +465,7 @@
<p> <p>
Within the MSYS2 shell, run the following command to install 32bit compiler and basic development tools: <blockquote> Within the MSYS2 shell, run the following command to install 32bit compiler and basic development tools: <blockquote>
<code> <code>
pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -496,18 +480,14 @@
</header> </header>
<p> <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> You can install tools and libraries required for compiling Tux Paint and Tux Paint Config on MSYS2/MINGW using "<code>pacman</code>" except for SDL2_Pango and libunibreak. </p>
<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> 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> <p>
<blockquote> <blockquote>
<code> <code>
$ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}<br/> $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}<br/>
$ pacman -S mingw-w64-i686-libvorbis<br/> $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk}<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> </code>
</blockquote> </blockquote>
</p> </p>
@ -518,52 +498,27 @@
<section class="indent"><!-- H4: Install SDL_Pango... --> <section class="indent"><!-- H4: Install SDL_Pango... -->
<header> <header>
<h4> <h4>
Install SDL_mixer, SDL_Pango and libunibreak on the 32bit environment </h4> Install SDL2_Pango and libunibreak on the 32bit environment </h4>
</header> </header>
<p> <p>
SDL_mixer, SDL_Pango and libunibreak should be installed manually. </p> SDL2_Pango and libunibreak should be installed manually. </p>
<p> <p>
This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" </p> This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" </p>
<section class="indent"><!-- H5: SDL_mixer --> <section class="indent"><!-- H5: SDL2_Pango -->
<header>
<h5>SDL_mixer</h5>
</header>
<p>
Download <a href="https://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.12.tar.gz">source tar-ball of SDL_mixer-1.2.12</a> from <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 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</section><!-- H5: SDL_mixer -->
<section class="indent"><!-- H5: SDL_Pango -->
<header> <header>
<h5>SDL_Pango</h5> <h5>SDL_Pango</h5>
</header> </header>
<p> <p>
At first, you have to prepare source tar-ball and a required patch in the same directory. <ul> Download <a href="https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch">a patch</a> from <a href="https://z1.plala.jp/tuxpaint/buildwin.html">z1.plala.jp</a>, which enable SDL2_Pango to create dlls, then build and install SDL2_Pango as follows. <blockquote>
<li>
Download <a href="https://sourceforge.net/projects/sdlpango/files/SDL_Pango/0.1.2/SDL_Pango-0.1.2.tar.gz/download">source tar-ball of SDL_Pango-0.1.2</a> from <a href="https://sourceforge.net/projects/sdlpango/">SDL_Pango's page on Sourceforge.net</a>. </li>
<li>
Download <a href="http://johnnypops.co.uk/tuxpaint/SDL_Pango-configure-extra-api.patch">a patch file</a> from <a href="http://www.johnnypops.co.uk/tuxpaint/">John Popplewell's "Tux Paint - MinGW/MSYS build instructions" webpage</a>. (This adds some extra (required) functionality to SDL_Pango.) </li>
</ul>
</p>
<p>
Build and install SDL_Pango as follows. <blockquote>
<code> <code>
$ tar zxvf SDL_Pango-0.1.2.tar.gz<br/> $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch<br/>
$ cd SDL_Pango-0.1.2/<br/> $ git clone https://github.com/markuskimius/SDL2_Pango<br/>
$ patch -p0 &lt; ../SDL_Pango-configure-extra-api.patch<br/> $ cd SDL2_Pango<br/>
$ ./configure --prefix=/mingw32 &amp;&amp; make &amp;&amp; make install $ patch -p0 &lt; ../SDL2_Pango-dll.patch<br/>
$ ./configure --prefix=/mingw32 &amp;&amp; make &amp;&amp; make install<br/>
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -602,7 +557,7 @@
<p> <p>
<a href="https://imagemagick.org">ImageMagick</a> 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. </p> <a href="https://imagemagick.org">ImageMagick</a> 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. </p>
<p> <p>
Using official binary release available from "<a href="https://imagemagick.org/script/download.php#windowsand">Windows Binary Release</a>" is recommended, due to the commands installed with "<code>pacman</code>" on MinGW/MSYS not working as expected! </p> Using official binary release available from "<a href="https://imagemagick.org/script/download.php#windows">Windows Binary Release</a>" is recommended, due to the commands installed with "<code>pacman</code>" on MinGW/MSYS not working as expected! </p>
<p> <p>
Do not forget to enable "Install legacy utilities (e.g. convert)" while installing it, because Tux Paint's build process uses them. </p> Do not forget to enable "Install legacy utilities (e.g. convert)" while installing it, because Tux Paint's build process uses them. </p>
<p> <p>
@ -616,31 +571,114 @@
You can make this permanent by adding the above to your the BASH shell configuration file, "<code>~/.bash_profile</code>". </p> You can make this permanent by adding the above to your the BASH shell configuration file, "<code>~/.bash_profile</code>". </p>
</section><!-- H3: ImageMagick --> </section><!-- H3: ImageMagick -->
<section class="indent"><!-- H3: Tux Paint --> <section class="indent"><!-- H3: Tux Paint & Tux Paint Config. -->
<header> <header>
<h3>Tux Paint</h3> <h3>Tux Paint &amp; Tux Paint Config.</h3>
</header> </header>
<p> <p>
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit binaries using MSYS2 32bit shell, respectively. </p> You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries using "MSYS2 32bit" shell, respectively. </p>
<ul> <ul>
<li> <li>
Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" from the "Start Menu" to open the 64bit shell. </li> Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" from the "Start Menu" to open the 64bit shell. </li>
<li> <li>
Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" from the "Start Menu" to open the 32bit shell. </li> Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" from the "Start Menu" to open the 32bit shell. </li>
</ul> </ul>
<p>
Compile Tux Paint with the following command: <blockquote> <section class="indent"><!-- H4: Tux Paint Config. -->
<code> <header>
$ make bdist-win32 <h4>Tux Paint Config.</h4>
</code> </header>
</blockquote> <p>
</p> "Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's behavior. You have to build this component before compiling Tux Paint if you want to have it included in your package. </p>
<p class="note"> <p>
<span title="Information">&#128161;</span> <strong>Note:</strong> 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 "<code>tuxpaint-config</code>" (with no version number, e.g., "<code>tuxpaint-config-X.Y.Z</code>"). See "Tux Paint Config."'s INSTALL.txt documentation for details. </p> You can use either (a) a stable tar-ball release, or (b) the developing source tree. <ol type="a">
<li>
Using stable tar-ball release: <ul>
<li>
<a href="https://sourceforge.net/projects/tuxpaint/files/tuxpaint-config/">Download a source tar-ball</a>
</li>
<li>
Expand the tar-ball and change the directory name so that the final packaging process can find related files. <blockquote>
<code>
$ tar zxvf tuxpaint-config-A.B.C.tar.gz<br/>
$ mv tuxpaint-config-A.B.C tuxpaint-config<br/>
</code>
</blockquote>
</li>
</ul>
</li>
<li>
Using the developing source tree: <ul>
<li>
Fetch the developing source tree from git repository: <blockquote>
<code>
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config tuxpaint-config
</code>
</blockquote>
</li>
</ul>
</li>
</ol>
</p>
<p>
Now you can build Tux Paint Config. as follows: <blockquote>
<code>
$ cd tuxpaint-config<br/>
$ make win32<br/>
</code>
</blockquote>
</p>
</section><!-- H4: Tux Paint Config. -->
<section class="indent"><!-- H4: Tux Paint -->
<header>
<h4>Tux Paint</h4>
</header>
<p>
You can use either (a) a stable tar-ball release, or (b) the developing source tree. <ol type="a">
<li>
Using stable tar-ball release: <ul>
<li>
<a href="https://sourceforge.net/projects/tuxpaint/files/tuxpaint/">Download a source tar-ball</a>
</li>
<li>
Expand the tar-ball and change the directory name so that the final packaging process can find related files. <blockquote>
<code>
$ tar zxvf tuxpaint-A.B.C-sdl2.tar.gz<br/>
$ mv tuxpaint-A.B.C-sdl2 tuxpaint-sdl2<br/>
</code>
</blockquote>
</li>
</ul>
</li>
<li>
Using the developing source tree: <ul>
<li>
Fetch the developing source tree from git repository: <blockquote>
<code>
$ git clone -b sdl2.0 https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint-sdl2
</code>
</blockquote>
</li>
</ul>
</li>
</ol>
</p>
<p>
Now you can build Tux Paint as follows: <blockquote>
<code>
$ cd tuxpaint-sdl2<br/>
$ make bdist-win32<br/>
</code>
</blockquote>
</p>
</section><!-- H4: Tux Paint -->
<p> <p>
All the files needed for starting Tux Paint (and Tux Paint Config.) are collected in the directory for binary distribution "<code>bdist</code>" directory under "<code>win32</code>". You can start them by double-clicking their executable (<code>.exe</code>) files in the "<code>bdist</code>" directory. </p> All the files needed for starting Tux Paint (and Tux Paint Config.) are collected in the directory for binary distribution "<code>bdist</code>" directory under "<code>win32</code>". You can start them by double-clicking their executable (<code>.exe</code>) files in the "<code>bdist</code>" directory. </p>
</section><!-- H3: Tux Paint --> </section><!-- H3: Tux Paint & Tux Paint Config. -->
<section class="indent"><!-- H3: Building the Tux Paint Windows Installer --> <section class="indent"><!-- H3: Building the Tux Paint Windows Installer -->
<header> <header>
@ -655,7 +693,7 @@
<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> 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> <p>
Then, you can easily build an executable installer by right-clicking on the "<code>tuxpaint.iss</code>" icon in the "<code>win32</code>" directory and selecting "Compile" on the list. It will run for a while, and eventually you will find a "<code>tuxpaint-<i>X.Y.Z</i>-windows-&lt;arch&gt;-installer.exe</code>" file in the same directory. </p> Then, you can easily build an executable installer by right-clicking on the "<code>tuxpaint.iss</code>" icon in the "<code>win32</code>" directory and selecting "Compile" on the list. It will run for a while, and eventually you will find a "<code>tuxpaint-<i>X.Y.Z</i>-windows-sdl2.0-&lt;arch&gt;-installer.exe</code>" file in the same directory. </p>
</section><!-- H3: Building the Tux Paint Windows Installer --> </section><!-- H3: Building the Tux Paint Windows Installer -->
<section class="indent"><!-- H3: Running the Tux Paint Windows Installer --> <section class="indent"><!-- H3: Running the Tux Paint Windows Installer -->
@ -942,7 +980,7 @@
<p> <p>
Although Tux Paint is built without the Xcode IDE, Xcode itself is still required to build Tux Paint. <a href="https://developer.apple.com/xcode/ide/">Download it from the App Store</a>, and launch it once to accept its license agreements. You may also need to install the Xcode command line tools using the command: <blockquote> Although Tux Paint is built without the Xcode IDE, Xcode itself is still required to build Tux Paint. <a href="https://developer.apple.com/xcode/ide/">Download it from the App Store</a>, and launch it once to accept its license agreements. You may also need to install the Xcode command line tools using the command: <blockquote>
<code> <code>
xcode-select --install $ xcode-select --install
</code> </code>
</blockquote> </blockquote>
</p> </p>

2
docs/es_ES.UTF-8/html/OPTIONS.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/es_ES.UTF-8/html/PNG.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/es_ES.UTF-8/html/README.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/es_ES.UTF-8/html/SIGNALS.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/es_ES.UTF-8/html/SVG.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

195
docs/fr_FR.UTF-8/INSTALL.txt
View file

@ -5,7 +5,7 @@
Copyright © 2002-2022 by divers contributeurs; see AUTHORS.txt. Copyright © 2002-2022 by divers contributeurs; see AUTHORS.txt.
https://tuxpaint.org/ https://tuxpaint.org/
juin 4, 2022 juillet 8, 2022
+--------------------------------------------------------+ +--------------------------------------------------------+
|Table des matières | |Table des matières |
@ -147,8 +147,7 @@ Biliothèque Simple DirectMedia Layer (libSDL)
Windows Windows
mai 16, 2022 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp juillet 8, 2022 Shin-ichi TOYAMA <dolphin6k@wmail.plala.or.jp>
<dolphin6k@wmail.plala.or.jp>
Réglages pour compilation Réglages pour compilation
@ -156,29 +155,35 @@ Windows
la prise en charge de la construction sur un système Windows à l'aide de la prise en charge de la construction sur un système Windows à l'aide de
MinGW/MSYS (https://sourceforge.net/projects/msys2/). MinGW/MSYS (https://sourceforge.net/projects/msys2/).
💡 Note: This documentation relates to the SDL2.0 version of Tux Paint,
which became available starting with version 0.9.28 in June 2022.
Beaucoup d'outils et de bibliothèques sont nécessaires pour élaborer Tux Beaucoup d'outils et de bibliothèques sont nécessaires pour élaborer Tux
Paint. Le système de gestion de paquet "pacman" apporte une aide pour Paint. Le système de gestion de paquet "pacman" apporte une aide pour
installer automatiquement, en résolvant les dépendances nombreuses. installer automatiquement, en résolvant les dépendances nombreuses.
MYSYS2
Téléchargez le dernier environnement MSYS2 à partir de Téléchargez le dernier environnement MSYS2 à partir de
https://sourceforge.net/projects/msys2/files/Base/ et installez-le où vous https://www.msys2.org/ et installez-le où vous voulez (par défaut
voulez (par défaut "C:\msys64") "C:\msys64")
Ouvrez le shell MSYS2 via le "Menu de Démarrage" ->"MSYS2 64bit" -> "MSTS2 Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" -> "MSYS2
MSYS" et exécutez la commande suivante (pressez [Entrée] ou [Retour] pour MSYS" and execute following command:
accepter par défaut toutes les questions) :
pacman -Syu $ yes "" | pacman -Syu
Ceci mettra à jour tout le système et la fenêtre de se fermera This will update core system and the window will close automatically. Open
automatiquement. Répétez les étapes précédentes encore une fois pour the msys2 shell again and execute following command to finish remaining
finaliser le process restant de mise à jour. updating process.
$ yes "" | pacman -Syu
Sous le shell MSYS2, exécutez la commande suivante pour installer outils Sous le shell MSYS2, exécutez la commande suivante pour installer outils
basiques pour le développement : basiques pour le développement :
pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git
gperf zip patch gperf dos2unix
Allez à la prochaine section "chaînes d'outils MinGW 64bit (x86_64) ", ou Allez à la prochaine section "chaînes d'outils MinGW 64bit (x86_64) ", ou
bien à la section "chaînes d'outils MinGW 32bit (i686)" si vous ne voulez bien à la section "chaînes d'outils MinGW 32bit (i686)" si vous ne voulez
@ -191,7 +196,7 @@ Windows
Sous le shell MSYS2, exécutez la commande suivante pour installer 64bit Sous le shell MSYS2, exécutez la commande suivante pour installer 64bit
compiler and basic development tools : compiler and basic development tools :
pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
"ntldd" est un petit outil qui examine les fichiers exécutables de windows "ntldd" est un petit outil qui examine les fichiers exécutables de windows
en vue de lister les fichiers DLL (.dll) qui leur sont nécessaires. Le en vue de lister les fichiers DLL (.dll) qui leur sont nécessaires. Le
@ -201,54 +206,33 @@ Windows
64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config
You can install tools and libraries required for compiling Tux Paint and You can install tools and libraries required for compiling Tux Paint and
Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL_mixer, Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
SDL_Pango and libunibreak. libunibreak.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can
skip installing it if you are only building "Tux Paint". skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx}
$ pacman -S mingw-w64-x86_64-libvorbis $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk}
$ 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
💡 Nota : Fermez l'interpréteur de commandes avant de passer à la suite. 💡 Nota : Fermez l'interpréteur de commandes avant de passer à la suite.
Install SDL_mixer, SDL_Pango and libunibreak on the 64bit environment Install SDL2_Pango and libunibreak on the 64bit environment
SDL_mixer, SDL_Pango and libunibreak should be installed manually. SDL2_Pango and libunibreak should be installed manually.
Cette fois-ci, utilisez le shell MinGW "64bit". Ouvrez le shell depuis le Cette fois-ci, utilisez le shell MinGW "64bit". Ouvrez le shell depuis le
"Menu de Démarrage" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" "Menu de Démarrage" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit"
SDL_mixer
Télécharger fichier source de SDL_mixer-1.2.12 depuis SDL_mixer's page.
Build and install SDL_mixer as follows.
$ tar zxvf SDL_mixer-1.2.12.tar.gz
$ cd SDL_mixer-1.2.12/
$ ./configure --prefix=/mingw64 && make && make install
SDL_Pango SDL_Pango
Tout d'abord, vous devrez préparer l'archive source et un patch qui est Download a patch from z1.plala.jp, which enable SDL2_Pango to create dlls,
requis, dans le même répertoire. then build and install SDL2_Pango as follows.
* Télécharger fichier source de SDL_Pango-0.1.2 depuis La page SDL_Pango
sur Sourceforge.net.
* Télécharger un fichier patch depuis La page web de John Popplewell
traitant des "instructions pour la compilation de Tux Paint -
MinGW/MSYS". (Ceci ajoute une fonctionnalité supplémentaire (requise)
à SDL_Pango.)
Compiler et installer SDL_Pango comme suit. $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch
$ git clone https://github.com/markuskimius/SDL2_Pango
$ tar zxvf SDL_Pango-0.1.2.tar.gz $ cd SDL2_Pango
$ cd SDL_Pango-0.1.2/ $ patch -p0 < ../SDL2_Pango-dll.patch
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw64 && make && make install $ ./configure --prefix=/mingw64 && make && make install
libunibreak libunibreak
@ -274,7 +258,7 @@ Windows
Sous le shell MSYS2, exécutez la commande suivante pour installer 32bit Sous le shell MSYS2, exécutez la commande suivante pour installer 32bit
compiler and basic development tools : compiler and basic development tools :
pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
"ntldd" est un petit outil qui examine les fichiers exécutables de windows "ntldd" est un petit outil qui examine les fichiers exécutables de windows
en vue de lister les fichiers DLL (.dll) qui leur sont nécessaires. Le en vue de lister les fichiers DLL (.dll) qui leur sont nécessaires. Le
@ -284,54 +268,33 @@ Windows
32bit (i686) dependency libraries for Tux Paint and Tux Paint Config 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config
You can install tools and libraries required for compiling Tux Paint and You can install tools and libraries required for compiling Tux Paint and
Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL_mixer, Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
SDL_Pango and libunibreak. libunibreak.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can
skip installing it if you are only building "Tux Paint". skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}
$ pacman -S mingw-w64-i686-libvorbis $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk}
$ pacman -S mingw-w64-i686-librsvg
$ pacman -S mingw-w64-i686-fribidi
$ pacman -S mingw-w64-i686-libimagequant
$ pacman -S mingw-w64-i686-fltk
💡 Nota : Fermez l'interpréteur de commandes avant de passer à la suite. 💡 Nota : Fermez l'interpréteur de commandes avant de passer à la suite.
Install SDL_mixer, SDL_Pango and libunibreak on the 32bit environment Install SDL2_Pango and libunibreak on the 32bit environment
SDL_mixer, SDL_Pango and libunibreak should be installed manually. SDL2_Pango and libunibreak should be installed manually.
Cette fois-ci, utilisez le shell MinGW "32bit". Ouvrez le shell depuis le Cette fois-ci, utilisez le shell MinGW "32bit". Ouvrez le shell depuis le
"Menu de Démarrage" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" "Menu de Démarrage" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit"
SDL_mixer
Télécharger fichier source de SDL_mixer-1.2.12 depuis SDL_mixer's page.
Build and install SDL_mixer as follows.
$ tar zxvf SDL_mixer-1.2.12.tar.gz
$ cd SDL_mixer-1.2.12/
$ ./configure --prefix=/mingw32 && make && make install
SDL_Pango SDL_Pango
Tout d'abord, vous devrez préparer l'archive source et un patch qui est Download a patch from z1.plala.jp, which enable SDL2_Pango to create dlls,
requis, dans le même répertoire. then build and install SDL2_Pango as follows.
* Télécharger fichier source de SDL_Pango-0.1.2 depuis La page SDL_Pango
sur Sourceforge.net.
* Télécharger un fichier patch depuis La page web de John Popplewell
traitant des "instructions pour la compilation de Tux Paint -
MinGW/MSYS". (Ceci ajoute une fonctionnalité supplémentaire (requise)
à SDL_Pango.)
Compiler et installer SDL_Pango comme suit. $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch
$ git clone https://github.com/markuskimius/SDL2_Pango
$ tar zxvf SDL_Pango-0.1.2.tar.gz $ cd SDL2_Pango
$ cd SDL_Pango-0.1.2/ $ patch -p0 < ../SDL2_Pango-dll.patch
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw32 && make && make install $ ./configure --prefix=/mingw32 && make && make install
libunibreak libunibreak
@ -354,9 +317,9 @@ Windows
"composite") pour générer des vignettes pour les images de démarrage et "composite") pour générer des vignettes pour les images de démarrage et
des modèles durant le process de compilation. des modèles durant le process de compilation.
L'utilisation des binaires officiels tirés de "Versions binaires pour Using official binary release available from "Windows Binary Release" is
Windows" est recommandée car les commandes installées avec "pacman" sur recommended, due to the commands installed with "pacman" on MinGW/MSYS not
MinGW/MSYS ne fonctionnent pas comme elles devraient ! working as expected!
N'oubliez pas de cocher "Installer les utilitaires hérités (par ex. N'oubliez pas de cocher "Installer les utilitaires hérités (par ex.
convert)" pour l'installation, car le processus de compilation de Tux convert)" pour l'installation, car le processus de compilation de Tux
@ -370,27 +333,66 @@ Windows
Vous pouvez rendre ceci permanent en ajoutant ce qui précède à votre Vous pouvez rendre ceci permanent en ajoutant ce qui précède à votre
fichier de configuration du shell BASH, "~/.bash_profile". fichier de configuration du shell BASH, "~/.bash_profile".
Tux Paint Tux Paint & Tux Paint Config.
Vous pouvez compiler des binaires 64bit en utilisant le shell MSYS2 64bit, You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit
et des binaires 32bit en utilisant le shell MSYS2 32bit. binaries using "MSYS2 32bit" shell, respectively.
* Choisissez "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" dans le "Menu de * Choisissez "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" dans le "Menu de
Démarrage" pour ouvrir le shell 64bit. Démarrage" pour ouvrir le shell 64bit.
* Choisissez "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" dans le "Menu de * Choisissez "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" dans le "Menu de
Démarrage" pour ouvrir le shell 32bit. Démarrage" pour ouvrir le shell 32bit.
Compilez Tux Paint avec la commande suivante : Tux Paint Config.
"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's
behavior. You have to build this component before compiling Tux Paint if
you 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
* 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:
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config
tuxpaint-config
Now you can build Tux Paint Config. as follows:
$ cd tuxpaint-config
$ make win32
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
* 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-sdl2.tar.gz
$ mv tuxpaint-A.B.C-sdl2 tuxpaint-sdl2
b. Using the developing source tree:
* Fetch the developing source tree from git repository:
$ git clone -b sdl2.0
https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint-sdl2
Now you can build Tux Paint as follows:
$ cd tuxpaint-sdl2
$ make bdist-win32 $ make bdist-win32
💡 Nota : À 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é "tuxpaint-config" (sans numéro de version, par ex voir
"tuxpaint-config-X.Y.Z"). Voir le fichier INSTALL.txt de "Tux Paint
Config" pour les détails.
Tous les fichiers nécessaires pour démarrer Tux Paint (et Tux Paint 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 Config) sont rassemblés dans le répertoire de la distribution binaire
"bdist", répertoire situé sous "win323. Vous pouvez les démarrer en "bdist", répertoire situé sous "win323. Vous pouvez les démarrer en
@ -419,7 +421,8 @@ Windows
cliquant-droit sur l'icône "tuxpaint.iss" du répertoires "win32" et cliquant-droit sur l'icône "tuxpaint.iss" du répertoires "win32" et
sélectionner "Compile" dans la liste. Cela prendra un certain temps, et sélectionner "Compile" dans la liste. Cela prendra un certain temps, et
éventuellement vous obtiendrez un fichier éventuellement vous obtiendrez un fichier
"tuxpaint-X.Y.Z-windows-<arch>-installer.exe" dans le même répertoire. "tuxpaint-X.Y.Z-windows-sdl2.0-<arch>-installer.exe" dans le même
répertoire.
Running the Tux Paint Windows Installer Running the Tux Paint Windows Installer
@ -624,7 +627,7 @@ macOS
lancez le une fois pour accepter ses accords de licence. Vous pouvez aussi 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 : installer les outils de ligne de commande de Xcode en tapant la commande :
xcode-select --install $ xcode-select --install
Construire Tux Paint nécessite plusieurs bibliothèques. Nous les Construire Tux Paint nécessite plusieurs bibliothèques. Nous les
installons à partir de MacPorts quand c'est possible, sinon à partir du installons à partir de MacPorts quand c'est possible, sinon à partir du

2
docs/fr_FR.UTF-8/html/EXTENDING.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

290
docs/fr_FR.UTF-8/html/INSTALL.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }
@ -96,7 +96,7 @@
</p> </p>
<p> <p>
juin 4, 2022 </p> juillet 8, 2022 </p>
</center> </center>
</header> </header>
@ -301,7 +301,7 @@
<p style="font-size: small;"> <p style="font-size: small;">
<em> <em>
mai 16, 2022 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp &lt;<a href="mailto:dolphin6k@wmail.plala.or.jp">dolphin6k@wmail.plala.or.jp</a>&gt; juillet 8, 2022 Shin-ichi TOYAMA &lt;<a href="mailto:dolphin6k@wmail.plala.or.jp">dolphin6k@wmail.plala.or.jp</a>&gt;
</em> </em>
</p> </p>
</header> </header>
@ -314,35 +314,48 @@
<p> <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> 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 class="note">
<span title="Information">&#128161;</span> <strong>Note:</strong> This documentation relates to the SDL2.0 version of Tux Paint, which became available starting with version 0.9.28 in June 2022. </p>
<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> 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> <section class="indent"><!-- H4: MSYS2 -->
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> <header>
<p> <h4>MYSYS2</h4>
Ouvrez le shell MSYS2 via le "Menu de Démarrage" -&gt;"MSYS2 64bit" -&gt; "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) : </header>
<blockquote>
<code>
pacman -Syu
</code>
</blockquote>
</p>
<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> Téléchargez le dernier environnement MSYS2 à partir de <a href="https://www.msys2.org/">https://www.msys2.org/</a> et installez-le où vous voulez (par défaut "<code>C:\msys64</code>") </p>
<p>
<p> Open the MSYS2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command: <blockquote>
Sous le shell MSYS2, exécutez la commande suivante pour installer outils basiques pour le développement : <blockquote> <code>
<code> $ yes "" | pacman -Syu
pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch gperf </code>
</code> </blockquote>
</blockquote> </p>
</p>
<p>
<p> 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. <blockquote>
<i> <code>
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> $ yes "" | pacman -Syu
</p> </code>
</blockquote>
</p>
<p>
Sous le shell MSYS2, exécutez la commande suivante pour installer outils basiques pour le développement : <blockquote>
<code>
$ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch gperf dos2unix
</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>
</section>
<hr size="1" noshade width="75%" /> <hr size="1" noshade width="75%" />
<section class="indent"><!-- H4: MinGW...compiler and tools --> <section class="indent"><!-- H4: MinGW...compiler and tools -->
@ -356,7 +369,7 @@
<p> <p>
Sous le shell MSYS2, exécutez la commande suivante pour installer 64bit compiler and basic development tools : <blockquote> Sous le shell MSYS2, exécutez la commande suivante pour installer 64bit compiler and basic development tools : <blockquote>
<code> <code>
pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -371,18 +384,14 @@
</header> </header>
<p> <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> You can install tools and libraries required for compiling Tux Paint and Tux Paint Config on MSYS2/MINGW using "<code>pacman</code>" except for SDL2_Pango and libunibreak. </p>
<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> 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> <p>
<blockquote> <blockquote>
<code> <code>
$ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx}<br/> $ 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,fribidi,libimagequant,fltk}<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> </code>
</blockquote> </blockquote>
</p> </p>
@ -393,52 +402,27 @@
<section class="indent"><!-- H4: Install SDL_Pango... --> <section class="indent"><!-- H4: Install SDL_Pango... -->
<header> <header>
<h4> <h4>
Install SDL_mixer, SDL_Pango and libunibreak on the 64bit environment </h4> Install SDL2_Pango and libunibreak on the 64bit environment </h4>
</header> </header>
<p> <p>
SDL_mixer, SDL_Pango and libunibreak should be installed manually. </p> SDL2_Pango and libunibreak should be installed manually. </p>
<p> <p>
Cette fois-ci, utilisez le shell MinGW "64bit". Ouvrez le shell depuis le "Menu de Démarrage" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" </p> Cette fois-ci, utilisez le shell MinGW "64bit". Ouvrez le shell depuis le "Menu de Démarrage" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" </p>
<section class="indent"><!-- H5: SDL_mixer --> <section class="indent"><!-- H5: SDL2_Pango -->
<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 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</section><!-- H5: SDL_mixer -->
<section class="indent"><!-- H5: SDL_Pango -->
<header> <header>
<h5>SDL_Pango</h5> <h5>SDL_Pango</h5>
</header> </header>
<p> <p>
Tout d'abord, vous devrez préparer l'archive source et un patch qui est requis, dans le même répertoire. <ul> Download <a href="https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch">a patch</a> from <a href="https://z1.plala.jp/tuxpaint/buildwin.html">z1.plala.jp</a>, which enable SDL2_Pango to create dlls, then build and install SDL2_Pango as follows. <blockquote>
<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> <code>
$ tar zxvf SDL_Pango-0.1.2.tar.gz<br/> $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch<br/>
$ cd SDL_Pango-0.1.2/<br/> $ git clone https://github.com/markuskimius/SDL2_Pango<br/>
$ patch -p0 &lt; ../SDL_Pango-configure-extra-api.patch<br/> $ cd SDL2_Pango<br/>
$ ./configure --prefix=/mingw64 &amp;&amp; make &amp;&amp; make install $ patch -p0 &lt; ../SDL2_Pango-dll.patch<br/>
$ ./configure --prefix=/mingw64 &amp;&amp; make &amp;&amp; make install<br/>
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -481,7 +465,7 @@
<p> <p>
Sous le shell MSYS2, exécutez la commande suivante pour installer 32bit compiler and basic development tools : <blockquote> Sous le shell MSYS2, exécutez la commande suivante pour installer 32bit compiler and basic development tools : <blockquote>
<code> <code>
pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -496,18 +480,14 @@
</header> </header>
<p> <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> You can install tools and libraries required for compiling Tux Paint and Tux Paint Config on MSYS2/MINGW using "<code>pacman</code>" except for SDL2_Pango and libunibreak. </p>
<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> 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> <p>
<blockquote> <blockquote>
<code> <code>
$ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}<br/> $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}<br/>
$ pacman -S mingw-w64-i686-libvorbis<br/> $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk}<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> </code>
</blockquote> </blockquote>
</p> </p>
@ -518,52 +498,27 @@
<section class="indent"><!-- H4: Install SDL_Pango... --> <section class="indent"><!-- H4: Install SDL_Pango... -->
<header> <header>
<h4> <h4>
Install SDL_mixer, SDL_Pango and libunibreak on the 32bit environment </h4> Install SDL2_Pango and libunibreak on the 32bit environment </h4>
</header> </header>
<p> <p>
SDL_mixer, SDL_Pango and libunibreak should be installed manually. </p> SDL2_Pango and libunibreak should be installed manually. </p>
<p> <p>
Cette fois-ci, utilisez le shell MinGW "32bit". Ouvrez le shell depuis le "Menu de Démarrage" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" </p> Cette fois-ci, utilisez le shell MinGW "32bit". Ouvrez le shell depuis le "Menu de Démarrage" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" </p>
<section class="indent"><!-- H5: SDL_mixer --> <section class="indent"><!-- H5: SDL2_Pango -->
<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 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</section><!-- H5: SDL_mixer -->
<section class="indent"><!-- H5: SDL_Pango -->
<header> <header>
<h5>SDL_Pango</h5> <h5>SDL_Pango</h5>
</header> </header>
<p> <p>
Tout d'abord, vous devrez préparer l'archive source et un patch qui est requis, dans le même répertoire. <ul> Download <a href="https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch">a patch</a> from <a href="https://z1.plala.jp/tuxpaint/buildwin.html">z1.plala.jp</a>, which enable SDL2_Pango to create dlls, then build and install SDL2_Pango as follows. <blockquote>
<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> <code>
$ tar zxvf SDL_Pango-0.1.2.tar.gz<br/> $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch<br/>
$ cd SDL_Pango-0.1.2/<br/> $ git clone https://github.com/markuskimius/SDL2_Pango<br/>
$ patch -p0 &lt; ../SDL_Pango-configure-extra-api.patch<br/> $ cd SDL2_Pango<br/>
$ ./configure --prefix=/mingw32 &amp;&amp; make &amp;&amp; make install $ patch -p0 &lt; ../SDL2_Pango-dll.patch<br/>
$ ./configure --prefix=/mingw32 &amp;&amp; make &amp;&amp; make install<br/>
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -602,7 +557,7 @@
<p> <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> <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> <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> Using official binary release available from "<a href="https://imagemagick.org/script/download.php#windows">Windows Binary Release</a>" is recommended, due to the commands installed with "<code>pacman</code>" on MinGW/MSYS not working as expected! </p>
<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> 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> <p>
@ -616,31 +571,114 @@
Vous pouvez rendre ceci permanent en ajoutant ce qui précède à votre fichier de configuration du shell BASH, "<code>~/.bash_profile</code>". </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><!-- H3: ImageMagick -->
<section class="indent"><!-- H3: Tux Paint --> <section class="indent"><!-- H3: Tux Paint & Tux Paint Config. -->
<header> <header>
<h3>Tux Paint</h3> <h3>Tux Paint &amp; Tux Paint Config.</h3>
</header> </header>
<p> <p>
Vous pouvez compiler des binaires 64bit en utilisant le shell MSYS2 64bit, et des binaires 32bit en utilisant le shell MSYS2 32bit. </p> You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries using "MSYS2 32bit" shell, respectively. </p>
<ul> <ul>
<li> <li>
Choisissez "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" dans le "Menu de Démarrage" pour ouvrir le shell 64bit. </li> Choisissez "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" dans le "Menu de Démarrage" pour ouvrir le shell 64bit. </li>
<li> <li>
Choisissez "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" dans le "Menu de Démarrage" pour ouvrir le shell 32bit. </li> Choisissez "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" dans le "Menu de Démarrage" pour ouvrir le shell 32bit. </li>
</ul> </ul>
<p>
Compilez Tux Paint avec la commande suivante : <blockquote> <section class="indent"><!-- H4: Tux Paint Config. -->
<code> <header>
$ make bdist-win32 <h4>Tux Paint Config.</h4>
</code> </header>
</blockquote> <p>
</p> "Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's behavior. You have to build this component before compiling Tux Paint if you want to have it included in your package. </p>
<p class="note"> <p>
<span title="Information">&#128161;</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> You can use either (a) a stable tar-ball release, or (b) the developing source tree. <ol type="a">
<li>
Using stable tar-ball release: <ul>
<li>
<a href="https://sourceforge.net/projects/tuxpaint/files/tuxpaint-config/">Download a source tar-ball</a>
</li>
<li>
Expand the tar-ball and change the directory name so that the final packaging process can find related files. <blockquote>
<code>
$ tar zxvf tuxpaint-config-A.B.C.tar.gz<br/>
$ mv tuxpaint-config-A.B.C tuxpaint-config<br/>
</code>
</blockquote>
</li>
</ul>
</li>
<li>
Using the developing source tree: <ul>
<li>
Fetch the developing source tree from git repository: <blockquote>
<code>
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config tuxpaint-config
</code>
</blockquote>
</li>
</ul>
</li>
</ol>
</p>
<p>
Now you can build Tux Paint Config. as follows: <blockquote>
<code>
$ cd tuxpaint-config<br/>
$ make win32<br/>
</code>
</blockquote>
</p>
</section><!-- H4: Tux Paint Config. -->
<section class="indent"><!-- H4: Tux Paint -->
<header>
<h4>Tux Paint</h4>
</header>
<p>
You can use either (a) a stable tar-ball release, or (b) the developing source tree. <ol type="a">
<li>
Using stable tar-ball release: <ul>
<li>
<a href="https://sourceforge.net/projects/tuxpaint/files/tuxpaint/">Download a source tar-ball</a>
</li>
<li>
Expand the tar-ball and change the directory name so that the final packaging process can find related files. <blockquote>
<code>
$ tar zxvf tuxpaint-A.B.C-sdl2.tar.gz<br/>
$ mv tuxpaint-A.B.C-sdl2 tuxpaint-sdl2<br/>
</code>
</blockquote>
</li>
</ul>
</li>
<li>
Using the developing source tree: <ul>
<li>
Fetch the developing source tree from git repository: <blockquote>
<code>
$ git clone -b sdl2.0 https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint-sdl2
</code>
</blockquote>
</li>
</ul>
</li>
</ol>
</p>
<p>
Now you can build Tux Paint as follows: <blockquote>
<code>
$ cd tuxpaint-sdl2<br/>
$ make bdist-win32<br/>
</code>
</blockquote>
</p>
</section><!-- H4: Tux Paint -->
<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> 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><!-- H3: Tux Paint & Tux Paint Config. -->
<section class="indent"><!-- H3: Building the Tux Paint Windows Installer --> <section class="indent"><!-- H3: Building the Tux Paint Windows Installer -->
<header> <header>
@ -655,7 +693,7 @@
<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> 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> <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-&lt;arch&gt;-installer.exe</code>" dans le même répertoire. </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-sdl2.0-&lt;arch&gt;-installer.exe</code>" dans le même répertoire. </p>
</section><!-- H3: Building the Tux Paint Windows Installer --> </section><!-- H3: Building the Tux Paint Windows Installer -->
<section class="indent"><!-- H3: Running the Tux Paint Windows Installer --> <section class="indent"><!-- H3: Running the Tux Paint Windows Installer -->
@ -942,7 +980,7 @@
<p> <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> 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> <code>
xcode-select --install $ xcode-select --install
</code> </code>
</blockquote> </blockquote>
</p> </p>

2
docs/fr_FR.UTF-8/html/OPTIONS.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/fr_FR.UTF-8/html/PNG.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/fr_FR.UTF-8/html/README.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/fr_FR.UTF-8/html/SIGNALS.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/fr_FR.UTF-8/html/SVG.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

186
docs/gl_ES.UTF-8/INSTALL.txt
View file

@ -5,7 +5,7 @@
Copyright © 2002-2022 by varios colaboradores; see AUTHORS.txt. Copyright © 2002-2022 by varios colaboradores; see AUTHORS.txt.
https://tuxpaint.org/ https://tuxpaint.org/
4 de Xuño de 2022 8 de Xullo de 2022
+----------------------------------------------------+ +----------------------------------------------------+
|Índice | |Índice |
@ -147,8 +147,7 @@ Simple DirectMedia Layer library (libSDL)
Windows Windows
16 de Maio de 2022 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp 8 de Xullo de 2022 Shin-ichi TOYAMA <dolphin6k@wmail.plala.or.jp>
<dolphin6k@wmail.plala.or.jp>
Compiling Set-Up Compiling Set-Up
@ -156,29 +155,34 @@ Windows
«Makefile» inclúe compatibilidade para construír nun sistema Windows «Makefile» inclúe compatibilidade para construír nun sistema Windows
usando MinGW/MSYS (https://sourceforge.net/projects/msys2/). usando MinGW/MSYS (https://sourceforge.net/projects/msys2/).
💡 Note: This documentation relates to the SDL2.0 version of Tux Paint,
which became available starting with version 0.9.28 in June 2022.
Many tools and libraries are required to build Tux Paint. The package Many tools and libraries are required to build Tux Paint. The package
management system "pacman" helps you install them automatically solving management system "pacman" helps you install them automatically solving
complicated dependencies. complicated dependencies.
Download the latest MSYS2 environment from MYSYS2
https://sourceforge.net/projects/msys2/files/Base/ and install it where
you'd like (the default is "C:\msys64") Download the latest MSYS2 environment from https://www.msys2.org/ and
install it where you'd like (the default is "C:\msys64")
Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" -> "MSYS2 Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" -> "MSYS2
MSYS" and execute following command (press [Intro] or [Retorno] to accept MSYS" and execute following command:
the defaults for all questions):
pacman -Syu $ yes "" | pacman -Syu
This will update core system and the window will close automatically. This will update core system and the window will close automatically. Open
Repeat the steps above one more time to finish the remaining update the msys2 shell again and execute following command to finish remaining
process. updating process.
$ yes "" | pacman -Syu
Within the MSYS2 shell, run the following command to install basic Within the MSYS2 shell, run the following command to install basic
development tools: development tools:
pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git
gperf zip patch gperf dos2unix
Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip to 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 the "MinGW 32bit (i686) toolchains" section if you need only a 32bit build
@ -191,7 +195,7 @@ Windows
Within the MSYS2 shell, run the following command to install 64bit Within the MSYS2 shell, run the following command to install 64bit
compiler and basic development tools: compiler and basic development tools:
pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
"ntldd" is a small tool which examine windows executable files to list "ntldd" is a small tool which examine windows executable files to list
Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging
@ -200,53 +204,33 @@ Windows
64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config
You can install tools and libraries required for compiling Tux Paint and You can install tools and libraries required for compiling Tux Paint and
Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL_mixer, Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
SDL_Pango and libunibreak. libunibreak.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can
skip installing it if you are only building "Tux Paint". skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx}
$ pacman -S mingw-w64-x86_64-libvorbis $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk}
$ 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
💡 Note: Close the shell before proceeding to the remaining process. 💡 Note: Close the shell before proceeding to the remaining process.
Install SDL_mixer, SDL_Pango and libunibreak on the 64bit environment Install SDL2_Pango and libunibreak on the 64bit environment
SDL_mixer, SDL_Pango and libunibreak should be installed manually. SDL2_Pango and libunibreak should be installed manually.
This time, use the MinGW "64bit" shell. Open the shell from the "Start This time, use the MinGW "64bit" shell. Open the shell from the "Start
Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit"
SDL_mixer
Download source tar-ball of SDL_mixer-1.2.12 from SDL_mixer's page.
Build and install SDL_mixer as follows.
$ tar zxvf SDL_mixer-1.2.12.tar.gz
$ cd SDL_mixer-1.2.12/
$ ./configure --prefix=/mingw64 && make && make install
SDL_Pango SDL_Pango
At first, you have to prepare source tar-ball and a required patch in the Download a patch from z1.plala.jp, which enable SDL2_Pango to create dlls,
same directory. then build and install SDL2_Pango as follows.
* 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. $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch
$ git clone https://github.com/markuskimius/SDL2_Pango
$ tar zxvf SDL_Pango-0.1.2.tar.gz $ cd SDL2_Pango
$ cd SDL_Pango-0.1.2/ $ patch -p0 < ../SDL2_Pango-dll.patch
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw64 && make && make install $ ./configure --prefix=/mingw64 && make && make install
libunibreak libunibreak
@ -271,7 +255,7 @@ Windows
Within the MSYS2 shell, run the following command to install 32bit Within the MSYS2 shell, run the following command to install 32bit
compiler and basic development tools: compiler and basic development tools:
pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
"ntldd" is a small tool which examine windows executable files to list "ntldd" is a small tool which examine windows executable files to list
Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging
@ -280,53 +264,33 @@ Windows
32bit (i686) dependency libraries for Tux Paint and Tux Paint Config 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config
You can install tools and libraries required for compiling Tux Paint and You can install tools and libraries required for compiling Tux Paint and
Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL_mixer, Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
SDL_Pango and libunibreak. libunibreak.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can
skip installing it if you are only building "Tux Paint". skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}
$ pacman -S mingw-w64-i686-libvorbis $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk}
$ pacman -S mingw-w64-i686-librsvg
$ pacman -S mingw-w64-i686-fribidi
$ pacman -S mingw-w64-i686-libimagequant
$ pacman -S mingw-w64-i686-fltk
💡 Note: Close the shell before proceeding to the remaining process. 💡 Note: Close the shell before proceeding to the remaining process.
Install SDL_mixer, SDL_Pango and libunibreak on the 32bit environment Install SDL2_Pango and libunibreak on the 32bit environment
SDL_mixer, SDL_Pango and libunibreak should be installed manually. SDL2_Pango and libunibreak should be installed manually.
This time, use the MinGW "32bit" shell. Open the shell from the "Start This time, use the MinGW "32bit" shell. Open the shell from the "Start
Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit"
SDL_mixer
Download source tar-ball of SDL_mixer-1.2.12 from SDL_mixer's page.
Build and install SDL_mixer as follows.
$ tar zxvf SDL_mixer-1.2.12.tar.gz
$ cd SDL_mixer-1.2.12/
$ ./configure --prefix=/mingw32 && make && make install
SDL_Pango SDL_Pango
At first, you have to prepare source tar-ball and a required patch in the Download a patch from z1.plala.jp, which enable SDL2_Pango to create dlls,
same directory. then build and install SDL2_Pango as follows.
* 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. $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch
$ git clone https://github.com/markuskimius/SDL2_Pango
$ tar zxvf SDL_Pango-0.1.2.tar.gz $ cd SDL2_Pango
$ cd SDL_Pango-0.1.2/ $ patch -p0 < ../SDL2_Pango-dll.patch
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw32 && make && make install $ ./configure --prefix=/mingw32 && make && make install
libunibreak libunibreak
@ -364,27 +328,66 @@ Windows
You can make this permanent by adding the above to your the BASH shell You can make this permanent by adding the above to your the BASH shell
configuration file, "~/.bash_profile". configuration file, "~/.bash_profile".
Tux Paint Tux Paint & Tux Paint Config.
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit binaries You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit
using MSYS2 32bit shell, respectively. binaries using "MSYS2 32bit" shell, respectively.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start Menu" to * Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start Menu" to
open the 64bit shell. open the 64bit shell.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start Menu" to * Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start Menu" to
open the 32bit shell. open the 32bit shell.
Compile Tux Paint with the following command: Tux Paint Config.
"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's
behavior. You have to build this component before compiling Tux Paint if
you 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
* 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:
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config
tuxpaint-config
Now you can build Tux Paint Config. as follows:
$ cd tuxpaint-config
$ make win32
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
* 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-sdl2.tar.gz
$ mv tuxpaint-A.B.C-sdl2 tuxpaint-sdl2
b. Using the developing source tree:
* Fetch the developing source tree from git repository:
$ git clone -b sdl2.0
https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint-sdl2
Now you can build Tux Paint as follows:
$ cd tuxpaint-sdl2
$ make bdist-win32 $ 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 All the files needed for starting Tux Paint (and Tux Paint Config.) are
collected in the directory for binary distribution "bdist" directory under collected in the directory for binary distribution "bdist" directory under
"win32". You can start them by double-clicking their executable (.exe) "win32". You can start them by double-clicking their executable (.exe)
@ -410,7 +413,8 @@ Windows
Then, you can easily build an executable installer by right-clicking on Then, you can easily build an executable installer by right-clicking on
the "tuxpaint.iss" icon in the "win32" directory and selecting "Compile" 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 on the list. It will run for a while, and eventually you will find a
"tuxpaint-X.Y.Z-windows-<arch>-installer.exe" file in the same directory. "tuxpaint-X.Y.Z-windows-sdl2.0-<arch>-installer.exe" file in the same
directory.
Running the Tux Paint Windows Installer Running the Tux Paint Windows Installer
@ -613,7 +617,7 @@ macOS
once to accept its license agreements. You may also need to install the once to accept its license agreements. You may also need to install the
Xcode command line tools using the command: Xcode command line tools using the command:
xcode-select --install $ xcode-select --install
Building Tux Paint also requires various libraries. We install them from Building Tux Paint also requires various libraries. We install them from
MacPorts where possible, source code otherwise. Install MacPorts to the MacPorts where possible, source code otherwise. Install MacPorts to the

2
docs/gl_ES.UTF-8/html/EXTENDING.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

290
docs/gl_ES.UTF-8/html/INSTALL.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }
@ -96,7 +96,7 @@
</p> </p>
<p> <p>
4 de Xuño de 2022 </p> 8 de Xullo de 2022 </p>
</center> </center>
</header> </header>
@ -301,7 +301,7 @@
<p style="font-size: small;"> <p style="font-size: small;">
<em> <em>
16 de Maio de 2022 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp &lt;<a href="mailto:dolphin6k@wmail.plala.or.jp">dolphin6k@wmail.plala.or.jp</a>&gt; 8 de Xullo de 2022 Shin-ichi TOYAMA &lt;<a href="mailto:dolphin6k@wmail.plala.or.jp">dolphin6k@wmail.plala.or.jp</a>&gt;
</em> </em>
</p> </p>
</header> </header>
@ -314,35 +314,48 @@
<p> <p>
A partir de febreiro de 2005 (comezando con Tux Paint 0.9.15), o «<code>Makefile</code>» inclúe compatibilidade para construír nun sistema Windows usando MinGW/MSYS (<a href="https://sourceforge.net/projects/msys2/">https://sourceforge.net/projects/msys2/</a>). </p> A partir de febreiro de 2005 (comezando con Tux Paint 0.9.15), o «<code>Makefile</code>» inclúe compatibilidade para construír nun sistema Windows usando MinGW/MSYS (<a href="https://sourceforge.net/projects/msys2/">https://sourceforge.net/projects/msys2/</a>). </p>
<p class="note">
<span title="Information">&#128161;</span> <strong>Note:</strong> This documentation relates to the SDL2.0 version of Tux Paint, which became available starting with version 0.9.28 in June 2022. </p>
<p> <p>
Many tools and libraries are required to build Tux Paint. The package management system "<code>pacman</code>" helps you install them automatically solving complicated dependencies. </p> Many tools and libraries are required to build Tux Paint. The package management system "<code>pacman</code>" helps you install them automatically solving complicated dependencies. </p>
<p> <section class="indent"><!-- H4: MSYS2 -->
Download the latest MSYS2 environment from <a href="https://sourceforge.net/projects/msys2/files/Base/">https://sourceforge.net/projects/msys2/files/Base/</a> and install it where you'd like (the default is "<code>C:\msys64</code>") </p> <header>
<p> <h4>MYSYS2</h4>
Open the MSYS2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command (press <b><code>[Intro]</code></b> or <b><code>[Retorno]</code></b> to accept the defaults for all questions): </header>
<blockquote>
<code>
pacman -Syu
</code>
</blockquote>
</p>
<p> <p>
This will update core system and the window will close automatically. Repeat the steps above one more time to finish the remaining update process. </p> Download the latest MSYS2 environment from <a href="https://www.msys2.org/">https://www.msys2.org/</a> and install it where you'd like (the default is "<code>C:\msys64</code>") </p>
<p>
<p> Open the MSYS2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command: <blockquote>
Within the MSYS2 shell, run the following command to install basic development tools: <blockquote> <code>
<code> $ yes "" | pacman -Syu
pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch gperf </code>
</code> </blockquote>
</blockquote> </p>
</p>
<p>
<p> 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. <blockquote>
<i> <code>
Proceed to the next "<a href="#64bit">MinGW 64bit (x86_64) toolchains</a>" section, or skip to the "<a href="#32bit">MinGW 32bit (i686) toolchains</a>" section if you need only a 32bit build environment. </i> $ yes "" | pacman -Syu
</p> </code>
</blockquote>
</p>
<p>
Within the MSYS2 shell, run the following command to install basic development tools: <blockquote>
<code>
$ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch gperf dos2unix
</code>
</blockquote>
</p>
<p>
<i>
Proceed to the next "<a href="#64bit">MinGW 64bit (x86_64) toolchains</a>" section, or skip to the "<a href="#32bit">MinGW 32bit (i686) toolchains</a>" section if you need only a 32bit build environment. </i>
</p>
</section>
<hr size="1" noshade width="75%" /> <hr size="1" noshade width="75%" />
<section class="indent"><!-- H4: MinGW...compiler and tools --> <section class="indent"><!-- H4: MinGW...compiler and tools -->
@ -356,7 +369,7 @@
<p> <p>
Within the MSYS2 shell, run the following command to install 64bit compiler and basic development tools: <blockquote> Within the MSYS2 shell, run the following command to install 64bit compiler and basic development tools: <blockquote>
<code> <code>
pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -371,18 +384,14 @@
</header> </header>
<p> <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> You can install tools and libraries required for compiling Tux Paint and Tux Paint Config on MSYS2/MINGW using "<code>pacman</code>" except for SDL2_Pango and libunibreak. </p>
<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> 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> <p>
<blockquote> <blockquote>
<code> <code>
$ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx}<br/> $ 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,fribidi,libimagequant,fltk}<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> </code>
</blockquote> </blockquote>
</p> </p>
@ -393,52 +402,27 @@
<section class="indent"><!-- H4: Install SDL_Pango... --> <section class="indent"><!-- H4: Install SDL_Pango... -->
<header> <header>
<h4> <h4>
Install SDL_mixer, SDL_Pango and libunibreak on the 64bit environment </h4> Install SDL2_Pango and libunibreak on the 64bit environment </h4>
</header> </header>
<p> <p>
SDL_mixer, SDL_Pango and libunibreak should be installed manually. </p> SDL2_Pango and libunibreak should be installed manually. </p>
<p> <p>
This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" </p> This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" </p>
<section class="indent"><!-- H5: SDL_mixer --> <section class="indent"><!-- H5: SDL2_Pango -->
<header>
<h5>SDL_mixer</h5>
</header>
<p>
Download <a href="https://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.12.tar.gz">source tar-ball of SDL_mixer-1.2.12</a> from <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 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</section><!-- H5: SDL_mixer -->
<section class="indent"><!-- H5: SDL_Pango -->
<header> <header>
<h5>SDL_Pango</h5> <h5>SDL_Pango</h5>
</header> </header>
<p> <p>
At first, you have to prepare source tar-ball and a required patch in the same directory. <ul> Download <a href="https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch">a patch</a> from <a href="https://z1.plala.jp/tuxpaint/buildwin.html">z1.plala.jp</a>, which enable SDL2_Pango to create dlls, then build and install SDL2_Pango as follows. <blockquote>
<li>
Download <a href="https://sourceforge.net/projects/sdlpango/files/SDL_Pango/0.1.2/SDL_Pango-0.1.2.tar.gz/download">source tar-ball of SDL_Pango-0.1.2</a> from <a href="https://sourceforge.net/projects/sdlpango/">SDL_Pango's page on Sourceforge.net</a>. </li>
<li>
Download <a href="http://johnnypops.co.uk/tuxpaint/SDL_Pango-configure-extra-api.patch">a patch file</a> from <a href="http://www.johnnypops.co.uk/tuxpaint/">John Popplewell's "Tux Paint - MinGW/MSYS build instructions" webpage</a>. (This adds some extra (required) functionality to SDL_Pango.) </li>
</ul>
</p>
<p>
Build and install SDL_Pango as follows. <blockquote>
<code> <code>
$ tar zxvf SDL_Pango-0.1.2.tar.gz<br/> $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch<br/>
$ cd SDL_Pango-0.1.2/<br/> $ git clone https://github.com/markuskimius/SDL2_Pango<br/>
$ patch -p0 &lt; ../SDL_Pango-configure-extra-api.patch<br/> $ cd SDL2_Pango<br/>
$ ./configure --prefix=/mingw64 &amp;&amp; make &amp;&amp; make install $ patch -p0 &lt; ../SDL2_Pango-dll.patch<br/>
$ ./configure --prefix=/mingw64 &amp;&amp; make &amp;&amp; make install<br/>
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -481,7 +465,7 @@
<p> <p>
Within the MSYS2 shell, run the following command to install 32bit compiler and basic development tools: <blockquote> Within the MSYS2 shell, run the following command to install 32bit compiler and basic development tools: <blockquote>
<code> <code>
pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -496,18 +480,14 @@
</header> </header>
<p> <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> You can install tools and libraries required for compiling Tux Paint and Tux Paint Config on MSYS2/MINGW using "<code>pacman</code>" except for SDL2_Pango and libunibreak. </p>
<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> 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> <p>
<blockquote> <blockquote>
<code> <code>
$ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}<br/> $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}<br/>
$ pacman -S mingw-w64-i686-libvorbis<br/> $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk}<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> </code>
</blockquote> </blockquote>
</p> </p>
@ -518,52 +498,27 @@
<section class="indent"><!-- H4: Install SDL_Pango... --> <section class="indent"><!-- H4: Install SDL_Pango... -->
<header> <header>
<h4> <h4>
Install SDL_mixer, SDL_Pango and libunibreak on the 32bit environment </h4> Install SDL2_Pango and libunibreak on the 32bit environment </h4>
</header> </header>
<p> <p>
SDL_mixer, SDL_Pango and libunibreak should be installed manually. </p> SDL2_Pango and libunibreak should be installed manually. </p>
<p> <p>
This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" </p> This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" </p>
<section class="indent"><!-- H5: SDL_mixer --> <section class="indent"><!-- H5: SDL2_Pango -->
<header>
<h5>SDL_mixer</h5>
</header>
<p>
Download <a href="https://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.12.tar.gz">source tar-ball of SDL_mixer-1.2.12</a> from <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 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</section><!-- H5: SDL_mixer -->
<section class="indent"><!-- H5: SDL_Pango -->
<header> <header>
<h5>SDL_Pango</h5> <h5>SDL_Pango</h5>
</header> </header>
<p> <p>
At first, you have to prepare source tar-ball and a required patch in the same directory. <ul> Download <a href="https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch">a patch</a> from <a href="https://z1.plala.jp/tuxpaint/buildwin.html">z1.plala.jp</a>, which enable SDL2_Pango to create dlls, then build and install SDL2_Pango as follows. <blockquote>
<li>
Download <a href="https://sourceforge.net/projects/sdlpango/files/SDL_Pango/0.1.2/SDL_Pango-0.1.2.tar.gz/download">source tar-ball of SDL_Pango-0.1.2</a> from <a href="https://sourceforge.net/projects/sdlpango/">SDL_Pango's page on Sourceforge.net</a>. </li>
<li>
Download <a href="http://johnnypops.co.uk/tuxpaint/SDL_Pango-configure-extra-api.patch">a patch file</a> from <a href="http://www.johnnypops.co.uk/tuxpaint/">John Popplewell's "Tux Paint - MinGW/MSYS build instructions" webpage</a>. (This adds some extra (required) functionality to SDL_Pango.) </li>
</ul>
</p>
<p>
Build and install SDL_Pango as follows. <blockquote>
<code> <code>
$ tar zxvf SDL_Pango-0.1.2.tar.gz<br/> $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch<br/>
$ cd SDL_Pango-0.1.2/<br/> $ git clone https://github.com/markuskimius/SDL2_Pango<br/>
$ patch -p0 &lt; ../SDL_Pango-configure-extra-api.patch<br/> $ cd SDL2_Pango<br/>
$ ./configure --prefix=/mingw32 &amp;&amp; make &amp;&amp; make install $ patch -p0 &lt; ../SDL2_Pango-dll.patch<br/>
$ ./configure --prefix=/mingw32 &amp;&amp; make &amp;&amp; make install<br/>
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -602,7 +557,7 @@
<p> <p>
<a href="https://imagemagick.org">ImageMagick</a> 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. </p> <a href="https://imagemagick.org">ImageMagick</a> 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. </p>
<p> <p>
Using official binary release available from "<a href="https://imagemagick.org/script/download.php#windowsand">Windows Binary Release</a>" is recommended, due to the commands installed with "<code>pacman</code>" on MinGW/MSYS not working as expected! </p> Using official binary release available from "<a href="https://imagemagick.org/script/download.php#windows">Windows Binary Release</a>" is recommended, due to the commands installed with "<code>pacman</code>" on MinGW/MSYS not working as expected! </p>
<p> <p>
Do not forget to enable "Install legacy utilities (e.g. convert)" while installing it, because Tux Paint's build process uses them. </p> Do not forget to enable "Install legacy utilities (e.g. convert)" while installing it, because Tux Paint's build process uses them. </p>
<p> <p>
@ -616,31 +571,114 @@
You can make this permanent by adding the above to your the BASH shell configuration file, "<code>~/.bash_profile</code>". </p> You can make this permanent by adding the above to your the BASH shell configuration file, "<code>~/.bash_profile</code>". </p>
</section><!-- H3: ImageMagick --> </section><!-- H3: ImageMagick -->
<section class="indent"><!-- H3: Tux Paint --> <section class="indent"><!-- H3: Tux Paint & Tux Paint Config. -->
<header> <header>
<h3>Tux Paint</h3> <h3>Tux Paint &amp; Tux Paint Config.</h3>
</header> </header>
<p> <p>
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit binaries using MSYS2 32bit shell, respectively. </p> You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries using "MSYS2 32bit" shell, respectively. </p>
<ul> <ul>
<li> <li>
Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" from the "Start Menu" to open the 64bit shell. </li> Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" from the "Start Menu" to open the 64bit shell. </li>
<li> <li>
Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" from the "Start Menu" to open the 32bit shell. </li> Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" from the "Start Menu" to open the 32bit shell. </li>
</ul> </ul>
<p>
Compile Tux Paint with the following command: <blockquote> <section class="indent"><!-- H4: Tux Paint Config. -->
<code> <header>
$ make bdist-win32 <h4>Tux Paint Config.</h4>
</code> </header>
</blockquote> <p>
</p> "Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's behavior. You have to build this component before compiling Tux Paint if you want to have it included in your package. </p>
<p class="note"> <p>
<span title="Information">&#128161;</span> <strong>Note:</strong> 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 "<code>tuxpaint-config</code>" (with no version number, e.g., "<code>tuxpaint-config-X.Y.Z</code>"). See "Tux Paint Config."'s INSTALL.txt documentation for details. </p> You can use either (a) a stable tar-ball release, or (b) the developing source tree. <ol type="a">
<li>
Using stable tar-ball release: <ul>
<li>
<a href="https://sourceforge.net/projects/tuxpaint/files/tuxpaint-config/">Download a source tar-ball</a>
</li>
<li>
Expand the tar-ball and change the directory name so that the final packaging process can find related files. <blockquote>
<code>
$ tar zxvf tuxpaint-config-A.B.C.tar.gz<br/>
$ mv tuxpaint-config-A.B.C tuxpaint-config<br/>
</code>
</blockquote>
</li>
</ul>
</li>
<li>
Using the developing source tree: <ul>
<li>
Fetch the developing source tree from git repository: <blockquote>
<code>
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config tuxpaint-config
</code>
</blockquote>
</li>
</ul>
</li>
</ol>
</p>
<p>
Now you can build Tux Paint Config. as follows: <blockquote>
<code>
$ cd tuxpaint-config<br/>
$ make win32<br/>
</code>
</blockquote>
</p>
</section><!-- H4: Tux Paint Config. -->
<section class="indent"><!-- H4: Tux Paint -->
<header>
<h4>Tux Paint</h4>
</header>
<p>
You can use either (a) a stable tar-ball release, or (b) the developing source tree. <ol type="a">
<li>
Using stable tar-ball release: <ul>
<li>
<a href="https://sourceforge.net/projects/tuxpaint/files/tuxpaint/">Download a source tar-ball</a>
</li>
<li>
Expand the tar-ball and change the directory name so that the final packaging process can find related files. <blockquote>
<code>
$ tar zxvf tuxpaint-A.B.C-sdl2.tar.gz<br/>
$ mv tuxpaint-A.B.C-sdl2 tuxpaint-sdl2<br/>
</code>
</blockquote>
</li>
</ul>
</li>
<li>
Using the developing source tree: <ul>
<li>
Fetch the developing source tree from git repository: <blockquote>
<code>
$ git clone -b sdl2.0 https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint-sdl2
</code>
</blockquote>
</li>
</ul>
</li>
</ol>
</p>
<p>
Now you can build Tux Paint as follows: <blockquote>
<code>
$ cd tuxpaint-sdl2<br/>
$ make bdist-win32<br/>
</code>
</blockquote>
</p>
</section><!-- H4: Tux Paint -->
<p> <p>
All the files needed for starting Tux Paint (and Tux Paint Config.) are collected in the directory for binary distribution "<code>bdist</code>" directory under "<code>win32</code>". You can start them by double-clicking their executable (<code>.exe</code>) files in the "<code>bdist</code>" directory. </p> All the files needed for starting Tux Paint (and Tux Paint Config.) are collected in the directory for binary distribution "<code>bdist</code>" directory under "<code>win32</code>". You can start them by double-clicking their executable (<code>.exe</code>) files in the "<code>bdist</code>" directory. </p>
</section><!-- H3: Tux Paint --> </section><!-- H3: Tux Paint & Tux Paint Config. -->
<section class="indent"><!-- H3: Building the Tux Paint Windows Installer --> <section class="indent"><!-- H3: Building the Tux Paint Windows Installer -->
<header> <header>
@ -655,7 +693,7 @@
<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> 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> <p>
Then, you can easily build an executable installer by right-clicking on the "<code>tuxpaint.iss</code>" icon in the "<code>win32</code>" directory and selecting "Compile" on the list. It will run for a while, and eventually you will find a "<code>tuxpaint-<i>X.Y.Z</i>-windows-&lt;arch&gt;-installer.exe</code>" file in the same directory. </p> Then, you can easily build an executable installer by right-clicking on the "<code>tuxpaint.iss</code>" icon in the "<code>win32</code>" directory and selecting "Compile" on the list. It will run for a while, and eventually you will find a "<code>tuxpaint-<i>X.Y.Z</i>-windows-sdl2.0-&lt;arch&gt;-installer.exe</code>" file in the same directory. </p>
</section><!-- H3: Building the Tux Paint Windows Installer --> </section><!-- H3: Building the Tux Paint Windows Installer -->
<section class="indent"><!-- H3: Running the Tux Paint Windows Installer --> <section class="indent"><!-- H3: Running the Tux Paint Windows Installer -->
@ -942,7 +980,7 @@
<p> <p>
Although Tux Paint is built without the Xcode IDE, Xcode itself is still required to build Tux Paint. <a href="https://developer.apple.com/xcode/ide/">Download it from the App Store</a>, and launch it once to accept its license agreements. You may also need to install the Xcode command line tools using the command: <blockquote> Although Tux Paint is built without the Xcode IDE, Xcode itself is still required to build Tux Paint. <a href="https://developer.apple.com/xcode/ide/">Download it from the App Store</a>, and launch it once to accept its license agreements. You may also need to install the Xcode command line tools using the command: <blockquote>
<code> <code>
xcode-select --install $ xcode-select --install
</code> </code>
</blockquote> </blockquote>
</p> </p>

2
docs/gl_ES.UTF-8/html/OPTIONS.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/gl_ES.UTF-8/html/PNG.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/gl_ES.UTF-8/html/README.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/gl_ES.UTF-8/html/SIGNALS.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/gl_ES.UTF-8/html/SVG.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

186
docs/ja_JP.UTF-8/INSTALL.txt
View file

@ -5,7 +5,7 @@
Copyright © 2002-2022 by various contributors; AUTHORS.txt 参照. Copyright © 2002-2022 by various contributors; AUTHORS.txt 参照.
https://tuxpaint.org/ https://tuxpaint.org/
2022年6月 4日 2022年7月 8日
+----------------------------------------------------+ +----------------------------------------------------+
|目次 | |目次 |
@ -144,8 +144,7 @@ Simple DirectMedia Layer library (libSDL)
Windows Windows
2022年5月16日 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp 2022年7月 8日 Shin-ichi TOYAMA <dolphin6k@wmail.plala.or.jp>
<dolphin6k@wmail.plala.or.jp>
Compiling Set-Up Compiling Set-Up
@ -153,29 +152,34 @@ Windows
includes support for building on a Windows system using MinGW/MSYS includes support for building on a Windows system using MinGW/MSYS
(https://sourceforge.net/projects/msys2/). (https://sourceforge.net/projects/msys2/).
💡 Note: This documentation relates to the SDL2.0 version of Tux Paint,
which became available starting with version 0.9.28 in June 2022.
Many tools and libraries are required to build Tux Paint. The package Many tools and libraries are required to build Tux Paint. The package
management system "pacman" helps you install them automatically solving management system "pacman" helps you install them automatically solving
complicated dependencies. complicated dependencies.
Download the latest MSYS2 environment from MYSYS2
https://sourceforge.net/projects/msys2/files/Base/ and install it where
you'd like (the default is "C:\msys64") Download the latest MSYS2 environment from https://www.msys2.org/ and
install it where you'd like (the default is "C:\msys64")
Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" -> "MSYS2 Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" -> "MSYS2
MSYS" and execute following command (press [Enter] or [Return] to accept MSYS" and execute following command:
the defaults for all questions):
pacman -Syu $ yes "" | pacman -Syu
This will update core system and the window will close automatically. This will update core system and the window will close automatically. Open
Repeat the steps above one more time to finish the remaining update the msys2 shell again and execute following command to finish remaining
process. updating process.
$ yes "" | pacman -Syu
Within the MSYS2 shell, run the following command to install basic Within the MSYS2 shell, run the following command to install basic
development tools: development tools:
pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git
gperf zip patch gperf dos2unix
Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip to 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 the "MinGW 32bit (i686) toolchains" section if you need only a 32bit build
@ -188,7 +192,7 @@ Windows
Within the MSYS2 shell, run the following command to install 64bit Within the MSYS2 shell, run the following command to install 64bit
compiler and basic development tools: compiler and basic development tools:
pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
"ntldd" is a small tool which examine windows executable files to list "ntldd" is a small tool which examine windows executable files to list
Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging
@ -197,53 +201,33 @@ Windows
64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config
You can install tools and libraries required for compiling Tux Paint and You can install tools and libraries required for compiling Tux Paint and
Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL_mixer, Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
SDL_Pango and libunibreak. libunibreak.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can
skip installing it if you are only building "Tux Paint". skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx}
$ pacman -S mingw-w64-x86_64-libvorbis $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk}
$ 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
💡 Note: Close the shell before proceeding to the remaining process. 💡 Note: Close the shell before proceeding to the remaining process.
Install SDL_mixer, SDL_Pango and libunibreak on the 64bit environment Install SDL2_Pango and libunibreak on the 64bit environment
SDL_mixer, SDL_Pango and libunibreak should be installed manually. SDL2_Pango and libunibreak should be installed manually.
This time, use the MinGW "64bit" shell. Open the shell from the "Start This time, use the MinGW "64bit" shell. Open the shell from the "Start
Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit"
SDL_mixer
Download source tar-ball of SDL_mixer-1.2.12 from SDL_mixer's page.
Build and install SDL_mixer as follows.
$ tar zxvf SDL_mixer-1.2.12.tar.gz
$ cd SDL_mixer-1.2.12/
$ ./configure --prefix=/mingw64 && make && make install
SDL_Pango SDL_Pango
At first, you have to prepare source tar-ball and a required patch in the Download a patch from z1.plala.jp, which enable SDL2_Pango to create dlls,
same directory. then build and install SDL2_Pango as follows.
* 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. $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch
$ git clone https://github.com/markuskimius/SDL2_Pango
$ tar zxvf SDL_Pango-0.1.2.tar.gz $ cd SDL2_Pango
$ cd SDL_Pango-0.1.2/ $ patch -p0 < ../SDL2_Pango-dll.patch
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw64 && make && make install $ ./configure --prefix=/mingw64 && make && make install
libunibreak libunibreak
@ -268,7 +252,7 @@ Windows
Within the MSYS2 shell, run the following command to install 32bit Within the MSYS2 shell, run the following command to install 32bit
compiler and basic development tools: compiler and basic development tools:
pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
"ntldd" is a small tool which examine windows executable files to list "ntldd" is a small tool which examine windows executable files to list
Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging
@ -277,53 +261,33 @@ Windows
32bit (i686) dependency libraries for Tux Paint and Tux Paint Config 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config
You can install tools and libraries required for compiling Tux Paint and You can install tools and libraries required for compiling Tux Paint and
Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL_mixer, Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
SDL_Pango and libunibreak. libunibreak.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can
skip installing it if you are only building "Tux Paint". skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}
$ pacman -S mingw-w64-i686-libvorbis $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk}
$ pacman -S mingw-w64-i686-librsvg
$ pacman -S mingw-w64-i686-fribidi
$ pacman -S mingw-w64-i686-libimagequant
$ pacman -S mingw-w64-i686-fltk
💡 Note: Close the shell before proceeding to the remaining process. 💡 Note: Close the shell before proceeding to the remaining process.
Install SDL_mixer, SDL_Pango and libunibreak on the 32bit environment Install SDL2_Pango and libunibreak on the 32bit environment
SDL_mixer, SDL_Pango and libunibreak should be installed manually. SDL2_Pango and libunibreak should be installed manually.
This time, use the MinGW "32bit" shell. Open the shell from the "Start This time, use the MinGW "32bit" shell. Open the shell from the "Start
Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit"
SDL_mixer
Download source tar-ball of SDL_mixer-1.2.12 from SDL_mixer's page.
Build and install SDL_mixer as follows.
$ tar zxvf SDL_mixer-1.2.12.tar.gz
$ cd SDL_mixer-1.2.12/
$ ./configure --prefix=/mingw32 && make && make install
SDL_Pango SDL_Pango
At first, you have to prepare source tar-ball and a required patch in the Download a patch from z1.plala.jp, which enable SDL2_Pango to create dlls,
same directory. then build and install SDL2_Pango as follows.
* 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. $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch
$ git clone https://github.com/markuskimius/SDL2_Pango
$ tar zxvf SDL_Pango-0.1.2.tar.gz $ cd SDL2_Pango
$ cd SDL_Pango-0.1.2/ $ patch -p0 < ../SDL2_Pango-dll.patch
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw32 && make && make install $ ./configure --prefix=/mingw32 && make && make install
libunibreak libunibreak
@ -361,27 +325,66 @@ Windows
You can make this permanent by adding the above to your the BASH shell You can make this permanent by adding the above to your the BASH shell
configuration file, "~/.bash_profile". configuration file, "~/.bash_profile".
Tux Paint Tux Paint & Tux Paint Config.
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit binaries You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit
using MSYS2 32bit shell, respectively. binaries using "MSYS2 32bit" shell, respectively.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start Menu" to * Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start Menu" to
open the 64bit shell. open the 64bit shell.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start Menu" to * Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start Menu" to
open the 32bit shell. open the 32bit shell.
Compile Tux Paint with the following command: Tux Paint Config.
"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's
behavior. You have to build this component before compiling Tux Paint if
you 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
* 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:
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config
tuxpaint-config
Now you can build Tux Paint Config. as follows:
$ cd tuxpaint-config
$ make win32
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
* 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-sdl2.tar.gz
$ mv tuxpaint-A.B.C-sdl2 tuxpaint-sdl2
b. Using the developing source tree:
* Fetch the developing source tree from git repository:
$ git clone -b sdl2.0
https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint-sdl2
Now you can build Tux Paint as follows:
$ cd tuxpaint-sdl2
$ make bdist-win32 $ 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 All the files needed for starting Tux Paint (and Tux Paint Config.) are
collected in the directory for binary distribution "bdist" directory under collected in the directory for binary distribution "bdist" directory under
"win32". You can start them by double-clicking their executable (.exe) "win32". You can start them by double-clicking their executable (.exe)
@ -407,7 +410,8 @@ Windows
Then, you can easily build an executable installer by right-clicking on Then, you can easily build an executable installer by right-clicking on
the "tuxpaint.iss" icon in the "win32" directory and selecting "Compile" 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 on the list. It will run for a while, and eventually you will find a
"tuxpaint-X.Y.Z-windows-<arch>-installer.exe" file in the same directory. "tuxpaint-X.Y.Z-windows-sdl2.0-<arch>-installer.exe" file in the same
directory.
Running the Tux Paint Windows Installer Running the Tux Paint Windows Installer
@ -604,7 +608,7 @@ macOS
once to accept its license agreements. You may also need to install the once to accept its license agreements. You may also need to install the
Xcode command line tools using the command: Xcode command line tools using the command:
xcode-select --install $ xcode-select --install
Building Tux Paint also requires various libraries. We install them from Building Tux Paint also requires various libraries. We install them from
MacPorts where possible, source code otherwise. Install MacPorts to the MacPorts where possible, source code otherwise. Install MacPorts to the

2
docs/ja_JP.UTF-8/html/EXTENDING.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

290
docs/ja_JP.UTF-8/html/INSTALL.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }
@ -96,7 +96,7 @@
</p> </p>
<p> <p>
2022年6月 4日 </p> 2022年7月 8日 </p>
</center> </center>
</header> </header>
@ -301,7 +301,7 @@
<p style="font-size: small;"> <p style="font-size: small;">
<em> <em>
2022年5月16日 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp &lt;<a href="mailto:dolphin6k@wmail.plala.or.jp">dolphin6k@wmail.plala.or.jp</a>&gt; 2022年7月 8日 Shin-ichi TOYAMA &lt;<a href="mailto:dolphin6k@wmail.plala.or.jp">dolphin6k@wmail.plala.or.jp</a>&gt;
</em> </em>
</p> </p>
</header> </header>
@ -314,35 +314,48 @@
<p> <p>
As of February 2005 (starting with Tux Paint 0.9.15), the "<code>Makefile</code>" includes support for building on a Windows system using MinGW/MSYS (<a href="https://sourceforge.net/projects/msys2/">https://sourceforge.net/projects/msys2/</a>). </p> As of February 2005 (starting with Tux Paint 0.9.15), the "<code>Makefile</code>" includes support for building on a Windows system using MinGW/MSYS (<a href="https://sourceforge.net/projects/msys2/">https://sourceforge.net/projects/msys2/</a>). </p>
<p class="note">
<span title="Information">&#128161;</span> <strong>Note:</strong> This documentation relates to the SDL2.0 version of Tux Paint, which became available starting with version 0.9.28 in June 2022. </p>
<p> <p>
Many tools and libraries are required to build Tux Paint. The package management system "<code>pacman</code>" helps you install them automatically solving complicated dependencies. </p> Many tools and libraries are required to build Tux Paint. The package management system "<code>pacman</code>" helps you install them automatically solving complicated dependencies. </p>
<p> <section class="indent"><!-- H4: MSYS2 -->
Download the latest MSYS2 environment from <a href="https://sourceforge.net/projects/msys2/files/Base/">https://sourceforge.net/projects/msys2/files/Base/</a> and install it where you'd like (the default is "<code>C:\msys64</code>") </p> <header>
<p> <h4>MYSYS2</h4>
Open the MSYS2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command (press <b><code>[Enter]</code></b> or <b><code>[Return]</code></b> to accept the defaults for all questions): </header>
<blockquote>
<code>
pacman -Syu
</code>
</blockquote>
</p>
<p> <p>
This will update core system and the window will close automatically. Repeat the steps above one more time to finish the remaining update process. </p> Download the latest MSYS2 environment from <a href="https://www.msys2.org/">https://www.msys2.org/</a> and install it where you'd like (the default is "<code>C:\msys64</code>") </p>
<p>
<p> Open the MSYS2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command: <blockquote>
Within the MSYS2 shell, run the following command to install basic development tools: <blockquote> <code>
<code> $ yes "" | pacman -Syu
pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch gperf </code>
</code> </blockquote>
</blockquote> </p>
</p>
<p>
<p> 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. <blockquote>
<i> <code>
Proceed to the next "<a href="#64bit">MinGW 64bit (x86_64) toolchains</a>" section, or skip to the "<a href="#32bit">MinGW 32bit (i686) toolchains</a>" section if you need only a 32bit build environment. </i> $ yes "" | pacman -Syu
</p> </code>
</blockquote>
</p>
<p>
Within the MSYS2 shell, run the following command to install basic development tools: <blockquote>
<code>
$ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch gperf dos2unix
</code>
</blockquote>
</p>
<p>
<i>
Proceed to the next "<a href="#64bit">MinGW 64bit (x86_64) toolchains</a>" section, or skip to the "<a href="#32bit">MinGW 32bit (i686) toolchains</a>" section if you need only a 32bit build environment. </i>
</p>
</section>
<hr size="1" noshade width="75%" /> <hr size="1" noshade width="75%" />
<section class="indent"><!-- H4: MinGW...compiler and tools --> <section class="indent"><!-- H4: MinGW...compiler and tools -->
@ -356,7 +369,7 @@
<p> <p>
Within the MSYS2 shell, run the following command to install 64bit compiler and basic development tools: <blockquote> Within the MSYS2 shell, run the following command to install 64bit compiler and basic development tools: <blockquote>
<code> <code>
pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -371,18 +384,14 @@
</header> </header>
<p> <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> You can install tools and libraries required for compiling Tux Paint and Tux Paint Config on MSYS2/MINGW using "<code>pacman</code>" except for SDL2_Pango and libunibreak. </p>
<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> 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> <p>
<blockquote> <blockquote>
<code> <code>
$ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx}<br/> $ 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,fribidi,libimagequant,fltk}<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> </code>
</blockquote> </blockquote>
</p> </p>
@ -393,52 +402,27 @@
<section class="indent"><!-- H4: Install SDL_Pango... --> <section class="indent"><!-- H4: Install SDL_Pango... -->
<header> <header>
<h4> <h4>
Install SDL_mixer, SDL_Pango and libunibreak on the 64bit environment </h4> Install SDL2_Pango and libunibreak on the 64bit environment </h4>
</header> </header>
<p> <p>
SDL_mixer, SDL_Pango and libunibreak should be installed manually. </p> SDL2_Pango and libunibreak should be installed manually. </p>
<p> <p>
This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" </p> This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" </p>
<section class="indent"><!-- H5: SDL_mixer --> <section class="indent"><!-- H5: SDL2_Pango -->
<header>
<h5>SDL_mixer</h5>
</header>
<p>
Download <a href="https://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.12.tar.gz">source tar-ball of SDL_mixer-1.2.12</a> from <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 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</section><!-- H5: SDL_mixer -->
<section class="indent"><!-- H5: SDL_Pango -->
<header> <header>
<h5>SDL_Pango</h5> <h5>SDL_Pango</h5>
</header> </header>
<p> <p>
At first, you have to prepare source tar-ball and a required patch in the same directory. <ul> Download <a href="https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch">a patch</a> from <a href="https://z1.plala.jp/tuxpaint/buildwin.html">z1.plala.jp</a>, which enable SDL2_Pango to create dlls, then build and install SDL2_Pango as follows. <blockquote>
<li>
Download <a href="https://sourceforge.net/projects/sdlpango/files/SDL_Pango/0.1.2/SDL_Pango-0.1.2.tar.gz/download">source tar-ball of SDL_Pango-0.1.2</a> from <a href="https://sourceforge.net/projects/sdlpango/">SDL_Pango's page on Sourceforge.net</a>. </li>
<li>
Download <a href="http://johnnypops.co.uk/tuxpaint/SDL_Pango-configure-extra-api.patch">a patch file</a> from <a href="http://www.johnnypops.co.uk/tuxpaint/">John Popplewell's "Tux Paint - MinGW/MSYS build instructions" webpage</a>. (This adds some extra (required) functionality to SDL_Pango.) </li>
</ul>
</p>
<p>
Build and install SDL_Pango as follows. <blockquote>
<code> <code>
$ tar zxvf SDL_Pango-0.1.2.tar.gz<br/> $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch<br/>
$ cd SDL_Pango-0.1.2/<br/> $ git clone https://github.com/markuskimius/SDL2_Pango<br/>
$ patch -p0 &lt; ../SDL_Pango-configure-extra-api.patch<br/> $ cd SDL2_Pango<br/>
$ ./configure --prefix=/mingw64 &amp;&amp; make &amp;&amp; make install $ patch -p0 &lt; ../SDL2_Pango-dll.patch<br/>
$ ./configure --prefix=/mingw64 &amp;&amp; make &amp;&amp; make install<br/>
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -481,7 +465,7 @@
<p> <p>
Within the MSYS2 shell, run the following command to install 32bit compiler and basic development tools: <blockquote> Within the MSYS2 shell, run the following command to install 32bit compiler and basic development tools: <blockquote>
<code> <code>
pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -496,18 +480,14 @@
</header> </header>
<p> <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> You can install tools and libraries required for compiling Tux Paint and Tux Paint Config on MSYS2/MINGW using "<code>pacman</code>" except for SDL2_Pango and libunibreak. </p>
<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> 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> <p>
<blockquote> <blockquote>
<code> <code>
$ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}<br/> $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}<br/>
$ pacman -S mingw-w64-i686-libvorbis<br/> $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk}<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> </code>
</blockquote> </blockquote>
</p> </p>
@ -518,52 +498,27 @@
<section class="indent"><!-- H4: Install SDL_Pango... --> <section class="indent"><!-- H4: Install SDL_Pango... -->
<header> <header>
<h4> <h4>
Install SDL_mixer, SDL_Pango and libunibreak on the 32bit environment </h4> Install SDL2_Pango and libunibreak on the 32bit environment </h4>
</header> </header>
<p> <p>
SDL_mixer, SDL_Pango and libunibreak should be installed manually. </p> SDL2_Pango and libunibreak should be installed manually. </p>
<p> <p>
This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" </p> This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" </p>
<section class="indent"><!-- H5: SDL_mixer --> <section class="indent"><!-- H5: SDL2_Pango -->
<header>
<h5>SDL_mixer</h5>
</header>
<p>
Download <a href="https://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.12.tar.gz">source tar-ball of SDL_mixer-1.2.12</a> from <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 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</section><!-- H5: SDL_mixer -->
<section class="indent"><!-- H5: SDL_Pango -->
<header> <header>
<h5>SDL_Pango</h5> <h5>SDL_Pango</h5>
</header> </header>
<p> <p>
At first, you have to prepare source tar-ball and a required patch in the same directory. <ul> Download <a href="https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch">a patch</a> from <a href="https://z1.plala.jp/tuxpaint/buildwin.html">z1.plala.jp</a>, which enable SDL2_Pango to create dlls, then build and install SDL2_Pango as follows. <blockquote>
<li>
Download <a href="https://sourceforge.net/projects/sdlpango/files/SDL_Pango/0.1.2/SDL_Pango-0.1.2.tar.gz/download">source tar-ball of SDL_Pango-0.1.2</a> from <a href="https://sourceforge.net/projects/sdlpango/">SDL_Pango's page on Sourceforge.net</a>. </li>
<li>
Download <a href="http://johnnypops.co.uk/tuxpaint/SDL_Pango-configure-extra-api.patch">a patch file</a> from <a href="http://www.johnnypops.co.uk/tuxpaint/">John Popplewell's "Tux Paint - MinGW/MSYS build instructions" webpage</a>. (This adds some extra (required) functionality to SDL_Pango.) </li>
</ul>
</p>
<p>
Build and install SDL_Pango as follows. <blockquote>
<code> <code>
$ tar zxvf SDL_Pango-0.1.2.tar.gz<br/> $ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch<br/>
$ cd SDL_Pango-0.1.2/<br/> $ git clone https://github.com/markuskimius/SDL2_Pango<br/>
$ patch -p0 &lt; ../SDL_Pango-configure-extra-api.patch<br/> $ cd SDL2_Pango<br/>
$ ./configure --prefix=/mingw32 &amp;&amp; make &amp;&amp; make install $ patch -p0 &lt; ../SDL2_Pango-dll.patch<br/>
$ ./configure --prefix=/mingw32 &amp;&amp; make &amp;&amp; make install<br/>
</code> </code>
</blockquote> </blockquote>
</p> </p>
@ -602,7 +557,7 @@
<p> <p>
<a href="https://imagemagick.org">ImageMagick</a> 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. </p> <a href="https://imagemagick.org">ImageMagick</a> 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. </p>
<p> <p>
Using official binary release available from "<a href="https://imagemagick.org/script/download.php#windowsand">Windows Binary Release</a>" is recommended, due to the commands installed with "<code>pacman</code>" on MinGW/MSYS not working as expected! </p> Using official binary release available from "<a href="https://imagemagick.org/script/download.php#windows">Windows Binary Release</a>" is recommended, due to the commands installed with "<code>pacman</code>" on MinGW/MSYS not working as expected! </p>
<p> <p>
Do not forget to enable "Install legacy utilities (e.g. convert)" while installing it, because Tux Paint's build process uses them. </p> Do not forget to enable "Install legacy utilities (e.g. convert)" while installing it, because Tux Paint's build process uses them. </p>
<p> <p>
@ -616,31 +571,114 @@
You can make this permanent by adding the above to your the BASH shell configuration file, "<code>~/.bash_profile</code>". </p> You can make this permanent by adding the above to your the BASH shell configuration file, "<code>~/.bash_profile</code>". </p>
</section><!-- H3: ImageMagick --> </section><!-- H3: ImageMagick -->
<section class="indent"><!-- H3: Tux Paint --> <section class="indent"><!-- H3: Tux Paint & Tux Paint Config. -->
<header> <header>
<h3>Tux Paint</h3> <h3>Tux Paint &amp; Tux Paint Config.</h3>
</header> </header>
<p> <p>
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit binaries using MSYS2 32bit shell, respectively. </p> You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries using "MSYS2 32bit" shell, respectively. </p>
<ul> <ul>
<li> <li>
Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" from the "Start Menu" to open the 64bit shell. </li> Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" from the "Start Menu" to open the 64bit shell. </li>
<li> <li>
Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" from the "Start Menu" to open the 32bit shell. </li> Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" from the "Start Menu" to open the 32bit shell. </li>
</ul> </ul>
<p>
Compile Tux Paint with the following command: <blockquote> <section class="indent"><!-- H4: Tux Paint Config. -->
<code> <header>
$ make bdist-win32 <h4>Tux Paint Config.</h4>
</code> </header>
</blockquote> <p>
</p> "Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's behavior. You have to build this component before compiling Tux Paint if you want to have it included in your package. </p>
<p class="note"> <p>
<span title="Information">&#128161;</span> <strong>Note:</strong> 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 "<code>tuxpaint-config</code>" (with no version number, e.g., "<code>tuxpaint-config-X.Y.Z</code>"). See "Tux Paint Config."'s INSTALL.txt documentation for details. </p> You can use either (a) a stable tar-ball release, or (b) the developing source tree. <ol type="a">
<li>
Using stable tar-ball release: <ul>
<li>
<a href="https://sourceforge.net/projects/tuxpaint/files/tuxpaint-config/">Download a source tar-ball</a>
</li>
<li>
Expand the tar-ball and change the directory name so that the final packaging process can find related files. <blockquote>
<code>
$ tar zxvf tuxpaint-config-A.B.C.tar.gz<br/>
$ mv tuxpaint-config-A.B.C tuxpaint-config<br/>
</code>
</blockquote>
</li>
</ul>
</li>
<li>
Using the developing source tree: <ul>
<li>
Fetch the developing source tree from git repository: <blockquote>
<code>
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config tuxpaint-config
</code>
</blockquote>
</li>
</ul>
</li>
</ol>
</p>
<p>
Now you can build Tux Paint Config. as follows: <blockquote>
<code>
$ cd tuxpaint-config<br/>
$ make win32<br/>
</code>
</blockquote>
</p>
</section><!-- H4: Tux Paint Config. -->
<section class="indent"><!-- H4: Tux Paint -->
<header>
<h4>Tux Paint</h4>
</header>
<p>
You can use either (a) a stable tar-ball release, or (b) the developing source tree. <ol type="a">
<li>
Using stable tar-ball release: <ul>
<li>
<a href="https://sourceforge.net/projects/tuxpaint/files/tuxpaint/">Download a source tar-ball</a>
</li>
<li>
Expand the tar-ball and change the directory name so that the final packaging process can find related files. <blockquote>
<code>
$ tar zxvf tuxpaint-A.B.C-sdl2.tar.gz<br/>
$ mv tuxpaint-A.B.C-sdl2 tuxpaint-sdl2<br/>
</code>
</blockquote>
</li>
</ul>
</li>
<li>
Using the developing source tree: <ul>
<li>
Fetch the developing source tree from git repository: <blockquote>
<code>
$ git clone -b sdl2.0 https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint-sdl2
</code>
</blockquote>
</li>
</ul>
</li>
</ol>
</p>
<p>
Now you can build Tux Paint as follows: <blockquote>
<code>
$ cd tuxpaint-sdl2<br/>
$ make bdist-win32<br/>
</code>
</blockquote>
</p>
</section><!-- H4: Tux Paint -->
<p> <p>
All the files needed for starting Tux Paint (and Tux Paint Config.) are collected in the directory for binary distribution "<code>bdist</code>" directory under "<code>win32</code>". You can start them by double-clicking their executable (<code>.exe</code>) files in the "<code>bdist</code>" directory. </p> All the files needed for starting Tux Paint (and Tux Paint Config.) are collected in the directory for binary distribution "<code>bdist</code>" directory under "<code>win32</code>". You can start them by double-clicking their executable (<code>.exe</code>) files in the "<code>bdist</code>" directory. </p>
</section><!-- H3: Tux Paint --> </section><!-- H3: Tux Paint & Tux Paint Config. -->
<section class="indent"><!-- H3: Building the Tux Paint Windows Installer --> <section class="indent"><!-- H3: Building the Tux Paint Windows Installer -->
<header> <header>
@ -655,7 +693,7 @@
<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> 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> <p>
Then, you can easily build an executable installer by right-clicking on the "<code>tuxpaint.iss</code>" icon in the "<code>win32</code>" directory and selecting "Compile" on the list. It will run for a while, and eventually you will find a "<code>tuxpaint-<i>X.Y.Z</i>-windows-&lt;arch&gt;-installer.exe</code>" file in the same directory. </p> Then, you can easily build an executable installer by right-clicking on the "<code>tuxpaint.iss</code>" icon in the "<code>win32</code>" directory and selecting "Compile" on the list. It will run for a while, and eventually you will find a "<code>tuxpaint-<i>X.Y.Z</i>-windows-sdl2.0-&lt;arch&gt;-installer.exe</code>" file in the same directory. </p>
</section><!-- H3: Building the Tux Paint Windows Installer --> </section><!-- H3: Building the Tux Paint Windows Installer -->
<section class="indent"><!-- H3: Running the Tux Paint Windows Installer --> <section class="indent"><!-- H3: Running the Tux Paint Windows Installer -->
@ -942,7 +980,7 @@
<p> <p>
Although Tux Paint is built without the Xcode IDE, Xcode itself is still required to build Tux Paint. <a href="https://developer.apple.com/xcode/ide/">Download it from the App Store</a>, and launch it once to accept its license agreements. You may also need to install the Xcode command line tools using the command: <blockquote> Although Tux Paint is built without the Xcode IDE, Xcode itself is still required to build Tux Paint. <a href="https://developer.apple.com/xcode/ide/">Download it from the App Store</a>, and launch it once to accept its license agreements. You may also need to install the Xcode command line tools using the command: <blockquote>
<code> <code>
xcode-select --install $ xcode-select --install
</code> </code>
</blockquote> </blockquote>
</p> </p>

2
docs/ja_JP.UTF-8/html/OPTIONS.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/ja_JP.UTF-8/html/PNG.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/ja_JP.UTF-8/html/README.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/ja_JP.UTF-8/html/SIGNALS.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }

2
docs/ja_JP.UTF-8/html/SVG.html
View file

@ -62,7 +62,7 @@
section.indent dl p { section.indent dl p {
margin-left: 0; margin-left: 0;
} }
p + ul { p + ul, p + ol {
margin-left: 2em; margin-left: 2em;
} }