Sync docs after various doc source updates

...mostly in terms of modularizing how various file
and directory (folder) paths are shown (for consistency in
both name and styling); add some missing paths (e.g., where
does Tux Paint save drawings on Haiku?)
This commit is contained in:
Bill Kendrick 2024-04-27 12:42:55 -07:00
parent 9c2a75455d
commit e268b598ff
71 changed files with 1074 additions and 873 deletions

View file

@ -100,7 +100,7 @@
</p>
<p>
2024年1月26</p>
2024年4月27</p>
</center>
</header>

View file

@ -312,27 +312,34 @@
Unless you asked Tux Paint to save into a specific location (using the "savedir" option), Tux Paint saves into a standard location on your local drive: </p>
<dl>
<dt>
<cite>Windows Vista, Windows 8, Windows 10, Windows 11</cite>
</dt>
<dt>
<cite>Windows Vista, Windows 8, Windows 10, Windows 11</cite>
</dt>
<dd>
In the user's "AppData" folder:<br> e.g., <code>C:\Users\<i>Username</i>\AppData\Roaming\TuxPaint\saved</code> </dd>
<dd>
In the user's "AppData" folder:<br> e.g., <nobr>"<code>C:\Users\username\AppData\Roaming\TuxPaint\saved\</code>"</nobr> </dd>
<dt>
<cite>macOS</cite>
</dt>
<dt>
<cite>macOS</cite>
</dt>
<dd>
In the user's "Application Support" folder:<br> e.g., <code>/Users/<i>Username</i>/Library/Applicaton Support/TuxPaint/saved/</code> </dd>
<dd>
In the user's "Application Support" folder:<br> e.g., <nobr>"<code>/Users/username/Library/Application Support/TuxPaint/saved/</code>"</nobr> </dd>
<dt>
<cite>Linux / Unix</cite>
</dt>
<dt>
<cite>Linux / Unix</cite>
</dt>
<dd>
In the user's home directory ("<code>$HOME</code>"), under a ".tuxpaint" subfolder:<br> e.g., <code>/home/<i>username</i>/.tuxpaint/saved/</code> </dd>
</dl>
<dd>
In the user's "home directory" folder:<br> e.g., <nobr>"<code>/home/username/.tuxpaint/saved/</code>"</nobr> </dd>
<dt>
<cite>Haiku</cite>
</dt>
<dd>
In the user's "settings" folder:<br> e.g., <nobr>"<code>/boot/home/config/settings/TuxPaint/saved/</code>"</nobr> </dd>
</dl>
<p>
The images are stored as PNG bitmaps, which most modern programs should be able to load (image editors, word processors, web browsers, etc.) </p>
@ -610,10 +617,10 @@
<dd>
<p>
If Tux Paint aborts with the message: "You're already running a copy of Tux Paint!", this means it has been launched in the last 30 seconds. (On Unix/Linux, this message would appear in a terminal console if you ran Tux Paint from a command-line. On Windows, this message would appear in a file named "<code>stdout.txt</code>" in the same folder where <code>TuxPaint.exe</code> resides (e.g., in "<code>C:\Program Files\TuxPaint</code>"). </p>
If Tux Paint aborts with the message: "You're already running a copy of Tux Paint!", this means it has been launched in the last 30 seconds. (On Unix/Linux, this message would appear in a terminal console if you ran Tux Paint from a command-line. On Windows, this message would appear in a file named "<code>stdout.txt</code>" in the same folder where <code>TuxPaint.exe</code> resides (e.g., in <nobr>"<code>C:\Program Files\TuxPaint\</code>"</nobr>). </p>
<p>
A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, "userdata\lockfile.dat" on Windows) is used to make sure Tux Paint isn't run too many times at once (e.g., due to a child impatiently clicking its icon more than once). </p>
A lockfile (e.g., <nobr>"<code>/home/username/.tuxpaint/lockfile.dat</code>"</nobr> on Linux and Unix, <nobr>"<code>userdata\lockfile.dat</code>"</nobr> on Windows) is used to make sure Tux Paint isn't run too many times at once (e.g., due to a child impatiently clicking its icon more than once). </p>
<p>
Even if the lockfile exists, it contains the 'time' Tux Paint was last run. If it's been more than 30 seconds, Tux Paint should run fine, and simply update the lockfile with the current time. </p>
@ -694,12 +701,19 @@
<li>
<cite>Windows</cite>
<p>
Under Windows, Tux Paint first examines the configuration file: </p>
Under Windows, it first examines the system-wide configuration file, located here: </p>
<blockquote>
<p>
<code>C:\Users\<i>Username</i>\AppData\Roaming\TuxPaint\tuxpaint.cfg</code>
</p>
<nobr><code>C:\Program Files\TuxPaint\tuxpaint.cfg</code></nobr> </p>
</blockquote>
<p>
It then examines the user's personal configuration file: </p>
<blockquote>
<p>
<nobr><code>C:\Users\username\AppData\Roaming\TuxPaint\tuxpaint.cfg</code></nobr> </p>
</blockquote>
<p>
@ -713,8 +727,7 @@
<blockquote>
<p>
<code>/Library/Application Support/TuxPaint/tuxpaint.cfg</code>
</p>
<nobr><code>/Library/Application Support/TuxPaint/tuxpaint.cfg</code></nobr> </p>
</blockquote>
<p>
@ -722,8 +735,7 @@
<blockquote>
<p>
<code>/Users/<i>Username</i>/Library/Application Support/TuxPaint/tuxpaint.cfg</code>
</p>
<nobr><code>/Users/username/Library/Application Support/TuxPaint/tuxpaint.cfg</code></nobr> </p>
</blockquote>
<p>
@ -737,8 +749,7 @@
<blockquote>
<p>
<code>/etc/tuxpaint/tuxpaint.conf</code>
</p>
<nobr><code>/etc/tuxpaint/tuxpaint.conf</code></nobr> </p>
</blockquote>
<p>
@ -746,8 +757,7 @@
<blockquote>
<p>
<code>/home/username/.tuxpaintrc</code>
</p>
<nobr><code>/home/username/.tuxpaintrc</code></nobr> </p>
</blockquote>
<p>
@ -761,8 +771,7 @@
<blockquote>
<p>
<code>/boot/home/config/settings/TuxPaint/tuxpaint.conf</code>
</p>
<nobr><code>/boot/home/config/settings/TuxPaint/tuxpaint.conf</code></nobr> </p>
</blockquote>
<p>
@ -774,7 +783,7 @@
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 (if you can), or override the option on the command-line. </p>
<p>
For example, on Linux and Unix, if "<code>/etc/tuxpaint/tuxpaint.conf</code>" includes this option to disable sound... </p>
For example, on Linux and Unix, if <nobr>"<code>/etc/tuxpaint/tuxpaint.conf</code>"</nobr> includes this option to disable sound... </p>
<blockquote>
<p>
@ -783,7 +792,7 @@
</blockquote>
<p>
...then you can reenable sound by either adding this option to your own "<code>/home/username/.tuxpaintrc</code>" file: </p>
...then you can reenable sound by either adding this option to your own <nobr>"<code>/home/username/.tuxpaintrc</code>"</nobr> file: </p>
<blockquote>
<p>

View file

@ -93,12 +93,12 @@
Installation Documentation </h1>
<p>
Copyright &copy; 2002-2023 by various contributors; <a href="../../AUTHORS.txt">AUTHORS.txt</a> 参照.<br>
Copyright &copy; 2002-2024 by various contributors; <a href="../../AUTHORS.txt">AUTHORS.txt</a> 参照.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
<p>
2023年5月13</p>
2024年4月27</p>
</center>
</header>
@ -757,7 +757,7 @@
</header>
<p>
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it is probably because some of these command-line options are wrong. Open an Explorer, and look for a file called "<code>stderr.txt</code>" in your personal saving folder for TuxPaint which is normaly "C:\Users\<i>username</i>\AppData\Roaming\TuxPaint". </p>
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it is probably because some of these command-line options are wrong. Open an Explorer, and look for a file called "<code>stderr.txt</code>" in your personal saving folder for TuxPaint which is normaly <nobr>"<code>C:\Users\username\AppData\Roaming\TuxPaint\</code>"</nobr>. </p>
<p>
It will contain a description of what was wrong. Usually it will just be due to incorrect character-case (capital 'Z' instead of lowercase 'z') or a missing (or extra) '-' (dash). </p>

View file

@ -1786,17 +1786,24 @@
<p>
特に設定していなければ、標準のディレクトリは次の場所にあります: </p>
<ul>
<li>Linux および Unix — ユーザーのホームディレクトリ("<code>~</code>" または "<code>$HOME</code>")にある隠しディレクトリ "<code>.tuxpaint</code>" 以下<br>
例: <code>/home/<i>username</i>/.tuxpaint/saved/</code> </li>
<dl>
<dt>Linux / Unix</dt>
<dd>
Under a hidden directory in your home directory:<br/>
<nobr><code>/home/username/.tuxpaint/saved/</code></nobr> </dd>
<li>Windows — ユーザーごとの "<code>Application Data</code>" フォルダーにある "<code>TuxPaint</code>" フォルダー以下<br>
例: <code>C:\Documents and Settings\<i>Username</i>\Application Data\TuxPaint\saved\</code> <br>
</li>
<dt>Windows</dt>
<dd>
<nobr><code>C:\Users\username\AppData\Roaming\TuxPaint\saved\</code></nobr> </dd>
<li>macOS — ユーザーごとの "<code>Application Support</code>" フォルダーにある "<code>TuxPaint</code>" フォルダー以下<br>
例: <code>/Users/<i>Username</i>/Library/Application Support/TuxPaint/saved/</code> </li>
</ul>
<dt>macOS</dt>
<dd>
<nobr><code>/Users/username/Library/Application Support/TuxPaint/saved/</code></nobr> </dd>
<dt>Haiku</dt>
<dd>
<nobr><code>/boot/home/config/settings/TuxPaint/saved/</code></nobr> </dd>
</dl>
<p class="note">
<span title="Information">&#128161;</span> <strong>注:</strong> Windowsのドライブ例: "<code>H:\</code>")を指定する際は、サブディレクトリも指定する必要があります。 </p>

View file

@ -318,7 +318,7 @@
ポータブル版ZIPファイル版をダウンロードして Tux Paint をインストールした場合や、インストーラーでショートカットを作成しなかった場合は、"<code>Tux Paint</code>"のフォルダにある "<code>tuxpaint.exe</code>" のアイコンをダブルクリックします。 </p>
<p>
インストーラーを用いた場合、「Tux Paint」のフォルダは、通常、"C:\Program Files\" に配置されます。(インストール時に、これを変更することもできます) </p>
By default, the 'Tux Paint Installer' will put Tux Paint's folder in <nobr>"<code>C:\Program Files\TuxPaint\</code>"</nobr>, though you may have changed this when you ran the installer. </p>
<p>
ZIP ファイルを用いた場合、「Tux Paint」のフォルダは、任意の場所に配置できます。 </p>
@ -1669,36 +1669,36 @@
<p>
そのための方法は簡単で、画像ファイルを PNG (Portable Network Graphic) 形式に変換して、Tux Paint で作成した画像が保存されている "<code>saved</code>" フォルダにコピーします。(標準では以下のフォルダ): </p>
<dl>
<dt>
<strong>Windows 10, 8, 7, Vista</strong>
</dt>
<dd>
各ユーザーの "<code>AppData</code>" フォルダ。例: "<code>C:\Users\<em>username</em>\AppData\Roaming\TuxPaint\saved\</code>"。 </dd>
<dt>
<strong>Windows 2000, XP</strong>
</dt>
<dd>
各ユーザーの "<code>Application Data</code>" フォルダ。例: "<code>C:\Documents and Settings\<em>username</em>\Application Data\TuxPaint\saved\</code>"。 </dd>
<dt>
<strong>macOS</strong>
</dt>
<dd>
各ユーザーの "<code>Library</code>" フォルダ。例: "<code>/Users/<em>username</em>/Library/Application Support/Tux Paint/saved/</code>"。 </dd>
<dt>
<strong>Linux/Unix</strong>
</dt>
<dd>
各ユーザーのホームディレクトリ("<code>$HOME</code>")の隠しディレクトリ "<code>.tuxpaint</code>" 以下 ― 例: "<code>/home/<em>username</em>/.tuxpaint/saved/</code>"。 </dd>
</dl>
<dt>
<cite>Windows Vista, Windows 8, Windows 10, Windows 11</cite>
</dt>
<dd>
In the user's "AppData" folder:<br> e.g., <nobr>"<code>C:\Users\username\AppData\Roaming\TuxPaint\saved\</code>"</nobr> </dd>
<dt>
<cite>macOS</cite>
</dt>
<dd>
In the user's "Application Support" folder:<br> e.g., <nobr>"<code>/Users/username/Library/Application Support/TuxPaint/saved/</code>"</nobr> </dd>
<dt>
<cite>Linux / Unix</cite>
</dt>
<dd>
In the user's "home directory" folder:<br> e.g., <nobr>"<code>/home/username/.tuxpaint/saved/</code>"</nobr> </dd>
<dt>
<cite>Haiku</cite>
</dt>
<dd>
In the user's "settings" folder:<br> e.g., <nobr>"<code>/boot/home/config/settings/TuxPaint/saved/</code>"</nobr> </dd>
</dl>
<p class="note">
<span title="Information">&#128161;</span> <strong>注:</strong> Tux Paint で作成した画像を<em>他のアプリケーションを使って</em>開く場合も、これらのフォルダからになります。しかしながら、「ひらく」ダイアログの「かきだす」の機能を使えば、Tux Paint で作成した画像を、もっと簡単で安全にアクセスできるフォルダにコピーすることができます。 </p>