~ubuntu-branches/ubuntu/quantal/thunar/quantal

« back to all changes in this revision

Viewing changes to docs/manual/html/gl/customizing-thunar.html

  • Committer: Bazaar Package Importer
  • Author(s): Lionel Le Folgoc
  • Date: 2011-01-30 20:05:10 UTC
  • mfrom: (1.1.31 upstream)
  • Revision ID: james.westby@ubuntu.com-20110130200510-r0mwai90pd8in8zr
Tags: 1.2.1-0ubuntu1
New upstream bugfix release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
9
9
Exec=postr %F
10
10
Icon=postr
11
11
Name=Flickr
12
 
MimeType=image/jpeg;</pre><p>Se instala este ficheiro en <code class="filename">~/.local/share/Thunar/sendto/</code> (cree o cartafol se a�nda non existe), o men� <span class="guilabel"><strong>Enviar a</strong></span> dos ficheiros JPEG mostrar� a nova entrada <span class="guilabel"><strong>Flickr</strong></span>, a cal se pode usar para subir imaxes JPEG a Flickr.</p><p>A <a class="ulink" href="http://thunar.xfce.org/pwiki/documentation/sendto_menu" target="_top">Wiki do proxecto Thunar</a> cont�n exemplos adicionais de destinos �tiles para o men� <span class="guilabel"><strong>Enviar a</strong></span>. Vostede � libre de extender a p�xina da Wiki con novos exemplos.</p></div><div class="sect2" title="Miniaturizadores"><div class="titlepage"><div><div><h3 class="title"><a name="thumbnailers"></a>Miniaturizadores</h3></div></div></div><p>Thunar usa pequenas utilidades para crear miniaturas de certos tipos de ficheiros e mostra as miniaturas como vista previa do contido do ficheiro. Estas pequenas ferramentas ch�manse miniaturizadores. Thunar publ�case con miniaturizadores para imaxes e ficheiros de tipo de letra, e usa automaticamente os miniaturizadores instalados por GNOME se se instalou con soporte para <code class="literal">gconf</code>. A�nda as� os usuarios poden estender de xeito din�mico esta funcionalidade b�sica con miniaturizadores para tipos de ficheiros adicionais.</p><p>Se pensa escribir un miniaturizador propio, ten que comezar cun programa que acepte polo menos dous par�metros de li�a de comandos, o ficheiro de entrada, que � do tipo de ficheiro que pensa soportar e mailo ficheiro de sa�da, que � un ficheiro PNG que cumpre o formato especificado no <a class="ulink" href="http://jens.triq.net/thumbnail-spec/creation.html#AEN139" target="_top">Thumbnail Management Standard</a>. Ademais o seu programa tam�n poder�a aceptar o tama�o desexado da miniatura, que � opcional pero moi recomendable. Se escribe un ficheiro de sa�da cun tama�o de imaxe arbitrario, Thunar escalarao posteriormente ao tama�o desexado, o que poder�a producir un resultado menos �ptimo do que se obter�a xerando unha miniatura das dimensi�ns solicitadas.</p><p>Unha vez que a s�a utilidade para xerar miniaturas estea rematada, ter� que rexistrar o seu miniaturizador para que Thunar sexa capaz de localizalo e usalo. Polo tanto todo o que ten que facer � instalar un ficheiro de descrici�n do miniaturizador (un ficheiro <code class="filename">.desktop</code>) nunha das rutas <code class="filename">$XDG_DATA_DIRS/thumbnailers/</code>. Por exemplo se desexa rexistrar o miniaturizador s� para a s�a conta de usuario, pode instalar o ficheiro no cartafol <code class="filename">~/.local/share/thumbnailers/</code>. O <code class="filename">.desktop</code> dos miniaturizadores ten o seguinte formato.</p><div class="sect3" title="Formato do ficheiro de descrici�n do miniaturizador"><div class="titlepage"><div><div><h4 class="title"><a name="thumbnailer-desktop-file-format"></a>Formato do ficheiro de descrici�n do miniaturizador</h4></div></div></div><p>Os ficheiros de descrici�n de miniaturizadores utilizan o <a class="ulink" href="http://standards.freedesktop.org/desktop-entry-spec/latest/" target="_top">Desktop Entry Format</a> cun <code class="literal">Tipo</code> especial <code class="literal">X-Thumbnailer</code> o campo especial <code class="literal">X-Thumbnailer-Exec</code> con novos c�digos de campo. Basicamente un ficheiro de descrici�n de miniaturizador ten o seguinte formato.</p><pre class="programlisting">
 
12
MimeType=image/jpeg;</pre><p>Se instala este ficheiro en <code class="filename">~/.local/share/Thunar/sendto/</code> (cree o cartafol se a�nda non existe), o men� <span class="guilabel"><strong>Enviar a</strong></span> dos ficheiros JPEG mostrar� a nova entrada <span class="guilabel"><strong>Flickr</strong></span>, a cal se pode usar para subir imaxes JPEG a Flickr.</p><p>A <a class="ulink" href="http://thunar.xfce.org/pwiki/documentation/sendto_menu" target="_top">Wiki do proxecto Thunar</a> cont�n exemplos adicionais de destinos �tiles para o men� <span class="guilabel"><strong>Enviar a</strong></span>. Vostede � libre de extender a p�xina da Wiki con novos exemplos.</p></div><div class="sect2" title="Miniaturizadores"><div class="titlepage"><div><div><h3 class="title"><a name="thumbnailers"></a>Miniaturizadores</h3></div></div></div><p>Thunar usa pequenas utilidades para crear miniaturas de certos tipos de ficheiros e mostra as miniaturas como vista previa do contido do ficheiro. Estas pequenas ferramentas ch�manse miniaturizadores. Thunar publ�case con miniaturizadores para imaxes e ficheiros de tipo de letra, e usa automaticamente os miniaturizadores instalados por GNOME se se instalou con soporte para <code class="literal">gconf</code>. A�nda as� os usuarios poden estender de xeito din�mico esta funcionalidade b�sica con miniaturizadores para tipos de ficheiros adicionais.</p><p>Se pensa escribir un miniaturizador propio, ten que comezar cun programa que acepte polo menos dous par�metros de li�a de ordes, o ficheiro de entrada, que � do tipo de ficheiro que pensa soportar e mailo ficheiro de sa�da, que � un ficheiro PNG que cumpre o formato especificado no <a class="ulink" href="http://jens.triq.net/thumbnail-spec/creation.html#AEN139" target="_top">Thumbnail Management Standard</a>. Ademais o seu programa tam�n poder�a aceptar o tama�o desexado da miniatura, que � opcional pero moi recomendable. Se escribe un ficheiro de sa�da cun tama�o de imaxe arbitrario, Thunar escalarao posteriormente ao tama�o desexado, o que poder�a producir un resultado menos �ptimo do que se obter�a xerando unha miniatura das dimensi�ns solicitadas.</p><p>Unha vez que a s�a utilidade para xerar miniaturas estea rematada, ter� que rexistrar o seu miniaturizador para que Thunar sexa capaz de atopalo e usalo. Polo tanto todo o que ten que facer � instalar un ficheiro de descrici�n do miniaturizador (un ficheiro <code class="filename">.desktop</code>) nunha das rutas <code class="filename">$XDG_DATA_DIRS/thumbnailers/</code>. Por exemplo se desexa rexistrar o miniaturizador s� para a s�a conta de usuario, pode instalar o ficheiro no cartafol <code class="filename">~/.local/share/thumbnailers/</code>. O <code class="filename">.desktop</code> dos miniaturizadores ten o seguinte formato.</p><div class="sect3" title="Formato do ficheiro de descrici�n do miniaturizador"><div class="titlepage"><div><div><h4 class="title"><a name="thumbnailer-desktop-file-format"></a>Formato do ficheiro de descrici�n do miniaturizador</h4></div></div></div><p>Os ficheiros de descrici�n de miniaturizadores utilizan o <a class="ulink" href="http://standards.freedesktop.org/desktop-entry-spec/latest/" target="_top">Desktop Entry Format</a> cun <code class="literal">Tipo</code> especial <code class="literal">X-Thumbnailer</code> o campo especial <code class="literal">X-Thumbnailer-Exec</code> con novos c�digos de campo. Basicamente un ficheiro de descrici�n de miniaturizador ten o seguinte formato.</p><pre class="programlisting">
13
13
[Desktop Entry]
14
14
Version=1.0
15
15
Encoding=UTF-8
16
16
Type=X-Thumbnailer
17
17
Name=O seu miniaturizador
18
18
MimeType=tipo-mime-soportado/polo-miniaturizador;
19
 
X-Thumbnailer-Exec=o-seu-miniaturizador %i %o %s</pre><p><code class="literal">Version</code> e <code class="literal">Encoding</code> son obrigatorios debido � Desktop Entry Specification, as� que use os valores que se mostran no exemplo de enriba. O campo <code class="literal">Type</code> debe ter o valor especial <code class="literal">X-Thumbnailer</code>, ou sen�n non se reco�ecer� o seu miniaturizador. O valor <code class="literal">Name</code> describe o seu miniaturizador.</p><p>O campo <code class="literal">X-Thumbnailer-Exec</code> cont�n o comando para executar o seu miniaturizador, e soporta certos c�digos de campo que se substituir�n cando se execute o miniaturizador. Os c�digos de campo reco�ecidos son os seguintes:</p><div class="variablelist"><dl><dt><span class="term"><code class="varname">%i</code></span></dt><dd><p>A ruta local do ficheiro de entrada co que se vai crear unha miniatura. Pode ser unha ruta relativa ao directorio dende o que se chamou ao miniaturizador ou unha ruta absoluta.</p></dd><dt><span class="term"><code class="varname">%o</code></span></dt><dd><p>A ruta local ao ficheiro de sa�da onde se vai almacenar a miniatura xerada. O ficheiro de sa�da debe escribirse como un ficheiro PNG v�lido que cumpra o est�ndar de miniaturas (consulte enriba). Te�a en conta que a ruta poder�a non rematar con <code class="literal">.png</code>, que � importante se invoca certas ferramentas de terceiros.</p></dd><dt><span class="term"><code class="varname">%s</code></span></dt><dd><p>O tama�o desexado en p�xels da miniatura xerada. Este par�metro � opcional.</p></dd><dt><span class="term"><code class="varname">%u</code></span></dt><dd><p>Semellante a <code class="literal">%i</code>, pero substit�ese polo URI do ficheiro, en vez de pola s�a ruta. Isto engadiuse para ter compatibilidade con GNOME.</p></dd><dt><span class="term"><code class="varname">%%</code></span></dt><dd><p>Substituirase cun simple <code class="literal">%</code>.</p></dd></dl></div><p>Ten que inclu�r polo menos <code class="literal">%o</code> e <code class="literal">%i</code> ou <code class="literal">%u</code>, noutro caso o seu miniaturizador ser� in�til.</p><p><code class="literal">MimeType</code> lista os tipos MIME - separados por punto e coma - para os cales o seu miniaturizador � capaz de crear previsualizaci�ns.</p></div><div class="sect3" title="Exemplo de miniaturizador EPS"><div class="titlepage"><div><div><h4 class="title"><a name="eps-thumbnailer-example"></a>Exemplo de miniaturizador EPS</h4></div></div></div><p>Este exemplo demostra como escribir e instalar un novo miniaturizador para os ficheiros <code class="filename">.eps</code>, o cal usa a utilidade <span class="command"><strong>convert</strong></span> que forma parte de ImageMagick. Primeiro comezamos cun simple script que invoca <span class="command"><strong>convert</strong></span> para xerar unha miniatura do tama�o solicitado.</p><pre class="programlisting">
 
19
X-Thumbnailer-Exec=o-seu-miniaturizador %i %o %s</pre><p><code class="literal">Version</code> e <code class="literal">Encoding</code> son obrigatorios debido � Desktop Entry Specification, as� que use os valores que se mostran no exemplo de enriba. O campo <code class="literal">Type</code> debe ter o valor especial <code class="literal">X-Thumbnailer</code>, ou sen�n non se reco�ecer� o seu miniaturizador. O valor <code class="literal">Name</code> describe o seu miniaturizador.</p><p>O campo <code class="literal">X-Thumbnailer-Exec</code> cont�n a orde para executar o seu miniaturizador, e admite certos c�digos de campo que se substituir�n cando se execute o miniaturizador. Os c�digos de campo reco�ecidos son os seguintes:</p><div class="variablelist"><dl><dt><span class="term"><code class="varname">%i</code></span></dt><dd><p>A ruta local do ficheiro de entrada co que se vai crear unha miniatura. Pode ser unha ruta relativa ao directorio dende o que se chamou ao miniaturizador ou unha ruta absoluta.</p></dd><dt><span class="term"><code class="varname">%o</code></span></dt><dd><p>A ruta local ao ficheiro de sa�da onde se vai almacenar a miniatura xerada. O ficheiro de sa�da debe escribirse como un ficheiro PNG v�lido que cumpra o est�ndar de miniaturas (consulte enriba). Te�a en conta que a ruta poder�a non rematar con <code class="literal">.png</code>, que � importante se invoca certas ferramentas de terceiros.</p></dd><dt><span class="term"><code class="varname">%s</code></span></dt><dd><p>O tama�o desexado en p�xels da miniatura xerada. Este par�metro � opcional.</p></dd><dt><span class="term"><code class="varname">%u</code></span></dt><dd><p>Semellante a <code class="literal">%i</code>, pero substit�ese polo URI do ficheiro, en vez de pola s�a ruta. Isto engadiuse para ter compatibilidade con GNOME.</p></dd><dt><span class="term"><code class="varname">%%</code></span></dt><dd><p>Substituirase cun simple <code class="literal">%</code>.</p></dd></dl></div><p>Ten que inclu�r polo menos <code class="literal">%o</code> e <code class="literal">%i</code> ou <code class="literal">%u</code>, noutro caso o seu miniaturizador ser� in�til.</p><p><code class="literal">MimeType</code> lista os tipos MIME - separados por punto e coma - para os cales o seu miniaturizador � capaz de crear previsualizaci�ns.</p></div><div class="sect3" title="Exemplo de miniaturizador EPS"><div class="titlepage"><div><div><h4 class="title"><a name="eps-thumbnailer-example"></a>Exemplo de miniaturizador EPS</h4></div></div></div><p>Este exemplo demostra como escribir e instalar un novo miniaturizador para os ficheiros <code class="filename">.eps</code>, o cal usa a utilidade <span class="command"><strong>convert</strong></span> que forma parte de ImageMagick. Primeiro comezamos cun simple script que invoca <span class="command"><strong>convert</strong></span> para xerar unha miniatura do tama�o solicitado.</p><pre class="programlisting">
20
20
#!/bin/sh
21
21
#
22
22
# eps-thumbnailer - Miniaturizador de exemplo para ficheiros EPS.
24
24
# Modo de uso: esp-thumbnailer ficheiro-eps ficheiro-png tama�o
25
25
#
26
26
 
27
 
# par�metros de li�a de comandos
 
27
# par�metros de li�a de ordes
28
28
ifile=$1
29
29
ofile=$2
30
30
size=$3
42
42
MimeType=image/x-eps;
43
43
X-Thumbnailer-Exec=/usr/local/bin/eps-thumbnailer %i %o %s</pre><p>Este ficheiro debe instalarse en <code class="filename">/usr/local/share/thumbnailers</code> (cree o cartafol se non existe).</p><pre class="screen">
44
44
$ sudo install -d /usr/local/share/thumbnailers
45
 
$ sudo install eps-thumbnailer.desktop /usr/local/share/thumbnailers/eps-thumbnailer.desktop</pre><p>O ficheiro <code class="filename">eps-thumbnailer.desktop</code> usa a clave especial <code class="literal">TryExec</code>, a cal se se especifica menciona un comando que debe estar presente no sistema para que o miniaturizador sexa �til. No noso exemplo o script � in�til se a utilidade <span class="command"><strong>convert</strong></span> non est� presente.</p><p>O �ltimo paso � xerar de novo a cach� do miniaturizador, de forma que Thunar detecte ao miniaturizador. A cach� do miniaturizador est� situada en <code class="filename">$XDG_CACHE_HOME/Thunar/thumbnailers.cache</code> (a menos que o administrador do sistema o cambie, <code class="varname">$XDG_CACHE_HOME</code> apunta ao cartafol <code class="filename">~/.cache/</code>). Thunar xera de novo a cach� dos miniaturizadores periodicamente, pero pode forzar que se xere de novo invocando a utilidade <code class="filename">thunar-vfs-update-thumbnailers-cache-1</code>, que se publica como parte de Thunar. Normalmente a utilidade est� instalada no subcartafol <code class="filename">libexec</code> en do directorio de instalaci�n (<code class="filename">sbin</code> en Debian/Ubuntu). As� que se por exemplo Thunar est� instalado en <code class="filename">/usr</code>, invoque a utilidade do seguinte xeito:</p><pre class="screen">$ /usr/libexec/thunar-vfs-update-thumbnailers-cache-1</pre><p>Pero aseg�rese de que executa o programa ca s�a conta de usuario, e non ca conta do superusuario, xa que a cach� dos miniaturizadores se almacena no seu cartafol persoal, en vez de nun lugar com�n para todo o sistema.</p><p>Agora se Thunar se compilou con soporte para a monitorizaci�n de alteraci�ns nos ficheiros (mediante os servizos FAM ou Gamin), en poucos segundos coller� automaticamente a nova cach� dos miniaturizadores e despois ser� capaz de xerar miniaturas usando os miniaturizadores personalizados. Noutro caso poder�a necesitar reiniciar totalmente Thunar para aplicar os cambios, usando</p><pre class="screen">$ Thunar -q</pre><p>para terminar calquera instancia en execuci�n, e posteriormente reiniciala dende o seu iniciador.</p></div><div class="sect3" title="Limpar as miniaturas"><div class="titlepage"><div><div><h4 class="title"><a name="cleaning-up-thumbnails"></a>Limpar as miniaturas</h4></div></div></div><p>As miniaturas xeradas almac�nanse no cartafol <code class="filename">~/.thumbnails/</code> de acordo co <a class="ulink" href="http://jens.triq.net/thumbnail-spec/index.html" target="_top">Thumbnail Management Standard</a>. Ao probar un novo miniaturizador, poder�a ser �til limpar a cach� de miniaturas usando</p><pre class="screen">$ rm -rf ~/.thumbnails/</pre><p>que tam�n lle dar� alg�n espazo libre no seu cartafol persoal. Xa que toda a informaci�n almacenada neste cartafol se xera automaticamente a partir dos ficheiros do sistema de ficheiros, non perder� ning�n dato importante.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="preferences.html">Anterior</a>�</td><td width="20%" align="center">�</td><td width="40%" align="right">�<a accesskey="n" href="advanced-topics.html">Pr�ximo</a></td></tr><tr><td width="40%" align="left" valign="top">Preferencias da xesti�n de ficheiros�</td><td width="20%" align="center"><a accesskey="h" href="index.html">Inicio</a></td><td width="40%" align="right" valign="top">�Temas avanzados</td></tr></table></div></body></html>
 
45
$ sudo install eps-thumbnailer.desktop /usr/local/share/thumbnailers/eps-thumbnailer.desktop</pre><p>O ficheiro <code class="filename">eps-thumbnailer.desktop</code> usa a clave especial <code class="literal">TryExec</code>, a cal se se especifica menciona unha orde que debe estar presente no sistema para que o miniaturizador sexa �til. No noso exemplo o script � in�til se a utilidade <span class="command"><strong>convert</strong></span> non est� presente.</p><p>O �ltimo paso � xerar de novo a cach� do miniaturizador, de forma que Thunar detecte ao miniaturizador. A cach� do miniaturizador est� situada en <code class="filename">$XDG_CACHE_HOME/Thunar/thumbnailers.cache</code> (a menos que o administrador do sistema o cambie, <code class="varname">$XDG_CACHE_HOME</code> apunta ao cartafol <code class="filename">~/.cache/</code>). Thunar xera de novo a cach� dos miniaturizadores periodicamente, pero pode forzar que se xere de novo invocando a utilidade <code class="filename">thunar-vfs-update-thumbnailers-cache-1</code>, que se publica como parte de Thunar. Normalmente a utilidade est� instalada no subcartafol <code class="filename">libexec</code> en do directorio de instalaci�n (<code class="filename">sbin</code> en Debian/Ubuntu). As� que se por exemplo Thunar est� instalado en <code class="filename">/usr</code>, invoque a utilidade do seguinte xeito:</p><pre class="screen">$ /usr/libexec/thunar-vfs-update-thumbnailers-cache-1</pre><p>Pero aseg�rese de que executa o programa ca s�a conta de usuario, e non ca conta do superusuario, xa que a cach� dos miniaturizadores se almacena no seu cartafol persoal, en vez de nun lugar com�n para todo o sistema.</p><p>Agora se Thunar se compilou con soporte para a monitorizaci�n de alteraci�ns nos ficheiros (mediante os servizos FAM ou Gamin), en poucos segundos coller� automaticamente a nova cach� dos miniaturizadores e despois ser� capaz de xerar miniaturas usando os miniaturizadores personalizados. Noutro caso poder�a necesitar reiniciar totalmente Thunar para aplicar os cambios, usando</p><pre class="screen">$ Thunar -q</pre><p>para terminar calquera instancia en execuci�n, e posteriormente reiniciala dende o seu iniciador.</p></div><div class="sect3" title="Limpar as miniaturas"><div class="titlepage"><div><div><h4 class="title"><a name="cleaning-up-thumbnails"></a>Limpar as miniaturas</h4></div></div></div><p>As miniaturas xeradas almac�nanse no cartafol <code class="filename">~/.thumbnails/</code> de acordo co <a class="ulink" href="http://jens.triq.net/thumbnail-spec/index.html" target="_top">Thumbnail Management Standard</a>. Ao probar un novo miniaturizador, poder�a ser �til limpar a cach� de miniaturas usando</p><pre class="screen">$ rm -rf ~/.thumbnails/</pre><p>que tam�n lle dar� alg�n espazo libre no seu cartafol persoal. Xa que toda a informaci�n almacenada neste cartafol se xera automaticamente a partir dos ficheiros do sistema de ficheiros, non perder� ning�n dato importante.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="preferences.html">Anterior</a>�</td><td width="20%" align="center">�</td><td width="40%" align="right">�<a accesskey="n" href="advanced-topics.html">Pr�ximo</a></td></tr><tr><td width="40%" align="left" valign="top">Preferencias da xesti�n de ficheiros�</td><td width="20%" align="center"><a accesskey="h" href="index.html">Inicio</a></td><td width="40%" align="right" valign="top">�Temas avanzados</td></tr></table></div></body></html>