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

610 lines
25 KiB
Text
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Tux Paint
versión 0.9.27
Documentación da instalación
Copyright © 2002-2021 por varios colaboradores; vexa AUTHORS (AUTORES).
http://www.tuxpaint.org/
31 de Agosto de 2021
----------------------------------------------------------------------
+----------------------------------------------------+
|Índice |
|----------------------------------------------------|
| * Requirements |
| * Simple DirectMedia Layer library (libSDL) |
| * Outras bibliotecas |
| * Compiling and Installation |
| * Usuarios de Windows |
| * Usuarios de Linux/Unix |
| * Debugging |
| * Uninstalling Tux Paint |
| * Windows |
| * Linux |
+----------------------------------------------------+
----------------------------------------------------------------------
Requirements
Simple DirectMedia Layer library (libSDL)
Tux Paint require a «Simple DirectMedia Layer Library (libSDL)», unha
biblioteca de programación multimedia de código aberto dispoñíbel
baixo a licenza pública GNU Lesser General Public License (LGPL).
Xunto con libSDL, Tux Paint depende doutras bibliotecas «de axuda» de
SDL: SDL_Image (para ficheiros gráficos), SDL_TTF e (opcionalmente)
SDL_Pango (para compatibilidade de tipo True Type) e, opcionalmente,
SDL_Mixer (para efectos de son).
Usuarios de Linux/Unix:
As bibliotecas SDL están dispoñíbeis como código fonte ou como
paquetes RPM ou Debian para varias distribucións de Linux. Pódense
descargar dende:
* libSDL: http://www.libsdl.org/
* SDL_Image: http://www.libsdl.org/projects/SDL_image/
* SDL_TTF: http://www.libsdl.org/projects/SDL_ttf/
* SDL_Pango: http://sourceforge.net/projects/sdlpango/ (opcional)
* SDL_Mixer: http://www.libsdl.org/projects/SDL_mixer/ (opcional)
Normalmente tamén están dispoñíbeis xunto coa súa distribución de
Linux (p. ex.: nun medio de instalación ou dispoñíbeis a través dun
software de mantemento de paquetes como «apt» de Debian).
Nota: Cando instale bibliotecas a partir de paquetes, asegúrese de
instalar TAMÉN as versións de desenvolvemento dos paquetes. (Por
exemplo, instale tanto «SDL-1.2.4.rpm» como «SDL-1.2.4-devel.rpm».).
Outras bibliotecas
Tux Paint tamén aproveita outras bibliotecas libres con licenza LGPL.
En Linux, do mesmo xeito que SDL, deberían estar xa instaladas ou
estar dispoñíbeis para a súa instalación como parte da súa
distribución de Linux.
libPNG
Tux Paint utiliza o formato PNG (Portable Network Graphics
Gráficos de Rede Portátiles) para os seus ficheiros de datos. A
imaxe SDL requirirá a instalación de libPNG.
http://www.libpng.org/pub/png/libpng.html
gettext
Tux Paint utiliza a configuración local do sistema xunto coa
biblioteca «gettext» para admitir varios idiomas (p. ex., o
español). Necesitará ter a biblioteca gettext instalada.
http://www.gnu.org/software/gettext/
libpaper (Só Linux/Unix)
A partir de Tux Paint 0.9.17, Tux Paint pode determinar o tamaño de
papel predeterminado do seu sistema (p. ex.: A4 ou Carta), ou
pódeselle indicar que use un tamaño de papel particular, grazas a
«libpaper».
https://github.com/naota/libpaper
FriBiDi
As ferramentas «Texto» e «Etiqueta» de Tux Paint admiten linguaxes
bidireccionais grazas á biblioteca «FriBiDi».
http://fribidi.org/
Compatibilidade de SVG
A partir de Tux Paint 0.9.17, Tux Paint pode cargar imaxes SVG
(Scalable Vector Graphics — Gráficos Vectoriais Escalábeis) como
selos. Admítense dous conxuntos de bibliotecas e pódese desactivar
completamente a compatibilidade SVG (a través de «make SVG_LIB:=»)
librsvg-2 & libCairo2 (bibliotecas máis recentes)
* libRSVG 2: http://librsvg.sourceforge.net/
* Cairo 2: http://www.cairographics.org/
* Estes tamén dependen do seguinte:
* GdkPixbuf & GLib: http://www.gtk.org/
* Pango: http://www.pango.org/
Bibliotecas SVG máis antigas
* libcairo1, libsvg1, & libsvg-cairo1:
http://www.cairographics.org/
* Estes tamén dependen do seguinte:
* libxml2: https://gitlab.gnome.org/GNOME/libxml2
Función de exportación de GIF animado
Para a compatibilidade da exportación de GIF animados (presentacións
de diapositivas), é necesaria a biblioteca «libimagequant» (do
proxecto «pngquant2»).
https://github.com/ImageOptim/libimagequant
Ferramentas NetPBM (opcional) Xa non se usa, de xeito predeterminado
En Linux e Unix, as versións anteriores de Tux Paint utilizaban as
ferramentas NetPBM para axudar á impresión. (Tux Paint xera un PNG e
convértese nun PostScript usando as ferramentas da liña de ordes
NetPBM «pngtopnm» e «pnmtops»).
http://netpbm.sourceforge.net/
----------------------------------------------------------------------
Compiling and Installation
Tux Paint publícase baixo a Licenza Pública Xeral de GNU (GPL) (consulte
«COPYING.txt» para máis detalles) e, polo tanto, o «código fonte» do
programa está dispoñíbel libremente.
Usuarios de Windows
Compiling Set-Up
A partir de febreiro de 2005 (comezando con Tux Paint 0.9.15), o
«Makefile» inclúe compatibilidade para construír nun sistema Windows
usando MinGW/MSYS (https://sourceforge.net/projects/msys2/).
Many tools and libraries are required to build Tux Paint. The
package management system "pacman" helps you install them
automatically solving complicated dependencies.
Download the latest MSYS2 environment from
https://sourceforge.net/projects/msys2/files/Base/ and install it
where you'd like (the default is
"https://sourceforge.net/projects/msys2/files/Base/")
Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" ->
"MSYS2 MSYS" and execute following command (press [Intro] or
[Retorno] to accept the defaults for all questions):
pacman -Syu
This will update core system and the window will close
automatically. Repeat the steps above one more time to finish the
remaining update process.
Within the MSYS2 shell, run the following command to install basic
development tools:
pacman -S base-devel msys2-devel git
Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip
to the "MinGW 32bit (i686) toolchains" section if you need only a
32bit build environment.
MinGW 64bit (x86_64) toolchains
Within the MSYS2 shell, run the following command to install basic
64bit development tools:
pacman -S mingw-w64-x86_64-toolchain
64bit (x86_64) dependency libraries for Tux Paint
You can install tools and libraries required for compiling Tux Paint
on MSYS2/MINGW using "pacman" except for SDL_Pango.
"ntldd" is a small tool which examine windows executable files to
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
packaging process for binary distribution uses it to find required
.dll files.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
You can skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-x86_64-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-x86_64-librsvg
$ pacman -S mingw-w64-x86_64-fribidi
$ pacman -S mingw-w64-x86_64-libimagequant
$ pacman -S mingw-w64-x86_64-fltk
$ pacman -S mingw64/mingw-w64-x86_64-ntldd-git
Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango and re-install SDL on the 64bit environment
SDL_Pango should be installed manually. In addition, you have to
re-install SDL from the source code or you will see unnecessary
blank window opens when starting Tux Paint.
This time, use the MinGW "64bit" shell. Open the shell from the
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit"
SDL_Pango
At first, you have to prepare source tar-ball and a required patch
in the same directory.
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
page on Sourceforge.net.
* Download a patch file from John Popplewell's "Tux Paint -
MinGW/MSYS build instructions" webpage. (This adds some extra
(required) functionality to SDL_Pango.)
Build and install SDL_Pango as follows.
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw64 && make && make install
SDL
Download source tar-ball of SDL_1.2.15 from libsdl.org.
Re-install SDL as follows.
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw64 && make && make install
Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip
to the "ImageMagick" section if you need only a 64bit build
environment.
MinGW 32bit (i686) toolchains
Within the MSYS2 shell, run the following command to install basic
32bit development tools:
pacman -S mingw-w64-i686-toolchain
32bit (i686) dependency libraries for Tux Paint
You can install tools and libraries required for compiling Tux Paint
on MSYS2/MINGW using "pacman" except for SDL_Pango.
"ntldd" is a small tool which examine windows executable files to
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
packaging process for binary distribution uses it to find required
.dll files.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
You can skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-i686-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-i686-librsvg
$ pacman -S mingw-w64-i686-fribidi
$ pacman -S mingw-w64-i686-libimagequant
$ pacman -S mingw-w64-i686-fltk
$ pacman -S mingw-w64-i686-ntldd-git
Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango and re-install SDL on the 32bit environment
SDL_Pango should be installed manually. In addition, you have to
re-install SDL from the source code or you will see unnecessary
blank window opens when starting Tux Paint.
This time, use the MinGW "32bit" shell. Open the shell from the
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit"
SDL_Pango
At first, you have to prepare source tar-ball and a required patch
in the same directory.
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
page on Sourceforge.net.
* Download a patch file from John Popplewell's "Tux Paint -
MinGW/MSYS build instructions" webpage. (This adds some extra
(required) functionality to SDL_Pango.)
Build and install SDL_Pango as follows.
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw32 && make && make install
SDL
Download source tar-ball of SDL_1.2.15 from libsdl.org.
Re-install SDL as follows.
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw32 && make && make install
ImageMagick
ImageMagick is a compilation of command line tools to create, edit,
compose, or convert bitmap images supporting quite a large number of
image formats. Tux Paint uses two functions ("convert" and
"composite") in it to generate thumbnails for startar images and
templates during the build process.
Using official binary release available from "Windows Binary
Release" is recommended, due to the commands installed with "pacman"
on MinGW/MSYS not working as expected!
Do not forget to enable "Install legacy utilities (e.g. convert)"
while installing it, because Tux Paint's build process uses them.
Add the path to the directory in which ImageMagick is installed at
the top of your "PATH" environment variable. For example:
$ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH
You can make this permanent by adding the above to your the BASH
shell configuration file, "~/.bash_profile".
Tux Paint
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit
binaries using MSYS2 32bit shell, respectively.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start
Menu" to open the 64bit shell.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start
Menu" to open the 32bit shell.
Compile Tux Paint with the following command:
$ make bdist-win32
Note: At this point, you will want to build "Tux Paint Config." for
Windows, so it can be included along with "Tux Paint", if you're
making an official (or test) release. The build process will look
for it in a directory named "tuxpaint-config" (with no version
number, e.g., "tuxpaint-config-X.Y.Z"). See "Tux Paint Config."'s
INSTALL.txt documentation for details.
All the files needed for starting Tux Paint (and Tux Paint Config.)
are collected in the directory for binary distribution "bdist"
directory under "win32". You can start them by double-clicking their
executable (.exe) files in the "bdist" directory.
Building the Tux Paint Windows Installer:
Inno Setup is used to build executable installer for Tux Paint.
Therefore you have to install it in the first place.
Then, you can easily build an executable installer by right-clicking
on the "tuxpaint.iss" icon in the "win32" directory and selecting
"Compile" on the list. It will run for a while, and eventually you
will find a "tuxpaint-X.Y.Z-win32-installer.exe" file in the same
directory.
Running the Tux Paint Windows Installer:
Faga dobre clic no executábel do instalador de Tux Paint (ficheiro
.EXE) e siga as instrucións.
En primeiro lugar, solicitaráselle que acepte a licenza. (É a
Licenza pública xeral de GNU (GPL), que tamén está dispoñíbel como
«COPYING.txt»).
Após preguntaráselle se quere instalar accesos directos a Tux Paint
no seu menú de inicio de Windows e no escritorio de Windows.
(Ámbalas dúas opcións están definidas de xeito predeterminado.)
A seguir preguntaráselle onde quere instalar Tux Paint. O valor
predeterminado debería ser axeitado, sempre que haxa espazo
dispoñíbel. Se non, escolla un lugar diferente.
Neste punto, pode premer en «Instalar» para instalar Tux Paint.
Cambiar os axustes usando o acceso directo:
Para cambiar os axustes do programa, prema co botón dereito no
atallo de TuxPaint e seleccione «Propiedades» (na parte inferior).
Asegúrese de que a lapela «Atallo» está seleccionada na xanela que
aparece e examine o campo «Obxectivo:». Debería ver algo así:
"C:\Program Files\TuxPaint\TuxPaint.exe"
Agora pode engadir opcións de liña de ordes que se activarán ao
facer dobre clic na icona.
Por exemplo, para que o xogo se execute en modo de pantalla
completa, con formas sinxelas (sen opción de rotación) e en francés,
engada as opcións (após «TuxPaint.exe»), así:
"C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french
(Vexa a documentación principal para obter unha lista completa das
opcións dispoñíbeis da liña de ordes.)
Se se trabuca ou desaparece todo, use [Ctrl] + [Z] para desfacer ou
só prema a tecla [Esc] e a caixa pecharase sen facer cambios (a non
ser que premera o botón «Aplicar»).
Cando teña rematado, prema en «Aceptar».
Se algo vai mal:
Se ao facer dobre clic no atallo para executar Tux Paint, non ocorre
nada, probabelmente sexa porque algunhas destas opcións da liña de
ordes son incorrectas. Abra un explorador de ficheiros coma antes e
busque un ficheiro chamado «stderr.txt» no cartafol TuxPaint.
Conterá unha descrición do que estaba mal. Normalmente só se debe a
maiúsculas e minúsculas incorrectas (maiúsculas «Z» no canto de
minúsculas «z») ou a falta (ou exceso) de «-» (guións).
Usuarios de Linux/Unix
Compilación:
Nota: Tux Paint non usa autoconf/automake, polo que non hai ningún
script «./configure» para executar. Non obstante, a compilación
debería ser directa, supoñendo que todo o que precisa Tux Paint está
instalado.
Para compilar o programa dende o código fonte, simplemente execute a
seguinte orde dende un indicador do sistema (p. ex.: «$»):
$ make
Desactivar a compatibilidade de «SVG» (e, polo tanto, as dependencias de
«Cairo, libSVG, e svg-cairo»:
Para desactivar a compatibilidade con SVG (por exemplo, se o seu
sistema non é compatíbel coa biblioteca de Cairo ou outras
dependencias relacionadas co SVG), pode executar «make» engadindo
«SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG»:
$ make SVG_LIB= SVG_CFLAGS=
Desactivar a compatibilidade de «Pango» (e, polo tanto, as dependencias de
«Pango, Cairo, etc.»:
Antes da versión 0.9.18, Tux Paint utilizaba a biblioteca libSDL_ttf
para renderizar texto usando tipos de letra TrueType. Dende o 0.9.18
úsase libSDL_Pango, xa que ten unha mellor compatibilidade coa
internacionalización. Non obstante, se quere desactivar o uso de
SDL_Pango, pode facelo executando «make» engadindo «SDL_PANGO_LIB=»:
$ make SDL_PANGO_LIB=
Desactivación do son en tempo de compilación:
Se non te unha tarxeta de son ou prefire construír o programa sen
asistencia de son (e polo tanto sen a dependencia SDL_mixer), pode
executar «make» con «SDL_MIXER_LIB=» engadido:
$ make SDL_MIXER_LIB=
Outras opcións:
Outras opcións (p. ex.: rutas de instalación) poden ser anuladas;
véxaas en «Makefile» para máis detalles.
Se se producen erros:
Se recibe algún erro durante o tempo de compilación, asegúrese de
ter instaladas as bibliotecas axeitadas (ver máis arriba). Se está a
empregar versións empaquetadas das bibliotecas (por exemplo, RPM en
RedHat ou DEB en Debian), asegúrese de obter tamén os
correspondentes paquetes «-dev» ou «-devel», se non, non poderá
compilar Tux Paint (e outros programas) dende o código fonte.
Instalar:
Supoñendo que non se produciron erros graves, agora pode instalar o
programa para que os usuarios do sistema poidan executalo. De xeito
predeterminado, isto debe facelo o usuario «root» («superusuario»).
Cambie a «root» escribindo a orde:
$ su
Introduza o contrasinal de «root» no indicador do sistema. Agora
debería ser «root» (cun indicador como «#»). Para instalar o
programa e os seus ficheiros de datos, escriba:
# make install
Finalmente, pode volver ao seu usuario habitual saíndo do modo de
superusuario:
# exit
Como alternativa, pode simplemente usar a orde «sudo» (po.ex.: en
Ubuntu Linux):
$ sudo make install
Nota: De xeito predeterminado, «tuxpaint», o programa executábel,
colócase en «/usr/local/bin/». Os ficheiros de datos (imaxes, sons,
etc.) colócanse en «/usr/local/share/tuxpaint/».
Cambiar onde van as cousas
Pode cambiar onde irán as cousas axustando as variábeis de
«Makefile» na liña de ordes. «DESTDIR» úsase para colocar a saída
nunha área de espera para a creación de paquetes. «PREFIX» é a
base de onde van todos os demais ficheiros e, de xeito
predeterminado, está estabelecido en «/usr/local».
Outras variábeis son:
BIN_PREFIX
Onde se instalará o binario «tuxpaint». (Estabelécese como
«$(PREFIX)/bin»como predeterminado, p. ex.:
«/usr/local/bin»)
DATA_PREFIX
Onde irán os ficheiros de datos (son, gráficos, pinceis,
selos, tipos de letra) e onde os buscará Tux Paint cando
se execute. (Estabelecer en «$(PREFIX)/share/tuxpaint»)
DOC_PREFIX
Onde irán os ficheiros de texto da documentación (o
directorio «docs»). (Estabelecer como
«$(PREFIX)/share/doc/tuxpaint»)
MAN_PREFIX
Onde irá a páxina do manual de Tux Paint. (Estabelecer
como «$(PREFIX)/share/man»)
ICON_PREFIX — $(PREFIX)/share/pixmaps
X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps
GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics
KDE_PREFIX — $(PREFIX)/share/applnk/Graphics
Onde irán as iconas e os lanzadores (para GNOME e KDE).
LOCALE_PREFIX
Onde irán os ficheiros de tradución para Tux Paint e onde
os buscará Tux Paint. (Estabelécese en
«$(PREFIX)/share/locale/») (A localización final dun
ficheiro de tradución estará no directorio da
configuración local (por exemplo, «es» para o español),
dentro do subdirectorio «LC_MESSAGES»).
Nota: Esta lista non está actualizada. Consulte «Makefile» e
«Makefile-i18n» para ver unha lista completa.
----------------------------------------------------------------------
Debugging
A depuración (a «STDOUT», por exemplo, á terminal ou a un ficheiro
«stdout.txt» en Windows) pódese activar co axuste «DEBUG» (e, se se
quere un rexistro detallado, «VERBOSE») #define en «src/debug.h».
----------------------------------------------------------------------
Uninstalling Tux Paint
Windows
Uso do desinstalador
Se instalou os atallos do menú Inicio (o predeterminado), vaia ao
cartafol TuxPaint e seleccione «Desinstalar». Amosarase unha caixa
que confirmará que está a piques de desinstalar Tux Paint e, se está
seguro de que quere eliminar permanentemente Tux Paint, prema no
botón «Desinstalar».
Cando remate, prema no botón pechar.
Usar o Panel de control
Tamén é posíbel usar a entrada «TuxPaint (só eliminar)« na sección
Engadir/Eliminar programas do Panel de control.
Linux
Dentro do directorio de orixe de Tux Paint (onde compilou Tux Paint),
pode usar o destino «make uninstall» para desinstalar Tux Paint. De
xeito predeterminado, debe facelo o usuario «root» («superusuario»),
mais se instalou Tux Paint noutro lugar (por exemplo, usando a
configuración «PREFIX=...» en «make» e «make install»), pode que non e
queira proporcionar a mesma configuración aquí. (Consulte as
instrucións de instalación anteriores para obter máis información.)