Update userguide

2014-04-05 18:48:32 +02:00
parent 1dc78b8c1e
commit e795d95872
636 changed files with 6411 additions and 3537 deletions
@@ -63,13 +63,13 @@
 <h2><img src="../../images/apps-images/bepdf-icon_64.png" alt="bepdf-icon_64.png" width="64" height="64" />BePDF</h2>
 <table summary="layout" border="0" cellspacing="0" cellpadding="2">
 <tr><td>Deskbar:</td><td style="width:15px;"></td><td><span class="menu">Applicazioni</span></td></tr>
-<tr><td>Localita:</td><td></td><td><span class="path">/boot/apps/BePDF/BePDF</span></td></tr>
-<tr><td>Documentazione:</td><td></td><td><span class="path">/boot/apps/BePDF/docs/*</span></td></tr>
+<tr><td>Localita:</td><td></td><td><span class="path">/boot/system/apps/BePDF/BePDF</span></td></tr>
+<tr><td>Documentazione:</td><td></td><td><span class="path">/boot/system/apps/BePDF/docs/*</span></td></tr>
 <tr><td>Impostazioni:</td><td></td><td><span class="path">~/config/settings/BePDF</span></td></tr>
 </table>
 <p><br /></p>
 <p>BePDF è un veloce lettore di documenti PDF. È possibile visualizzarli e aggiungere notazioni, ha inoltre la possibilità di creare dei segnalibri definiti dall'utente per i PDF non criptati. Al momento è tradotto nella sua interezza in 20 lingue con la possibilità di aggiungere lingue addizionali tramite file di testo.</p>
-<p>La documentazione è disponibile sia in formato <a href="file:///boot/apps/BePDF/docs/English/table_of_contents.html">HTML</a> sia in <a href="file:///boot/apps/BePDF/docs/English.pdf">PDF</a>. Quest'ultima è visualizzabile tramite il menù <span class="menu">Help | Show Help...</span>.</p>
+<p>Documentation is available as <a href="file:///boot/system/apps/BePDF/docs/English/table_of_contents.html">HTML</a> or <a href="file:///boot/system/apps/BePDF/docs/English.pdf">PDF</a>. The latter will also open from the menu <span class="menu">Help | Show Help...</span>.</p>
 </div>
 </div>

@@ -55,6 +55,7 @@

 <div id="content">
 <div>
+<div class="box-info">La traduzione di questa pagina non è stata completata. Per questo motivo le parti non tradotte sono visibili in inglese.</div>

 <h2><img src="../../images/apps-images/diskprobe-icon_64.png" alt="diskprobe-icon_64.png" width="64" height="64" />DiskProbe</h2>
 <table summary="layout" border="0" cellspacing="0" cellpadding="2">
@@ -73,7 +74,8 @@
 <p><span class="menu">Block | Selection</span> non solo mostrerà la selezione secondo i diversi 
 endianess (o in modalità esadecimale o in quella decimale, impostata da <span class="menu">View | Base</span>), ma interpreterà anche la selezione come blocco al quale è possibile saltare. Questo apparirà grigio se la posizione non è presente all'interno del file o del dispositivo.<br />
 Questa è una caratteristica piuttosto utile quando si esplorano i filesystem dal momento che spesso contengono puntatori ad altri blocchi.</p>
-<p>Se il file che si sta esaminando include degli attributi, è possibile usare il menù <span class="menu">Attributes</span> per aprirli in una nuova finestra di DiskProbe. Qui è mostrato l'attributo copyright dell'applicazione <span class="app">AboutSystem</span>:</p><p><img id="diskprobe-attribute" src="../images/apps-images/diskprobe-about-attr.png" alt="diskprobe-about-attr.png" /></p>
+<p>If the file you're probing includes attributes, the <span class="menu">Attributes</span> menu can be used to open any of them in a new DiskProbe window. Here's the SYS:PACKAGE attribute of the <span class="app">AboutSystem</span> application:
+</p><p><img id="diskprobe-attribute" src="../images/apps-images/diskprobe-about-attr.png" alt="diskprobe-about-attr.png" /></p>
 <p>In base al tipo di attributo, verranno visualizzate schede differenti accanto al sempre presente <i>Raw Editor</i>. Ad esempio ci sono editor per le stringhe e per i MIME type o un visualizzatore di icone per l'attributo vectoricon.</p>
 </div>
 </div>
@@ -65,7 +65,7 @@
 <p><br /></p>
 <p>DiskUsage si occupa di mostrare graficamente come è utilizzato lo spazio sui volumi.<br />
 Un'applicazione piuttosto utile per rispondere alla domanda, "<i>Che fine ha fatto tutto lo spazio libero sul disco?</i>".</p>
-<p>After launching, DiskUsage shows only a white window with all mounted volumes as tabs at the top. You'll have to choose the one you're interested in and click <span class="button">Scan</span> to start chugging through the disk. For larger disks this can take some time... While you wait, you may switch to a different tab and start exploring that volume or begin the scan process there as well.<br />
+<p>After launching, DiskUsage shows only an empty window with all mounted volumes as tabs at the top. You'll have to choose the one you're interested in and click <span class="button">Scan</span> to start chugging through the disk. For larger disks this can take some time... While you wait, you may switch to a different tab and start exploring that volume or begin the scan process there as well.<br />
 It's not recommended to start several concurrent scan processes on the same physical disk, as the constant repositioning of the heads of the drive will only extend the wait.</p>
 <p><img id="diskusage" src="../images/apps-images/diskusage.png" alt="diskusage.png" /></p>
 <p>I cerchi concentrici rappresentano i diversi livelli nella gerarchia del filesystem. Nell'immagine qui sopra, il cerchio centrale rappresenta la cartella <span class="path">/boot/home/</span>. Ogni segmento dell'anello immediatamente successivo a quello centrale è un file o una cartella presente sotto <span class="path">/boot/home/</span>. Ogni segmento sempre più esterno rappresenta un livello inferiore nella gerarchia dei file. È possibile ridimensionare la finestra in modo che vengano mostrate anche le cartelle dei livelli più bassi.</p>
@@ -61,7 +61,40 @@
 <tr><td>Settings:</td><td></td><td><span class="path">~/config/settings/HaikuDepot/</span></td></tr>
 </table>
 <p><br /></p>
-<p>Documentation is still missing. If you want to work on it, please announce it on the <a href="http://www.freelists.org/list/haiku-doc">Documentation mailing list</a> to avoid duplication.</p>
+<p>HaikuDepot is the central application when it comes to managing your software packages. With it you can browse and search through package repositories (also called "depots") and install, update and uninstall packages.</p>
+<img src="../images/apps-images/haikudepot.png" alt="haikudepot.png" />
+
+<h3>The Filter</h3>
+<p>At the top we find a few means to filter the list of available packages below:</p>
+<ul>
+<li><p>The <span class="menu">Show</span> pop-up menu lets you limit the list to individual categories like "<i>Audio</i>" or "<i>Games</i>". You can also have only your already installed packages displayed or those that have an update available.</p></li>
+<li><p>The <span class="menu">Depot</span> pop-up menu lets you limit the list to only show packages from certain repositories,</p></li>
+<li><p>The <span class="menu">Search terms</span> text field lets you filter the list to the keywords you enter.</p></li>
+</ul>
+
+<h3>The List</h3>
+<p>Like in any Tracker window, you can choose from a context menu which columns to display by right-clicking the column heading. A left-click sorts the list according to that column. Of course, you can rearrange the columns by dragging them to a new position.</p>
+<p>The status column of a package can have one of several states:</p>
+<ul>
+<li><p><span class="menu">Available</span>: The package exists in that depot and can be downloaded and installed. If there are any dependencies on other packages, you'll be informed of that while installing and get the choice of downloading/installing all that's necessary.</p></li>
+<li><p><span class="menu">Active</span>: The package is currently installed and ready to be used.</p></li>
+<li><p><span class="menu">Update available</span>: There's a newer version than your installed one available.</p></li>
+</ul>
+<p>You can grab the dotted line between the packages list and the info area to vertically resize the packages list.</p>
+
+<h3>The Info Area</h3>
+<p>At the bottom is an area that displays information on the package that is currently selected in the list above it.<br />
+To the right of package name, author, rating and version is a button, that – depending on the current state of the package – lets you <span class="button">Install</span>, <span class="button">Uninstall</span> or <span class="button">Update</span> it.</p>
+<p>Below are three tabs:</p>
+<ul>
+<li><p><span class="menu">About</span> has a more detailed description of the package, as well as screenshots and a contact address and URL of the team that maintains the packaged software, if available.</p></li>
+<li><p><span class="menu">Ratings</span> shows ratings and comments of users, if available. With the little thumb up/down icons to the right, you can show your approval or disapproval with a certain comment.</p></li>
+<li><p><span class="menu">Changelog</span> show the detailed history of all the  versions of the package that have been released so far.</p></li>
+</ul>
+
+<h3>Tools and Options</h3>
+<p>In the <span class="menu">Tools</span> menu at the top of the window, you'll find an item to <span class="menu">Refresh depots</span>. This will request an up-to-date list of all available packages from the repositories.</p>
+<p>Under <span class="menu">Options</span> you can choose to also <span class="menu">Show develop packages</span> and <span class="menu">Show source packages</span> in the packages list. For the normal user those are of no interest and would only clutter the list. They are important, however, for people who need the libraries, headers etc. of a package to develop and compile programs depending on them.</p>

 </div>
 </div>
@@ -4,7 +4,7 @@
 <head>
 <!-- 
 *
- * Copyright 2010-2013, Haiku. All rights reserved.
+ * Copyright 2010-2014, Haiku. All rights reserved.
 * Distributed under the terms of the MIT License.
 *
 * Authors:
@@ -84,8 +84,8 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
 <tr><td><tt>bc</tt></td><td> </td><td>Un linguaggio di calcolo a precisione arbitraria.</td></tr>
 <tr><td><tt>beep</tt></td><td> </td><td>Emette un segnale acustico.</td></tr>
 <tr><td><tt>bunzip2</tt></td><td> </td><td>Vedere <tt>bzip2</tt>.</td></tr>
-<tr><td><tt>bzip2</tt></td><td> </td><td>Compressore di file.</td></tr>
-<tr><td><tt>c++</tt></td><td> </td><td>Compilatore C++.</td></tr>
+<tr><td><tt>bzip2</tt></td><td> </td><td>File compressor.</td></tr>
+<tr><td><tt>c++</tt></td><td> </td><td>C  -Compiler.</td></tr>
 <tr><td><tt>cal</tt></td><td> </td><td>Visualizza un calendario.</td></tr>
 <tr><td><tt>cat</tt></td><td> </td><td>Concatena file e li visualizza nello standar output.</td></tr>
 <tr><td><tt>catattr</tt></td><td> </td><td>Visualizza il contenuto di un attributo di un file. <a href="cli-apps.html">(specifico per Haiku)</a></td></tr>
@@ -168,7 +168,6 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
 <tr><td><tt>ifconfig</tt></td><td> </td><td>Configura un'interfaccia di rete.</td></tr>
 <tr><td><tt>install</tt></td><td> </td><td>Copia dei file in una destinazione senza arrestare il sistema in esecuzione.</td></tr>
 <tr><td><tt>install-wifi-firmwares.sh</tt></td><td> </td><td>Installa i firmware per diverse schede di rete wireless.</td></tr>
-<tr><td><tt>installoptionalpackage</tt></td><td> </td><td>Soluzione temporanea per installare pacchetti opzionali.</td></tr>
 <tr><td><tt>installsound</tt></td><td> </td><td>Crea un nuovo evento nel pannello delle preferenze dei Suoni.</td></tr>
 <tr><td><tt>iroster</tt></td><td> </td><td>Elenca i dispositivi di input.</td></tr>
 <tr><td><tt>isvolume</tt></td><td> </td><td>Restituisce informazioni su un dispositivo montato.</td></tr>
@@ -206,7 +205,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
 <tr><td><tt>merge</tt></td><td> </td><td>Unisce i file in tre modi.</td></tr>
 <tr><td><tt>message</tt></td><td> </td><td>Stampa un file BMessage come file piano.</td></tr>
 <tr><td><tt>mimeset</tt></td><td> </td><td>Imposta un MIME type per un file.</td></tr>
-<tr><td><tt>mkdepend</tt></td><td> </td><td>Generatore di dipendenze Makefile.</td></tr>
+<tr><td><tt>mkdepend</tt></td><td> </td><td>Makefile dependency generator.</td></tr>
 <tr><td><tt>mkdir</tt></td><td> </td><td>Crea una cartella.</td></tr>
 <tr><td><tt>mkdos</tt></td><td> </td><td>Inizializza una partizione FAT.</td></tr>
 <tr><td><tt>mkfifo</tt></td><td> </td><td>Crea un pipe col nome specificato.</td></tr>
@@ -4,7 +4,7 @@
 <head>
 <!-- 
 *
- * Copyright 2010-2011, Haiku. All rights reserved.
+ * Copyright 2010-2013, Haiku. All rights reserved.
 * Distributed under the terms of the MIT License.
 *
 * Authors:
@@ -82,7 +82,7 @@ Finally, you can decide to include the "Home" button in the navigation bar and s
 <ul>
 <li><img src="../images/apps-images/webpositive-tabbar.png" alt="webpositive-tabbar.png" />
 <p>New tabs are created with the <span class="key">+</span> button to the right in the tab bar or, if there's still enough space, by double-clicking into an empty area of it. If there are more tabs open than fit into the bar, the <span class="key">&lt;</span> <span class="key">&gt;</span> scroll-buttons become active, allowing you to scroll the tab bar left and right. The <span class="key">∨</span> button to the far right hosts a pop-up menu with all open tabs for even quicker navigation.</p></li>
-<li><p>Clicking on a link with the middle mouse button opens the page in a new tab in the background.</p></li>
+<li><p>Clicking on a link with the middle mouse button opens the page in a new tab in the background. Holding <span class="key">SHIFT</span> while middle-clicking, opens it in the foreground.</p></li>
 <li><p>From the <span class="menu">View</span> menu you can <span class="menu">Zoom in</span> and <span class="menu">Zoom out</span> of a page. There's also an option to <span class="menu">Zoom text only</span>, leaving all images with their original size.</p></li>
 <li><p>If you switch to full screen mode and have activated the setting to hide the interface, it will disappear after a second. To slide it temporarily back in, simply move the mouse pointer to the top of the screen.</p></li>
 <li><img src="../images/apps-images/webpositive-locator.png" alt="webpositive-locator.png" />
@@ -91,7 +91,6 @@ Strings not recognized as URLs will get looked up with Google, so the locator fi
 <li><p>Right-clicking opens a context menu which, depending on the object you've clicked on, offers to open the link in a new window or a new tab, download the object etc.</p></li>
 <li><p><span class="menu">Edit | Find</span> shows a find bar at the bottom to start an in-page search. Matches are highlighted in the page.</p></li>
 </ul>
-<div class="box-info">After a while you may experience web pages being loaded slower and slower. Not really a bug in the truest sense, it's more an effect of a deficient handling of cookies. Either way, until that is fixed you'll have to manually intervene: Have a look at <span class="path">~/config/settings/WebPositive/Cookies.curl</span>. This file stores cookies from webpages and slowly grows while surfing the web. Once it's a few dozen kilobytes in size, it starts to slow down browsing. Just delete the file at that point to start with a clean slate.</div>
 <h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Segnalibri</h2>
 <p>WebPositive's bookmarks are managed as files and folders in <tt>~/config/settings/WebPositive/Bookmarks/</tt>. Adding a bookmark will create a new file there. You can quickly open the folder with <span class="menu">Manage Bookmarks...</span>.</p>
 <img src="../images/apps-images/webpositive-bookmarks.png" alt="webpositive-bookmarks" />
@@ -119,7 +118,7 @@ Generally, WebPositive is very tolerant when it comes to managing files with Tra
 <tr><td><span class="key">ALT</span> <span class="key">H</span></td><td> </td><td>Opens the home page.</td></tr>
 <tr><td><span class="key">ALT</span> <span class="key">D</span></td><td> </td><td>Shows/hides the Downloads window.</td></tr>
 <tr><td><span class="key">ALT</span> <span class="key">F</span></td><td> </td><td>Shows the find bar for in-page searching (hide with <span class="key">ESC</span>).</td></tr>
-<tr><td><span class="key">ALT</span> <span class="key">B</span></td><td> </td><td>Bookmarks this page.</td></tr>
+<tr><td><span class="key">ALT</span> <span class="key">B</span></td><td> </td><td>Bookmarks the current page.</td></tr>
 <tr><td><span class="key">ALT</span> <span class="key">M</span></td><td> </td><td>Manage bookmarks, opening the Bookmarks folder.</td></tr>
 <tr><td><span class="key">ALT</span> <span class="key">←</span></td><td> </td><td>Previous page in the history.</td></tr>
 <tr><td><span class="key">ALT</span> <span class="key">→</span></td><td> </td><td>Next page in the history.</td></tr>