Skip to content

Latest commit

 

History

History
executable file
·
118 lines (73 loc) · 4.12 KB

README.md

File metadata and controls

executable file
·
118 lines (73 loc) · 4.12 KB

Le tutoriel JavaScript moderne

Ce dépôt héberge le contenu français du tutoriel JavaScript moderne, publié à l'adresse https://fr.javascript.info.

Aidez-nous à améliorer la traduction.

  • Consultez l'issue nommée "Translate Progress".
  • Choisissez un article non coché que vous souhaitez traduire.
  • Répondez à 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 apparaîtront dans la page "À propos du projet" lorsque la traduction sera publiée.

P.S. La liste complète des langues est disponible sur https://javascript.info/translate.

Structure

Chaque chapitre, article ou exercice réside dans son propre dossier.

Le dossier est nommé N-url, où N – est le numéro de tri (les articles sont ordonnés), et url est l'URL raccourcie (slug) de la partie en question.

N'hésitez pas à consulter https://javascript.info/translate pour plus de détails.

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 amélioré de "markdown", facile à comprendre. Et si vous voulez voir à quoi ça ressemble sur le site, il y a un serveur pour exécuter le tutoriel localement à https://github.com/javascript-tutorial/server.

La liste des contributeurs est disponible à https://javascript.info/about#contributors.

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 supplémentaires et des exemples pour l'article ou l'exercice se trouvent également dans le même dossier.

Conseils de traduction

La traduction ne doit pas nécessairement être ultra précise (mot par mot). Elle devrait être techniquement correcte et bien expliquée.

Si vous voyez que la version anglaise peut être améliorée, 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:

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

✅ DO (translate comment):

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

❌ DON'T (translate string or class):

// 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é, créez un lien vers cette version.

Exemple:

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

✅ OK (en -> es):

[JavaScript](https://es.wikipedia.org/wiki/JavaScript) es un lenguaje de programación.

Pour les liens vers MDN, qui ne sont que partiellement traduits, utilisez également la version spécifique à la langue.

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

Exécuter une version locale

  • index.md représente un chapitre
  • article.md représente un article
  • task.md représente un exercice (la solution doit également être fournie dans le fichier solution.md)

Le serveur est disponible à cette adresse : https://github.com/javascript-tutorial/server. Chacun de ces fichiers commence à partir du # titre principal.

Il est très facile d'ajouter quelque chose de nouveau.


♥ Ilya Kantor @iliakan