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

@ -125,3 +125,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

@ -620,7 +620,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
@ -633,7 +633,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.)
'Starters'

View file

@ -6,7 +6,7 @@
Copyright © 2002-2025 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
maí 26, 2025
júní 8, 2025
+-------------------------------------------------+
| Table of Contents |
@ -480,6 +480,9 @@ e."Text" and "Label" Tools ←
font, color, and styling while entering the text, before it is applied to
the canvas.)
⚙ See the "Extending Tux Paint" documentation for information on where Tux
Paint searches for fonts.
Press [Enter] or [Return] and the text will be drawn onto the picture and
the cursor will move down one line.

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>
maí 26, 2025 </p>
júní 8, 2025 </p>
</center>
</header>
<table border="2"
@ -813,6 +813,9 @@
<p>
Choose a font (from the 'Letters' available on the right) and a color (from the color palette near the bottom). You may also apply a bold, and/or an italic styling effect to the text. Click on the screen and a cursor will appear. Type text and it will show up on the screen. (You can change the font, color, and styling while entering the text, before it is applied to the canvas.) </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>
Press <b><code>[Enter]</code></b> or <b><code>[Return]</code></b> and the text will be drawn onto the picture and the cursor will move down one line. </p>