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

Regen ENVVARS after section/header tags added

Browse source
This commit is contained in:
Bill Kendrick 2025-06-08 11:23:14 -07:00
parent 09cb4e769e
commit 858fa75ea5
16 changed files with 1360 additions and 1200 deletions
Download patch file Download diff file Expand all files Collapse all files

2
docs/en/ENVVARS.txt
View file

@ -7,8 +7,6 @@
June 8, 2025
-------------------------------------------------------------------------------
Tux Paint understands a number of environment variables, either directly, or
indirectly by the libraries that it utilizes.

318
docs/en/html/ENVVARS.html
View file

@ -81,158 +81,180 @@
link="#0000FF"
vlink="#FF0000"
alink="#FF00FF">
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
version 0.9.36<br/>
Environment Variables Documentation </h1>
<section class="outer">
<header>
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
version 0.9.36<br/>
Environment Variables Documentation </h1>
<p>
Copyright &copy; 2021-2025 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
<p>
June 8, 2025 </p>
</center>
</header>
</section>
<section class="outer">
<p>
Tux Paint understands a number of environment variables, either directly, or indirectly by the libraries that it utilizes. </p>
</section>
<section class="indent outer"><!-- H2: Storage-related environment variables -->
<header>
<h2>
Storage-related environment variables </h2>
</header>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Specifies the user's "home directory", which is used to locate numerous other files or directories. In some cases, it is utilized as part of a fall-back location, when other environment variables (elsewhere in this documentation) are not set. Sometimes, the location to use can be overridden by options provided on the command-line or via Tux Paint's configuration file. See the "OPTIONS" documentation for details. </p>
<p>
A few examples of where "<code>$HOME</code>" is used include: </p>
<ul>
<li>The location of Tux Paint's configuration file</li>
<li>The basis of where Tux Paint saves and loads users' drawings</li>
<li>The location of a user's private collection of data files &mdash; stamps, brushes, etc. &mdash; (versus those available system wide)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. Specifically, where to find "<code>user-dirs.dirs</code>", where the "<code>XDG_PICTURES_DIR</code>" might be defined. It is used for exporting drawings and animated GIFs. Generally it's set to something like "<code>$HOME/Pictures/</code>". If not specified, Tux Paint checks in the directory "<code>$HOME/.config/</code>". If the configuration cannot be found, Tux Paint simply exports drawings and GIFs to "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's data directories. Specifically, where to find the "<code>Trash</code>" directory. It is used when deleting images from Tux Paint's "Open" dialog. If not set, the location "<code>$HOME/.local/share/Trash/</code>" is used, if available. If not, images are simply deleted, rather than moved anywhere. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Specifies the location where temporary files may be created. Only used by Tux Paint on Microsoft Windows OSes. Uses "<code>userdata</code>" if not set. </p>
</dl>
</section><!-- H2: Storage-related environment variables -->
<section class="indent outer"><!-- H2: Language-related environment variables -->
<header>
<h2>
Language-related environment variables </h2>
</header>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Specify the language Tux Paint should utilize in its user interface. Overridden by the "<code>--lang</code>" and "<code>--locale</code>" command-line options or their configuration file counterparts. The "<code>LANGUAGE</code>" environment variable is used, if set. If not, "<code>LC_ALL</code>" is used as a fallback. Then "<code>LC_MESSAGES</code>", and finally "<code>LANG</code>". </p>
</dd>
</dl>
</section><!-- H2: Language-related environment variables -->
<section class="indent outer"><!-- H2: Display-related environment variables -->
<header>
<h2>
Display-related environment variables </h2>
</header>
<p>
Copyright &copy; 2021-2025 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
The following are a few of the environment variables supported by Simple DirectMedia Layer (libSDL) &mdash; which Tux Paint utilizes for displaying graphics, playing sounds, and receiving mouse, keyboard, and joystick input &mdash; and which may be useful to users of Tux Paint. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Specifies whether Tux Paint should allow a screensaver to run. Can be set to '1' (true) by Tux Paint itself by issuing the command-line option "<code>--allowscreensaver</code>" or its configuration file counterpart. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Requests where to position Tux Paint's window, and can be used to specify what display to place a fullscreen Tux Paint in a multi-monitor configuration. If not set, or set to "<code>nopref</code>" (meaning "no preference"), Simple DirectMedia Layer (libSDL) decides. Can be set to an <code>X,Y</code> coordinate (e.g. <code>200,100</code>), or "<code>center</code>" (meaning "center"). </p>
</dd>
</dl>
</section><!-- H2: Display-related environment variables -->
<section class="indent outer"><!-- H2: Font-related environment variables -->
<header>
<h2>
Font-related environment variables </h2>
</header>
<p>
June 8, 2025 </p>
</center>
<hr>
<p>
Tux Paint understands a number of environment variables, either directly, or indirectly by the libraries that it utilizes. </p>
<h2>
Storage-related environment variables </h2>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Specifies the user's "home directory", which is used to locate numerous other files or directories. In some cases, it is utilized as part of a fall-back location, when other environment variables (elsewhere in this documentation) are not set. Sometimes, the location to use can be overridden by options provided on the command-line or via Tux Paint's configuration file. See the "OPTIONS" documentation for details. </p>
<p>
A few examples of where "<code>$HOME</code>" is used include: </p>
<ul>
<li>The location of Tux Paint's configuration file</li>
<li>The basis of where Tux Paint saves and loads users' drawings</li>
<li>The location of a user's private collection of data files &mdash; stamps, brushes, etc. &mdash; (versus those available system wide)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. Specifically, where to find "<code>user-dirs.dirs</code>", where the "<code>XDG_PICTURES_DIR</code>" might be defined. It is used for exporting drawings and animated GIFs. Generally it's set to something like "<code>$HOME/Pictures/</code>". If not specified, Tux Paint checks in the directory "<code>$HOME/.config/</code>". If the configuration cannot be found, Tux Paint simply exports drawings and GIFs to "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's data directories. Specifically, where to find the "<code>Trash</code>" directory. It is used when deleting images from Tux Paint's "Open" dialog. If not set, the location "<code>$HOME/.local/share/Trash/</code>" is used, if available. If not, images are simply deleted, rather than moved anywhere. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Specifies the location where temporary files may be created. Only used by Tux Paint on Microsoft Windows OSes. Uses "<code>userdata</code>" if not set. </p>
</dl>
<h2>
Language-related environment variables </h2>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Specify the language Tux Paint should utilize in its user interface. Overridden by the "<code>--lang</code>" and "<code>--locale</code>" command-line options or their configuration file counterparts. The "<code>LANGUAGE</code>" environment variable is used, if set. If not, "<code>LC_ALL</code>" is used as a fallback. Then "<code>LC_MESSAGES</code>", and finally "<code>LANG</code>". </p>
</dd>
</dl>
<h2>
Display-related environment variables </h2>
<p>
The following are a few of the environment variables supported by Simple DirectMedia Layer (libSDL) &mdash; which Tux Paint utilizes for displaying graphics, playing sounds, and receiving mouse, keyboard, and joystick input &mdash; and which may be useful to users of Tux Paint. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Specifies whether Tux Paint should allow a screensaver to run. Can be set to '1' (true) by Tux Paint itself by issuing the command-line option "<code>--allowscreensaver</code>" or its configuration file counterpart. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Requests where to position Tux Paint's window, and can be used to specify what display to place a fullscreen Tux Paint in a multi-monitor configuration. If not set, or set to "<code>nopref</code>" (meaning "no preference"), Simple DirectMedia Layer (libSDL) decides. Can be set to an <code>X,Y</code> coordinate (e.g. <code>200,100</code>), or "<code>center</code>" (meaning "center"). </p>
</dd>
</dl>
<h2>
Font-related environment variables </h2>
<p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
</section><!-- H2: Font-related environment variables -->
</body>
</html>

2
docs/es_ES.UTF-8/ENVVARS.txt
View file

@ -7,8 +7,6 @@
junio 8, 2025
-------------------------------------------------------------------------------
Tux Paint understands a number of environment variables, either directly, or
indirectly by the libraries that it utilizes.

318
docs/es_ES.UTF-8/html/ENVVARS.html
View file

@ -81,158 +81,180 @@
link="#0000FF"
vlink="#FF0000"
alink="#FF00FF">
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
versi&oacute;n 0.9.36<br/>
Environment Variables Documentation </h1>
<section class="outer">
<header>
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
versi&oacute;n 0.9.36<br/>
Environment Variables Documentation </h1>
<p>
Copyright &copy; 2021-2025 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
<p>
junio 8, 2025 </p>
</center>
</header>
</section>
<section class="outer">
<p>
Tux Paint understands a number of environment variables, either directly, or indirectly by the libraries that it utilizes. </p>
</section>
<section class="indent outer"><!-- H2: Storage-related environment variables -->
<header>
<h2>
Storage-related environment variables </h2>
</header>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Specifies the user's "home directory", which is used to locate numerous other files or directories. In some cases, it is utilized as part of a fall-back location, when other environment variables (elsewhere in this documentation) are not set. Sometimes, the location to use can be overridden by options provided on the command-line or via Tux Paint's configuration file. See the "OPTIONS" documentation for details. </p>
<p>
A few examples of where "<code>$HOME</code>" is used include: </p>
<ul>
<li>The location of Tux Paint's configuration file</li>
<li>The basis of where Tux Paint saves and loads users' drawings</li>
<li>The location of a user's private collection of data files &mdash; stamps, brushes, etc. &mdash; (versus those available system wide)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. Specifically, where to find "<code>user-dirs.dirs</code>", where the "<code>XDG_PICTURES_DIR</code>" might be defined. It is used for exporting drawings and animated GIFs. Generally it's set to something like "<code>$HOME/Pictures/</code>". If not specified, Tux Paint checks in the directory "<code>$HOME/.config/</code>". If the configuration cannot be found, Tux Paint simply exports drawings and GIFs to "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's data directories. Specifically, where to find the "<code>Trash</code>" directory. It is used when deleting images from Tux Paint's "Open" dialog. If not set, the location "<code>$HOME/.local/share/Trash/</code>" is used, if available. If not, images are simply deleted, rather than moved anywhere. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Specifies the location where temporary files may be created. Only used by Tux Paint on Microsoft Windows OSes. Uses "<code>userdata</code>" if not set. </p>
</dl>
</section><!-- H2: Storage-related environment variables -->
<section class="indent outer"><!-- H2: Language-related environment variables -->
<header>
<h2>
Language-related environment variables </h2>
</header>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Specify the language Tux Paint should utilize in its user interface. Overridden by the "<code>--lang</code>" and "<code>--locale</code>" command-line options or their configuration file counterparts. The "<code>LANGUAGE</code>" environment variable is used, if set. If not, "<code>LC_ALL</code>" is used as a fallback. Then "<code>LC_MESSAGES</code>", and finally "<code>LANG</code>". </p>
</dd>
</dl>
</section><!-- H2: Language-related environment variables -->
<section class="indent outer"><!-- H2: Display-related environment variables -->
<header>
<h2>
Display-related environment variables </h2>
</header>
<p>
Copyright &copy; 2021-2025 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
The following are a few of the environment variables supported by Simple DirectMedia Layer (libSDL) &mdash; which Tux Paint utilizes for displaying graphics, playing sounds, and receiving mouse, keyboard, and joystick input &mdash; and which may be useful to users of Tux Paint. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Specifies whether Tux Paint should allow a screensaver to run. Can be set to '1' (true) by Tux Paint itself by issuing the command-line option "<code>--allowscreensaver</code>" or its configuration file counterpart. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Requests where to position Tux Paint's window, and can be used to specify what display to place a fullscreen Tux Paint in a multi-monitor configuration. If not set, or set to "<code>nopref</code>" (meaning "no preference"), Simple DirectMedia Layer (libSDL) decides. Can be set to an <code>X,Y</code> coordinate (e.g. <code>200,100</code>), or "<code>center</code>" (meaning "center"). </p>
</dd>
</dl>
</section><!-- H2: Display-related environment variables -->
<section class="indent outer"><!-- H2: Font-related environment variables -->
<header>
<h2>
Font-related environment variables </h2>
</header>
<p>
junio 8, 2025 </p>
</center>
<hr>
<p>
Tux Paint understands a number of environment variables, either directly, or indirectly by the libraries that it utilizes. </p>
<h2>
Storage-related environment variables </h2>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Specifies the user's "home directory", which is used to locate numerous other files or directories. In some cases, it is utilized as part of a fall-back location, when other environment variables (elsewhere in this documentation) are not set. Sometimes, the location to use can be overridden by options provided on the command-line or via Tux Paint's configuration file. See the "OPTIONS" documentation for details. </p>
<p>
A few examples of where "<code>$HOME</code>" is used include: </p>
<ul>
<li>The location of Tux Paint's configuration file</li>
<li>The basis of where Tux Paint saves and loads users' drawings</li>
<li>The location of a user's private collection of data files &mdash; stamps, brushes, etc. &mdash; (versus those available system wide)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. Specifically, where to find "<code>user-dirs.dirs</code>", where the "<code>XDG_PICTURES_DIR</code>" might be defined. It is used for exporting drawings and animated GIFs. Generally it's set to something like "<code>$HOME/Pictures/</code>". If not specified, Tux Paint checks in the directory "<code>$HOME/.config/</code>". If the configuration cannot be found, Tux Paint simply exports drawings and GIFs to "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's data directories. Specifically, where to find the "<code>Trash</code>" directory. It is used when deleting images from Tux Paint's "Open" dialog. If not set, the location "<code>$HOME/.local/share/Trash/</code>" is used, if available. If not, images are simply deleted, rather than moved anywhere. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Specifies the location where temporary files may be created. Only used by Tux Paint on Microsoft Windows OSes. Uses "<code>userdata</code>" if not set. </p>
</dl>
<h2>
Language-related environment variables </h2>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Specify the language Tux Paint should utilize in its user interface. Overridden by the "<code>--lang</code>" and "<code>--locale</code>" command-line options or their configuration file counterparts. The "<code>LANGUAGE</code>" environment variable is used, if set. If not, "<code>LC_ALL</code>" is used as a fallback. Then "<code>LC_MESSAGES</code>", and finally "<code>LANG</code>". </p>
</dd>
</dl>
<h2>
Display-related environment variables </h2>
<p>
The following are a few of the environment variables supported by Simple DirectMedia Layer (libSDL) &mdash; which Tux Paint utilizes for displaying graphics, playing sounds, and receiving mouse, keyboard, and joystick input &mdash; and which may be useful to users of Tux Paint. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Specifies whether Tux Paint should allow a screensaver to run. Can be set to '1' (true) by Tux Paint itself by issuing the command-line option "<code>--allowscreensaver</code>" or its configuration file counterpart. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Requests where to position Tux Paint's window, and can be used to specify what display to place a fullscreen Tux Paint in a multi-monitor configuration. If not set, or set to "<code>nopref</code>" (meaning "no preference"), Simple DirectMedia Layer (libSDL) decides. Can be set to an <code>X,Y</code> coordinate (e.g. <code>200,100</code>), or "<code>center</code>" (meaning "center"). </p>
</dd>
</dl>
<h2>
Font-related environment variables </h2>
<p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
</section><!-- H2: Font-related environment variables -->
</body>
</html>

2
docs/fr_FR.UTF-8/ENVVARS.txt
View file

@ -7,8 +7,6 @@
juin 8, 2025
-------------------------------------------------------------------------------
Tux Paint interprète plusieurs variables d'environnement, soit directement,
soit indirectement par le biais des bibliothèques qu'il utilise.

318
docs/fr_FR.UTF-8/html/ENVVARS.html
View file

@ -81,158 +81,180 @@
link="#0000FF"
vlink="#FF0000"
alink="#FF00FF">
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
version 0.9.36<br/>
Documentation sur les variables d'environnement </h1>
<section class="outer">
<header>
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
version 0.9.36<br/>
Documentation sur les variables d'environnement </h1>
<p>
Copyright &copy; 2021-2025 by divers contributeurs; voir <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
<p>
juin 8, 2025 </p>
</center>
</header>
</section>
<section class="outer">
<p>
Tux Paint interprète plusieurs variables d'environnement, soit directement, soit indirectement par le biais des bibliothèques qu'il utilise. </p>
</section>
<section class="indent outer"><!-- H2: Storage-related environment variables -->
<header>
<h2>
Variables d'environnement relatives au stockage </h2>
</header>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Spécifie le répertoire personnel de l'utilisateur, qui sert à accueillir de nombreux autres fichiers ou répertoires. Dans quelques cas, il sert de solution de repli, quand d'autres variables d'environnement (autre part dans cette documentation) n'ont pas été positionnées. Parfois, l'endroit à utiliser peut être changer par des options fournies en ligne de commande ou via le fichier de configuration de Tux Paint. Voir le document "OPTIONS" pour les détails. </p>
<p>
Quelques exemples où "<code>$HOME</code>" est utilisé incluent : </p>
<ul>
<li>L'emplacement du fichier de configuration de Tux Paint</li>
<li>La base où Tux Paint sauvegarde et lit les dessins des utilisateurs</li>
<li>L'endroit où se situent les fichiers privés d'un utilisateur (&mdash; tampons, pinceaux, etc, &mdash;) (par opposition aux fichiers accessibles à tout le monde)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
Sur Linux et d'autres plateformes où les standards du XDG (X Desktop Group) sont appliqués, c'est l'endroit où se trouvent les fichiers de configuration de l'utilisateur. Plus précisément, c'est où trouver "<code>user-dirs.dirs</code>", où le "<code>XDG_PICTURES_DIR</code>" devrait être défini. Il est utilisé pour exporter les dessins et GIF animés. En général, il est égal à quelque chose comme "<code>$HOME/Pictures/</code>". S'il n'est pas spécifié, Tux Paint vérifie le répertoire "<code>$HOME/.config/</code>". Si la configuration ne peut être trouvée, Tux Paint exporte simplement les dessins et GIF animés vers "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
Sur Linux et d'autres plateformes où les standards du XDG (X Desktop Group) sont appliqués, c'est l'endroit où se trouvent les fichiers de données de l'utilisateur. Plus précisément, c'est où trouver le répertoire "<code>Trash</code>". Il est utilisé quand on supprime des images à partir de la boîte de dialogue "Ouvrir". Si ce n'est pas défini, le répertoire "<code>$HOME/.local/share/Trash/</code>" est utilisé, s'il existe. Sinon, les images sont simplement supprimées, plutôt que déplacées quelque part. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Spécifie l'endroit où les fichiers temporaires peuvent être créés. Tux Paint l'utilise seulement sous Microsoft Windows. Utilise "<code>userdata</code>" si non spécifié. </p>
</dl>
</section><!-- H2: Storage-related environment variables -->
<section class="indent outer"><!-- H2: Language-related environment variables -->
<header>
<h2>
Variables d'environnement relatives aux langues </h2>
</header>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Spécifie la langue utilisée par Tux Paint sur l'interface utilisateur. Remplacé par les options en ligne de commande "<code>--lang</code>" et "<code>--locale</code>", ou bien leurs équivalents dans le fichier de configuration. La variable d'environnement "<code>LANGUAGE</code>" est utilisée (si elle est activée) sinon, "<code>LC_ALL</code>" est utilisé comme solution de repli. Puis "<code>LC_MESSAGES</code>" et enfin "<code>LANG</code>". </p>
</dd>
</dl>
</section><!-- H2: Language-related environment variables -->
<section class="indent outer"><!-- H2: Display-related environment variables -->
<header>
<h2>
Variables d'environnement en rapport avec l'affichage </h2>
</header>
<p>
Copyright &copy; 2021-2025 by divers contributeurs; voir <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
Ce qui suit donne quelques variables d'environnement supportées par Simple DirectMedia Layer (libSDL) &mdash; que Tux Paint utilise pour l'affichage des dessins, pour jouer des sons et traiter les saisies de la souris, du clavier et du joystick &mdash; et qui peuvent être utiles aux utilisateurs de Tux Paint. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Spécifie si Tux Paint autorise l'utilisation d'un économiseur d'écran. Peut être mis à '1' (vrai) par Tux Paint lui-même avec l'option en ligne de commande "<code>--allowscreensaver</code>" ou dans son fichier de configuration. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Demande où positionner la fenêntre de Tux Paint, ce qui peut être utilisé pour spécifier où mettre Tux Paint en plein écran en configuration multi-moniteurs. Si il n'y a rien, ou bien le réglage est mis à "<code>nopref</code>" (ce qui signifie "pas de préférence"), Simple DirectMedia Layer (libSDL) décide. Peut être réglé pour une coordonnée <code>X,Y</code> (par ex. <code>200,100</code>), ou "<code>center</code>" (ce qui signifie "centré"). </p>
</dd>
</dl>
</section><!-- H2: Display-related environment variables -->
<section class="indent outer"><!-- H2: Font-related environment variables -->
<header>
<h2>
Font-related environment variables </h2>
</header>
<p>
juin 8, 2025 </p>
</center>
<hr>
<p>
Tux Paint interprète plusieurs variables d'environnement, soit directement, soit indirectement par le biais des bibliothèques qu'il utilise. </p>
<h2>
Variables d'environnement relatives au stockage </h2>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Spécifie le répertoire personnel de l'utilisateur, qui sert à accueillir de nombreux autres fichiers ou répertoires. Dans quelques cas, il sert de solution de repli, quand d'autres variables d'environnement (autre part dans cette documentation) n'ont pas été positionnées. Parfois, l'endroit à utiliser peut être changer par des options fournies en ligne de commande ou via le fichier de configuration de Tux Paint. Voir le document "OPTIONS" pour les détails. </p>
<p>
Quelques exemples où "<code>$HOME</code>" est utilisé incluent : </p>
<ul>
<li>L'emplacement du fichier de configuration de Tux Paint</li>
<li>La base où Tux Paint sauvegarde et lit les dessins des utilisateurs</li>
<li>L'endroit où se situent les fichiers privés d'un utilisateur (&mdash; tampons, pinceaux, etc, &mdash;) (par opposition aux fichiers accessibles à tout le monde)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
Sur Linux et d'autres plateformes où les standards du XDG (X Desktop Group) sont appliqués, c'est l'endroit où se trouvent les fichiers de configuration de l'utilisateur. Plus précisément, c'est où trouver "<code>user-dirs.dirs</code>", où le "<code>XDG_PICTURES_DIR</code>" devrait être défini. Il est utilisé pour exporter les dessins et GIF animés. En général, il est égal à quelque chose comme "<code>$HOME/Pictures/</code>". S'il n'est pas spécifié, Tux Paint vérifie le répertoire "<code>$HOME/.config/</code>". Si la configuration ne peut être trouvée, Tux Paint exporte simplement les dessins et GIF animés vers "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
Sur Linux et d'autres plateformes où les standards du XDG (X Desktop Group) sont appliqués, c'est l'endroit où se trouvent les fichiers de données de l'utilisateur. Plus précisément, c'est où trouver le répertoire "<code>Trash</code>". Il est utilisé quand on supprime des images à partir de la boîte de dialogue "Ouvrir". Si ce n'est pas défini, le répertoire "<code>$HOME/.local/share/Trash/</code>" est utilisé, s'il existe. Sinon, les images sont simplement supprimées, plutôt que déplacées quelque part. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Spécifie l'endroit où les fichiers temporaires peuvent être créés. Tux Paint l'utilise seulement sous Microsoft Windows. Utilise "<code>userdata</code>" si non spécifié. </p>
</dl>
<h2>
Variables d'environnement relatives aux langues </h2>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Spécifie la langue utilisée par Tux Paint sur l'interface utilisateur. Remplacé par les options en ligne de commande "<code>--lang</code>" et "<code>--locale</code>", ou bien leurs équivalents dans le fichier de configuration. La variable d'environnement "<code>LANGUAGE</code>" est utilisée (si elle est activée) sinon, "<code>LC_ALL</code>" est utilisé comme solution de repli. Puis "<code>LC_MESSAGES</code>" et enfin "<code>LANG</code>". </p>
</dd>
</dl>
<h2>
Variables d'environnement en rapport avec l'affichage </h2>
<p>
Ce qui suit donne quelques variables d'environnement supportées par Simple DirectMedia Layer (libSDL) &mdash; que Tux Paint utilise pour l'affichage des dessins, pour jouer des sons et traiter les saisies de la souris, du clavier et du joystick &mdash; et qui peuvent être utiles aux utilisateurs de Tux Paint. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Spécifie si Tux Paint autorise l'utilisation d'un économiseur d'écran. Peut être mis à '1' (vrai) par Tux Paint lui-même avec l'option en ligne de commande "<code>--allowscreensaver</code>" ou dans son fichier de configuration. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Demande où positionner la fenêntre de Tux Paint, ce qui peut être utilisé pour spécifier où mettre Tux Paint en plein écran en configuration multi-moniteurs. Si il n'y a rien, ou bien le réglage est mis à "<code>nopref</code>" (ce qui signifie "pas de préférence"), Simple DirectMedia Layer (libSDL) décide. Peut être réglé pour une coordonnée <code>X,Y</code> (par ex. <code>200,100</code>), ou "<code>center</code>" (ce qui signifie "centré"). </p>
</dd>
</dl>
<h2>
Font-related environment variables </h2>
<p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
</section><!-- H2: Font-related environment variables -->
</body>
</html>

2
docs/gl_ES.UTF-8/ENVVARS.txt
View file

@ -7,8 +7,6 @@
8 de Xuño de 2025
-------------------------------------------------------------------------------
Tux Paint comprende unha serie de variábeis de contorno, ben directamente ou
indirectamente polas bibliotecas que emprega.

318
docs/gl_ES.UTF-8/html/ENVVARS.html
View file

@ -81,158 +81,180 @@
link="#0000FF"
vlink="#FF0000"
alink="#FF00FF">
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
versión 0.9.36<br/>
Documentación de variábeis de contorno </h1>
<section class="outer">
<header>
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
versión 0.9.36<br/>
Documentación de variábeis de contorno </h1>
<p>
Copyright &copy; 2021-2025 by varios colaboradores; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
<p>
8 de Xuño de 2025 </p>
</center>
</header>
</section>
<section class="outer">
<p>
Tux Paint comprende unha serie de variábeis de contorno, ben directamente ou indirectamente polas bibliotecas que emprega. </p>
</section>
<section class="indent outer"><!-- H2: Storage-related environment variables -->
<header>
<h2>
Variábeis de contorno relacionadas co almacenamento </h2>
</header>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Especifica o «directorio persoal» do usuario, que se usa para localizar outros ficheiros ou directorios. Nalgúns casos, úsase como parte dunha situación alternativa, cando non se configuran outras variábeis de contorno (noutros lugares desta documentación). Ás veces, a localización a empregar pode ser anulada polas opcións fornecidas na liña de ordes ou a través do ficheiro de configuración de Tux Paint. Consulte a documentación de «OPCIÓNS» (OPTIONS) para máis detalles. </p>
<p>
Algúns exemplos de onde se usa «<code>$HOME</code>» inclúen: </p>
<ul>
<li>A localización do ficheiro de configuración de Tux Paint</li>
<li>A base de onde Tux Paint garda e carga os debuxos dos usuarios</li>
<li>A localización da colección privada de ficheiros de datos dun usuario &mdash; selos, pinceis, etc. &mdash; (fronte aos dispoñíbeis no sistema)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. Specifically, where to find "<code>user-dirs.dirs</code>", where the "<code>XDG_PICTURES_DIR</code>" might be defined. It is used for exporting drawings and animated GIFs. Generally it's set to something like "<code>$HOME/Pictures/</code>". If not specified, Tux Paint checks in the directory "<code>$HOME/.config/</code>". If the configuration cannot be found, Tux Paint simply exports drawings and GIFs to "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's data directories. Specifically, where to find the "<code>Trash</code>" directory. It is used when deleting images from Tux Paint's "Open" dialog. If not set, the location "<code>$HOME/.local/share/Trash/</code>" is used, if available. If not, images are simply deleted, rather than moved anywhere. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Especifica a localización onde se poden crear ficheiros temporais. Só o usa Tux Paint nos sistemas operativos Microsoft Windows. Emprega «<code>userdata</code>» se non se define. </p>
</dl>
</section><!-- H2: Storage-related environment variables -->
<section class="indent outer"><!-- H2: Language-related environment variables -->
<header>
<h2>
Variábeis de contorno relacionadas co idioma </h2>
</header>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Specify the language Tux Paint should utilize in its user interface. Overridden by the "<code>--lang</code>" and "<code>--locale</code>" command-line options or their configuration file counterparts. The "<code>LANGUAGE</code>" environment variable is used, if set. If not, "<code>LC_ALL</code>" is used as a fallback. Then "<code>LC_MESSAGES</code>", and finally "<code>LANG</code>". </p>
</dd>
</dl>
</section><!-- H2: Language-related environment variables -->
<section class="indent outer"><!-- H2: Display-related environment variables -->
<header>
<h2>
Variábeisbles de contorno relacionadas co que se amosa </h2>
</header>
<p>
Copyright &copy; 2021-2025 by varios colaboradores; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
A seguir amósanse algunhas das variábeis de contorno compatíbeis con Simple DirectMedia Layer (libSDL) &mdash; que Tux Paint utiliza para amosar gráficos, reproducir sons e recibir entrada do rato, teclado e joystick &mdash; e que poden ser útiles para os usuarios de Tux Paint. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Especifica se Tux Paint debería permitir a execución dun protector de pantalla. Pode ser definido como «1» (verdadeiro) polo propio Tux Paint emitindo a opción de liña de ordes «<code>--allowscreensaver</code>» ou o seu equivaente no ficheiro de configuración. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Requests where to position Tux Paint's window, and can be used to specify what display to place a fullscreen Tux Paint in a multi-monitor configuration. If not set, or set to "<code>nopref</code>" (meaning "no preference"), Simple DirectMedia Layer (libSDL) decides. Can be set to an <code>X,Y</code> coordinate (e.g. <code>200,100</code>), or "<code>center</code>" (meaning "center"). </p>
</dd>
</dl>
</section><!-- H2: Display-related environment variables -->
<section class="indent outer"><!-- H2: Font-related environment variables -->
<header>
<h2>
Font-related environment variables </h2>
</header>
<p>
8 de Xuño de 2025 </p>
</center>
<hr>
<p>
Tux Paint comprende unha serie de variábeis de contorno, ben directamente ou indirectamente polas bibliotecas que emprega. </p>
<h2>
Variábeis de contorno relacionadas co almacenamento </h2>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Especifica o «directorio persoal» do usuario, que se usa para localizar outros ficheiros ou directorios. Nalgúns casos, úsase como parte dunha situación alternativa, cando non se configuran outras variábeis de contorno (noutros lugares desta documentación). Ás veces, a localización a empregar pode ser anulada polas opcións fornecidas na liña de ordes ou a través do ficheiro de configuración de Tux Paint. Consulte a documentación de «OPCIÓNS» (OPTIONS) para máis detalles. </p>
<p>
Algúns exemplos de onde se usa «<code>$HOME</code>» inclúen: </p>
<ul>
<li>A localización do ficheiro de configuración de Tux Paint</li>
<li>A base de onde Tux Paint garda e carga os debuxos dos usuarios</li>
<li>A localización da colección privada de ficheiros de datos dun usuario &mdash; selos, pinceis, etc. &mdash; (fronte aos dispoñíbeis no sistema)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. Specifically, where to find "<code>user-dirs.dirs</code>", where the "<code>XDG_PICTURES_DIR</code>" might be defined. It is used for exporting drawings and animated GIFs. Generally it's set to something like "<code>$HOME/Pictures/</code>". If not specified, Tux Paint checks in the directory "<code>$HOME/.config/</code>". If the configuration cannot be found, Tux Paint simply exports drawings and GIFs to "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's data directories. Specifically, where to find the "<code>Trash</code>" directory. It is used when deleting images from Tux Paint's "Open" dialog. If not set, the location "<code>$HOME/.local/share/Trash/</code>" is used, if available. If not, images are simply deleted, rather than moved anywhere. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Especifica a localización onde se poden crear ficheiros temporais. Só o usa Tux Paint nos sistemas operativos Microsoft Windows. Emprega «<code>userdata</code>» se non se define. </p>
</dl>
<h2>
Variábeis de contorno relacionadas co idioma </h2>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Specify the language Tux Paint should utilize in its user interface. Overridden by the "<code>--lang</code>" and "<code>--locale</code>" command-line options or their configuration file counterparts. The "<code>LANGUAGE</code>" environment variable is used, if set. If not, "<code>LC_ALL</code>" is used as a fallback. Then "<code>LC_MESSAGES</code>", and finally "<code>LANG</code>". </p>
</dd>
</dl>
<h2>
Variábeisbles de contorno relacionadas co que se amosa </h2>
<p>
A seguir amósanse algunhas das variábeis de contorno compatíbeis con Simple DirectMedia Layer (libSDL) &mdash; que Tux Paint utiliza para amosar gráficos, reproducir sons e recibir entrada do rato, teclado e joystick &mdash; e que poden ser útiles para os usuarios de Tux Paint. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Especifica se Tux Paint debería permitir a execución dun protector de pantalla. Pode ser definido como «1» (verdadeiro) polo propio Tux Paint emitindo a opción de liña de ordes «<code>--allowscreensaver</code>» ou o seu equivaente no ficheiro de configuración. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Requests where to position Tux Paint's window, and can be used to specify what display to place a fullscreen Tux Paint in a multi-monitor configuration. If not set, or set to "<code>nopref</code>" (meaning "no preference"), Simple DirectMedia Layer (libSDL) decides. Can be set to an <code>X,Y</code> coordinate (e.g. <code>200,100</code>), or "<code>center</code>" (meaning "center"). </p>
</dd>
</dl>
<h2>
Font-related environment variables </h2>
<p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
</section><!-- H2: Font-related environment variables -->
</body>
</html>

2
docs/is_IS.UTF-8/ENVVARS.txt
View file

@ -7,8 +7,6 @@
júní 8, 2025
-------------------------------------------------------------------------------
Tux Paint understands a number of environment variables, either directly, or
indirectly by the libraries that it utilizes.

318
docs/is_IS.UTF-8/html/ENVVARS.html
View file

@ -81,158 +81,180 @@
link="#0000FF"
vlink="#FF0000"
alink="#FF00FF">
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
version 0.9.36<br/>
Environment Variables Documentation </h1>
<section class="outer">
<header>
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
version 0.9.36<br/>
Environment Variables Documentation </h1>
<p>
Copyright &copy; 2021-2025 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
<p>
júní 8, 2025 </p>
</center>
</header>
</section>
<section class="outer">
<p>
Tux Paint understands a number of environment variables, either directly, or indirectly by the libraries that it utilizes. </p>
</section>
<section class="indent outer"><!-- H2: Storage-related environment variables -->
<header>
<h2>
Storage-related environment variables </h2>
</header>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Specifies the user's "home directory", which is used to locate numerous other files or directories. In some cases, it is utilized as part of a fall-back location, when other environment variables (elsewhere in this documentation) are not set. Sometimes, the location to use can be overridden by options provided on the command-line or via Tux Paint's configuration file. See the "OPTIONS" documentation for details. </p>
<p>
A few examples of where "<code>$HOME</code>" is used include: </p>
<ul>
<li>The location of Tux Paint's configuration file</li>
<li>The basis of where Tux Paint saves and loads users' drawings</li>
<li>The location of a user's private collection of data files &mdash; stamps, brushes, etc. &mdash; (versus those available system wide)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. Specifically, where to find "<code>user-dirs.dirs</code>", where the "<code>XDG_PICTURES_DIR</code>" might be defined. It is used for exporting drawings and animated GIFs. Generally it's set to something like "<code>$HOME/Pictures/</code>". If not specified, Tux Paint checks in the directory "<code>$HOME/.config/</code>". If the configuration cannot be found, Tux Paint simply exports drawings and GIFs to "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's data directories. Specifically, where to find the "<code>Trash</code>" directory. It is used when deleting images from Tux Paint's "Open" dialog. If not set, the location "<code>$HOME/.local/share/Trash/</code>" is used, if available. If not, images are simply deleted, rather than moved anywhere. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Specifies the location where temporary files may be created. Only used by Tux Paint on Microsoft Windows OSes. Uses "<code>userdata</code>" if not set. </p>
</dl>
</section><!-- H2: Storage-related environment variables -->
<section class="indent outer"><!-- H2: Language-related environment variables -->
<header>
<h2>
Language-related environment variables </h2>
</header>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Specify the language Tux Paint should utilize in its user interface. Overridden by the "<code>--lang</code>" and "<code>--locale</code>" command-line options or their configuration file counterparts. The "<code>LANGUAGE</code>" environment variable is used, if set. If not, "<code>LC_ALL</code>" is used as a fallback. Then "<code>LC_MESSAGES</code>", and finally "<code>LANG</code>". </p>
</dd>
</dl>
</section><!-- H2: Language-related environment variables -->
<section class="indent outer"><!-- H2: Display-related environment variables -->
<header>
<h2>
Display-related environment variables </h2>
</header>
<p>
Copyright &copy; 2021-2025 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
The following are a few of the environment variables supported by Simple DirectMedia Layer (libSDL) &mdash; which Tux Paint utilizes for displaying graphics, playing sounds, and receiving mouse, keyboard, and joystick input &mdash; and which may be useful to users of Tux Paint. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Specifies whether Tux Paint should allow a screensaver to run. Can be set to '1' (true) by Tux Paint itself by issuing the command-line option "<code>--allowscreensaver</code>" or its configuration file counterpart. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Requests where to position Tux Paint's window, and can be used to specify what display to place a fullscreen Tux Paint in a multi-monitor configuration. If not set, or set to "<code>nopref</code>" (meaning "no preference"), Simple DirectMedia Layer (libSDL) decides. Can be set to an <code>X,Y</code> coordinate (e.g. <code>200,100</code>), or "<code>center</code>" (meaning "center"). </p>
</dd>
</dl>
</section><!-- H2: Display-related environment variables -->
<section class="indent outer"><!-- H2: Font-related environment variables -->
<header>
<h2>
Font-related environment variables </h2>
</header>
<p>
júní 8, 2025 </p>
</center>
<hr>
<p>
Tux Paint understands a number of environment variables, either directly, or indirectly by the libraries that it utilizes. </p>
<h2>
Storage-related environment variables </h2>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Specifies the user's "home directory", which is used to locate numerous other files or directories. In some cases, it is utilized as part of a fall-back location, when other environment variables (elsewhere in this documentation) are not set. Sometimes, the location to use can be overridden by options provided on the command-line or via Tux Paint's configuration file. See the "OPTIONS" documentation for details. </p>
<p>
A few examples of where "<code>$HOME</code>" is used include: </p>
<ul>
<li>The location of Tux Paint's configuration file</li>
<li>The basis of where Tux Paint saves and loads users' drawings</li>
<li>The location of a user's private collection of data files &mdash; stamps, brushes, etc. &mdash; (versus those available system wide)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. Specifically, where to find "<code>user-dirs.dirs</code>", where the "<code>XDG_PICTURES_DIR</code>" might be defined. It is used for exporting drawings and animated GIFs. Generally it's set to something like "<code>$HOME/Pictures/</code>". If not specified, Tux Paint checks in the directory "<code>$HOME/.config/</code>". If the configuration cannot be found, Tux Paint simply exports drawings and GIFs to "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's data directories. Specifically, where to find the "<code>Trash</code>" directory. It is used when deleting images from Tux Paint's "Open" dialog. If not set, the location "<code>$HOME/.local/share/Trash/</code>" is used, if available. If not, images are simply deleted, rather than moved anywhere. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Specifies the location where temporary files may be created. Only used by Tux Paint on Microsoft Windows OSes. Uses "<code>userdata</code>" if not set. </p>
</dl>
<h2>
Language-related environment variables </h2>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Specify the language Tux Paint should utilize in its user interface. Overridden by the "<code>--lang</code>" and "<code>--locale</code>" command-line options or their configuration file counterparts. The "<code>LANGUAGE</code>" environment variable is used, if set. If not, "<code>LC_ALL</code>" is used as a fallback. Then "<code>LC_MESSAGES</code>", and finally "<code>LANG</code>". </p>
</dd>
</dl>
<h2>
Display-related environment variables </h2>
<p>
The following are a few of the environment variables supported by Simple DirectMedia Layer (libSDL) &mdash; which Tux Paint utilizes for displaying graphics, playing sounds, and receiving mouse, keyboard, and joystick input &mdash; and which may be useful to users of Tux Paint. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Specifies whether Tux Paint should allow a screensaver to run. Can be set to '1' (true) by Tux Paint itself by issuing the command-line option "<code>--allowscreensaver</code>" or its configuration file counterpart. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Requests where to position Tux Paint's window, and can be used to specify what display to place a fullscreen Tux Paint in a multi-monitor configuration. If not set, or set to "<code>nopref</code>" (meaning "no preference"), Simple DirectMedia Layer (libSDL) decides. Can be set to an <code>X,Y</code> coordinate (e.g. <code>200,100</code>), or "<code>center</code>" (meaning "center"). </p>
</dd>
</dl>
<h2>
Font-related environment variables </h2>
<p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
</section><!-- H2: Font-related environment variables -->
</body>
</html>

2
docs/ja_JP.UTF-8/ENVVARS.txt
View file

@ -7,8 +7,6 @@
2025年6月 8日
-------------------------------------------------------------------------------
Tux Paint understands a number of environment variables, either directly, or
indirectly by the libraries that it utilizes.

318
docs/ja_JP.UTF-8/html/ENVVARS.html
View file

@ -81,158 +81,180 @@
link="#0000FF"
vlink="#FF0000"
alink="#FF00FF">
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
バージョン 0.9.36<br/>
Environment Variables Documentation </h1>
<section class="outer">
<header>
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
バージョン 0.9.36<br/>
Environment Variables Documentation </h1>
<p>
Copyright &copy; 2021-2025 by various contributors; <a href="../../AUTHORS.txt">AUTHORS.txt</a> 参照.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
<p>
2025年6月 8日 </p>
</center>
</header>
</section>
<section class="outer">
<p>
Tux Paint understands a number of environment variables, either directly, or indirectly by the libraries that it utilizes. </p>
</section>
<section class="indent outer"><!-- H2: Storage-related environment variables -->
<header>
<h2>
Storage-related environment variables </h2>
</header>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Specifies the user's "home directory", which is used to locate numerous other files or directories. In some cases, it is utilized as part of a fall-back location, when other environment variables (elsewhere in this documentation) are not set. Sometimes, the location to use can be overridden by options provided on the command-line or via Tux Paint's configuration file. See the "OPTIONS" documentation for details. </p>
<p>
A few examples of where "<code>$HOME</code>" is used include: </p>
<ul>
<li>The location of Tux Paint's configuration file</li>
<li>The basis of where Tux Paint saves and loads users' drawings</li>
<li>The location of a user's private collection of data files &mdash; stamps, brushes, etc. &mdash; (versus those available system wide)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. Specifically, where to find "<code>user-dirs.dirs</code>", where the "<code>XDG_PICTURES_DIR</code>" might be defined. It is used for exporting drawings and animated GIFs. Generally it's set to something like "<code>$HOME/Pictures/</code>". If not specified, Tux Paint checks in the directory "<code>$HOME/.config/</code>". If the configuration cannot be found, Tux Paint simply exports drawings and GIFs to "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's data directories. Specifically, where to find the "<code>Trash</code>" directory. It is used when deleting images from Tux Paint's "Open" dialog. If not set, the location "<code>$HOME/.local/share/Trash/</code>" is used, if available. If not, images are simply deleted, rather than moved anywhere. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Specifies the location where temporary files may be created. Only used by Tux Paint on Microsoft Windows OSes. Uses "<code>userdata</code>" if not set. </p>
</dl>
</section><!-- H2: Storage-related environment variables -->
<section class="indent outer"><!-- H2: Language-related environment variables -->
<header>
<h2>
Language-related environment variables </h2>
</header>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Specify the language Tux Paint should utilize in its user interface. Overridden by the "<code>--lang</code>" and "<code>--locale</code>" command-line options or their configuration file counterparts. The "<code>LANGUAGE</code>" environment variable is used, if set. If not, "<code>LC_ALL</code>" is used as a fallback. Then "<code>LC_MESSAGES</code>", and finally "<code>LANG</code>". </p>
</dd>
</dl>
</section><!-- H2: Language-related environment variables -->
<section class="indent outer"><!-- H2: Display-related environment variables -->
<header>
<h2>
Display-related environment variables </h2>
</header>
<p>
Copyright &copy; 2021-2025 by various contributors; <a href="../../AUTHORS.txt">AUTHORS.txt</a> 参照.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
The following are a few of the environment variables supported by Simple DirectMedia Layer (libSDL) &mdash; which Tux Paint utilizes for displaying graphics, playing sounds, and receiving mouse, keyboard, and joystick input &mdash; and which may be useful to users of Tux Paint. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Specifies whether Tux Paint should allow a screensaver to run. Can be set to '1' (true) by Tux Paint itself by issuing the command-line option "<code>--allowscreensaver</code>" or its configuration file counterpart. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Requests where to position Tux Paint's window, and can be used to specify what display to place a fullscreen Tux Paint in a multi-monitor configuration. If not set, or set to "<code>nopref</code>" (meaning "no preference"), Simple DirectMedia Layer (libSDL) decides. Can be set to an <code>X,Y</code> coordinate (e.g. <code>200,100</code>), or "<code>center</code>" (meaning "center"). </p>
</dd>
</dl>
</section><!-- H2: Display-related environment variables -->
<section class="indent outer"><!-- H2: Font-related environment variables -->
<header>
<h2>
Font-related environment variables </h2>
</header>
<p>
2025年6月 8日 </p>
</center>
<hr>
<p>
Tux Paint understands a number of environment variables, either directly, or indirectly by the libraries that it utilizes. </p>
<h2>
Storage-related environment variables </h2>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Specifies the user's "home directory", which is used to locate numerous other files or directories. In some cases, it is utilized as part of a fall-back location, when other environment variables (elsewhere in this documentation) are not set. Sometimes, the location to use can be overridden by options provided on the command-line or via Tux Paint's configuration file. See the "OPTIONS" documentation for details. </p>
<p>
A few examples of where "<code>$HOME</code>" is used include: </p>
<ul>
<li>The location of Tux Paint's configuration file</li>
<li>The basis of where Tux Paint saves and loads users' drawings</li>
<li>The location of a user's private collection of data files &mdash; stamps, brushes, etc. &mdash; (versus those available system wide)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. Specifically, where to find "<code>user-dirs.dirs</code>", where the "<code>XDG_PICTURES_DIR</code>" might be defined. It is used for exporting drawings and animated GIFs. Generally it's set to something like "<code>$HOME/Pictures/</code>". If not specified, Tux Paint checks in the directory "<code>$HOME/.config/</code>". If the configuration cannot be found, Tux Paint simply exports drawings and GIFs to "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's data directories. Specifically, where to find the "<code>Trash</code>" directory. It is used when deleting images from Tux Paint's "Open" dialog. If not set, the location "<code>$HOME/.local/share/Trash/</code>" is used, if available. If not, images are simply deleted, rather than moved anywhere. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Specifies the location where temporary files may be created. Only used by Tux Paint on Microsoft Windows OSes. Uses "<code>userdata</code>" if not set. </p>
</dl>
<h2>
Language-related environment variables </h2>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Specify the language Tux Paint should utilize in its user interface. Overridden by the "<code>--lang</code>" and "<code>--locale</code>" command-line options or their configuration file counterparts. The "<code>LANGUAGE</code>" environment variable is used, if set. If not, "<code>LC_ALL</code>" is used as a fallback. Then "<code>LC_MESSAGES</code>", and finally "<code>LANG</code>". </p>
</dd>
</dl>
<h2>
Display-related environment variables </h2>
<p>
The following are a few of the environment variables supported by Simple DirectMedia Layer (libSDL) &mdash; which Tux Paint utilizes for displaying graphics, playing sounds, and receiving mouse, keyboard, and joystick input &mdash; and which may be useful to users of Tux Paint. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Specifies whether Tux Paint should allow a screensaver to run. Can be set to '1' (true) by Tux Paint itself by issuing the command-line option "<code>--allowscreensaver</code>" or its configuration file counterpart. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Requests where to position Tux Paint's window, and can be used to specify what display to place a fullscreen Tux Paint in a multi-monitor configuration. If not set, or set to "<code>nopref</code>" (meaning "no preference"), Simple DirectMedia Layer (libSDL) decides. Can be set to an <code>X,Y</code> coordinate (e.g. <code>200,100</code>), or "<code>center</code>" (meaning "center"). </p>
</dd>
</dl>
<h2>
Font-related environment variables </h2>
<p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
</section><!-- H2: Font-related environment variables -->
</body>
</html>

2
docs/sq_AL.UTF-8/ENVVARS.txt
View file

@ -7,8 +7,6 @@
8 qershor 2025
-------------------------------------------------------------------------------
Tux Paint-i njeh një numër ndryshoresh mjedisi, qoftë drejtpërsëdrejti, qoftë
tërthorazi nga bibliotekat që përdor.

318
docs/sq_AL.UTF-8/html/ENVVARS.html
View file

@ -81,158 +81,180 @@
link="#0000FF"
vlink="#FF0000"
alink="#FF00FF">
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
version 0.9.36<br/>
Dokumentim Ndryshoresh të Mjedisit </h1>
<section class="outer">
<header>
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
version 0.9.36<br/>
Dokumentim Ndryshoresh të Mjedisit </h1>
<p>
Të drejta kopjimi &copy; 2021-2025 nga kontribues të ndryshëm; shihni <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
<p>
8 qershor 2025 </p>
</center>
</header>
</section>
<section class="outer">
<p>
Tux Paint-i njeh një numër ndryshoresh mjedisi, qoftë drejtpërsëdrejti, qoftë tërthorazi nga bibliotekat që përdor. </p>
</section>
<section class="indent outer"><!-- H2: Storage-related environment variables -->
<header>
<h2>
Ndryshore mjedisi të lidhura me depozitim </h2>
</header>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Përcakton “drejtorinë shtëpi” të përdoruesit, që përdoret për të vendosur kartela dhe drejtori të tjera të shumta. Në disa raste përdoret si pjesë e një vendndodhje rrugëdalje, kur s’janë ujdisur ndryshore të tjera mjedisi (gjetkë në këtë dokumentim). Ndonjëherë, vendndodhja për t’u përdorur mund të anashkalohet nga mundësi të dhëna në rreshtin e urdhrave, ose përmes kartelës së formësimit të Tux Paint-it. Për hollësi, shihni “MUNDËSITË”. </p>
<p>
Në pak shembuj se ku përdoret “<code>$HOME</code>” përfshihen: </p>
<ul>
<li>Vendndodhja e kartelës së formësimit të Tux Paint-it</li>
<li>Baza se ku ruan dhe ngarkon Tux Paint-i vizatimet e përdoruesve</li>
<li>Vendndodhja e një koleksioni privat të përdoruesit të kartelave të të dhënave &mdash; stampave, penelave, etj. &mdash; (kundrejt atyre që mund të përdoren nga krejt sistemi)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
Në Linux dhe platforma të tjera ku përdoren standardet e Grupit Desktopi X, vendndodhja e kartelave të formësimeve të përdoruesit. Hollësisht, ku të gjendet “<code>user-dirs.dirs</code>”, ku “<code>XDG_PICTURES_DIR</code>” duhet përcaktuar. Përdoret për eksportim vizatimesh dhe GIF-esh të animuar. Përgjithësisht, caktohet diçka e ngjashme me “<code>$HOME/Pictures/</code>”. Në mos u përcaktoftë, Tux Paint kontrollon te drejtoria “<code>$HOME/.config/</code>”. Nëse s’gjendet dot formësimi, Tux Paint-i thjesht eksporton vizatime dhe GIF-e te “<code>$HOME</code>”. </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
Në Linux dhe platforma të tjera ku përdoren standardet e Grupit Desktopi X, vendndodhja e kartelave të formësimeve të përdoruesit. Hollësisht, ku të gjendet drejtoria “<code>Trash</code>”. Përdoret kur fshihen figura nga dialogu “Hap” i Tux Paint-it. Në mos u përcaktoftë, përdoret vendndodhja “<code>$HOME/.local/share/Trash/</code>”, në pastë. Nëse jo, figurat thjesht fshihen, në vend se të kalohe gjetiu. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Përcakton vendndodhjen ku mund të krijohen kartela të përkohshme. E përdorur nga Tux Paint-i vetëm në OSe Microsoft Windows. Përdor “<code>userdata</code>”, nëse s’është ujdisur. </p>
</dl>
</section><!-- H2: Storage-related environment variables -->
<section class="indent outer"><!-- H2: Language-related environment variables -->
<header>
<h2>
Ndryshore mjedisi të lidhura me gjuhët </h2>
</header>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Specify the language Tux Paint should utilize in its user interface. Overridden by the "<code>--lang</code>" and "<code>--locale</code>" command-line options or their configuration file counterparts. The "<code>LANGUAGE</code>" environment variable is used, if set. If not, "<code>LC_ALL</code>" is used as a fallback. Then "<code>LC_MESSAGES</code>", and finally "<code>LANG</code>". </p>
</dd>
</dl>
</section><!-- H2: Language-related environment variables -->
<section class="indent outer"><!-- H2: Display-related environment variables -->
<header>
<h2>
Ndryshore mjedisi të lidhura me ekranin </h2>
</header>
<p>
Të drejta kopjimi &copy; 2021-2025 nga kontribues të ndryshëm; shihni <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
Sa vijon janë pak nga ndryshoret e mjedisit të mbuluara nga Simple DirectMedia Layer (libSDL) &mdash; të cilat Tux Paint-i i përdorr për të shfaqur elementë grafikë, për të luajtur tinguj dhe për të marrë sinjale për miun, tastierën dhe joystick-un &mdash; dhe që mund të jenë të dobishme për për përdorues të Tux Paint-it. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Përcakton nëse Tux Paint-i duhet të lejojë xhirimin e një kursyesi ekrani. Mund të vihet '1' (true) nga vetëm Tux Paint-i, duke dhënë mundësinë “<code>--allowscreensaver</code>” në rresht urdhrash, ose te pjesa përkatëse e kartelës së formësimit. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Kërkesa ku të vendoset dritarja e Tux Paint-it dhe mund të përdoret për të përcaktuar në cilin ekrani të vendoset një Tux Paint sa krejt ekrani, në një sistem me shumë monitorë. Nëse nuk është ujdisur, ose ujdisur si “<code>nopref</code>” (që do të thotë “pa parapëlqim”), vendos Simple DirectMedia Layer (libSDL). Mund të vihet sa një koordinatë <code>X,Y</code> (p.sh., <code>200,100</code>), ose “<code>center</code>” (që do të thotë “qendër”). </p>
</dd>
</dl>
</section><!-- H2: Display-related environment variables -->
<section class="indent outer"><!-- H2: Font-related environment variables -->
<header>
<h2>
Font-related environment variables </h2>
</header>
<p>
8 qershor 2025 </p>
</center>
<hr>
<p>
Tux Paint-i njeh një numër ndryshoresh mjedisi, qoftë drejtpërsëdrejti, qoftë tërthorazi nga bibliotekat që përdor. </p>
<h2>
Ndryshore mjedisi të lidhura me depozitim </h2>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Përcakton “drejtorinë shtëpi” të përdoruesit, që përdoret për të vendosur kartela dhe drejtori të tjera të shumta. Në disa raste përdoret si pjesë e një vendndodhje rrugëdalje, kur s’janë ujdisur ndryshore të tjera mjedisi (gjetkë në këtë dokumentim). Ndonjëherë, vendndodhja për t’u përdorur mund të anashkalohet nga mundësi të dhëna në rreshtin e urdhrave, ose përmes kartelës së formësimit të Tux Paint-it. Për hollësi, shihni “MUNDËSITË”. </p>
<p>
Në pak shembuj se ku përdoret “<code>$HOME</code>” përfshihen: </p>
<ul>
<li>Vendndodhja e kartelës së formësimit të Tux Paint-it</li>
<li>Baza se ku ruan dhe ngarkon Tux Paint-i vizatimet e përdoruesve</li>
<li>Vendndodhja e një koleksioni privat të përdoruesit të kartelave të të dhënave &mdash; stampave, penelave, etj. &mdash; (kundrejt atyre që mund të përdoren nga krejt sistemi)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
Në Linux dhe platforma të tjera ku përdoren standardet e Grupit Desktopi X, vendndodhja e kartelave të formësimeve të përdoruesit. Hollësisht, ku të gjendet “<code>user-dirs.dirs</code>”, ku “<code>XDG_PICTURES_DIR</code>” duhet përcaktuar. Përdoret për eksportim vizatimesh dhe GIF-esh të animuar. Përgjithësisht, caktohet diçka e ngjashme me “<code>$HOME/Pictures/</code>”. Në mos u përcaktoftë, Tux Paint kontrollon te drejtoria “<code>$HOME/.config/</code>”. Nëse s’gjendet dot formësimi, Tux Paint-i thjesht eksporton vizatime dhe GIF-e te “<code>$HOME</code>”. </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
Në Linux dhe platforma të tjera ku përdoren standardet e Grupit Desktopi X, vendndodhja e kartelave të formësimeve të përdoruesit. Hollësisht, ku të gjendet drejtoria “<code>Trash</code>”. Përdoret kur fshihen figura nga dialogu “Hap” i Tux Paint-it. Në mos u përcaktoftë, përdoret vendndodhja “<code>$HOME/.local/share/Trash/</code>”, në pastë. Nëse jo, figurat thjesht fshihen, në vend se të kalohe gjetiu. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Përcakton vendndodhjen ku mund të krijohen kartela të përkohshme. E përdorur nga Tux Paint-i vetëm në OSe Microsoft Windows. Përdor “<code>userdata</code>”, nëse s’është ujdisur. </p>
</dl>
<h2>
Ndryshore mjedisi të lidhura me gjuhët </h2>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Specify the language Tux Paint should utilize in its user interface. Overridden by the "<code>--lang</code>" and "<code>--locale</code>" command-line options or their configuration file counterparts. The "<code>LANGUAGE</code>" environment variable is used, if set. If not, "<code>LC_ALL</code>" is used as a fallback. Then "<code>LC_MESSAGES</code>", and finally "<code>LANG</code>". </p>
</dd>
</dl>
<h2>
Ndryshore mjedisi të lidhura me ekranin </h2>
<p>
Sa vijon janë pak nga ndryshoret e mjedisit të mbuluara nga Simple DirectMedia Layer (libSDL) &mdash; të cilat Tux Paint-i i përdorr për të shfaqur elementë grafikë, për të luajtur tinguj dhe për të marrë sinjale për miun, tastierën dhe joystick-un &mdash; dhe që mund të jenë të dobishme për për përdorues të Tux Paint-it. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Përcakton nëse Tux Paint-i duhet të lejojë xhirimin e një kursyesi ekrani. Mund të vihet '1' (true) nga vetëm Tux Paint-i, duke dhënë mundësinë “<code>--allowscreensaver</code>” në rresht urdhrash, ose te pjesa përkatëse e kartelës së formësimit. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Kërkesa ku të vendoset dritarja e Tux Paint-it dhe mund të përdoret për të përcaktuar në cilin ekrani të vendoset një Tux Paint sa krejt ekrani, në një sistem me shumë monitorë. Nëse nuk është ujdisur, ose ujdisur si “<code>nopref</code>” (që do të thotë “pa parapëlqim”), vendos Simple DirectMedia Layer (libSDL). Mund të vihet sa një koordinatë <code>X,Y</code> (p.sh., <code>200,100</code>), ose “<code>center</code>” (që do të thotë “qendër”). </p>
</dd>
</dl>
<h2>
Font-related environment variables </h2>
<p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
</section><!-- H2: Font-related environment variables -->
</body>
</html>

2
docs/sv_SE.UTF-8/ENVVARS.txt
View file

@ -7,8 +7,6 @@
juni 8, 2025
-------------------------------------------------------------------------------
Rita med Tux förstår ett antal miljövariabler, antingen direkt eller indirekt
genom de bibliotek som den använder.

318
docs/sv_SE.UTF-8/html/ENVVARS.html
View file

@ -81,158 +81,180 @@
link="#0000FF"
vlink="#FF0000"
alink="#FF00FF">
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
version 0.9.36<br/>
Dokumentation om miljövariabler </h1>
<section class="outer">
<header>
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
version 0.9.36<br/>
Dokumentation om miljövariabler </h1>
<p>
Copyright © 2021-2025 av olika bidragsgivare; se <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
<p>
juni 8, 2025 </p>
</center>
</header>
</section>
<section class="outer">
<p>
Rita med Tux förstår ett antal miljövariabler, antingen direkt eller indirekt genom de bibliotek som den använder. </p>
</section>
<section class="indent outer"><!-- H2: Storage-related environment variables -->
<header>
<h2>
Lagringsrelaterade miljövariabler </h2>
</header>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Anger användarens "hemkatalog", som används för att hitta många andra filer eller kataloger. I vissa fall används den som en del av en reservplats, när andra miljövariabler (på andra ställen i den här dokumentationen) inte är inställda. Ibland kan den plats som ska användas åsidosättas genom alternativ som anges på kommandoraden eller via Rita med Tuxs konfigurationsfil. Se dokumentationen "OPTIONS" för mer information. </p>
<p>
Några exempel på när "<code>$HOME</code>" används är bl.a: </p>
<ul>
<li>Platsen för Rita med Tuxs konfigurationsfil</li>
<li>Grunden för var Rita med Tux sparar och laddar användarnas ritningar</li>
<li>Platsen för en användares privata samling av datafiler - stämplar, penslar etc. - (jämfört med de som finns tillgängliga i hela systemet)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
På Linux och andra plattformar där X Desktop Group-standarderna används, platsen för användarens konfigurationsfiler. Specifikt var man hittar "<code>user-dirs.dirs</code>", var "<code>XDG_PICTURES_DIR</code>" kan definieras. Den används för att exportera ritningar och animerade GIF-filer. I allmänhet är den inställd på något i stil med "<code>$HOME/Pictures/</code>". Om inget anges kontrollerar Rita med Tux i katalogen "<code>$HOME/.config/</code>". Om konfigurationen inte kan hittas exporterar Rita med Tux helt enkelt ritningar och GIF-filer till "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
På Linux och andra plattformar där X Desktop Group-standarderna används, platsen för användarens datakataloger. Specifikt var du hittar katalogen "<code>Trash</code>". Den används när man tar bort bilder från Rita med Tuxs "Öppna"-dialog. Om den inte anges används platsen "<code>$HOME/.local/share/Trash/</code>", om den finns tillgänglig. Om inte, raderas bilderna helt enkelt, snarare än att flyttas någonstans. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Anger den plats där tillfälliga filer kan skapas. Används endast av Rita med Tux på Microsoft Windows operativsystem. Använder "<code>userdata</code>" om den inte anges. </p>
</dl>
</section><!-- H2: Storage-related environment variables -->
<section class="indent outer"><!-- H2: Language-related environment variables -->
<header>
<h2>
Språkrelaterade miljövariabler </h2>
</header>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Ange vilket språk som Rita med Tux ska använda i sitt användargränssnitt. Åsidosätts av kommandoradsalternativen "<code>--lang</code>" och "<code>--locale</code>" eller deras motsvarigheter i konfigurationsfilen. Miljövariabeln "<code>LANGUAGE</code>" används om den är inställd. Om så inte är fallet används "<code>LC_ALL</code>" som reserv. Sedan "<code>LC_MESSAGES</code>" och slutligen "<code>LANG</code>". </p>
</dd>
</dl>
</section><!-- H2: Language-related environment variables -->
<section class="indent outer"><!-- H2: Display-related environment variables -->
<header>
<h2>
Displayrelaterade miljövariabler </h2>
</header>
<p>
Copyright © 2021-2025 av olika bidragsgivare; se <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
Här följer några av de miljövariabler som stöds av Simple DirectMedia Layer (libSDL) - som Rita med Tux använder för att visa grafik, spela upp ljud och ta emot mus-, tangentbords- och joystickinmatning - och som kan vara användbara för användare av Rita med Tux. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Anger om Rita med Tux ska tillåta att en skärmsläckare körs. Kan sättas till '1' (true) av Rita med Tux själv genom att ange kommandoradsalternativet "<code>--allowscreensaver</code>" eller dess motsvarighet i konfigurationsfilen. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Begär var Rita med Tux-fönstret ska placeras och kan användas för att ange vilken skärm som ska användas för att placera Rita med Tux i fullskärm i en konfiguration med flera skärmar. Om den inte är inställd, eller är inställd på "<code>nopref</code>" (vilket betyder "ingen preferens"), bestämmer Simple DirectMedia Layer (libSDL). Kan ställas in på en <code>X,Y</code>-koordinat (t.ex. <code>200,100</code>) eller "<code>center</code>" (vilket betyder "mitt"). </p>
</dd>
</dl>
</section><!-- H2: Display-related environment variables -->
<section class="indent outer"><!-- H2: Font-related environment variables -->
<header>
<h2>
Font-related environment variables </h2>
</header>
<p>
juni 8, 2025 </p>
</center>
<hr>
<p>
Rita med Tux förstår ett antal miljövariabler, antingen direkt eller indirekt genom de bibliotek som den använder. </p>
<h2>
Lagringsrelaterade miljövariabler </h2>
<dl>
<dt>
<code>HOME</code>
</dt>
<dd>
<p>
Anger användarens "hemkatalog", som används för att hitta många andra filer eller kataloger. I vissa fall används den som en del av en reservplats, när andra miljövariabler (på andra ställen i den här dokumentationen) inte är inställda. Ibland kan den plats som ska användas åsidosättas genom alternativ som anges på kommandoraden eller via Rita med Tuxs konfigurationsfil. Se dokumentationen "OPTIONS" för mer information. </p>
<p>
Några exempel på när "<code>$HOME</code>" används är bl.a: </p>
<ul>
<li>Platsen för Rita med Tuxs konfigurationsfil</li>
<li>Grunden för var Rita med Tux sparar och laddar användarnas ritningar</li>
<li>Platsen för en användares privata samling av datafiler - stämplar, penslar etc. - (jämfört med de som finns tillgängliga i hela systemet)</li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
<p>
På Linux och andra plattformar där X Desktop Group-standarderna används, platsen för användarens konfigurationsfiler. Specifikt var man hittar "<code>user-dirs.dirs</code>", var "<code>XDG_PICTURES_DIR</code>" kan definieras. Den används för att exportera ritningar och animerade GIF-filer. I allmänhet är den inställd på något i stil med "<code>$HOME/Pictures/</code>". Om inget anges kontrollerar Rita med Tux i katalogen "<code>$HOME/.config/</code>". Om konfigurationen inte kan hittas exporterar Rita med Tux helt enkelt ritningar och GIF-filer till "<code>$HOME</code>". </p>
<p>
Tux Paint also uses this to find FontConfig configuration files; see below. </p>
</dd>
<dt>
<code>XDG_DATA_HOME</code>
</dt>
<dd>
<p>
På Linux och andra plattformar där X Desktop Group-standarderna används, platsen för användarens datakataloger. Specifikt var du hittar katalogen "<code>Trash</code>". Den används när man tar bort bilder från Rita med Tuxs "Öppna"-dialog. Om den inte anges används platsen "<code>$HOME/.local/share/Trash/</code>", om den finns tillgänglig. Om inte, raderas bilderna helt enkelt, snarare än att flyttas någonstans. </p>
</dd>
<dt>
<code>TEMP</code>
</dt>
<dd>
<p>
Anger den plats där tillfälliga filer kan skapas. Används endast av Rita med Tux på Microsoft Windows operativsystem. Använder "<code>userdata</code>" om den inte anges. </p>
</dl>
<h2>
Språkrelaterade miljövariabler </h2>
<dl>
<dt>
<code>LANG</code>
</dt>
<dt>
<code>LANGUAGE</code>
</dt>
<dt>
<code>LC_ALL</code>
</dt>
<dt>
<code>LC_MESSAGES</code>
</dt>
<dd>
<p>
Ange vilket språk som Rita med Tux ska använda i sitt användargränssnitt. Åsidosätts av kommandoradsalternativen "<code>--lang</code>" och "<code>--locale</code>" eller deras motsvarigheter i konfigurationsfilen. Miljövariabeln "<code>LANGUAGE</code>" används om den är inställd. Om så inte är fallet används "<code>LC_ALL</code>" som reserv. Sedan "<code>LC_MESSAGES</code>" och slutligen "<code>LANG</code>". </p>
</dd>
</dl>
<h2>
Displayrelaterade miljövariabler </h2>
<p>
Här följer några av de miljövariabler som stöds av Simple DirectMedia Layer (libSDL) - som Rita med Tux använder för att visa grafik, spela upp ljud och ta emot mus-, tangentbords- och joystickinmatning - och som kan vara användbara för användare av Rita med Tux. </p>
<dl>
<dt>
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
</dt>
<dd>
<p>
Anger om Rita med Tux ska tillåta att en skärmsläckare körs. Kan sättas till '1' (true) av Rita med Tux själv genom att ange kommandoradsalternativet "<code>--allowscreensaver</code>" eller dess motsvarighet i konfigurationsfilen. </p>
</dd>
<dt>
<code>SDL_VIDEO_WINDOW_POS</code>
</dt>
<dd>
<p>
Begär var Rita med Tux-fönstret ska placeras och kan användas för att ange vilken skärm som ska användas för att placera Rita med Tux i fullskärm i en konfiguration med flera skärmar. Om den inte är inställd, eller är inställd på "<code>nopref</code>" (vilket betyder "ingen preferens"), bestämmer Simple DirectMedia Layer (libSDL). Kan ställas in på en <code>X,Y</code>-koordinat (t.ex. <code>200,100</code>) eller "<code>center</code>" (vilket betyder "mitt"). </p>
</dd>
</dl>
<h2>
Font-related environment variables </h2>
<p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
Tux Paint uses <cite>FontConfig</cite> (via <cite>Pango</cite>, in turn via <cite>SDL_Pango</cite>) to find fonts that may be used by the "Text" and "Label" tools. </p>
<dl>
<dt>
<code>FONTCONFIG_PATH</code>
</dt>
<dd>
<p>
Specifies where <cite>FontConfig</cite> should look for a "<code>fonts.conf</cite>" configuration file which Tux Paint examines for any "<code>&lt;dir&gt;</code>" tags, which it then uses to search for fonts that could be used by the tools. </p>
<ul>
<li>
Note: On Apple macOS, this is forced to be the "<code>Resources/etc</code>" folder, inside the Tux Paint application itself. </li>
<li>
Note: On Apple iOS, this is forced to be the "<code>etc</code>" folder, inside the Tux Paint application itself. </li>
</ul>
</dd>
<dt>
<code>XDG_CONFIG_HOME</code>
</dt>
<dd>
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. It is used to find a user-specific "<code>fonts.conf</code>" configuration file. </dd>
</dl>
<p class="note">
<span title="Configuration option">&#9881;</span> See the "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for information on where Tux Paint searches for fonts. </p>
</section><!-- H2: Font-related environment variables -->
</body>
</html>