163 lines
14 KiB
HTML
163 lines
14 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
||
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-US">
|
||
<head>
|
||
<!--
|
||
*
|
||
* Copyright 2013-2017 Haiku. All rights reserved.
|
||
* Distributed under the terms of the MIT License.
|
||
*
|
||
* Authors:
|
||
* Humdinger <humdingerb@gmail.com>
|
||
*
|
||
-->
|
||
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
||
<meta http-equiv="Content-Style-Type" content="text/css" />
|
||
<meta name="robots" content="all" />
|
||
<title>HaikuDepot</title>
|
||
<link rel="stylesheet" type="text/css" href="../../Haiku-doc.css" />
|
||
</head>
|
||
<body>
|
||
|
||
<div id="banner">
|
||
<div><span>User guide</span></div>
|
||
</div>
|
||
|
||
<div class="nav">
|
||
<div class="inner">
|
||
<ul class="lang-menu">
|
||
<li class="now"><img src="../../images/flags/pt_PT.png" alt="" /> Português</li>
|
||
<li><a href="../../fr/applications/haikudepot.html"><img src="../../images/flags/fr.png" alt="" />Français</a></li>
|
||
<li><a href="../../de/applications/haikudepot.html"><img src="../../images/flags/de.png" alt="" />Deutsch</a></li>
|
||
<li><a href="../../it/applications/haikudepot.html"><img src="../../images/flags/it.png" alt="" />Italiano</a></li>
|
||
<li><a href="../../ru/applications/haikudepot.html"><img src="../../images/flags/ru.png" alt="" />Русский</a></li>
|
||
<li><a href="../../es/applications/haikudepot.html"><img src="../../images/flags/es.png" alt="" />Español</a></li>
|
||
<li><a href="../../sv_SE/applications/haikudepot.html"><img src="../../images/flags/sv_SE.png" alt="" />Svenska</a></li>
|
||
<li><a href="../../jp/applications/haikudepot.html"><img src="../../images/flags/jp.png" alt="" />日本語</a></li>
|
||
<li><a href="../../uk/applications/haikudepot.html"><img src="../../images/flags/uk.png" alt="" />Українська</a></li>
|
||
<li><a href="../../zh_CN/applications/haikudepot.html"><img src="../../images/flags/zh_CN.png" alt="" /> 中文 ［中文］</a></li>
|
||
<li><a href="../../fi/applications/haikudepot.html"><img src="../../images/flags/fi.png" alt="" />Suomi</a></li>
|
||
<li><a href="../../sk/applications/haikudepot.html"><img src="../../images/flags/sk.png" alt="" />Slovenčina</a></li>
|
||
<li><a href="../../hu/applications/haikudepot.html"><img src="../../images/flags/hu.png" alt="" />Magyar</a></li>
|
||
<li><a href="../../pt_BR/applications/haikudepot.html"><img src="../../images/flags/pt_BR.png" alt="" />Português (Brazil)</a></li>
|
||
<li><a href="../../ca/applications/haikudepot.html"><img src="../../images/flags/ca.png" alt="" />Català</a></li>
|
||
<li><a href="../../pl/applications/haikudepot.html"><img src="../../images/flags/pl.png" alt="" />Polski</a></li>
|
||
<li><a href="../../ro/applications/haikudepot.html"><img src="../../images/flags/ro.png" alt="" />Română</a></li>
|
||
<li><a href="../../en/applications/haikudepot.html"><img src="../../images/flags/gb.png" alt="" />English</a></li>
|
||
</ul>
|
||
<span>
|
||
« <a href="expander.html">Expander</a>
|
||
:: <a href="../applications.html#list-of-apps" class="uplink">Applications</a>
|
||
:: <a href="icon-o-matic.html">Icon-O-Matic</a> »
|
||
</span></div>
|
||
</div>
|
||
|
||
<div id="content">
|
||
<div>
|
||
<div class="box-info">The translation of this page isn't yet complete. Until it is, unfinished parts use the English original.</div>
|
||
|
||
<table class="index" id="index" summary="index">
|
||
<tr class="heading"><td>Index</td></tr>
|
||
<tr class="index"><td><a href="#filter">The Filter</a><br />
|
||
<a href="#list">The List</a><br />
|
||
<a href="#info">The Info Area</a><br />
|
||
<a href="#menu">Tools and Show</a><br />
|
||
<a href="#account">Creating a User Account</a><br />
|
||
<a href="#rating">Rating and Commenting</a><br />
|
||
</td></tr>
|
||
</table>
|
||
|
||
<h2><img src="../../images/apps-images/haikudepot-icon_64.png" alt="haikudepot-icon_64.png" width="64" height="64" />HaikuDepot</h2>
|
||
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
|
||
<tr><td>Deskbar:</td><td style="width:15px;"></td><td><span class="menu">Applications</span></td></tr>
|
||
<tr><td>Location:</td><td></td><td><span class="path">/boot/system/apps/HaikuDepot</span></td></tr>
|
||
<tr><td>Settings:</td><td></td><td><span class="path">~/config/settings/HaikuDepot/main_settings</span><br />
|
||
<span class="path">~/config/cache/HaikuDepot/</span> - Cached icons, screenshots, descriptions etc.</td></tr>
|
||
</table>
|
||
<p><br /></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 and install, update and uninstall packages. By default, HaikuDepot starts up with a list of "<i>Featured packages</i>", software that's deemed interesting to many users.</p>
|
||
<img src="../images/apps-images/haikudepot.png" alt="haikudepot.png" />
|
||
<p>As soon as you enter something in the <span class="menu">Search terms</span> box, the display changes to smaller icons and more information arranged in columns.</p>
|
||
|
||
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="filter" name="filter">The Filter</a></h2>
|
||
<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">Category</span> pop-up menu lets you limit the list to individual categories like "<i>Audio</i>" or "<i>Games</i>".</p></li>
|
||
<li><p>The <span class="menu">Repositories</span> pop-up menu determines which online repos are queried or if only those packages are shown, that were installed from somewhere other than an online repo ("<i>Local</i>"). Maybe from an USB thumb drive or downloaded from some website or a package that you've built yourself.</p></li>
|
||
<li><p>The <span class="menu">Search terms</span> text field filters the list to those packages that have all the entered (space-delimited) strings in their name or description.</p></li>
|
||
</ul>
|
||
|
||
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="list" name="list">The List</a></h2>
|
||
<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">Active</span>: The package is currently installed and ready to be used.</p></li>
|
||
<li><p><span class="menu">Available</span>: The package exists in that repository 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">Pending / %</span>: <i>Pending</i> is shown for a package that is queued for download/installation. While a package is downloaded, the progress is shown as percentage.</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>
|
||
|
||
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="info" name="info">The Info Area</a></h2>
|
||
<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. If a package is already installed, you'll find an additional button there to <span class="button">Open</span> the application.</p>
|
||
<p>Below are four tabs: About, Ratings, Changelog and Contents.</p>
|
||
<ul>
|
||
<li><p _translation_id="5252"><span class="menu">About</span></p>
|
||
<p _translation_id="5253">The first tab has a 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. Clicking the screenshot thumbnail will open it full-size in a new window</p></li>
|
||
<li><p _translation_id="5254"><span class="menu">Ratings</span></p>
|
||
<p _translation_id="5255">The second tab shows ratings and comments of users, if available.</p>
|
||
<img src="../images/apps-images/haikudepot-rating-tab.png" alt="haikudepot-rating-tab.png" />
|
||
<p _translation_id="5268">To the left is a statistic, showing the number of stars (1 to 5) the package got from how many users.<br />
|
||
In the middle are user comments with their nickname, the number of stars they gave the package and which version of the package they were rating or commenting on. You'll find more on how to rate a package yourself <a href="#rating">further down</a>.<br />
|
||
<!-- 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 _translation_id="5257"><span class="menu">Changelog</span></p>
|
||
<p _translation_id="5258">Here you find a detailed history of all the versions of the package that have been released so far, if the maintainer of the package provides that information.</p></li>
|
||
<li><p><span class="menu">Contents</span></p>
|
||
<p>The last tab shows all the files and folders a package contains. This only works for already downloaded packages.</p></li>
|
||
</ul>
|
||
|
||
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="menu" name="menu">Tools and Show</a></h2>
|
||
<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 repositories</span>. This will request an up-to-date list of all available packages from the repositories. The other item is to <span class="menu">Manage repositories...</span>. It opens the <a href="../preferences/repositories.html">Repositories</a> preferences, to add/remove or disable and enable repositories.</p>
|
||
<p>Under <span class="menu">Show</span> you can deactivate <span class="menu">Only featured packages</span>. Now you'll always see all packages and not just the featured ones when HaikuDepot starts up or the search text field is empty.<br />
|
||
Furthermore, you can choose to also Show <span class="menu">Develop packages</span> and <span class="menu">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>
|
||
<p>Of more interest are the options to only show <span class="menu">Available packages</span> and <span class="menu">Installed packages</span>, which are pretty self-explanatory.</p>
|
||
|
||
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="account" name="account">Creating a User Account</a></h2>
|
||
<p>To be able to rate a package, you need a user account at the <a href="http://depot.haiku-os.org">Haiku Depot Server</a> that serves all the packages and keeps track of ratings and user comments. You can create an account within the HaikuDepot application by clicking on the menu in the far right of the menu bar that shows your current status: <span class="menu">Not logged in</span>. Choosing <span class="menu">Log in...</span> opens a window with two tabs; one to enter your user name and password (once you have those) to log in, and the other to create a new account:</p>
|
||
<img src="../images/apps-images/haikudepot-login-tab.png" alt="haikudepot-login-tab.png" />
|
||
<p>To create an account you need to:</p>
|
||
<ul><li>use an all lower-case user name without special characters</li>
|
||
<li>use a password that's at least 8 characters long with at least 2 capitals and 2 numbers</li>
|
||
<li>provide a valid email address (if you want a new password sent to you in case you forgot it)</li>
|
||
<li>solve the captcha</li></ul>
|
||
<p>After logging in, the top-right menu of the HaikuDepot window will now say <span class="menu">Logged in as (...)</span>, showing your user name. The menu now offers you to <span class="menu">Switch account...</span> or <span class="menu">Log out</span>.</p>
|
||
|
||
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="rating" name="rating">Rating and Commenting</a></h2>
|
||
<p>After you've created a user account and are logged in, you can rate a package and leave a comment, if you want. Just hover the mouse over the rating stars in the info area of a package and they turn into a <span class="button">Rating...</span> button. Click it to open the rating window:</p>
|
||
<img src="../images/apps-images/haiku-depot-ratingpanel.png" alt="haiku-depot-ratingpanel.png" />
|
||
<p>Here you move the mouse over the stars to light them up and choose your rating, you can also choose from a number of levels to judge the stability of the application and pick the language of your optional comment. To make a comment meaningful, you should have worked with the application you're about to rate for a while to become familiar with its features, bugs and quirks. And don't write the next great American novel... keep it short, sweet and polite. :)<br />
|
||
After you click <span class="button">Send</span> the data is transmitted to the server. You may have to go to the <span class="menu">Tools</span> menu to <span class="menu">Refresh repositories</span> before you can see your changes.</p>
|
||
<p>At any time, you can come back and edit your comment and re-rate it. You can also hide your rating from other users by deactivating the checkbox <span class="menu">Other users can see this rating</span>.</p>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="nav">
|
||
<div class="inner"><span>
|
||
« <a href="expander.html">Expander</a>
|
||
:: <a href="../applications.html#list-of-apps" class="uplink">Applications</a>
|
||
:: <a href="icon-o-matic.html">Icon-O-Matic</a> »
|
||
</span></div>
|
||
</div>
|
||
|
||
</body>
|
||
</html>
|