<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" xmlns:xi="http://www.w3.org/2001/XInclude" type="guide" style="task" id="hello-world.py" xml:lang="es">

  <info>

  <title type="text">Hola mundo (Python)</title>

    <link type="guide" xref="py#tutorial" group="#first"/>

    <revision version="0.1" date="2013-06-17" status="review"/>

    <credit type="author copyright">

      <name>Susanna Huhtanen</name>

      <email its:translate="no">ihmis.suski@gmail.com</email>

      <years>2012</years>

    </credit>

    <credit type="editor">

      <name>Tiffany Antopolski</name>

      <email its:translate="no">tiffany.antopolski@gmail.com</email>

    </credit>

    <desc>Una aplicación «Hola mundo» básica</desc>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Daniel Mustieles</mal:name>

      <mal:email>daniel.mustieles@gmail.com</mal:email>

      <mal:years>2011 - 2017</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Nicolás Satragno</mal:name>

      <mal:email>nsatragno@gmail.com</mal:email>

      <mal:years>2012 - 2013</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Jorge González</mal:name>

      <mal:email>jorgegonz@svn.gnome.org</mal:email>

      <mal:years>2011</mal:years>

    </mal:credit>

  </info>

  <title>Cómo construir, instalar y crear un <file>tar.xz</file> de un programa Hola mundo</title>

    <media type="image" mime="image/png" style="floatend" src="media/hello-world.png"/>

    <synopsis>

      
Este tutorial le demostrará cómo:

      <list style="numbered">

        <item>
crear una pequeña aplicación «Hola, mundo» usando Python y GTK+
</item>

        <item>
hacer el archivo <file>.desktop</file>
</item>

        <item>
configurar el sistema de construcción
</item>

      </list>

    </synopsis>

  <links type="section"/>

  <section id="HelloWorld"><title>Crear el programa</title>

    <links type="section"/>

    <section id="imports"><title>Bibliotecas que importar</title>

      from gi.repository import Gtk

import sys

      
Para que su script funcione con GNOME, se deben importar las bibliotecas de GNOME mediante introspección de GObject. En este caso, se están importando las vinculaciones de lenguaje y GTK+, la biblioteca que contiene los widgets gráficos usados para crear aplicaciones de GNOME.

    </section>

    <section id="mainwindow"><title>Crear la ventana principal de la aplicación</title>

      class MyWindow(Gtk.ApplicationWindow):

    # constructor for a Gtk.ApplicationWindow

    def __init__(self, app):

        Gtk.Window.__init__(self, title="Hello World!", application=app)

        self.set_default_size(200, 100)

class MyApplication(Gtk.Application):

    def __init__(self):

        Gtk.Application.__init__(self)

    def do_activate(self):

        win = MyWindow(self)

        win.show_all()

    def do_startup(self):

        Gtk.Application.do_startup(self)

    
«Gtk.Application» inicializa GTK+. También conecta el botón <gui>x</gui>, que se genera automáticamente junto con la ventana, a la señal «destroy».

    
Se puede empezar a construir la primera ventana. Esto se hace creando una clase llamada MyWindow y asignándole una «Gtk.ApplicationWindow».

    
Se le asignara una propiedad llamada title. El título puede ser la cadena que quiera pero, para estar seguro, es conveniente que tenga una codificación UTF-8.

    
Ya tiene una ventana que contiene un título y un botón «cerrar» que funciona. Ahora, añada el texto «Hola mundo».

    </section>

    <section id="label"><title>Etiqueta para la ventana</title>

      # Add a label widget to your window

        # create a label

        label = Gtk.Label()

        # set the text of the label

        label.set_text("Hello GNOME!")

        # add the label to the window

        self.add(label)

      
Una etiqueta de texto es uno de los widgets de GTK+ que puede usar si importó la biblioteca GTK+. Para usarlo, cree una variable nueva llamada label y establezca el texto que la etiqueta contendrá. Finalmente, se crea y ejecuta la aplicación:

      #run the application

app = MyApplication()

exit_status = app.run(sys.argv)

sys.exit(exit_status)

      
«Gtk.ApplicationWindow» sólo puede contener un widget a la vez. Para construir programas más elaborados necesita crear un widget contenedor como «Gtk.Grid» dentro de la ventana, y después añadirle los otros.

   </section>

    <section id="py"><title>hola-mundo.py</title>

      
El archivo completo:

      from gi.repository import Gtk

import sys

class MyWindow(Gtk.ApplicationWindow):

    # constructor for a Gtk.ApplicationWindow

    def __init__(self, app):

        Gtk.Window.__init__(self, title="Welcome to GNOME", application=app)

        self.set_default_size(200, 100)

        # create a label

        label = Gtk.Label()

        # set the text of the label

        label.set_text("Hello GNOME!")

        # add the label to the window

        self.add(label)

class MyApplication(Gtk.Application):

    def __init__(self):

        Gtk.Application.__init__(self)

    def do_activate(self):

        win = MyWindow(self)

        win.show_all()

    def do_startup(self):

        Gtk.Application.do_startup(self)

app = MyApplication()

exit_status = app.run(sys.argv)

sys.exit(exit_status)

    </section>

    <section id="terminal"><title>Ejecutar la aplicación desde la terminal</title>

      
Para ejecutar esta aplicación, primero guárdela como hello-world.py. Luego, vaya a la carpeta donde está la aplicación.

      <screen><output style="prompt">$ </output><input>python hola-mundo.py</input></screen>

    </section>

  </section>

  <section id="desktop.in"><title>El archivo <file>.desktop.in</file></title>

      
Ejecutar aplicaciones desde la terminal es útil al principio del proceso de crear la aplicación. Para tener una <link href="https://developer.gnome.org/integration-guide/stable/mime.html.en">integración con la aplicación</link> completa en GNOME 3, se necesita un lanzador en el escritorio. Para esto, necesita crear un archivo <file>.desktop</file>. El archivo «.desktop» describe el nombre de la aplicación, el icono que usa y varios campos de integración. Puede encontrar una descripción de los archivos <file>.desktop</file> <link href="http://developer.gnome.org/desktop-entry-spec/">aquí</link>. El archivo <file>.desktop.in</file> creará el <file>.desktop</file>.

    
El ejemplo muestra los requerimientos mínimos de un archivo .desktop.in.

    [Desktop Entry]

Version=1.0

Encoding=UTF-8

Name=Hello World

Comment=Say Hello

Exec=@prefix@/bin/hello-world

Icon=application-default-icon

Terminal=false

Type=Application

StartupNotify=true

Categories=GNOME;GTK;Utility;

    
Ahora se verán algunas partes del archivo .desktop.in.

    <terms>

      <item><title>Name</title>
El nombre de la aplicación.
</item>

      <item><title>Comment</title>
Una descripción corta de la aplicación.
</item>

      <item><title>Exec</title>
Especifica un comando que ejecutar cuando se elige la aplicación en el menú. En este ejemplo, «exec» sólo indica dónde encontrar el archivo hello-world y el archivo se hace cargo del resto.
</item>

      <item><title>Terminal</title>
Especifica si el comando del campo «Exec» se ejecuta en una ventana de la terminal.
</item>

    </terms>

    
Para incluir su aplicación en la categoría correcta, debe añadir las categorías necesarias a la línea «Categories». Puede encontrar más información sobre las distintas categorías en la <link href="http://standards.freedesktop.org/menu-spec/latest/apa.html">especificación del menú</link>.

    
En este ejemplo se ha usado un icono existente. Para usar un icono personalizado, necesita un archivo «.svg» con su icono guardado en <file>/usr/share/icons/hicolor/scalable/apps</file>. Escriba el nombre del archivo del icono en el archivo «.desktop.in», en la línea 7. Puede obtener más información sobre los iconos en <link href="http://freedesktop.org/wiki/Specifications/icon-theme-spec">Instalar iconos para temas</link>, <link href="https://live.gnome.org/GnomeGoals/AppIcon">Instalar iconos para temas</link> y en <link href="http://freedesktop.org/wiki/Specifications/icon-theme-spec">freedesktop.org: especificaciones/icon-theme-spec</link>.

  </section>

  <section id="autotools"><title>El sistema de construcción</title>

    
Para que su aplicación forme parte realmente del sistema GNOME 3 debe instalarla con la ayuda de autotools. La construcción autotools instalará todos los archivos necesarios en las ubicaciones correctas.

    
Para esto deberá tener los siguientes archivos:

    <links type="section"/>

      <section id="autogen"><title>autogen.sh</title>

        #!/bin/sh

set -e

test -n "$srcdir" || srcdir=`dirname "$0"`

test -n "$srcdir" || srcdir=.

olddir=`pwd`

cd "$srcdir"

# This will run autoconf, automake, etc. for us

autoreconf --force --install

cd "$olddir"

if test -z "$NOCONFIGURE"; then

  "$srcdir"/configure "$@"

fi

      
Una vez que el archivo <file>autogen.sh</file> esté listo y guardado, ejecute:

      <screen><output style="prompt">$ </output><input>chmod +x autogen.sh</input></screen>

    </section>

    <section id="makefile"><title>Makefile.am</title>

      # The actual runnable program is set to the SCRIPTS primitive.

# # Prefix bin_ tells where to copy this

bin_SCRIPTS = hello-world.py

# # List of files to be distributed

EXTRA_DIST=  \

	$(bin_SCRIPTS)

#

#     # The desktop files

desktopdir = $(datadir)/applications

desktop_DATA = \

	hello-world.desktop

    </section>

    <section id="configure"><title>configure.ac</title>

      # This file is processed by autoconf to create a configure script

AC_INIT([Hello World], 1.0)

AM_INIT_AUTOMAKE([1.10 no-define foreign dist-xz no-dist-gzip])

AC_CONFIG_FILES([Makefile hello-world.desktop])

AC_OUTPUT

    </section>

    <section id="readme"><title>README</title>

       
Información que los usuarios deben leer primero. Este archivo puede estar vacío.

       
Cuando tenga los archivos <file>hello-world</file>, <file>hello-world.desktop.in</file>, <file>Makefile.am</file>, <file>configure.ac</file> y <file>autogen.sh</file> con la información y los permisos correctos, el archivo <file>README</file> puede incluir las siguientes instrucciones:

      Para construir e instalar este programa:

./autogen.sh --prefix=/home/usuario/.local

make install

-------------

Al ejecutar la primera línea se crean los siguientes archivos:

aclocal.m4

autom4te.cache

config.log

config.status

configure

helloWorld.desktop

install-sh

missing

Makefile.in

Makefile

Al ejecutar «make install», se instala la aplicación en /home/usuario/.local/bin

y se instala el archivo helloWorld.desktop en /home/usuario/.local/share/applications

Ahora puede ejecutar la aplicación escribiendo «Hello World» en la vista general.

----------------

Para desinstalarla, escriba:

make uninstall

----------------

Para crear un archivador tar escriba:

make distcheck

Esto creará el archivo hello-world-1.0.tar.xz

    </section>

  </section>

</page>