ENVVARS docs update (re: FontConfig vars)

This commit is contained in:
Bill Kendrick 2025-06-08 09:55:36 -07:00
parent cab4394173
commit 46fb261e84
16 changed files with 495 additions and 31 deletions

View file

@ -1,11 +1,11 @@
Tux Paint
version 0.9.35
version 0.9.36
Dokumentation om miljövariabler
Copyright © 2021-2025 av olika bidragsgivare; se AUTHORS.txt.
https://tuxpaint.org/
maj 2, 2025
juni 8, 2025
-------------------------------------------------------------------------------
@ -42,6 +42,8 @@ genom de bibliotek som den använder.
hittas exporterar Rita med Tux helt enkelt ritningar och GIF-filer till
"$HOME".
Tux Paint also uses this to find FontConfig configuration files; see below.
→ XDG_DATA_HOME ←
@ -83,6 +85,7 @@ 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.
→ SDL_VIDEO_ALLOW_SCREENSAVER ←
Anger om Rita med Tux ska tillåta att en skärmsläckare körs. Kan sättas
@ -103,3 +106,26 @@ för användare av Rita med Tux.
### Font-related environment variables ###
Tux Paint uses FontConfig (via Pango, in turn via SDL_Pango) to find fonts that
may be used by the "Text" and "Label" tools.
→ FONTCONFIG_PATH ←
Specifies where FontConfig should look for a "fonts.conf" configuration
file which Tux Paint examines for any "<dir>" tags, which it then uses to
search for fonts that could be used by the tools.
# Note: On Apple macOS, this is forced to be the "Resources/etc" folder,
inside the Tux Paint application itself.
# Note: On Apple iOS, this is forced to be the "etc" folder, inside the
Tux Paint application itself.
→ XDG_CONFIG_HOME ←
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 "fonts.conf" configuration file.

View file

@ -96,7 +96,7 @@
</p>
<p>
maj 2, 2025 </p>
juni 8, 2025 </p>
</center>
<hr>
@ -132,6 +132,9 @@
<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>
@ -180,7 +183,8 @@
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.
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>
@ -199,6 +203,34 @@
</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>
</body>
</html>