<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" xmlns:e="http://projectmallard.org/experimental/" type="guide" style="task" id="tutorial.py" xml:lang="es">

<info>

  <title type="text">Tutorial para principiantes (Python)</title>

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

  <revision pkgversion="3.8" date="2013-02-25" status="draft"/>

  <desc>Un tutorial para principiantes que quieran aprender cómo programar IGU usando GTK+ en Python.</desc>

  <credit type="author copyright">

    <name>Tiffany Antopolski</name>

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

    <years>2012</years>

  </credit>

  <credit type="author copyright">

    <name>Marta Maria Casetti</name>

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

    <years>2012 2013</years>

  </credit>

  <credit type="editor author">

    <name>Jim Campbell</name>

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

    <years>2013</years>

  </credit>

    <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>Tutoriales para principiantes</title>

<synopsis>

 
Siguiendo estos tutoriales, aprenderá los conceptos básicos de la programación de interfaces de usuario usando GTK+ en Python.

 
Si nunca antes ha programado, o no está familiarizado con los conceptos de la programación orientada a objetos, puede necesitar aprender primero unos conceptos básicos. El libro <link href="http://learnpythonthehardway.org/book/">Learn Python the Hard Way</link> o <link href="http://docs.python.org/tutorial/index.html">The Python Tutorial</link> pueden ser un buen comienzo. Tal vez también esté interesado en <link href="http://python-gtk-3-tutorial.readthedocs.org/en/latest/index.html">The Python GTK+ 3 Tutorial</link>. Una vez que domine los conceptos básicos, vuelva y revise estos tutoriales.

</synopsis>

<links type="section"/>

<section id="to-run">

<title>Para ejecutar los ejemplos de código</title>

  
Para ejecutar los ejemplos de código en el tutorial:

  <steps>

    <item>
Escriba o copie y pegue el código en un archivo, y guárdelo con un nombre como nombre_archivo.py
</item>

    <item>
Para ejecutar el código, escriba en la terminal:

          <screen>python nombre_archivo.py</screen>

    </item>

  </steps>

  
Después de ejecutar el código, verá un widget en su pantalla, o (si ha escrito mal algo) un mensaje de error que le ayudará a identificar el problema.

</section>

<section id="widgets">

<title>Un camino a través de los widgets (con algo de teoría)</title>

El tutorial le llevará a través de ejemplos cada vez más complejos y teoría de programación, pero también puede ir directamente el tutorial que crea que le ayudará más.

<steps>

  <title>Tutorial</title>

  <item><steps>

    <title>Ventanas básicas</title>

    <item>
<link xref="window.py"/>
</item>

    <item>
<link xref="GtkApplicationWindow.py"/>
</item>

  </steps></item>

  <item><steps>

    <title>Imágenes y etiquetas</title>

    <item>
<link xref="image.py"/>
</item>

    <item>
<link xref="strings.py"/>
</item>

    <item>
<link xref="label.py"/>
</item>

  </steps></item>

  <item><steps>

    <title>Introducción a las propiedades</title>

    <item>
<link xref="properties.py"/>
</item>

  </steps></item>

  <item><steps>

    <title>Rejilla, separador y deslizamiento</title>

    <item>
<link xref="grid.py"/>
</item>

    <item>
<link xref="separator.py"/>
</item>

    <item>
<link xref="scrolledwindow.py"/>
</item>

    <item>
<link xref="paned.py"/>
</item>

  </steps></item>

  <item><steps>

    <title>Señales, retornos de llamada y botones</title>   

    <item>
<link xref="signals-callbacks.py"/>
</item>

    <item>
<link xref="button.py"/>
</item>

    <item>
<link xref="linkbutton.py"/>
</item>

    <item>
<link xref="checkbutton.py"/>
</item>

    <item>
<link xref="togglebutton.py"/>
</item>

    <item>
<link xref="switch.py"/>
</item>

    <item>
<link xref="radiobutton.py"/>
</item>

  </steps></item>

  <item><steps>

    <title>Botonera</title>

    <item>
<link xref="buttonbox.py"/>
</item>

  </steps></item>

  <item><steps>

    <title>Otros widgets de visualización</title>

    <item>
<link xref="statusbar.py"/>
</item>

    <item>
<link xref="spinner.py"/>
</item>

    <item>
<link xref="progressbar.py"/>
</item>

  </steps></item>

  <item><steps>

    <title>Widgets de entrada</title>

    <item>
<link xref="spinbutton.py"/>
</item>

    <item>
<link xref="entry.py"/>
</item>

    <item>
<link xref="scale.py"/>
</item>

  </steps></item>

  <item><steps>

    <title>Un widget para escribir y mostrar texto</title>

    <item>
<link xref="textview.py"/>
</item>

  </steps></item>

  <item><steps>

    <title>Diálogos</title>

    <item>
<link xref="dialog.py"/>
</item>

    <item>
<link xref="aboutdialog.py"/>
</item>

    <item>
<link xref="messagedialog.py"/>
</item>

  </steps></item>

  <item><steps>

    <title>Menús, barras de herramientas y consejos (también: usar Glade y GtkBuilder)</title>

    <item>
<link xref="gmenu.py"/>
</item>

    <item>
<link xref="menubutton.py"/>
</item>

    <item>
<link xref="toolbar.py"/>
</item>

    <item>
<link xref="tooltip.py"/>
</item>

    <item>
<link xref="toolbar_builder.py"/>
</item>

    <item>
<link xref="menubar.py"/>
</item>

  </steps></item>

  <item><steps>

    <title>Selectores</title>

    <item>
<link xref="colorbutton.py"/>
</item>

    <item>
<link xref="fontchooserwidget.py"/>
</item>

    <item>
<link xref="filechooserdialog.py"/>
</item>

  </steps></item>

  <item><steps>

    <title>TreeViews y ComboBoxes (usando el diseño M/V/C)</title>

    <item>
<link xref="combobox.py"/>
</item>

    <item>
<link xref="treeview_simple_liststore.py"/>
</item>

    <item>
<link xref="treeview_treestore.py"/>
</item>

    <item>
<link xref="model-view-controller.py"/>
</item>

    <item>
<link xref="combobox_multicolumn.py"/>
</item>

    <item>
<link xref="treeview_advanced_liststore.py"/>
</item>

    <item>
<link xref="treeview_cellrenderertoggle.py"/>
</item>

  </steps></item>

  <item><steps>

    <title>Widget personalizado</title>

    <item>
<link xref="widget_drawing.py"/>
</item>

  </steps></item>

</steps>

</section>

</page>