<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:e="http://projectmallard.org/experimental/" type="guide" style="task" id="tutorial.py" xml:lang="gl">

<info>
  <title type="text">Titorial para principantes (Python)</title>
  <link type="guide" xref="py"/>
  <revision version="0.1" date="2012-07-31" status="draft"/>

  <desc>Un titorial para principiantes que queren aprender como programar interfaces de usuario GTK+ empregando Python.</desc>
  <credit type="author copyright">
    <name>Tiffany Antopolski</name>
    <email>tiffany.antopolski@gmail.com</email>
    <years>2012</years>
  </credit>
  <credit type="author copyright">
    <name>Marta Maria Casetti</name>
    <email>mmcasetti@gmail.com</email>
    <years>2012</years>
  </credit>
</info>

<title>0. Titorial para principiantes</title>

<synopsis>
 <p>Seguindo estes titoriais aprenderá as bases para programar interfaces de usuario empregando Gtk+.</p>

 <p>If you have never programmed before, or are not familiar with the concepts of object oriented programming, you may need to learn a few basics first.  The book <link href="http://learnpythonthehardway.org/book/">Learn Python the Hard Way</link> or <link href="http://docs.python.org/tutorial/index.html">The Python Tutorial</link> may be a better place for you to start. You may also be interested in <link href="http://python-gtk-3-tutorial.readthedocs.org/en/latest/index.html">The Python GTK+ 3 Tutorial</link>. Once you master the basics, be sure to come back and check out these tutorials.</p>
</synopsis>

<links type="section"/>

<section id="to-run">
<title>Para executar os exemplos de código</title>

  <p>Para executar os exemplos de código</p>
  <steps>
    <item><p>Copie e pegue o código en <var>nomedeficheiro</var>.py</p></item>
    <item><p>Escriba no terminal</p>
          <screen>python <var>nomeficheiro</var>.py</screen>
    </item>
  </steps>
</section>

<section id="widgets">
<title>Unha ruta aos widgets</title>
<steps>
  <title>Titorial</title>
  <item><steps>
    <title>Xanela básica</title>
    <item><p><link xref="window.py"/></p></item>
    <item><p><link xref="GtkApplicationWindow.py"/></p></item>
  </steps></item>
  <item><steps>
    <title>Imaxes e etiquetas</title>
    <item><p><link xref="image.py"/></p></item>
    <item><p><link xref="label.py"/></p></item>
  </steps></item>
  <item><steps>
    <title>Grade</title>
    <item><p><link xref="grid.py"/></p></item>
  </steps></item>
  <item><steps>
    <title>Adornos</title>
    <item><p><link xref="separator.py"/></p></item>
  </steps></item>
  <item><steps>
    <title>Botóns básicos</title>
    <item><p><link xref="button.py"/></p></item>
    <item><p><link xref="linkbutton.py"/></p></item>
    <item><p><link xref="checkbutton.py"/></p></item>
    <item><p><link xref="togglebutton.py"/></p></item>
    <item><p><link xref="switch.py"/></p></item>
    <item><p><link xref="radiobutton.py"/></p></item>
  </steps></item>
  <item><steps>
    <title>Outros widgets de visualización</title>
    <item><p><link xref="statusbar.py"/></p></item>
    <item><p><link xref="spinner.py"/></p></item>
    <item><p><link xref="progressbar.py"/></p></item>
  </steps></item>
  <item><steps>
    <title>Entry widgets (with a detour on basic scrolling)</title>
    <item><p><link xref="spinbutton.py"/></p></item>
    <item><p><link xref="entry.py"/></p></item>
    <item><p><link xref="scrolledwindow.py"/></p></item>
    <item><p><link xref="textview.py"/></p></item>
    <item><p><link xref="scale.py"/></p></item>
  </steps></item>
  <item><steps>
    <title>Diálogos</title>
    <item><p><link xref="dialog.py"/></p></item>
    <item><p><link xref="aboutdialog.py"/></p></item>
    <item><p><link xref="messagedialog.py"/></p></item>
  </steps></item>
  <item><steps>
    <title>TreeViews e ComboBoxes (usando o deseño M/V/C)</title>
    <item><p><link xref="combobox.py"/></p></item>
    <item><p><link xref="combobox_multicolumn.py"/></p></item>
    <item><p><link xref="treeview_simple_liststore.py"/></p></item>
    <item><p><link xref="treeview_advanced_liststore.py"/></p></item>
    <item><p><link xref="treeview_treestore.py"/></p></item>
    <item><p><link xref="treeview_cellrenderertoggle.py"/></p></item>
  </steps></item>
  <item><steps>
    <title>Menús e barras de ferramentas (tamén: usando Glade)</title>
    <item><p><link xref="gmenu.py"/></p></item>
    <item><p><link xref="toolbar.py"/></p></item>
    <item><p><link xref="toolbar_builder.py"/></p></item>
    <item><p><link xref="menubar.py"/></p></item>
    <item><p><link xref="menubutton.py"/></p></item>
  </steps></item>
  <item><steps>
    <title>Selectores (un resumo)</title>
    <item><p><link xref="colorbutton.py"/></p></item>
    <item><p><link xref="fontchooserwidget.py"/></p></item>
    <item><p><link xref="filechooserdialog.py"/></p></item>
  </steps></item>
  <item><steps>
    <title>Consello</title>
    <item><p><link xref="tooltip.py"/></p></item>
  </steps></item>
  <item><steps>
    <title>Máis contedores</title>
    <item><p><link xref="paned.py"/></p></item>
    <item><p><link xref="buttonbox.py"/></p></item>
  </steps></item>
  <item><steps>
    <title>Máis desprazamento</title>
    <item><p>"scrollbar.py"</p></item>
  </steps></item>
  <item><steps>
    <title>Widget personalizado</title>
    <item><p>"widget.py"</p></item>
  </steps></item>
</steps>
</section>

<section id="theory">
<title>Algunha teoría para axudarlle</title>

</section>

<section id="exercises">
<title>Exercicios</title>
</section>


</page>
