Sync docs: Text/Labels/ENVVARS -> EXTENDING re: fonts

This commit is contained in:
Bill Kendrick 2025-06-08 11:10:03 -07:00
parent 848924c6dc
commit 2ef45a2c6a
39 changed files with 407 additions and 30 deletions

View file

@ -133,3 +133,7 @@ may be used by the "Text" and "Label" tools.
the location of the user's configuration files. It is used to find a
user-specific "fonts.conf" configuration file.
⚙ See the "Extending Tux Paint" documentation for information on where Tux
Paint searches for fonts.

View file

@ -652,7 +652,7 @@ option is set). The locations vary, depending on operating system.
+ B_USER_FONTS_DIRECTORY
+ B_USER_NONPACKAGED_FONTS_DIRECTORY
* Linux
* Linux/etc.
+ /usr/share/feh/fonts
+ /usr/share/fonts
+ /usr/X11R6/lib/X11/fonts
@ -665,7 +665,46 @@ option is set). The locations vary, depending on operating system.
### FontConfig ###
...
Tux Paint utilizes FontConfig to find additional system-wide and user-specific
fonts that the 'Text' and 'Label' tools might be able to use (unless the
"--nosysfonts" option is set). It does this by looking for FontConfig
configuration files ("fonts.conf") in various locations.
* Windows
+ The "etc/fonts/fonts.conf" file included with Tux Paint.
* macOS
+ The path specified by the "FONTCONFIG_PATH" environment variable, if
set.
* Haiku
+ /boot/system/settings/fonts/fonts.conf
* Linux/etc.
+ The path specified by the "FONTCONFIG_PATH" environment variable, if
set.
+ If the above fails, then "/etc/fonts/fonts.conf".
+ The path specified by the "XDG_CONFIG_HOME" environment variable, if
set. There, it looks for the file "fontconfig/fonts.conf".
+ If the above fails, then "$HOME/.config/fontconfig/fonts.conf".
Each FontConfig configuration file ("fonts.conf") is examined for "<dir>" tags
that specify directory (folder) paths where fonts might be found, and Tux Paint
scans them and loads the fonts. If a "prefix" attribute is included in the tag,
Tux Paint prefixes the path accordingly.
→ xdg ←
The directory path specified is considered to be relative to the user's
local data path, specified by the "XDG_DATA_HOME" environment variable. If
not set, then ".local/share" under the path specified by the "HOME"
environment variable will be used, if it exists.
→ relative ←
The directory path specified is considered to be relative to the
configuration file itself.
→ default, cwd, or no "prefix" attribute specified ←
The directory path specified is considered to be relative to the current
working directory (where Tux Paint is running), unless a root path is
included at the start (e.g., "/", "C:\\", etc.)
'Images de démarrage'

View file

@ -6,7 +6,7 @@
Copyright © 2002-2025 by divers contributeurs; voir AUTHORS.txt.
https://tuxpaint.org/
mai 26, 2025
juin 8, 2025
+-------------------------------------------------------+
| Table des matières |
@ -510,6 +510,9 @@ e.Outils "Texte" et "Étiquette" ←
l'écran. (Vous pouvez changer la police, la couleur et le style en entrant
le texte, avant de l'appliquer sur le canevas).
⚙ See the "Extending Tux Paint" documentation for information on where Tux
Paint searches for fonts.
Appuyez sur [Entrée] ou [Retour] et le texte sera inclus dans l'image et le
curseur se déplacera d'une ligne vers le bas.

View file

@ -231,6 +231,9 @@
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>
</body>
</html>

View file

@ -102,7 +102,7 @@
</p>
<p>
mai 26, 2025 </p>
juin 8, 2025 </p>
</center>
</header>
<table border="2"
@ -813,6 +813,9 @@
<p>
Choisissez une police (parmi les «Lettres» disponibles sur la droite) et une couleur (dans la palette de couleurs en bas). Vous pouvez aussi appliquer des effets tels que caractère gras et/ou italique. Cliquez sur l'écran et un curseur apparaîtra. Tapez un texte et il apparaîtra à l'écran. (Vous pouvez changer la police, la couleur et le style en entrant le texte, avant de l'appliquer sur le canevas). </p>
<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>
<p>
Appuyez sur <b><code>[Entrée]</code></b> ou <b><code>[Retour]</code></b> et le texte sera inclus dans l'image et le curseur se déplacera d'une ligne vers le bas. </p>