<?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="fr">
  <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>Un guide pour débuter la programmation d'applications GNOME en JavaScript, incluant des exemples de code et des exercices pratiques.</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Luc Rebert,</mal:name>
      <mal:email>traduc@rebert.name</mal:email>
      <mal:years>2011</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Alain Lojewski,</mal:name>
      <mal:email>allomervan@gmail.com</mal:email>
      <mal:years>2011-2012</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Luc Pionchon</mal:name>
      <mal:email>pionchon.luc@gmail.com</mal:email>
      <mal:years>2011</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Bruno Brouard</mal:name>
      <mal:email>annoa.b@gmail.com</mal:email>
      <mal:years>2011-12</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Luis Menina</mal:name>
      <mal:email>liberforce@freeside.fr</mal:email>
      <mal:years>2014</mal:years>
    </mal:credit>
  </info>

  <title>Tutoriel pour débutants et exemples de code</title>
<synopsis>
  <p>JavaScript is one of the most popular programming languages on the web. It's not just for the web, though. If you have even a basic understanding of JavaScript, you can write full-fledged applications for GNOME. <link href="https://wiki.gnome.org/Apps/Documents">GNOME Documents</link> is written in JavaScript, and so is <link href="https://live.gnome.org/GnomeShell/Tour">GNOME Shell</link>, the most basic part of GNOME.</p>
  <note style="tip"><p>GNOME Shell est le bureau qui s'affiche quand vous cliquez sur « Activités » dans le coin supérieur gauche de votre écran. Il contrôle aussi l'horloge et toute la barre supérieure. En plus de vous guider dans la programmation d'applications GNOME, ces tutoriels vont aussi vous montrer comment utiliser JavaScript pour programmer des extensions pour GNOME Shell, afin de lui apporter de nouvelles fonctionnalités ou modifier son comportement.</p></note>
</synopsis>

<section id="getting-started">
<title>Premiers pas</title>
 <p>Ces tutoriels sont destinés à des personnes ayant déjà des connaissances en JavaScript et qui ont déjà installé GNOME comme interface de bureau sur leur ordinateur, mais qui n'ont encore jamais développé d'application GNOME. Si vous n'avez pas de connaissance en JavaScript, ou si vous avez besoin d'aide pour installer GNOME, consultez d'abord ces ressources :</p>
<steps>
  <item><p><link href="http://eloquentjavascript.net/contents.html">Eloquent JavaScript</link> est un livre gratuit, sous licence Creative Commons et qui explique les bases de la programmation en JavaScript. Comme vous n'allez pas programmer en JavaScript pour le Web, il vous suffit de lire jusqu'au chapitre 10 environ.</p></item>
  <item><p><link href="http://www.gnome.org/getting-gnome/">Procurez-vous GNOME</link> pour une distribution, comme Fedora, openSUSE ou Ubuntu. Chaque distribution possède son propre moyen d'installer GNOME.</p></item>
  <item><p><link xref="set-up-gedit.js">Configurer Gedit</link> pour écrire des applications. Gedit est l'éditeur de texte de GNOME et parfois simplement appelé « éditeur de texte ».</p></item>
</steps>
</section>


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

<section id="samples">
<title>Exemples de code</title>
  <p>Ces exemples montrent la manière d'utiliser des éléments graphiques dans vos applications GNOME. Chacun d'eux fait la démonstration d'une application complète mettant en valeur un composant graphique en particulier. À la fin de chaque exemple, vous trouverez des liens vers de plus amples informations.</p>
  <p>Pour exécuter les exemples de code :</p>
  <steps>
    <item><p>Copiez puis collez le code dans <var>nomdufichier</var>.js</p></item>
    <item><p>Saisissez dans le terminal :</p>
          <screen>gjs <var>nomdufichier</var>.js</screen></item>
  </steps>

  <section id="windows" style="2column"><title>Fenêtres</title>
  </section>
  <section id="display-widgets" style="2column"><title>Éléments graphiques d'affichage</title>
  </section>
  <section id="buttons" style="2column"><title>Boutons et inverseurs</title>
  </section>
  <section id="entry" style="2column"><title>Entrée de données numériques et de texte</title>
  </section>
  <section id="multiline" style="2column"><title>Éditeur de texte multiligne</title>
  </section>
  <section id="menu-combo-toolbar" style="2column"><title>Menu, boîte combinée et éléments graphiques de barre d'outils</title>
  </section>
  <section id="treeview" style="2column"><title>Élément graphique arborescent</title>
  </section>
  <section id="selectors"><title>Sélecteurs</title>
    <section id="file-selectors"><title>Sélecteurs de fichiers</title>
    </section>
    <section id="font-selectors"><title>Sélecteurs de polices</title>
    </section>
    <section id="color-selectors"><title>Sélecteurs de couleurs</title>
    </section>
  </section>
  <section id="layout" style="2column"><title>Conteneurs d'agencement</title>
  </section>
  <section id="ornaments" style="2column"><title>Décorations</title>
  </section>
  <section id="scrolling" style="2column"><title>Barre de défilement</title>
  </section>
  <section id="misc" style="2column"><title>Divers</title>
  </section>
</section>

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