Sync docs after a bunch of changes, including make-Template

This commit is contained in:
Bill Kendrick 2023-05-29 10:23:27 -07:00
parent 9ab7fdba13
commit 36d7e0daf3
30 changed files with 662 additions and 357 deletions

View file

@ -755,11 +755,11 @@ Starter Options
Template Options
Like 'starters', a configuration file may be specified that defines how
Like 'Starters', a configuration file may be specified that defines how
Tux Paint should behave when applying 'template' images to the canvas when
they do not have identical proportions (aspect ratio). See "Starter
Options", above. (Note: Tux Paint prior to version 0.9.29 did not support
template options.)
starter options.)
Translations

View file

@ -17,7 +17,7 @@
| * Saving |
| * Audio Problems |
| * Fullscreen Mode Problems |
| * Other Probelms |
| * Other Problems |
| * Help / Contact |
+------------------------------+
@ -479,7 +479,7 @@ Fullscreen Mode Problems
----------------------------------------------------------------------
Other Probelms
Other Problems
Tux Paint won't run
@ -563,6 +563,17 @@ Other Probelms
By default, Tux Paint first looks at configuration files for
options.
* Windows
Under Windows, Tux Paint first examines the configuration
file:
tuxpaint.cfg
Finally, any options sent as command-line arguments are used.
* macOS
* Unix and Linux
Under Unix and Linux, it first examines the system-wide
@ -576,14 +587,7 @@ Other Probelms
Finally, any options sent as command-line arguments are used.
* Windows
Under Windows, Tux Paint first examines the configuration
file:
tuxpaint.cfg
Finally, any options sent as command-line arguments are used.
* Haiku
This means that if anything is set in a configuration file that
you don't want set, you'll need to either change the config. file

View file

@ -100,6 +100,10 @@ What's New in Tux Paint version 0.9.31?
New Magic tools
Loops, Ribbon, Smooth, and Squiggles
Create templates from Open dialog
Saved drawings can be turned into templates (used to make new
drawings) via a new option in the Open dialog
See CHANGES.txt for the complete list of changes.
Using Tux Paint
@ -679,35 +683,45 @@ Available Tools
⌨ Note: You can also press [Control / ⌘] + [N] on the keyboard to
start a new drawing.
Special Solid Background Color Choices
Special Solid Background Color Choices
Along with the preset solid colors, you can also
choose colors using a rainbow palette or a "color
mixer". These operate identically to the options
found in the color palette shown below the canvas
when drawing a picture. See Main Screen > Lower:
Colors > Special color options for details.
Along with the preset solid colors, you can also choose colors
using a rainbow palette or a "color mixer". These operate
identically to the options found in the color palette shown
below the canvas when drawing a picture. See Main Screen >
Lower: Colors > Special color options for details.
'Starter' & Template Images
* 'Starters' can behave like a page from a
coloring book — a black-and-white outline of a
picture, which you can then color in, and the
black outline remains intact — or like a 3D
photograph, where you draw in between a
foreground and background layer.
* 'Templates' are similar, but simply provide a
background drawing to work off of. Unlike
'Starters', there is no layer that remains in
the foreground of anything you draw in the
picture.
'Starter' & Template Images
When using the 'Eraser' tool, the original image from
the 'Starter' or 'Template' will reappear. The 'Flip'
and 'Mirror' Magic tools affect the orientation of
the 'Starter' or 'Template', as well.
'Starters' can behave like a page from a coloring book — a
black-and-white outline of a picture, which you can then color
in, and the black outline remains intact — or like a 3D
photograph, where you draw in between a foreground and
background layer.
When you load a 'Starter' or 'Template', draw on it,
and then click 'Save,' it creates a new picture file
— it doesn't overwrite the original, so you can use
it again later (by accessing it from the 'New'
dialog).
'Templates' are similar, but simply provide a background drawing
to work off of. Unlike 'Starters', there is no layer that
remains in the foreground of anything you draw in the picture.
⚙ You can create your own 'Starter' and Template
images. See the Extending Tux Paint documentation's
sections on 'Starters' and Templates.
When using the 'Eraser' tool, the original image from the
'Starter' or 'Template' will reappear. The 'Flip' and 'Mirror'
Magic tools affect the orientation of the 'Starter' or
'Template', as well.
When you load a 'Starter' or 'Template', draw on it, and then
click 'Save,' it creates a new picture file — it doesn't
overwrite the original, so you can use it again later (by
accessing it from the 'New' dialog).
💡 You can also convert your saved drawings into
Templates directly within Tux Paint, from the 'Open'
dialog. See "Open", below.
"Open" Command
@ -718,7 +732,8 @@ Available Tools
Click a picture to select it, and then...
* Click the green 'Open' button at the lower left of the list
to load the selected picture.
to load the selected picture. You will then be able to edit
it.
(Alternatively, you can double-click a picture's icon to load
it.)
@ -738,13 +753,21 @@ Available Tools
mind).
* Click the 'Export' button near the lower right to export the
image to your export folder. (e.g., "~/Pictures/TuxPaint/")
selected picture to your export folder. (e.g.,
"~/Pictures/TuxPaint/")
From the "Open" screen you can also:
* Click the blue 'Slides' (slide projector) button at the lower
left to go to slideshow mode. See "Slides", below, for
details.
* Click the blue 'Template' button at the lower left to go to
convert the selected picture into a new template, which can
be used as the basis for new drawings.
📜 Note: The Template creation feature was added to Tux Paint
in version 0.9.30.
* Click the red 'Back' arrow button at the lower right of the
list to cancel and return to the picture you were drawing.

View file

@ -947,7 +947,7 @@
</header>
<p>
Like 'starters', a configuration file may be specified that defines how Tux Paint should behave when applying 'template' images to the canvas when they do not have identical proportions (aspect ratio). See "Starter Options", above. (Note: Tux Paint prior to version 0.9.29 did not support template options.) </p>
Like <a href="#starters">'Starters'</a>, a configuration file may be specified that defines how Tux Paint should behave when applying 'template' images to the canvas when they do not have identical proportions (aspect ratio). See "<a href="#starter_options">Starter Options</a>", above. (Note: Tux Paint prior to version 0.9.29 did not support starter options.) </p>
</section><!-- H2: Template Options -->
</section><!-- H1: 'Templates' -->

View file

@ -62,7 +62,7 @@
<a href="#fullscreen">Fullscreen Mode Problems</a>
</li>
<li>
<a href="#other">Other Probelms</a>
<a href="#other">Other Problems</a>
</li>
<li>
<a href="#contact">Help / Contact</a>
@ -609,7 +609,7 @@
<h2>
<a name="other" id="other">
Other Probelms </a>
Other Problems </a>
</h2>
<dl>
@ -698,6 +698,28 @@
By default, Tux Paint first looks at configuration files for options. </p>
<ul>
<li>
<i>Windows</i>
<p>
Under Windows, Tux Paint first examines the configuration file: </p>
<blockquote>
<p>
<code>tuxpaint.cfg</code>
</p>
</blockquote>
<p>
Finally, any options sent as command-line arguments are used. </p>
</li>
<li>
<i>macOS</i>
<p>
</p>
</li>
<li>
<i>Unix and Linux</i>
<p>
@ -723,18 +745,9 @@
</li>
<li>
<i>Windows</i>
<i>Haiku</i>
<p>
Under Windows, Tux Paint first examines the configuration file: </p>
<blockquote>
<p>
<code>tuxpaint.cfg</code>
</p>
</blockquote>
<p>
Finally, any options sent as command-line arguments are used. </p>
</p>
</li>
</ul>
@ -769,7 +782,7 @@
</blockquote>
<p>
Linux and Unix users can also disable the system-wide configuration file by including the following command-line argument: </p>
Linux and Unix users can also disable the system-wide configuration file by including the following command-line argument: </p>
<blockquote>
<p>

View file

@ -224,6 +224,9 @@
<dt>New Magic tools</dt>
<dd>Loops, Ribbon, Smooth, and Squiggles</dd>
<dt>Create templates from Open dialog</dt>
<dd>Saved drawings can be turned into templates (used to make new drawings) via a new option in the Open dialog</dd>
</dl>
<p>
@ -504,7 +507,7 @@
</section>
<!-- Using: Tools -->
<section class="outer">
<section>
<header>
<h2 id="using_tools">
Available Tools </h2>
@ -1040,26 +1043,31 @@
<p class="note">
<span title="Keyboard shortcut">&#9000;</span> <strong>Note:</strong> You can also press <b><code>[Control / &#8984;]</code></b> + <code><b>[N]</b></code> on the keyboard to start a new drawing. </p>
<strong>Special Solid Background Color Choices</strong>
<blockquote>
<p>
Along with the preset solid colors, you can also choose colors using a rainbow palette or a "color mixer". These operate identically to the options found in the color palette shown below the canvas when drawing a picture. See <a href="#special_color_options">Main Screen &gt; Lower: Colors &gt; Special color options</a> for details. </p>
</blockquote>
<dl>
<dt><strong>Special Solid Background Color Choices</strong></dt>
<dd>
Along with the preset solid colors, you can also choose colors using a rainbow palette or a "color mixer". These operate identically to the options found in the color palette shown below the canvas when drawing a picture. See <a href="#special_color_options">Main Screen &gt; Lower: Colors &gt; Special color options</a> for details. </dd>
<strong>'Starter' &amp; Template Images</strong>
<blockquote>
<p>
'Starters' can behave like a page from a coloring book — a black-and-white outline of a picture, which you can then color in, and the black outline remains intact — or like a 3D photograph, where you draw in between a foreground and background layer. </p>
<dt><strong>'Starter' &amp; Template Images</strong></dt>
<dd>
<ul>
<li>'Starters' can behave like a page from a coloring book — a black-and-white outline of a picture, which you can then color in, and the black outline remains intact — or like a 3D photograph, where you draw in between a foreground and background layer.</li>
<li>'Templates' are similar, but simply provide a background drawing to work off of. Unlike 'Starters', there is no layer that remains in the foreground of anything you draw in the picture.</li>
</ul>
<p>
'Templates' are similar, but simply provide a background drawing to work off of. Unlike 'Starters', there is no layer that remains in the foreground of anything you draw in the picture. </p>
<p>
When using the 'Eraser' tool, the original image from the 'Starter' or 'Template' will reappear. The 'Flip' and 'Mirror' Magic tools affect the orientation of the 'Starter' or 'Template', as well. </p>
<p>
When using the 'Eraser' tool, the original image from the 'Starter' or 'Template' will reappear. The 'Flip' and 'Mirror' Magic tools affect the orientation of the 'Starter' or 'Template', as well. </p>
<p>
When you load a 'Starter' or 'Template', draw on it, and then click 'Save,' it creates a new picture file — it doesn't overwrite the original, so you can use it again later (by accessing it from the 'New' dialog). </p>
<p>
When you load a 'Starter' or 'Template', draw on it, and then click 'Save,' it creates a new picture file — it doesn't overwrite the original, so you can use it again later (by accessing it from the 'New' dialog). </p>
</blockquote>
<p class="note">
<span title="Configuration option">&#9881;</span> You can create your own 'Starter' and Template images. See the <em>Extending Tux Paint</em> documentation's sections on <a href="EXTENDING.html#starters">'Starters'</a> and <a href="EXTENDING.html#templates">Templates</a>. </p>
<p class="note">
<span title="Information">&#128161;</span> You can also convert your saved drawings into Templates directly within Tux Paint, from the 'Open' dialog. See "<a href="#using_tools_other_open">Open</a>", below. </p>
</dd>
</dl>
</dd>
<dt id="using_tools_other_open">
<strong>"Open" Command</strong>
@ -1091,7 +1099,7 @@
alt=""
align="right">
<p>
Click the green 'Open' button at the lower left of the list to load the selected picture. </p>
Click the green 'Open' button at the lower left of the list to load the selected picture. You will then be able to edit it. </p>
<p>
(Alternatively, you can double-click a picture's icon to load it.) </p>
@ -1123,7 +1131,7 @@
alt=""
align="right">
<p>
Click the 'Export' button near the lower right to export the image to your export folder. (e.g., "<code>~/Pictures/TuxPaint/</code>") </p>
Click the 'Export' button near the lower right to export the selected picture to your export folder. (e.g., "<code>~/Pictures/TuxPaint/</code>") </p>
<div class="screenshot-right-after"></div>
</li>
</ul>
@ -1142,6 +1150,20 @@
<div class="screenshot-right-after"></div>
</li>
<li>
<img src="../../html/images/open_template.png"
width="48"
height="48"
alt=""
align="right">
<p>
Click the blue 'Template' button at the lower left to go to convert the selected picture into a new template, which can be used as the basis for new drawings. </p>
<div class="screenshot-right-after"></div>
<p class="note">
<span title="Version variation">&#128220;</span> <strong>Note:</strong> The Template creation feature was added to Tux Paint in version 0.9.30. </p>
</li>
<li>
<img src="../../html/images/open_back.png"
width="48"