<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY appversion "1.10">
<!ENTITY manrevision "1.10">
<!ENTITY date "July 2015">
<!ENTITY app "Disk Usage Analyzer">
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the MATE Documentation Project
  http://wiki.mate-desktop.org/dev-doc:doc-team-guide
  Template version: 2.0 beta
  Template last modified Apr 11, 2002
  
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="es">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>Manual de Analizador del uso del disco</title>

    <abstract role="description">
      <para>Analizador del uso del disco es un visor gráfico basado en menús que puede usarse para ver y monitorear el uso del disco y la estructura de las carpetas</para>
    </abstract>

    <copyright lang="en"><year>2015-2021</year> <holder>Proyecto de documentación de MATE</holder></copyright>
    <copyright><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>Proyecto de documentación de MATE</publishername>
    </publisher> 
    <publisher> 
      <publishername>Proyecto de documentación de GNOME</publishername>
    </publisher> 

   

   <authorgroup>
      <author role="maintainer" lang="en"><surname>Equipo de documentación de MATE</surname> <affiliation> <orgname>Escritorio MATE</orgname> </affiliation></author>
   <author><firstname>Fabio</firstname> <surname>Marzocca</surname> <affiliation> <orgname>Proyecto de documentación de GNOME</orgname> <address> <email>thesaltydog@gmail.com</email> </address> </affiliation></author> 

   <author role="maintainer"><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="1.10" role="review">
	</releaseinfo>

    <revhistory>
      <revision><revnumber>Disk Usage Analyzer Manual 1.10</revnumber> <date>July 2015</date> <revdescription> 
	  		<para role="author" lang="en">Wolfgang Ulbrich</para>
	  		<para role="publisher">Proyecto de documentación de MATE</para>
		</revdescription></revision>
      <revision><revnumber>Manual de Analizador del uso del disco 1.0</revnumber> <date>Abril 2006</date> <revdescription> 
	  		<para role="author">Emmanuele Bassi <email>ebassi@gmail.com</email></para>
	  		<para role="publisher">Proyecto de documentación de GNOME</para>
		</revdescription></revision>
    </revhistory> 

    <releaseinfo>Este manual describe la versión 1.10 de Analizador del uso del disco</releaseinfo> 
    
    <legalnotice> 
      <title>Comentarios</title> 
      <para>Para informar de un error o hacer una sugerencia acerca de la aplicación  Analizador del uso del disco o de este manual, siga las instrucciones de la <ulink url="help:mate-user-guide/feedback" type="help">Página de comentarios de MATE</ulink>.</para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  
    <othercredit class="translator">
      <personname>
        <firstname>Toni Estevez</firstname>
      </personname>
      <email>toni.estevez@gmail.com</email>
    </othercredit>
    <copyright>
      
        <year>2019</year>
      
      <holder>Toni Estevez</holder>
    </copyright>
  
    <othercredit class="translator">
      <personname>
        <firstname>Jorge González</firstname>
      </personname>
      <email>jorgegonz@svn.gnome.org</email>
    </othercredit>
    <copyright>
      
        <year>2007-2010</year>
      
      <holder>Jorge González</holder>
    </copyright>
  
    <othercredit class="translator">
      <personname>
        <firstname>Francisco Javier F. Serrador</firstname>
      </personname>
      <email>serrador@cvs.gnome.org</email>
    </othercredit>
    <copyright>
      
        <year>2003-2006</year>
      
      <holder>Francisco Javier F. Serrador</holder>
    </copyright>
  
    <othercredit class="translator">
      <personname>
        <firstname>Pablo Gonzalo del Campo</firstname>
      </personname>
      <email>pablodc@bigfoot.com</email>
    </othercredit>
    <copyright>
      
        <year>2002-2003</year>
      
      <holder>Pablo Gonzalo del Campo</holder>
    </copyright>
  </articleinfo> 

  <indexterm><primary>Analizador del uso del disco</primary></indexterm> 

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

  <sect1 id="baobab-introduction"> 
    <title>Introducción</title> 

      <para><application>Analizador del uso del disco</application> es una aplicación gráfica, basada en menús, para analizar el uso del disco en cualquier entorno MATE. <application>Analizador del uso del disco</application> puede explorar fácilmente todo el árbol del sistema de archivos o una rama de carpetas específica solicitada por el usuario (local o remota).</para>
       <para>También detecta automáticamente en tiempo real cualquier cambio que se haga en la carpeta personal incluyendo dispositivos montados o desmontados. <application>Analizador del uso del disco</application> también proporciona una ventana con un gráfico de árbol completo para cada carpeta seleccionada.</para>

  </sect1>

<!-- ================ Getting Started ================================ -->
	<sect1 id="baobab-getting-started">
	<title>Cómo empezar</title>

    <para>Analizador del uso del disco puede iniciarse de tres maneras:</para>
	 <itemizedlist>
    <listitem><para>desde el menú MATE <menuchoice><guimenu>Aplicaciones</guimenu><guimenuitem>Accesorios</guimenuitem></menuchoice>;</para>
    		</listitem>
    <listitem><para>desde la ventana del terminal;</para>
    		</listitem>
    <listitem><para>desde «Abrir con...» de Caja;</para>
    		</listitem>
    </itemizedlist> 


<para>Si quiere iniciar <application>Analizador del uso del disco</application> desde la ventana del terminal, escriba:</para> 
  
<para><command>mate-disk-usage-analyzer &lt;full_path_to_a_directory&gt;</command>, después pulse <keycap>Ejecutar</keycap>.</para>  
<para/> 
	<para>Si lo inicia desde el menú MATE, <application>Analizador del uso del disco</application> se inicia y permanece en espera hasta que el usuario realiza una acción.</para> 
    <para>Al iniciar <application>Analizador del uso del disco</application> desde el menú MATE, se muestra la ventana siguiente.</para>

    <!-- ==== Figure ==== -->
      <figure id="baobab-fig"> 
	<title>Ventana de Analizador del uso del disco</title> 
	<screenshot> 
	  <mediaobject><imageobject> <imagedata fileref="figures/baobab_window.png" format="PNG"/> </imageobject> <textobject> <phrase>Muestra la ventana principal de Analizador del uso del disco. Contiene una barra de estado, un área de visualización, barras de desplazamiento y una barra de estado. </phrase> </textobject></mediaobject> 
	</screenshot> 
      </figure>
    <!-- ==== End of Figure ==== -->

<para>Entonces el usuario puede:</para>
	<itemizedlist>
    <listitem><para>iniciar una exploración completa del sistema de archivos;</para>
    		</listitem>
    <listitem><para>seleccionar una rama específica de la carpeta local para explorar</para>
    		</listitem>
    <listitem><para>seleccionar un servidor remoto y una carpeta para explorar</para>
    		</listitem>
    <listitem><para>configurar las preferencias</para>
    		</listitem>
	</itemizedlist>


</sect1>

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

  <sect1 id="baobab-usage"> 
    <title>Uso</title>

    <sect2 id="baobab-fullscan">
      <title>Exploración completa del sistema de archivos</title>
        <para>Para iniciar una exploración completa del sistema de archivos seleccione <menuchoice><guimenu>Analizador</guimenu><guimenuitem>Explorar el sistema de archivos</guimenuitem></menuchoice> en el menú o pulse el botón <guibutton>Explorar el sistema de archivos</guibutton>.</para>

	<para>Cuando el proceso de exploración finalice, obtendrá el diagrama completo de su sistema de archivos, como el que aparece en la imagen siguiente.</para>    

    <!-- ==== Figure ==== -->
      <figure id="baobab-fullscan-fig"> 
	<title>Exploración completa del sistema de archivos en Analizador del uso del disco</title> 
	<screenshot> 
	  <mediaobject><imageobject> <imagedata fileref="figures/baobab_fullscan.png" format="PNG"/> </imageobject> <textobject> <phrase>Muestra la ventana de exploración completa del sistema de archivos de Analizador del uso del disco. Contiene la barra de menús, el área de visualización, las barras de desplazamiento y la barra de estado. </phrase> </textobject></mediaobject> 
	</screenshot> 
      </figure>
    <!-- ==== End of Figure ==== -->
    
    	<note><para>Cuando realice una exploración completa del sistema, la ventana de <application>Analizador del uso del disco</application> comenzará a mostrar el gráfico en cuanto la cadena empiece a explorar el sistema de archivos. Si hubiera una partición montada en el sistema de archivos, también se exploraría. </para></note>
    
    <para><application>Analizador del uso del disco</application> mostrará los tamaños en el árbol de carpetas según el espacio asignado. Esto quiere decir que los tamaños mostrados hacen referencia al uso real del disco y no al tamaño aparente de la carpeta. Si quiere ver el tamaño aparente del archivo, desmarque  <menuchoice><guimenu>Ver</guimenu><guimenuitem>Espacio asignado</guimenuitem></menuchoice> .</para>
    
    <warning><para><application>Analizador del uso del disco</application> no contará el directorio /proc, ni tampoco otro tamaño de archivo que no esta relacionado al archivo "mismo", del mismo modo no serán parte del tamaño del directorio los symlinks, las secciones de caracteres, o las secciones de aparatos.</para></warning>
   
    <para>Los enlaces duros se gestionan de forma diferente: este primer enlace duro se cuenta como un archivo normal, mientras que los enlaces posteriores al mismo nodo índice del dispositivo no se cuentan en el total, sino que se resaltan en la columna de la derecha de la ventana.</para>
        </sect2>
	
	<sect2 id="baobab-folderscan">
      <title>Exploración de una sola carpeta</title>

    <para>Para iniciar una exploración de una sola carpeta, seleccione <menuchoice><guimenu>Analizar</guimenu><guimenuitem>Explorar la carpeta...</guimenuitem></menuchoice> en el menú o haga clic en el botón <guibutton>Explorar la carpeta</guibutton> de la barra de herramientas.</para>

	</sect2>

	<sect2 id="baobab-remotescan">
      <title>Exploración remota</title>
      
      <para lang="en">If you need to scan a remote server-folder, just click on the toolbar 
      icon <guibutton>Scan Remote Folder</guibutton> or select <menuchoice><guimenu>Analyzer</guimenu><guimenuitem>Scan Remote Folder</guimenuitem></menuchoice>
      from the menu and you will get the following dialog box. <application>Disk Usage Analyzer</application> 
      can connect to a server through ssh, ftp, smb, http and https.</para>
 
     <!-- ==== Figure ==== -->
      <figure id="baobab-remote-fig"> 
        <title>Carpeta de análisis del Analizador Remoto de Utilización del Disco</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>Preferencias</title>
    
    <para lang="en">To change the <application>Disk Usage Analyzer</application> application
    preferences, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>.</para>
 
   <!-- ==== Figure ==== -->
      <figure id="baobab-preferences-fig"> 
      	<title lang="en">Disk Usage Analyzer Preferences Window</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>Seleccionar los dispositivos que se van a explorar</title>
  <para lang="en">In the first part of the Preferences window, all detected mounted devices 
  are listed. Click on the checkbox to include/exclude the partition into the 
  filesystem scanning operations.  </para>
  <note><para lang="en">The device mounted on "/" cannot be excluded from the scan.</para></note>
  </sect2>
 
   <sect2 id="baobab-monitor-preferences">
      <title>Activar monitoreo de inicio</title>
      <para lang="en">If this option is checked, <application>Disk Usage Analyzer</application> will 
      constantly monitor any external changes to home directory and warn 
      the user if a file is added/removed.</para>  
   </sect2>  
	</sect1>
<!-- ================ Treemaps ================================ -->

  <sect1 id="baobab-treemaps"> 
  <title>Árboles</title>

    <para lang="en"><guilabel>Treemap</guilabel> concepts have been developed by Ben Shneiderman in the '90s.
    Read his <ulink type="http" url="http://www.cs.umd.edu/hcil/treemap-history/index.shtml">vision on treemaps</ulink>.</para>
    
       <!-- ==== Figure ==== -->
      <figure id="baobab-treemap-fig"> 
        <title lang="en">Disk Usage Analyzer Treemap Window</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 lang="en">Figure shows an example of treemap's theory. Each node 
    (as shown in the tree diagram) has a name (a letter) and an associated size 
    (a number). The size of leaves may represent for instance the size of individual 
    files, the size of non-leaf nodes is the sum of the sizes of its children.</para> 
    
    <para lang="en">The treemap is constructed via recursive subdivision of the initial rectangle. 
    The size of each sub-rectangle corresponds to the size of the node. 
    The direction of subdivision alternates per level: first horizontally, 
    next vertically, etcetera. As a result, the initial rectangle is partitioned 
    into smaller rectangles, such that the size of each rectangle reflects the size 
    of the leaf. The structure of the tree is also reflected in the treemap, 
    as a result of its construction. Color and annotation can
	be used to give extra information about the leaves.</para>

	<note><para lang="en">Treemaps are very effective when size is the most important feature to be 
	displayed.</para></note>
  </sect1>
  <!-- ================ Ringschart ================================ -->

  <sect1 id="baobab-ringschart"> 
  <title lang="en">Ringschart</title>

    <para lang="en"><guilabel>Ringschart</guilabel> is a graphical
      representation of the disk usage by a concrete folder. When
      launching the application, it is notified the usage of
      the file system as it can be seen in the next figure:</para>

    <!-- ==== Figure ==== -->
    <figure id="baobab-filesystem_scan"> 
      <title>Analizador del uso del disco que muestra un gráfico de anillos con el uso del sistema de archivos</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 lang="en">When you start scanning a folder, the tree of subfolders is
      created and listed on the left side. Each row contains
      information for the name, how much space it is taking up
      (percentage and size in KB, MB or GB) and the number of items
      (adding files and directories). When this process ends up,
      the <guilabel>Ringschart</guilabel> is drawn on the right
      side. If you stop it before it has been completed, only a
      partial representation is done based on the directories whose
      usage was computed.</para>


    <!-- ==== Figure ==== -->
    <figure id="baobab-folder_scan"> 
      <title>Analizador del uso del disco que muestra un gráfico de anillos con el uso de una carpeta</title>
      <screenshot> 
	<mediaobject><imageobject> <imagedata fileref="figures/baobab_ringschart2.png" format="PNG"/> </imageobject> <textobject> <phrase>Después de explorar una carpeta </phrase> </textobject></mediaobject> 
      </screenshot> 
    </figure>
    <!-- ==== End of Figure ==== -->
    
    <para>El gráfico de anillos está compuesto por un conjunto de anillos anidados alrededor de un círculo central. Este círculo simboliza la carpeta raíz del árbol parcial (es decir, la carpeta que el usuario ha seleccionado para la exploración). Cada anillo representa un nivel en el árbol parcial, por lo que las subcarpetas de la carpeta raíz se representarán en el primer anillo y los niveles más profundos del árbol corresponden a los anillos exteriores del gráfico. Cada subcarpeta está representada por un sector del anillo, cuyo ángulo es proporcional al tamaño del contenido de la carpeta, y está pintada de un color diferente para facilitar su visualización. Se pueden dibujar hasta cinco niveles; en caso de que una carpeta de ese último quinto nivel contenga aún más subcarpetas, esta situación será señalada por la presencia de una curva negra cerca del borde del sector del anillo de esa carpeta. Cuando se selecciona una carpeta sin más subcarpetas para que sea la raíz del árbol parcial, solo se dibujará el círculo interior. Cuando el puntero del ratón pase por encima de una de las carpetas del gráfico, la carpeta se destacará y aparecerá un cuadro emergente con información sobre su nombre y tamaño. Si hay alguna subcarpeta, aparecerán pequeños cuadros emergentes en gris, indicando el nombre. Es posible que no se muestren todos los nombres de las subcarpetas, para evitar superposiciones.</para>

    <para lang="en">You can go up and down the rows in the list (optionally 
      expanding those with subfolders), the graphic representation will 
      change using the selected folder as the root of the partial tree 
      to be represented. The folders can also be navigated from the 
      <guilabel>ringschart</guilabel> itself. If you click with the left
      button of your mouse inside a folder, you'll move deeper by 
      setting the root of the graphic to that folder. If you press the 
      middle button (no matter the place as long as you click inside the 
      <guilabel>ringschart</guilabel> frame) you'll get the opposite 
      behavior, going back one step in the hierarchy.</para>

    <para>El porcentaje del radio de la carpeta superior que se usa en una carpeta dada es directamente proporcional a la relación entre su propio tamaño y el de su carpeta superior. Es fácil de entender que el tamaño de una carpeta es igual o menor que el de la carpeta superior. Aunque en esta representación gráfica solo se muestran las carpetas, se tienen en cuenta los archivos para calcular la cantidad de espacio que ocupan las carpetas.</para>
  </sect1>
</article>
