<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY appversion "2.15">
<!ENTITY manrevision "1.0">
<!ENTITY date "April 2006">
<!ENTITY app "Disk Usage Analyzer">
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the MATE Documentation Project
  http://developer.mate.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Apr 11, 2002
  
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="pl">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>Podręcznik Analizatora wykorzystania dysku</title>

    <abstract role="description">
      <para>Analizator wykorzystania dysku jest graficznym, sterowanym przez menu programem, który umożliwia wyświetlanie i monitorowanie wykorzystania dysku i struktury katalogów.</para>
    </abstract>

    <copyright lang="en"> 
      <year>2006</year> 
      <holder>Fabio Marzocca</holder> 
    </copyright> 
<!-- translators: uncomment this:

  <copyright>
   <year>2002</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->
    <publisher> 
      <publishername>Projekt dokumentacji środowiska MATE</publishername> 
    </publisher> 

     <legalnotice id="legalnotice">
	<para>Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this <ulink type="help" url="help:fdl">link</ulink> or in the file COPYING-DOCS distributed with this manual.</para>
         <para>This manual is part of a collection of MATE manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the license to the manual, as described in section 6 of the license.</para>

	<para>Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any MATE documentation, and the members of the MATE Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.</para>

	<para lang="en">
	  DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
	  UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
	  WITH THE FURTHER UNDERSTANDING THAT:

	  <orderedlist>
		<listitem>
		  <para lang="en">DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
                    WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
                    IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
                    THAT THE DOCUMENT OR MODIFIED VERSION OF THE
                    DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
                    A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
                    RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
                    OF THE DOCUMENT OR MODIFIED VERSION OF THE
                    DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
                    MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
                    YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
                    CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
                    SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
                    OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
                    LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
                    VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
                    EXCEPT UNDER THIS DISCLAIMER; AND
		  </para>
		</listitem>
		<listitem>
		  <para lang="en">UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
                       THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
                       CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
                       INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
                       DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
                       OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
                       PARTIES, BE LIABLE TO ANY PERSON FOR ANY
                       DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
                       CONSEQUENTIAL DAMAGES OF ANY CHARACTER
                       INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
                       OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
                       MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
                       LOSSES ARISING OUT OF OR RELATING TO USE OF THE
                       DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
                       EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
                       THE POSSIBILITY OF SUCH DAMAGES.
		  </para>
		</listitem>
	  </orderedlist>
	</para>
  </legalnotice>



   <authorgroup> 
   <author lang="en"> 
		<firstname>Fabio</firstname> 
		<surname>Marzocca</surname> 
		<affiliation> 
	  	<orgname>MATE Documentation Project</orgname> 
	  	<address> <email>thesaltydog@gmail.com</email> </address> 
		</affiliation> 
   </author> 

   <author role="maintainer" lang="en">
   	<firstname>Fabio</firstname>
	<surname>Marzocca</surname>
	<affiliation>
	  <address><email>thesaltydog@gmail.com</email></address>
	</affiliation>
   </author>
      
<!-- This is appropriate place for other contributors: translators,
      maintainers,  etc. Commented out by default.
   <othercredit role="translator">
		<firstname>Latin</firstname> 
		<surname>Translator 1</surname> 
		<affiliation> 
	  	<orgname>Latin Translation Team</orgname> 
	  	<address> <email>translator@gnome.org</email> </address> 
		</affiliation>
		<contrib>Latin translation</contrib>
   </othercredit>
-->
    </authorgroup>

	<releaseinfo revision="2.30" role="review">
	</releaseinfo>

    <revhistory>
      <revision lang="en"> 
		<revnumber>Disk Usage Analyzer Manual 1.0</revnumber> 
		<date>April 2006</date> 
		<revdescription> 
	  		<para role="author" lang="en">Emmanuele Bassi
	    		<email>ebassi@gmail.com</email>
	  		</para>
	  		<para role="publisher" lang="en">MATE Documentation Project</para>
		</revdescription> 
      </revision>
    </revhistory> 

    <releaseinfo>Niniejszy podręcznik opisuje wersję 2.15 Analizatora wykorzystania dysku.</releaseinfo> 
    
    <legalnotice> 
      <title>Informacje zwrotne</title> 
      <para>Aby zgłosić błąd lub sugestię na temat Analizatora wykorzystania dysku lub tej instrukcji użytkownika, proszę postępować zgodnie z instrukcjami na <ulink url="help:mate-feedback" type="help">stronie informacji zwrotnych MATE</ulink>.</para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  </articleinfo> 

  <indexterm lang="en"> 
    <primary>Disk Usage Analyser</primary> 
  </indexterm> 

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->

  <sect1 id="baobab-introduction"> 
    <title>Wprowadzenie</title> 

      <para><application>Analizator wykorzystania dysku</application> jest graficznym programem analizującym wykorzystanie dysku dla środowiska MATE. <application>Analizator wykorzystania dysków</application> umożliwia skanowanie całego systemu plików lub konkretnego katalogu (lokalnego albo zdalnego).</para>
       <para>Program automatycznie wykrywa wszystkie zmiany w katalogu domowym, jak również zamontowanych lub odmontowanych nośnikach. <application>Analizator wykorzystania dysku</application> wyświetla także graficzną mapę wykorzystania dysku dla każdego wybranego katalogu.</para>

  </sect1>

<!-- ================ Getting Started ================================ -->
	<sect1 id="baobab-getting-started">
	<title>Pierwsze kroki</title>

    <para><application>Analizator wykorzystania dysku</application> można uruchomić na trzy sposoby:</para>
	 <itemizedlist>
    <listitem><para>z menu MATE <menuchoice><guimenu>Programy</guimenu><guimenuitem>Akcesoria</guimenuitem></menuchoice>;</para>
    		</listitem>
    <listitem><para>z okna terminala;</para>
    		</listitem>
    <listitem><para>z "Otwórz za pomocą innego programu..." programu Caja</para>
    		</listitem>
    </itemizedlist> 


<para>Aby uruchomić <application>Analizator wykorzystania dysku</application> z okna terminala, należy wpisać:</para> 
  
<para><command>baobab &lt;pełna_ścieżka_do_katalogu&gt;</command>, i nacisnąć klawisz <keycap>Enter</keycap>.</para>  
<para/> 
	<para>Jeżeli program <application>Analizator wykorzystania dysku</application> został uruchomiony z menu MATE, pozostaje uruchomiony w oczekiwaniu na działania użytkownika.</para> 
    <para>Po uruchomieniu <application>Analizatora wykorzystania dysku</application> z menu MATE, zostanie wyświetlone następujące okno.</para>

    <!-- ==== Figure ==== -->
      <figure id="baobab-fig"> 
	<title>Okno Analizatora wykorzystania dysku</title> 
	<screenshot> 
	  <mediaobject lang="en"> 
	    <imageobject>
	    <imagedata fileref="figures/baobab_window.png" format="PNG"/> 
	    </imageobject>
	    <textobject> 
	      <phrase>Shows Disk Usage Analyzer main window. Contains menubar, display area, scrollbars, and statusbar. </phrase> 
	    </textobject> 
	  </mediaobject> 
	</screenshot> 
      </figure>
    <!-- ==== End of Figure ==== -->

<para>Użytkownik może wtedy:</para>
	<itemizedlist>
    <listitem><para>rozpocząć skanowanie systemu plików;</para>
    		</listitem>
    <listitem><para>wybrać określony katalog do skanowania</para>
    		</listitem>
    <listitem><para>wybrać zdalny serwer i katalog do skanowania</para>
    		</listitem>
    <listitem><para>ustawić preferencje</para>
    		</listitem>
	</itemizedlist>


</sect1>

<!-- ================ Usage ================================ -->

  <sect1 id="baobab-usage"> 
    <title>Użytkowanie</title>

    <sect2 id="baobab-fullscan">
      <title>Skanowanie systemu plików</title>
        <para>Aby rozpocząć skanowanie systemu plików, należy wybrać <menuchoice><guimenu>Analiza</guimenu><guimenuitem>Skanuj system plików</guimenuitem></menuchoice> z menu, albo nacisnąć przycisk <guibutton>Skanuj system plików</guibutton> z paska narzędziowego.</para>

	<para>Po ukończeniu skanowania, zostanie wyświetlone pełne drzewo systemu plików, takie jak zaprezentowane poniżej.</para>    

    <!-- ==== Figure ==== -->
      <figure id="baobab-fullscan-fig"> 
	<title>Skanowanie systemu plików Analizatora wykorzystania dysku</title> 
	<screenshot> 
	  <mediaobject lang="en"> 
	    <imageobject>
	    <imagedata fileref="figures/baobab_fullscan.png" format="PNG"/> 
	    </imageobject>
	    <textobject> 
	      <phrase>Shows Disk Usage Analyzer full filesystem scan window. Contains menubar, display area, scrollbars, and statusbar. </phrase> 
	    </textobject> 
	  </mediaobject> 
	</screenshot> 
      </figure>
    <!-- ==== End of Figure ==== -->
    
    	<note><para>Po uruchomieniu pełnego skanowania systemu plików, okno <application>Analizator wykorzystania dysku</application> rozpocznie wyświetlanie drzewa katalogów z chwilą rozpoczęcia skanowania. Jeżeli jakaś duża partycja jest zamontowana, to również będzie skanowana.</para></note>
    
    <para><application>Analizator wykorzystania dysku</application> wyświetla rozmiary w drzewie katalogów jako zaalokowaną przestrzeń. Oznacza to, że wyświetlany jest rzeczywisty rozmiar, a nie widoczny rozmiar katalogu czy pliku. Aby wyświetlić widoczny rozmiar pliku czy katalogu, należy odznaczyć <menuchoice><guimenu>Widok</guimenu><guimenuitem>Przestrzeń zaalokowana</guimenuitem></menuchoice> .</para>
    
    <warning><para>Katalog /proc, dowiązania symboliczne, urządzenia blokowe i znaki blokowe nie będą zliczane przez <application>Analizator wykorzystania dysku</application>.</para></warning>
   
    <para>Dowiązania stałe są analizowane w inny sposób: pierwsze dowiązanie jest liczone jako normalny plik, pozostałe dowiązania nie są zliczane, jednak są wyszczególnione w prawej kolumnie okna.</para>
        </sect2>
	
	<sect2 id="baobab-folderscan">
      <title>Skanowanie katalogu</title>

    <para>Aby rozpocząć skanowanie pojedynczego katalogu, należy wybrać <menuchoice><guimenu>Analiza</guimenu><guimenuitem>Skanuj katalog</guimenuitem></menuchoice> z menu, albo nacisnąć przycisk <guibutton>Skanuj katalog</guibutton> z paska narzędziowego.</para>

	</sect2>

	<sect2 id="baobab-remotescan">
      <title>Zdalne skanowanie</title>
      
      <para>Aby wykonać skanowanie zdalnego katalogu, należy nacisnąć przycisk <guibutton>Skanuj zdalny katalog</guibutton> z paska narzędziowego lub wybrać z menu <menuchoice><guimenu>Analiza</guimenu><guimenuitem>Skanuj zdalny katalog</guimenuitem></menuchoice>. Następnie zostanie wyświetlone poniższe okno dialogowe. <application>Analizator wykorzystania dysku</application> można połączyć ze zdalnym serwerem przez protokoły ssh, ftp, smb, http oraz https.</para>
 
     <!-- ==== Figure ==== -->
      <figure id="baobab-remote-fig"> 
        <title>Skanowanie katalogu zdalnego Analizatora wykorzystania dysku</title> 
		<screenshot> 
	 	 <mediaobject lang="en"> 
	  	  <imageobject>
	   	 <imagedata fileref="figures/baobab_remote.png" format="PNG"/> 
	   	 </imageobject>
	   	 <textobject> 
	    	  <phrase>Shows Disk Usage Analyzer remote folder dialog window. </phrase> 
	   	 </textobject> 
	 	 </mediaobject> 
		</screenshot> 
      </figure>
    <!-- ==== End of Figure ==== -->
   
	</sect2> 

  </sect1>


<!-- ============= Preferences =============================== -->
  <sect1 id="baobab-preferences">
    <title>Preferencje</title>
    
    <para>Aby zmienić preferencje programu <application>Analizator wykorzystania dysku</application>, należy wybrać <menuchoice><guimenu>Edycja</guimenu><guimenuitem>Preferencje</guimenuitem></menuchoice>.</para>
 
   <!-- ==== Figure ==== -->
      <figure id="baobab-preferences-fig"> 
      	<title>Okno preferencji Analizatora wykorzystania dysku</title> 
	<screenshot> 
	  <mediaobject lang="en"> 
	    <imageobject>
	    <imagedata fileref="figures/baobab_prefs.png" format="PNG"/> 
	    </imageobject>
	    <textobject> 
	      <phrase>Preferences window </phrase> 
	    </textobject> 
	  </mediaobject> 
	</screenshot> 
      </figure>
    <!-- ==== End of Figure ==== -->
  
  <sect2 id="baobab-scan-preferences">
      <title>Wybieranie urządzeń do skanowania</title>
  <para>W pierwszej części okna preferencji są wyświetlane wszystkie zamontowane urządzenia. Należy kliknąć na pole zaznaczenia aby włączyć lub wyłączyć partycję z działań skanowania systemu plików</para>
  <note><para>Urządzenie zamontowane jako "/" nie może zostać wyłączone ze skanowania.</para></note>
  </sect2>
 
   <sect2 id="baobab-monitor-preferences">
      <title>Włączanie monitorowania katalogu domowego</title>
      <para>Jeżeli opcja jest zaznaczona, <application>Analizator wykorzystania dysku</application> będzie stale monitorował wszelkie zmiany katalogu domowego i ostrzegał użytkownika w przypadku dodania lub usunięcia pliku.</para>  
   </sect2>  
	</sect1>
<!-- ================ Treemaps ================================ -->

  <sect1 id="baobab-treemaps"> 
  <title>Wykres drzewa</title>

    <para>Idea <guilabel>wykresu drzewa</guilabel> została wymyślona przez Ben'a Shneiderman'a w latach 90. Jego publikacja: <ulink type="http" url="http://www.cs.umd.edu/hcil/treemap-history/index.shtml">Wizja wykresu drzewa</ulink>.</para>
    
       <!-- ==== Figure ==== -->
      <figure id="baobab-treemap-fig"> 
        <title>Okno wykresu drzewa Analizatora wykorzystania dysku</title>
	<screenshot> 
	  <mediaobject lang="en"> 
	    <imageobject>
	    <imagedata fileref="figures/baobab_treemaps.png" format="PNG"/> 
	    </imageobject>
	    <textobject> 
	      <phrase>Treemap's theory. Shows 2 treemap diagrams </phrase> 
	    </textobject> 
	  </mediaobject> 
	</screenshot> 
      </figure>
    <!-- ==== End of Figure ==== -->
  
    
    <para>Rysunek pokazuje przykład teorii wykresu drzewa. Każdy węzeł (tak jak jest to pokazane na drzewie) posiada nazwę (literę) oraz związany z nim rozmiar (liczbę). Rozmiar liści reprezentuje rozmiar poszczególnych plików, a rozmiar węzłów nie będących liśćmi jest sumą rozmiarów ich potomków.</para> 
    
    <para>Wykres drzewa jest konstruowany poprzez rekursywny podział początkowego prostokąta. Rozmiar każdego składowego prostokąta jest proporcjonalny do rozmiaru odpowiedniego węzła. Kierunek podziału przebiega naprzemiennie - na początku pionowo, potem poziomo, itp, itd. Ostatecznie początkowy prostokąt jest podzielony na wiele mniejszych, których rozmiar odzwierciedla rozmiar liści. Struktura drzewa jest również odzwierciedlona w mapie - jako rezultat jej konstrukcji. Kolor i komentarz może być użyty do podania dodatkowej informacji o liściach.</para>

	<note><para>Wykresy drzewa są bardzo efektywne w przypadku, gdy rozmiar jest najważniejszą informacją do wyświetlenia.</para></note>
  </sect1>
  <!-- ================ Ringschart ================================ -->

  <sect1 id="baobab-ringschart"> 
  <title>Wykres kołowy</title>

    <para><guilabel>Wykres kołowy</guilabel> jest graficzną reprezentacją wykorzystania dysku przez określony katalog. Po uruchomieniu programu, na wykresie jest wyświetlone wykorzystanie dysku przez cały system plików:</para>

    <!-- ==== Figure ==== -->
    <figure id="baobab-filesystem_scan"> 
      <title>Analizator wykorzystania dysku pokazuje wykres kołowy wykorzystania dysku przez system plików</title>
      <screenshot> 
	<mediaobject lang="en"> 
	  <imageobject>
	    <imagedata fileref="figures/baobab_ringschart1.png" format="PNG"/> 
	  </imageobject>
	  <textobject> 
	    <phrase>After launching the application, it is showed the
	    file system usage. Graphical representation on the right. </phrase> 
	  </textobject> 
	</mediaobject> 
      </screenshot> 
    </figure>
    <!-- ==== End of Figure ==== -->

    <para>Po rozpoczęciu skanowania katalogu, drzewo katalogów jest wyświetlana po lewej stronie. Każdy wiersz zawiera informację o nazwie, rozmiarze (procentowym oraz wyrażonym w KB, MB i GB) oraz ilości elementów (plików i katalogów). Gdy skanowanie dobiegnie końca, <guilabel>Wykres kołowy</guilabel> jest rysowany po prawej stronie. W przypadku zatrzymania skanowania przed jego ukończeniem wyświetlana jest tylko częściowa reprezentacja wykorzystania dysku odnosząca się do katalogów które zostały przetworzone przed zatrzymaniem.</para>


    <!-- ==== Figure ==== -->
    <figure id="baobab-folder_scan"> 
      <title>Analizator wykorzystania dysku wyświetla wykres kołowy wykorzystania miejsca przez katalog</title>
      <screenshot> 
	<mediaobject lang="en"> 
	  <imageobject>
	    <imagedata fileref="figures/baobab_ringschart2.png" format="PNG"/> 
	  </imageobject>
	  <textobject> 
	    <phrase>After scanning a folder. </phrase> 
	  </textobject> 
	</mediaobject> 
      </screenshot> 
    </figure>
    <!-- ==== End of Figure ==== -->
    
    <para><guilabel>Wykres kołowy</guilabel> jest złożony z pierścieni umieszczonych dookoła środkowego okręgu. Okrąg symbolizuje katalog będący korzeniem częściowego drzewa (jest to katalog, który użytkownik wybrał do skanowania). Każdy pierścień reprezentuje poziom w częściowym drzewie - katalogi korzenia reprezentują pierwszy pierścień, a głębszym poziomom odpowiadają bardziej zewnętrzne pierścienie na wykresie. Każdy podkatalog jest reprezentowany jako część pierścienia, kąt jest proporcjonalny do rozmiaru zawartości oraz pokolorowany w sposób ułatwiający wizualizację. Przedstawiane jest tylko pięć poziomów - w przypadku, gdy katalog na piątym poziomie zawiera dalsze podkatalogi, są one zaznaczone jako czarna krzywa położona blisko części pierścienia symbolizująca katalog. Gdy wybrany jako korzeń katalog nie ma dalszych podkatalogów, zostanie wyświetlone tylko koło wewnętrzne. Po najechaniu kursora na reprezentację katalogu na wykresie, zostanie on podświetlony oraz wyświetli się informacja odnośnie jego nazwy i rozmiaru. Gdy dany katalog posiada podkatalogi, zostanie wyświetlone małe okno z nazwą. Jest możliwe, że wyświetlone zostaną nazwy tylko części katalogów, aby uniknąć nakładania się ich na siebie.</para>

    <para>Podczas przemieszczania się pomiędzy wierszami listy (czy też rozwijaniem tych posiadających katalogi), graficzna reprezentacja zmienia się używając wskazanego katalogu jako korzenia częściowego drzewa będącego nową reprezentacją. Można także przemieszczać się pomiędzy katalogami z obszaru <guilabel>wykresu kołowego</guilabel>. Po kliknięciu lewym przyciskiem myszy na wnętrze katalogu, zaznaczony katalog zostaje korzeniem nowego drzewa. Po naciśnięciu środkowego przycisku myszy (wewnątrz ramki <guilabel>wykresu kołowego</guilabel>) następuje przeniesienie w górę hierarchii katalogów.</para>

    <para>Promienie katalogu i jego katalogu nadrzędnego mają rozmiar proporcjonalny do rozmiarów katalogów. Z łatwością można zauważyć, że rozmiar katalogu jest mniejszy bądź równy rozmiarowi jego katalogu nadrzędnego. Pomimo tego, że tylko katalogi są wyświetlane na wykresie, pliki są brane pod uwagę przy obliczaniu rozmiaru przestrzeni zajmowanej przez katalogi.</para>
  </sect1>
</article>
