<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="guide" style="task" id="beginner.js" xml:lang="es">
  <info>
    <link type="guide" xref="js#code-samples"/>
    <revision version="0.2" date="2012-06-10" status="draft"/>

    <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>Marta Maria Casetti</name>
      <email its:translate="no">mmcasettii@gmail.com</email>
      <years>2013</years>
    </credit>

    <desc>Una guía para principiantes sobre escribir aplicaciones de GNOME en JavaScript, incluyendo ejemplos de código y ejercicios de práctica.</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 - 2015</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>Tutorial para principiantes y ejemplos de código</title>
<synopsis>
  <p>JavaScript es uno de los lenguajes de programación más populares en la web. Sin embargo, no es sólo para la web. Si tiene aunque sea un conocimiento básico de JavaScript, puede escribir aplicaciones completas para GNOME. Los <link href="https://wiki.gnome.org/Apps/Documents">documentos de GNOME</link> está escritos en JavaScript, y también <link href="https://live.gnome.org/GnomeShell/Tour">GNOME Shell</link>, la parte más básica de GNOME.</p>
  <note style="tip"><p>GNOME Shell es lo que ve cuando pulsa en «Actividades», en la esquina superior izquierda de su pantalla. También controla el reloj y el resto del panel superior. Además de mostrarle cómo escribir aplicaciones de GNOME, estos tutoriales le mostrarán cómo usar JavaScript para escribir extensiones de GNOME Shell, que le añaden características o cambian su comportamiento.</p></note>
</synopsis>

<section id="getting-started">
<title>Inicio</title>
 <p>Estos tutoriales están diseñados para gente que ya sabe cómo programar en JavaScript, y que ya tienen GNOME instalado en sus equipos, pero que están comenzando a desarrollar aplicaciones de GNOME. Si todavía no sabe JavaScript, o si necesita ayuda instalando GNOME, eche un vistazo a estos recursos primero:</p>
<steps>
  <item><p><link href="http://eloquentjavascript.net/contents.html">Eloquent JavaScript</link> es un libro libre, con licencia Creative Commons, que explica los conceptos básicos de programación en JavaScript. Dado que no va a escribir JavaScript para la web, sólo necesitará leer hasta el capítulo 10.</p></item>
  <item><p><link href="http://www.gnome.org/getting-gnome/">Descargue GNOME</link> como parte de una distribución, como Fedora, openSUSE, o Ubuntu. Cada distribución tiene sus propias instrucciones para obtener GNOME.</p></item>
  <item><p><link xref="set-up-gedit.js">Configurar gedit</link> para escribir aplicaciones. El editor de texto de GNOME, gedit, a veces solo se llama «editor de texto».</p></item>
</steps>
</section>


<section id="tutorials">
<title>Tutoriales</title>
</section>

<section id="samples">
<title>Ejemplos de código</title>
  <p>Estos ejemplos muestran cómo usar widgets en sus aplicaciones de GNOME. Cada uno demuestra una aplicación completa que exhibe el widget presentado. Al final de cada ejemplo, encontrará enlaces a material de referencia más detallado.</p>
  <p>Para ejecutar los ejemplos de código:</p>
  <steps>
    <item><p>Copie y pegue el código en <var>nombre_archivo</var>.js</p></item>
    <item><p>Escriba en la terminal:</p>
          <screen>gjs <var>nombre_archivo</var>.js</screen></item>
  </steps>

  <section id="windows" style="2column"><title>Ventanas</title>
  </section>
  <section id="display-widgets" style="2column"><title>Widgets de visualización</title>
  </section>
  <section id="buttons" style="2column"><title>Botones y casillas</title>
  </section>
  <section id="entry" style="2column"><title>Entrada de daos numérica y de texto</title>
  </section>
  <section id="multiline" style="2column"><title>Editor de texto multilínea</title>
  </section>
  <section id="menu-combo-toolbar" style="2column"><title>Widgets de menú, caja combinada y barra de herramientas</title>
  </section>
  <section id="treeview" style="2column"><title>Widget TreeView</title>
  </section>
  <section id="selectors"><title>Selectores</title>
    <section id="file-selectors"><title>Selectores de archivos</title>
    </section>
    <section id="font-selectors"><title>Selectores de tipografías</title>
    </section>
    <section id="color-selectors"><title>Selectores de color</title>
    </section>
  </section>
  <section id="layout" style="2column"><title>Contenedores de la distribución</title>
  </section>
  <section id="ornaments" style="2column"><title>Adornos</title>
  </section>
  <section id="scrolling" style="2column"><title>Desplazamiento</title>
  </section>
  <section id="misc" style="2column"><title>Varios</title>
  </section>
</section>

<section id="exercises">
<title>Ejercicios</title>
</section>
</page>
