Development/Tutorials/Plasma4/ComicPlugin (es): Difference between revisions

    From KDE TechBase
    (started translating)
     
    (Another section translated)
    Line 26: Line 26:


    La idea es que el identificador debería ser suficiente para conseguir un comic específico, por ejemplo ''"xkcd:100"''. La primera parte dice qué plugin debe cargarse y la segunda parte le dice a tu plugin que comic cargar. Tu plugin no recibirá más información del motor de datos que eso.
    La idea es que el identificador debería ser suficiente para conseguir un comic específico, por ejemplo ''"xkcd:100"''. La primera parte dice qué plugin debe cargarse y la segunda parte le dice a tu plugin que comic cargar. Tu plugin no recibirá más información del motor de datos que eso.
    ==Estructura del paquete==
    Los plugins de comic se proveen como paquetes que se pueden subir a www.kde-files.org y se pueden descargar directamente desde el plasmoid.
    Primero, crea una carpeta donde vayas a trabajar. Necesitas una estructura así:
    *./metadata.desktop
    *./icon.png
    *./contents/code/main.es
    Después, necesitas poner los archivos en un paquete ".comic", que es un archivo zip. Puedes hacer esto con el comando:
    zip -r mi_comic.comic contents/code/main.es metadata.desktop
    donde "mi_comic" es el nombre del comic que quieres agregar.
    ==El archivo metadata.desktop==
    Cada plugin de comic necesita un archivo metadata.desktop como el siguiente:
    <code ini>
    [Desktop Entry]
    Name=Mi Comic
    Comment=Mi Comic
    Type=Service
    X-KDE-ServiceTypes=Plasma/Comic
    Icon=icon.png
    X-KDE-Library=plasma_comic_krossprovider
    X-KDE-PluginInfo-Author=Tu nombre
    X-KDE-PluginInfo-Email=Tu dirección de email
    X-KDE-PluginInfo-Name=mi_comic
    X-KDE-PluginInfo-Version=0.1
    X-KDE-PluginInfo-Website=http://plasma.kde.org/
    X-KDE-PluginInfo-License=GPLv2
    X-KDE-PluginInfo-EnabledByDefault=true
    X-KDE-PlasmaComicProvider-SuffixType=Date
    </code>
    En las líneas "Name" y "Comment", agrega el nombre del comic que quieres agregar. Aparecerá en la lista de comics con ese nombre (eso no es el diálogo de "Obtener cómics nuevos..."). También puedes poner el nombre del comic en varios idiomas. Por ejemplo:
    <code ini>
    Name=My Comic
    Comment=My Comic
    Name[es]=Mi Comic
    Comment[es]=Mi Comic
    Name[de]=Mein Comic
    Comment[de]=Mein Comic
    </code>
    Sólo necesitas "Icon" si tienes un icono para tu comic -- como un favicon -- y lo quieres agregar. En este ejemplo, el archivo se llama "icon.png".
    '''X-KDE-PluginInfo-Name''' es muy importante, ya que es el nombre de tu plugin. El motor de datos de comic usará este nombre para identificar qué plugin debe cargarse. Ese nombre tambpen se usa si pruebas tu plugin con ''plasmaengineexplorer''. No se permiten espacios en el nombre.
    '''X-KDE-PlasmaComicProvider-SuffixType''' es el tipo de comic, como se dijo en la sección anterior ('date', 'number', o 'string').

    Revision as of 02:02, 31 October 2009


    Development/Tutorials/Plasma/ComicPlugin


    [esta traducción está en progreso]

    Abstracto

    Este tutorial describirá cómo crear tu propio plugin ("Agregar comics") para el plasmoid de Tira de cómic. Necesitas al menos KDE 4.2 para crear plugins.

    En general, puedes crear plugins en cualquier lenguaje soportado por Kross, aunque este tutorial se focaliza en QtScript (JavaScript, ECMAScript), ya que es soportado por cualquier instalación de KDE.

    No necesitas tener experiencia en QtScript para escribir plugins de comics, frecuentemente es suficiente adaptar plugins existentes. Pero en cualquier caso, http://www.w3schools.com/JS/default.asp (en inglés) es una buena referencia y tutorial para Javascript.

    Ten en cuenta que no muestra todas las características soportadas, por el momento.

    Tipos de comics

    El motor de datos de comic soporta tres tipos de comics.

    1. date (fecha)
    2. number (número)
    3. string (cadena)

    Esa es la manera en que los comics se identifican, como "garfield:2000-01-01" para 'date' o "xkcd:100" para 'number'. 'string' podría ser cualquier cosa.

    A veces el sitio web donde se publica tu comic no tiene una forma fácil de conseguir una fecha o un número para cada comic, o da uno que no ayuda a acceder a un comic específico. En ese caso deberías usar 'string'.

    La idea es que el identificador debería ser suficiente para conseguir un comic específico, por ejemplo "xkcd:100". La primera parte dice qué plugin debe cargarse y la segunda parte le dice a tu plugin que comic cargar. Tu plugin no recibirá más información del motor de datos que eso.

    Estructura del paquete

    Los plugins de comic se proveen como paquetes que se pueden subir a www.kde-files.org y se pueden descargar directamente desde el plasmoid.

    Primero, crea una carpeta donde vayas a trabajar. Necesitas una estructura así:

    • ./metadata.desktop
    • ./icon.png
    • ./contents/code/main.es

    Después, necesitas poner los archivos en un paquete ".comic", que es un archivo zip. Puedes hacer esto con el comando:

    zip -r mi_comic.comic contents/code/main.es metadata.desktop

    donde "mi_comic" es el nombre del comic que quieres agregar.

    El archivo metadata.desktop

    Cada plugin de comic necesita un archivo metadata.desktop como el siguiente:

    [Desktop Entry] Name=Mi Comic Comment=Mi Comic Type=Service X-KDE-ServiceTypes=Plasma/Comic Icon=icon.png

    X-KDE-Library=plasma_comic_krossprovider X-KDE-PluginInfo-Author=Tu nombre X-KDE-PluginInfo-Email=Tu dirección de email X-KDE-PluginInfo-Name=mi_comic X-KDE-PluginInfo-Version=0.1 X-KDE-PluginInfo-Website=http://plasma.kde.org/ X-KDE-PluginInfo-License=GPLv2 X-KDE-PluginInfo-EnabledByDefault=true X-KDE-PlasmaComicProvider-SuffixType=Date

    En las líneas "Name" y "Comment", agrega el nombre del comic que quieres agregar. Aparecerá en la lista de comics con ese nombre (eso no es el diálogo de "Obtener cómics nuevos..."). También puedes poner el nombre del comic en varios idiomas. Por ejemplo:

    Name=My Comic Comment=My Comic Name[es]=Mi Comic Comment[es]=Mi Comic Name[de]=Mein Comic Comment[de]=Mein Comic

    Sólo necesitas "Icon" si tienes un icono para tu comic -- como un favicon -- y lo quieres agregar. En este ejemplo, el archivo se llama "icon.png".

    X-KDE-PluginInfo-Name es muy importante, ya que es el nombre de tu plugin. El motor de datos de comic usará este nombre para identificar qué plugin debe cargarse. Ese nombre tambpen se usa si pruebas tu plugin con plasmaengineexplorer. No se permiten espacios en el nombre.

    X-KDE-PlasmaComicProvider-SuffixType es el tipo de comic, como se dijo en la sección anterior ('date', 'number', o 'string').