User documentation: synchronize welcome docs from the userguide translator

Change-Id: I2a2b01d87c35f22f688d51740812a28acf51e11d
This commit is contained in:
Niels Sascha Reedijk
2021-07-21 08:51:26 +01:00
parent 348c49fde2
commit b2a0660172
87 changed files with 4938 additions and 2045 deletions

View File

@@ -33,6 +33,7 @@
<li><a href="../ca/bugreports.html">Català</a></li>
<li><a href="../de/bugreports.html">Deutsch</a></li>
<li><a href="../es/bugreports.html">Español</a></li>
<li><a href="../eo/bugreports.html">Esperanto</a></li>
<li><a href="../fr/bugreports.html">Français</a></li>
<li><a href="../fur/bugreports.html">Furlan</a></li>
<li><a href="../it/bugreports.html">Italiano</a></li>

View File

@@ -34,6 +34,7 @@
<li><a href="../ca/quicktour.html">Català</a></li>
<li><a href="../de/quicktour.html">Deutsch</a></li>
<li><a href="../es/quicktour.html">Español</a></li>
<li><a href="../eo/quicktour.html">Esperanto</a></li>
<li><a href="../fr/quicktour.html">Français</a></li>
<li><a href="../fur/quicktour.html">Furlan</a></li>
<li><a href="../it/quicktour.html">Italiano</a></li>
@@ -54,7 +55,8 @@
<span class="navdots">
<a href="#start"><acronym title="Start" class="current-page"></acronym></a>
<a class="hide-no-js" id="prevtopic" title="Previous topic"></a>
<a href="#start"><acronym title="Start"></acronym></a>
<a href="#deskbar"><acronym title="The Deskbar"></acronym></a>
<a href="#window"><acronym title="The window widgets"></acronym></a>
<a href="#shortcutkey"><acronym title="The shortcut key"></acronym></a>
@@ -73,16 +75,22 @@
<a href="#wireless"><acronym title="Wireless connection"></acronym></a>
<a href="#moresoftware"><acronym title="Getting more and updating software"></acronym></a>
<a href="#end"><acronym title="End"></acronym></a>
<a class="hide-no-js" id="nexttopic" title="Next topic"></a>
</span>
<span class="hide-no-js"><a id="toggle" title="Toggle slides view"></a></span>
<span>
<a href="#topics" class="uplink">Topics</a>
<a href="#index" class="uplink">Topics</a>
</span>
</div>
</div>
<div id="content">
<div>
<div></div>
<!-- Please keep the previous empty div there so that the tool can add the "not fully translated" notice on export -->
<div class="topic">
<table class="index" id="index" summary="index">
<tr class="heading"><td>Index</td></tr>
@@ -112,43 +120,58 @@
<h1><a id="start" name="start">Welcome to Haiku's Quick Tour</a></h1>
<p>While Haiku shares many ideas with other operating systems, it does have a unique approach in some areas that are worth pointing out. In just a few slides, youll learn about the most important Haiku features and peculiarities thatll help you get a running start.</p>
<p>At the bottom right of each page, are links for "further reading" that point to additional resources, like related topics in the <a href="https://www.haiku-os.org/docs/userguide/en/contents.html" target="_blank">Userguide</a>.</p>
<p>For each topic you can find a box with links for "further reading" that point to additional resources, like related topics in the <a href="https://www.haiku-os.org/docs/userguide/en/contents.html" target="_blank">Userguide</a>.</p>
</div>
<div class="topic">
<h1><a id="deskbar" name="deskbar">The Deskbar</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/deskbar.html" target="_blank">Deskbar</a>
</td></tr>
</table>
<p>By default at the top right corner of the desktop, the Deskbar is the hub of interacting with Haiku. You can start applications, applets and preferences from there, for example, and switch between running applications.</p>
<!-- [screenshot of opened deskbar, annotated] -->
<div class="shot">
<img src="./images/quicktour/deskbar.png" alt="The Deskbar" />
</div>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/deskbar.html" target="_blank">Deskbar</a></div>
</div>
<div class="topic">
<h1><a id="window" name="window">The window widgets</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/gui.html" target="_blank">Haiku's GUI</a>
</td></tr>
</table>
<p>Here's a typical Haiku window with its usual widgets:</p>
<!-- [screenshot of window, annotated: Close button, Zoom button (usually maximizes the window), Double-click the tab to hide/minimize a window (find it again in the Deskbar), Move a window by grabbing it at the tab or border, Resize from the corner or by dragging a border with the right mouse button.] -->
<div class="shot">
<img src="./images/quicktour/window.png" alt="A window and its widgets" />
</div>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/gui.html" target="_blank">Haiku's GUI</a></div>
</div>
<div class="topic">
<h1><a id="shortcutkey" name="shortcutkey">The shortcut key</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/keyboard-shortcuts.html" target="_blank">Shortcuts and key combinations</a>
</td></tr>
</table>
<p>The <span class="app">Keymap</span> preferences let you switch from the Haiku standard <span class="key">ALT</span> key to <span class="key">CTRL</span> (Windows/Linux mode). This is a global switch, so for example quitting a program in the shell will then be done with <span class="key">ALT</span> <span class="key">C</span> instead the usual <span class="key">CTRL</span> <span class="key">C</span>.<br />
This inconsistancy is one reason for the default <span class="key">ALT</span> shortcut in Haiku.</p>
@@ -156,30 +179,38 @@ This inconsistancy is one reason for the default <span class="key">ALT</span> sh
<div class="shot">
<img src="./images/quicktour/alt-ctrl.png" alt="Shortcut key: ALT vs. CTRL" />
</div>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/keyboard-shortcuts.html" target="_blank">Shortcuts and key combinations</a></div>
</div>
<div class="topic">
<h1><a id="twitcher" name="twitcher">The Twitcher</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/twitcher.html" target="_blank">Twitcher</a>
</td></tr>
</table>
<p>Holding <span class="key">CTRL</span> <span class="key">TAB</span> summons the <span class="app">Twitcher</span> where you switch between running applications.<br />
Tapping the <span class="key">TAB</span> key only quickly while holding <span class="key">CTRL</span> switches to the last used application.</p>
<div class="shot">
<img src="../images/quicktour/twitcher.png" alt="The Twitcher switching between apps" />
</div>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/twitcher.html" target="_blank">Twitcher</a></div>
</div>
<div class="topic">
<h1><a id="teammonitor" name="teammonitor">The Team monitor</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/teammonitor.html" target="_blank">Team monitor</a>
</td></tr>
</table>
<p>If some application crashed badly and maybe won't disappear from Deskbar's running application list, press <span class="key">CTRL</span> <span class="key">ALT</span> <span class="key">DEL</span> to invoke the <span class="app">Team monitor</span>. Here you can select an entry and kill a misbehaving app.</p>
<div class="shot">
@@ -188,14 +219,19 @@ Tapping the <span class="key">TAB</span> key only quickly while holding <span cl
<p>A neat way to quickly get rid of an app hanging in the Deskbar is the Vulcan Death Grip.<br />
Hold <span class="key">SHIFT</span> <span class="key">CTRL</span> <span class="key">ALT</span> and click on the offending entry in the Deskbar. Poof!</p>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/teammonitor.html" target="_blank">Team monitor</a></div>
</div>
<div class="topic">
<h1><a id="move-resize" name="move-resize">Window management: Move &amp; Resize</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/gui.html#move-resize" target="_blank">A quick way to move or resize windows</a>
</td></tr>
</table>
<p>Haiku offers a neat way to quickly move or resize windows:<br />
Holding down <span class="key">CTRL</span> <span class="key">ALT</span> will highlight the window borders nearest to the mouse pointer.<br />
Click and dragging with the <i>right</i> mouse button will resize the window along the highlighted border(s).<br />
@@ -204,15 +240,19 @@ Click and drag with the <i>left</i> mouse button to move it around.</p>
<div class="shot">
<img src="./images/quicktour/move-resize.png" alt="Move with CTRL+ALT+left mouse button" />
</div>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/gui.html#move-resize" target="_blank">A quick way to move or resize windows</a></div>
</div>
<div class="topic">
<h1><a id="stack" name="stack">Window management: Stack</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/gui.html#stack-tile" target="_blank">Stack &amp; Tile</a>
</td></tr>
</table>
<p>"Stacking" is putting windows on top of each other, automatically moving the yellow tabs into position.<br />
While holding the <span class="key">OPT</span> key (normally that's <span class="key">WIN</span> on the keyboard), tabs change color when they overlap; drop the window to establish the stacking.<br />
You un-stack by holding <span class="key">OPT</span> and dragging a window out of its group by the yellow tab.</p>
@@ -222,15 +262,19 @@ Delay time 200 (= 2 secs), option "Don't stack frames" -->
<div class="shot">
<img src="./images/quicktour/stack.gif" alt="Stacking windows" />
</div>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/gui.html#stack-tile" target="_blank">Stack &amp; Tile</a></div>
</div>
<div class="topic">
<h1><a id="tile" name="tile">Window management: Tile</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/gui.html#stack-tile" target="_blank">Stack &amp; Tile</a>
</td></tr>
</table>
<p>"Tiling" means gluing windows horizontally or vertically together.<br />
While holding <span class="key">OPT</span>, the borders that'll fuse together when you drop the window change color when brought near each other.<br />
You un-tile by holding <span class="key">OPT</span> and dragging a window out of its group by the yellow tab.</p>
@@ -240,15 +284,20 @@ Delay time 200 (= 2 secs), option "Don't stack frames" -->
<div class="shot">
<img src="./images/quicktour/tile.gif" alt="Tiling windows" />
</div>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/gui.html#stack-tile" target="_blank">Stack &amp; Tile</a></div>
</div>
<div class="topic">
<h1><a id="workspaces" name="workspaces">Workspaces</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/workspaces.html" target="_blank">Workspaces</a><br />
<a href="https://www.haiku-os.org/docs/userguide/en/preferences/screen.html" target="_blank">Screen</a>
</td></tr>
</table>
<p>Workspaces are virtual desktops, complete with their own resolution, color depth and background.<br />
Up to 32 of these workspaces can be set from the <span class="app">Screen</span> preferences.</p>
<p>The <span class="app">Workspaces</span> desktop applet can be used to change workspaces or to drag a window from one to another.</p>
@@ -258,16 +307,19 @@ If you add <span class="key">SHIFT</span> to that, the active window is taken wi
<div class="shot">
<img src="./images/quicktour/workspaces.png" alt="The Workspaces applet" />
</div>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/workspaces.html" target="_blank">Workspaces</a><br />
<a href="https://www.haiku-os.org/docs/userguide/en/preferences/screen.html" target="_blank">Screen</a></div>
</div>
<div class="topic">
<h1><a id="replicants" name="replicants">Replicants</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/gui.html#replicants" target="_blank">Replicants</a>
</td></tr>
</table>
<p>Replicants are small self-contained parts of applications that can be integrated into the Desktop (and other programs).<br />
Provided Deskbar's option to <span class="menu">Show replicants</span> is activated, replicants are indicated by a small handle.<br />
You can drag &amp; drop them by the handle onto the Desktop, where they are fully functional without their parent app running.</p>
@@ -278,15 +330,19 @@ You can drag &amp; drop them by the handle onto the Desktop, where they are full
</div>
<p>You can move a replicant by its handle and remove it with a right-click on it and choosing <span class="menu">Remove replicant</span>.</p>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/gui.html#replicants" target="_blank">Replicants</a></div>
</div>
<div class="topic">
<h1><a id="singlewindow" name="singlewindow">Single window navigation</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/tracker.html" target="_blank">Tracker</a>
</td></tr>
</table>
<p>Double-clicking your way down folder after folder, you'll quickly end up with many open Tracker windows.<br />
Holding the <span class="key">OPT</span> key (normally <span class="key">WIN</span> on the keyboard) prevents this as it automatically closes the parent folder.<br />
Alternatively, you can activate <span class="menu">Single window navigation</span> from the <span class="app">Tracker</span> preferences.<br />
@@ -296,30 +352,38 @@ Alternatively, you can activate <span class="menu">Single window navigation</spa
<div class="shot">
<img src="./images/quicktour/singlewindow.png" alt="Using Single window navigation" />
</div>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/tracker.html" target="_blank">Tracker</a></div>
</div>
<div class="topic">
<h1><a id="drilldown" name="drilldown">Drill-down navigation</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/tracker.html#navigating" target="_blank">Tracker navigation</a>
</td></tr>
</table>
<p>A nice alternative to opening a deep hierarchy of folders is called "drill-down navigation". Right-clicking a folder or anywhere in a Tracker window (or the Desktop) will open a context menu. Beside various expected commands, there's a menu of the current folder at the top that contains all its subfolders.<br />
Drill your way down until you find the folder or file to open.</p>
<div class="shot">
<img src="./images/quicktour/drilldown.png" alt="Drilling down folder hierarchies" />
</div>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/tracker.html#navigating" target="_blank">Tracker navigation</a></div>
</div>
<div class="topic">
<h1><a id="mounting" name="mounting">Mounting volumes</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/tracker.html#mounting-volumes" target="_blank">Mounting volumes</a>
</td></tr>
</table>
<p>In order to access a harddisk, CD, USB stick etc., you first have to mount the volume. Once mounted, its icon appears on the Desktop.<br />
This is done with a right-click on the Desktop or an already mounted volume (like the boot disk) and choosing the volume from the <span class="menu">Mount</span> submenu. You find the same <span class="menu">Mount</span> menu in the Deskbar. ISO images can be mounted with a double-click.</p>
@@ -328,15 +392,21 @@ This is done with a right-click on the Desktop or an already mounted volume (lik
<div class="shot">
<img src="./images/quicktour/mount.png" alt="Mounting a volume" />
</div>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/tracker.html#mounting-volumes" target="_blank">Mounting volumes</a></div>
</div>
<div class="topic">
<h1><a id="filesystem" name="filesystem">Filesystem layout</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/filesystem-layout.html" target="_blank">Filesystem layout</a><br />
<a href="https://www.haiku-os.org/docs/userguide/en/applications.html" target="_blank">Applications</a><br />
<a href="https://git.haiku-os.org/haiku/tree/docs/develop/packages/DirectoryStructure.rst" target="_blank">Directory structure</a>
</td></tr>
</table>
<p>While Haiku is currently not multi-user, there are already two branches in the filesystem tree:</p>
<table summary="layout" border="0" cellspacing="0" cellpadding="8">
@@ -357,33 +427,41 @@ The folders there (like <i>add-ons</i>, <i>apps</i>, <i>bin</i> etc.) are just a
<p>The writable <i>non-packaged</i> folders mirror the hierarchy of the /system or ~/config/ hierarchy (<i>add-ons</i>, <i>apps</i>, <i>bin</i>…).<br />
Software that doesn't come in form of a HPKG package can be installed here.</p>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/filesystem-layout.html" target="_blank">Filesystem layout</a><br />
<a href="https://www.haiku-os.org/docs/userguide/en/applications.html" target="_blank">Applications</a><br />
<a href="https://git.haiku-os.org/haiku/tree/docs/develop/packages/DirectoryStructure.rst" target="_blank">Directory structure</a></div>
</div>
<div class="topic">
<h1><a id="queries" name="queries">Finding files with queries</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/queries.html" target="_blank">Queries</a><br />
<a href="https://www.haiku-os.org/docs/userguide/en/workshop-filetypes attributes.html" target="_blank">Filetypes, Attributes, Index and Queries</a>
</td></tr>
</table>
<p>Files on Haiku formatted (BFS) volumes are quickly searched with <span class="menu">Find…</span> from the Deskbar. Instead of file and folder names, you can also look through filetype specific attributes, e.g. for an artist in your MP3 collection.</p>
<!-- [screenshot of Find window and result window of Artitst == Fairport] -->
<div class="shot">
<img src="./images/quicktour/query.png" alt="Finding all MP3s of an artist" />
</div>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/queries.html" target="_blank">Queries</a><br />
<a href="https://www.haiku-os.org/docs/userguide/en/workshop-filetypes attributes.html" target="_blank">Filetypes, Attributes, Index and Queries</a></div>
</div>
<div class="topic">
<h1><a id="wireless" name="wireless">Wireless connection</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/workshop-wlan.html" target="_blank">Wireless networking</a><br />
<a href="https://www.haiku-os.org/docs/userguide/en/desktop-applets/networkstatus.html" target="_blank">NetworkStatus</a><br />
<a href="https://www.haiku-os.org/docs/userguide/en/preferences/network.html" target="_blank">Network preferences</a>
</td></tr>
</table>
<p>You can connect to your WLAN router either by right-clicking the <span class="app">NetworkStatus</span> icon in Deskbar's tray,<br />
or by selecting your network from the <span class="app">Network</span> preferences.<br />
When the connection is established, you'll be asked for the network's encryption and password.</p>
@@ -392,17 +470,21 @@ When the connection is established, you'll be asked for the network's encryption
<div class="shot">
<img src="./images/quicktour/wireless.png" alt="Connecting with a wireless network" />
</div>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/workshop-wlan.html" target="_blank">Wireless networking</a><br />
<a href="https://www.haiku-os.org/docs/userguide/en/desktop-applets/networkstatus.html" target="_blank">NetworkStatus</a><br />
<a href="https://www.haiku-os.org/docs/userguide/en/preferences/network.html" target="_blank">Network preferences</a></div>
</div>
<div class="topic">
<h1><a id="moresoftware" name="moresoftware">Getting more and updating software</a></h1>
<table class="index further">
<tr class="heading"><td>Further reading</td></tr>
<tr class="index"><td>
<a href="https://www.haiku-os.org/docs/userguide/en/applications/haikudepot.html" target="_blank">HaikuDepot</a><br />
<a href="https://www.haiku-os.org/docs/userguide/en/applications/softwareupdater.html" target="_blank">SoftwareUpdater</a><br />
<a href="https://www.haiku-os.org/docs/userguide/en/preferences/repositories.html" target="_blank">Repositories</a>
</td></tr>
</table>
<p><span class="app">HaikuDepot</span> from the Deskbar's applications menu is where to search, install and uninstall software packages.<br />
<span class="app">SoftwareUpdater</span> should be started from time to time to update installed software as well as Haiku itself.</p>
@@ -410,14 +492,10 @@ When the connection is established, you'll be asked for the network's encryption
<div class="shot">
<img src="./images/quicktour/moresoftware.png" alt="Installing and updating apps" />
</div>
<div class="further">Further reading:<br />
<a href="https://www.haiku-os.org/docs/userguide/en/applications/haikudepot.html" target="_blank">HaikuDepot</a><br />
<a href="https://www.haiku-os.org/docs/userguide/en/applications/softwareupdater.html" target="_blank">SoftwareUpdater</a><br />
<a href="https://www.haiku-os.org/docs/userguide/en/preferences/repositories.html" target="_blank">Repositories</a></div>
</div>
<div>
<div class="topic">
<h1><a id="end" name="end">The end</a></h1>
<p>This is the end of the tour. We hope it helped you to quickly feel at home in your new OS!</p>
@@ -433,5 +511,10 @@ You can also join our <a href="https://discuss.haiku-os.org/" target="_blank">We
</div>
</div>
<div id="bottom-nav" class="slide-only">
<a id="prevtopic-bottom" class="navbutton" title="Previous"></a>
<a id="nexttopic-bottom" class="navbutton" title="Next"></a>
</div>
<script type="text/javascript" src="../Haiku-tour.js"></script>
</body>
</html>