<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="managing-plugins" xml:lang="es">

  <info>
   <link type="guide" xref="index#usage"/>
   <desc>Usar complementos con <app>Kupfer</app>.</desc>
  </info>

  <title>Cómo configurar los complementos</title>

  <p>La funcionalidad en Kupfer está organizada por módulos de extensiones llamados «complementos». Cada complemento proporciona funcionalidad adicional, por ejemplo, integración con una aplicación externa.</p>

  <section>
    <title>Configurar complementos</title>
    <steps>
      <title>Abra las <app>Preferencias de Kupfer</app> y vaya a la pestaña <em>Complementos</em>.</title>
      <item>
        <p>Use uno de los siguientes métodos:</p>
        <list>
          <item><p>Click the Kupfer icon in the notification area and select
              the item <em>Preferences</em></p>.
          </item>
          <item>
            <p>Busque el objeto<app>Preferencias de Kupfer</app> en el propio Kupfer. Pulse <key>Intro</key> para abrirlo.</p>
          </item>
          <item><p>Use el atajo de teclado <keyseq><key>Ctrl</key><key>;</key></keyseq></p>
          </item>
        </list>
      </item>
      <item>
        <p>Seleccione la solapa <em>Complementos</em>.</p>
      </item>
    </steps>

    <p>Seleccione complementos en la lista para leer sobre ellos, y marque la casilla junto al nombre para activar el complemento, o desmárquela para desactivarlo.</p>
    <p>Si el complemento tiene parámetros configurables, estarán visibles debajo de la información del complemento.</p>
    <p>El complemento <app>Complementos de Kupfer</app> permite un acceso rápido a la información de cada complemento así como la opción «Mostrar código fuente», que muestra su implementación.</p>
  </section>
  <section>
    <title>Si no se puede activar un complemento</title>
      <p>Si un complemento falla al activarlo porque requiere un módulo de software que no está disponible, la información del complemento mostrará un mensaje como este:</p>
      <p><em>Plugin could not be read due to an error:</em>
      </p><p><em>Python module 'gdata' is needed</em></p>
      <p>Esto significa que debe instalar el módulo de Python requerido para su distribución; y posiblemente la documentación del complemento le diga cómo hacerlo.</p>
      <p>El complemento también puede fallar inesperadamente al cargarse, y mostrar un mensaje de error diferente. Puede ser un error de programación, tanto en el complemento como en <app>Kupfer</app>.</p>
  </section>
  
  <section>
    <title>Instalar más complementos</title>
    <p>Puede instalar complementos personalizados en la carpeta <code>~/.local/share/kupfer/plugins</code>. Cada complemento puede ser un único archivo <code>.py</code> o un paquete de Python (una carpeta que directamente contiene un archivo llamado <code>__init__.py</code>). Los complementos en forma de paquete pueden incluir archivos de iconos. Los paquetes de Python también se pueden instalar como archivos <code>.zip</code>.</p>
    <note style="warning">
    <p><em>Precaución:</em> considere los complementos como programas. No instale complementos que no sean de confianza.</p>
    </note>
  </section>

  <section>
    <title>Crear complementos</title>
    <p>La documentación para creadores de complementos está disponible en el archivo <code>Documentation/Manual.rst</code> en la distribución fuente o en la página web <link href="http://kaizer.se/wiki/kupfer/Manual/">Manual de Kupfer</link>. Una manera sencilla de empezar es copiar un complemento existente y experimentar con él.</p>
  </section>
  <section>
    <title>La pestaña <em>Catálogo</em> en «Preferencias»</title>
    <p>Cada complemento puede exportar un número de fuentes que contienen objetos. Normalmente, todos estos objetos son accesibles directamente desde un nivel de búsqueda superior. Algunos complementos exportan muchos objetos o muy especializados que sus catálogos no debería exportar al nivel superior. Para alcanzar esos objetos, primero debe encontrar el catálogo por nombre, y entrar en el catálogo usando la acción <em>Buscar contenido</em>.</p>
    <p>En la pestaña <em>Catálogo</em> en las <app>Preferencias de Kupfer</app>, una casilla marcada junto a cada fuente indica que ese objeto está exportado. Una casilla desmarcada indica que su contenido está oculto desde el nivel superior.</p>
    <p><em>Nota:</em> Kupfer puede ralentizarse si se exportar muchos catálogos grandes al nivel superior.</p>
  </section>
</page>
