Tweaks to w3m.sh to improve TXT version of docs

Make headers and description terms more apparent, by adding
some more regexps into the `sed` that the HTML is piped through
before being sent to `w3m`.
This commit is contained in:
Bill Kendrick 2024-10-14 17:08:31 -07:00
parent 3032afb85f
commit a62db7f9c2
1060 changed files with 10160 additions and 9743 deletions

View file

@ -28,7 +28,7 @@
Domosdoshmëri
Bibliotekë Simple DirectMedia Layer (libSDL)
### Bibliotekë Simple DirectMedia Layer (libSDL) ###
Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open
Source multimedia programming library available under the GNU Lesser General
@ -58,13 +58,13 @@ Debian's "apt").
development versions of the packages. (For example, install both
"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".)
Biblioteka të Tjera
## Biblioteka të Tjera ##
Tux Paint also takes advantage of a number of other free, LGPL'd libraries.
Under Linux, just like SDL, they should either already be installed, or are
readily available for installation as part of your Linux distribution.
libPNG
libPNG
Tux Paint uses PNG (Portable Network Graphics) format for its data files.
SDL_image will require libPNG be installed.
@ -72,8 +72,8 @@ libPNG
http://www.libpng.org/pub/png/libpng.html
gettext
gettext
Tux Paint uses your system's locale settings along with the "gettext"
library to support various languages (e.g., Spanish). You'll need the
@ -82,8 +82,8 @@ gettext
http://www.gnu.org/software/gettext/
libpaper (vetëm për Linux/Unix)
libpaper (vetëm për Linux/Unix)
As of Tux Paint 0.9.17, Tux Paint can determine your system's default paper
size (e.g., A4 or Letter), or can be told to use a particular paper size,
@ -92,8 +92,8 @@ libpaper (vetëm për Linux/Unix)
https://github.com/naota/libpaper
FriBiDi
FriBiDi
Tux Paint's "Text" and also "Label" tools support bidirectional languages,
thanks to the "FriBiDi" library.
@ -101,31 +101,31 @@ FriBiDi
http://fribidi.org/
Mbulim SVG-sh
Mbulim SVG-sh
As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector Graphics)
images as stamps. Two sets of libraries are supported, and SVG support can
be completely disabled (via "make SVG_LIB:=")
librsvg-2 & libCairo2 (biblioteka më të reja)
librsvg-2 & libCairo2 (biblioteka më të reja)
o libRSVG 2: http://librsvg.sourceforge.net/
o Cairo 2: http://www.cairographics.org/
o Këto varen gjithashtu nga sa vijon:
# GdkPixbuf & GLib: http://www.gtk.org/
# Pango: http://www.pango.org/
Biblioteka SVG Më të Vjetra
Biblioteka SVG Më të Vjetra
o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/
o Këto varen gjithashtu nga sa vijon:
# libxml2: https://gitlab.gnome.org/GNOME/libxml2
Veçori eksportimi Gif-i të Animuar
→ Veçori eksportimi Gif-i të Animuar ←
To support export of animated GIFs (slideshows), the "libimagequant"
library (from the "pngquant2" project) is required.
@ -133,8 +133,8 @@ Veçori eksportimi Gif-i të Animuar
https://github.com/ImageOptim/libimagequant
Mjete NetPBM (opsionale) Spërdoret më, si parazgjedhje
Mjete NetPBM (opsionale) Spërdoret më, si parazgjedhje
📜 Under Linux and Unix, earlier versions of Tux Paint used the NetPBM tools
to assist with printing. (A PNG is generated by Tux Paint, and converted
@ -144,7 +144,7 @@ Mjete NetPBM (opsionale) Spërdoret më, si parazgjedhje
http://netpbm.sourceforge.net/
Përpilim dhe Instalim
@ -154,11 +154,11 @@ available freely.
-----------------------------------------------------------------------
Windows
### Windows ###
10 korrik 2022 Shin-ichi TOYAMA <dolphin6k@wmail.plala.or.jp>
Ujdisje e Përpilimit
## Ujdisje e Përpilimit ##
As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile" includes
support for building on a Windows system using MinGW/MSYS (https://
@ -168,7 +168,7 @@ Many tools and libraries are required to build Tux Paint. The package
management system "pacman" helps you install them automatically solving
complicated dependencies.
MYSYS2
# MYSYS2 #
Download the latest MSYS2 environment from https://www.msys2.org/ and install
it where you'd like (the default is "C:\msys64")
@ -196,7 +196,7 @@ environment.
-----------------------------------------------------------
MinGW 64bit (x86_64) compiler and tools
# MinGW 64bit (x86_64) compiler and tools #
Within the MSYS2 shell, run the following command to install Përpilues 64bit
dhe mjete elementare zhvillimesh:
@ -207,7 +207,7 @@ dhe mjete elementare zhvillimesh:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
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 Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@ -221,7 +221,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
Install SDL2_Pango and libunibreak on the 64bit environment
# Install SDL2_Pango and libunibreak on the 64bit environment #
SDL2_Pango and libunibreak should be installed manually.
@ -253,7 +253,7 @@ ImageMagick" section if you need only a 64bit build environment.
-----------------------------------------------------------
MinGW 32bit (i686) compiler and tools
# MinGW 32bit (i686) compiler and tools #
Within the MSYS2 shell, run the following command to install Përpilues 32bit
dhe mjete elementare zhvillimesh:
@ -264,7 +264,7 @@ dhe mjete elementare zhvillimesh:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
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 Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@ -278,7 +278,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
Install SDL2_Pango and libunibreak on the 32bit environment
# Install SDL2_Pango and libunibreak on the 32bit environment #
SDL2_Pango and libunibreak should be installed manually.
@ -305,7 +305,7 @@ You can fetch the source code from the git repositry and compile it as follows.
$ cd libunibreak
$ ./augogen.sh --prefix=/mingw32 && make && make install
ImageMagick
## 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
@ -327,7 +327,7 @@ your "PATH" environment variable. For example:
You can make this permanent by adding the above to your the BASH shell
configuration file, "~/.bash_profile".
Tux Paint & Tux Paint Config.
## Tux Paint & Tux Paint Config. ##
You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries
using "MSYS2 32bit" shell, respectively.
@ -337,7 +337,7 @@ using "MSYS2 32bit" shell, respectively.
* Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to open
the 32bit shell.
Tux Paint Config.
# 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
@ -365,7 +365,7 @@ Tani mund ta montoni Tux Paint Config. si vijon:
$ cd tuxpaint-config
$ make win32
Tux Paint
# Tux Paint #
You can use either (a) a stable tar-ball release, or (b) the developing source
tree.
@ -393,7 +393,7 @@ 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.
Montimi i Instaluesit të Tux Paint-it për Windows
## Montimi i Instaluesit të Tux Paint-it për Windows ##
Inno Setup is used to build executable installer for Tux Paint. Therefore you
have to install it in the first place.
@ -415,7 +415,7 @@ Then, you can easily build an executable installer by right-clicking 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.
Përdorimi i Instaluesit të Tux Paint-it për Windows
## Përdorimi i Instaluesit të Tux Paint-it për Windows ##
Double-click the Tux Paint installer executable (.EXE file) and follow the
instructions.
@ -433,7 +433,7 @@ location.
At this point, you can click 'Install' to install Tux Paint!
Ndryshim Rregullimesh Duke Përdorur Shkurtoren
## Ndryshim Rregullimesh Duke Përdorur Shkurtoren ##
To change program settings, right-click on the TuxPaint shortcut and select
'Properties' (at the bottom).
@ -461,7 +461,7 @@ or just hit the [Tasti Esc] key and the box will close with no changes made
Kur të keni mbaruar, klikoni “OK”.
Nëse Diçka Shkon Ters
## Nëse Diçka Shkon Ters ##
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it
is probably because some of these command-line options are wrong. Open an
@ -475,9 +475,9 @@ incorrect character-case (capital 'Z' instead of lowercase 'z') or a missing
-----------------------------------------------------------------------
Linux/Unix
### Linux/Unix ###
Përpilim:
## Përpilim: ##
💡 Note: Tux Paint does not use autoconf/automake, so there is no "./configure"
script to run. Compiling should be straight-forward though, assuming everything
@ -488,7 +488,8 @@ shell prompt (e.g., "$"):
$ make
Disabling SVG support (and hence Cairo, libSVG dhe svg-cairo dependencies):
## Disabling SVG support (and hence Cairo, libSVG dhe svg-cairo dependencies):
##
To disable SVG support (e.g., if your system is not currently supported by the
Cairo library or other SVG-related dependencies), you can run "make" with
@ -496,7 +497,7 @@ Cairo library or other SVG-related dependencies), you can run "make" with
$ make SVG_LIB= SVG_CFLAGS=
Çaktivizim i Tingullit, gjatë Përpilimit
## Çaktivizim i Tingullit, gjatë Përpilimit ##
If you don't have a sound card, or would prefer to build the program with no
sound support (and therefore without a the SDL_mixer dependency), you can run
@ -504,12 +505,12 @@ sound support (and therefore without a the SDL_mixer dependency), you can run
$ make SDL_MIXER_LIB=
Mundësi të tjera
## Mundësi të tjera ##
Various other options (e.g., installation paths) may be overridden; see them in
"Makefile" for further details.
Nëse ju dalin gabime
## Nëse ju dalin gabime ##
If you receive any errors during compile-time, make sure you have the
appropriate libraries installed (see above). If using packaged versions of the
@ -517,7 +518,7 @@ libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to get the
corresponding "-dev" or "-devel" packages as well, otherwise you won't be able
to compile Tux Paint (and other programs) from source!
Installng
## Installng ##
Assuming no fatal errors occured, you can now install the program so that it
can be run by users on the system. By default, this must be done by the "root"
@ -543,7 +544,7 @@ Ubuntu Linux):
local/bin/". The data files (images, sounds, etc.) are placed in "/usr/local/
share/tuxpaint/".
Ndryshim i Ku Venë Gjërat
# Ndryshim i Ku Venë Gjërat #
You can change where things will go by setting "Makefile"variables on the
command line. "DESTDIR" is used to place output in a staging area for package
@ -552,48 +553,48 @@ default, set to "/usr/local".
Ndryshore të tjera janë:
BIN_PREFIX
BIN_PREFIX
Where the "tuxpaint" binary will be installed. (Set to "$(PREFIX)/bin" by
default - e.g., "/usr/local/bin")
DATA_PREFIX
DATA_PREFIX
Where the data files (sound, graphics, brushes, stamps, fonts) will go, and
where Tux Paint will look for them when it's run. (Set to "$(PREFIX)/share/
tuxpaint")
DOC_PREFIX
DOC_PREFIX
Where the documentation text files (the "docs" directory) will go. (Set to
"$(PREFIX)/share/doc/tuxpaint")
MAN_PREFIX
MAN_PREFIX
Where the manual page for Tux Paint will go. (Set to "$(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
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
Where the icons and launchers (for GNOME and KDE) will go.
LOCALE_PREFIX
LOCALE_PREFIX
Where the translation files for Tux Paint will go, and where Tux Paint will
look for them. (Set to "$(PREFIX)/share/locale/") (Final location of a
translation file will be under the locale's directory (e.g., "es" for
Spanish), within the "LC_MESSAGES" subdirectory.)
💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a
complete list.
-----------------------------------------------------------------------
macOS
### macOS ###
5 qershor 2022 Mark Kim <markuskimius@gmail.com>
Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were
a Linux application.
Kushte paraprake
## Kushte paraprake ##
Although Tux Paint is built without the Xcode IDE, Xcode itself is still
required to build Tux Paint. Download it from the App Store, and launch it once
@ -629,7 +630,7 @@ of Tux Paint.
^* Not available from MacPorts as of this writing, see below.
libimagequant
# libimagequant #
libimagequant is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@ -641,7 +642,7 @@ installed from the source code as follows. It should be installed to /opt/local
$ cargo build --release # Must use cargo from MacPorts
$ sudo make PREFIX=/opt/local install
sdl2_pango
# sdl2_pango #
sdl2_pango is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@ -655,7 +656,7 @@ WARNING: Having any UNIX-like toolset installed on your Mac besides MacPorts
and Xcode, such as Fink or Brew, will prevent your app bundle from being
portable. Be sure Fink and Brew are not accessible from your build environment.
Si të Montohet
## Si të Montohet ##
Thjesht, xhironi:
@ -669,7 +670,7 @@ TuxPaint.dmg'.
Additional steps are required when building a Unviersal Binary. See "Building a
Universal Binary" below.
Probleme të Ditura
## Probleme të Ditura ##
* A macOS binary built on a specific version of macOS only runs on that
version of macOS or later. To ensure Tux Paint can run on the oldest
@ -686,7 +687,7 @@ Probleme të Ditura
(from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for
the instructions.
Versione të vjetër të macOS-it
## Versione të vjetër të macOS-it ##
Some old versions of macOS can be downloaded from Apple's support page: https:/
/support.apple.com/en-us/HT211683
@ -726,7 +727,7 @@ the Xcode command line tools (do not run "xcode-select --install") but
otherwise build Tux Paint using the same steps described in the earlier part of
this document.
Ripërpilim MacPorts
## Ripërpilim MacPorts ##
To recompile MacPorts to be usable on older versions of macOS, set the
following options in /opt/local/etc/macports/macports.conf:
@ -750,7 +751,7 @@ they can only be built to run natively on the hardware on which they were
built. See "Building a Universal Binary" below for instructions on how to build
Tux Paint as a Universal Binary.
Montimi i një Dyoreje Universale
## Montimi i një Dyoreje Universale ##
To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU
and the Apple Silicon separately first. Then rename the app bundle for the
@ -764,7 +765,7 @@ two application bundles as below. The DMG file can be built afterwards:
-----------------------------------------------------------------------
Android
### Android ###
29 mars 2023 Pere Pujal i Carabantes <perepujal@gmail.com> (Edited by Bill
Kendrick)
@ -773,7 +774,7 @@ As of March 2023, the Android build of Tux Paint is maintained in a separate
code repository at GitHub: https://github.com/tux4kids/Tuxpaint-Android.
Detailed instructions are there; this acts as an overview.
Kushte paraprake
## Kushte paraprake ##
Do tju duhen versione të freskët të:
@ -798,7 +799,7 @@ one another, and the script in the directory containing both.
Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint
&& ./mkzip_assets.sh
Montim
## Montim ##
The Gradle build generates some variants: PlayStore, debugPlayStore,
offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able
@ -827,36 +828,37 @@ the makebuildserver tool they provide, then, from the root of fdroiddata, run
-----------------------------------------------------------------------
Haiku
### Haiku ###
7 maj 2023 Luc Schrijvers <begasus@gmail.com> (Edited by Bill Kendrick)
Kushte paraprake
## Kushte paraprake ##
Instaloni paketat e domosdoshme në Terminal:
32-bit:
32-bit:
pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel
libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl
libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel
libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel
sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel
64-bit:
64-bit:
pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel
libimagequant_devel gettext_libintl libpaper_devel pango_devel
libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel
sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel
For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with
setarch x86
Montim
## Montim ##
make PREFIX=/boot/home/config/non-packaged
Stampa Tux Paint-i
## Stampa Tux Paint-i ##
make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/
@ -869,9 +871,9 @@ setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines in "src
Çinstalim i Tux Paint-it
Windows
### Windows ###
Duke përdorur Çinstaluesin
## Duke përdorur Çinstaluesin ##
If you installed the Start Menu shortcuts (the default), then go to the
TuxPaint folder and select "Uninstall". A box will be displayed that will
@ -880,12 +882,12 @@ you want to permanently remove Tux Paint, click on the 'Uninstall' button.
Kur të ketë mbaruar, klikoni butonin e mbylljes.
Duke përdorur Panelin e Kontrollit
## Duke përdorur Panelin e Kontrollit ##
It is also possible to use the entry "TuxPaint (remove only)" in the Control
Panel Add/Remove programs section.
macOS
### macOS ###
Delete "TuxPaint.app" from the "/Applications" folder. Data files, including
the configuration files, stamps, and saved pictures, may be found in
@ -893,7 +895,7 @@ the configuration files, stamps, and saved pictures, may be found in
"/Users/emër përdoruesi/Library/Application Support/TuxPaint/" (individual
users).
Linux
### Linux ###
Within the Tux Paint source directory (where you compiled Tux Paint), you can
use the "make uninstall" target to uninstall Tux Paint. By default, this must