# Le tutoriel JavaScript moderne

Ce dpt hberge le contenu franais du tutoriel JavaScript moderne, publi  l'adresse [https://fr.javascript.info](https://fr.javascript.info).

Aidez-nous  amliorer la traduction.

- Consultez l'[issue](https://github.com/javascript-tutorial/fr.javascript.info/issues/3).
- Choisissez un article non coch que vous souhaitez traduire.
- Rpondez  l'issue avec uniquement le titre sans aucun autre ajout pour informer le bot et le mainteneur que vous le traduisez.
- Forkez le repository, traduisez et envoyez un PR (pull requests) lorsque vous avez termin.

 Merci !

Votre nom et la taille de la contribution apparatront dans la page " propos du projet" lorsque la traduction sera publie.

P.S. La liste complte des langues est disponible sur .

## Structure

Chaque chapitre, article ou exercice rside dans son propre dossier.

Le dossier est nomm `N-url`, o `N`  est le numro de tri (les articles sont ordonns), et `url` est l'URL raccourcie (slug) de la partie en question.

N'hsitez pas  consulter  pour plus de dtails.

## Contributions

Nous aimerions galement collaborer dans ce tutoriel avec d'autres personnes.

Quelque chose ne va pas ? Un sujet est manquant ? Expliquez-le nous, en ajoutant un PR 

**Vous pouvez diter le texte dans n'importe quel diteur** Le tutoriel utilise un format amlior de "markdown", facile  comprendre. Et si vous voulez voir  quoi a ressemble sur le site, il y a un serveur pour excuter le tutoriel localement  .

La liste des contributeurs est disponible  .

Le dossier contient l'un des fichiers suivants :

- `index.md` pour une section,
- `article.md` pour un article,
- `task.md` pour un exercice (+`solution.md` avec le texte de la solution).

Un fichier commence par le `# Titre principal`, et ensuite le texte au format Markdown, ditable dans un simple diteur de texte.

Des ressources supplmentaires et des exemples pour l'article ou l'exercice se trouvent galement dans le mme dossier.

## Conseils de traduction

La traduction ne doit pas ncessairement tre ultra prcise (mot par mot). Elle devrait tre techniquement correcte et bien explique.

Si vous voyez que la version anglaise peut tre amliore, merci d'envoyer un PR sur le repo correspondant.

### Texte dans les blocs de code

- Traduire uniquement les commentaires.
- Ne traduisez rien d'autre -- strings, variables.


Exemple:

```js
// Example
const text = "Hello, world";
document.querySelector('.hello').innerHTML = text;
```

 DO (translate comment):

```js
// Ejemplo
const text = 'Hello, world';
document.querySelector('.hello').innerHTML = text;
```

 DON'T (translate string or class):

```js
// Ejemplo
const text = 'Hola mundo';
// ".hello" is a class
// DO NOT TRANSLATE
document.querySelector('.hola').innerHTML = text;
```

### Liens externes

Si un lien externe est vers Wikipedia, par exemple `https://en.wikipedia.org/wiki/JavaScript`, et qu'une version de cet article existe dans votre langue et qu'elle est de bonne qualit, crez un lien vers cette version.

Exemple:

```md
[JavaScript](https://en.wikipedia.org/wiki/JavaScript) is a programming language.
```

 OK (en -> es):

```md
[JavaScript](https://es.wikipedia.org/wiki/JavaScript) es un lenguaje de programacin.
```

Pour les liens vers MDN, qui ne sont que partiellement traduits, utilisez galement la version spcifique  la langue.

Si un article li n'a pas de version traduite, laissez le lien "tel quel".


## Excuter une version locale

  - `index.md` reprsente un chapitre
  - `article.md` reprsente un article
  - `task.md` reprsente un exercice (la solution doit galement tre fournie dans le fichier `solution.md`)

Le serveur est disponible  cette adresse : .
Chacun de ces fichiers commence  partir du `# titre principal`.

Il est trs facile d'ajouter quelque chose de nouveau.

---

Ilya Kantor @iliakan