reactjs / fr.react.dev Goto Github PK

View Code? Open in Web Editor NEW

91.0 15.0 160.0 152.87 MB

Version française du site de documentation officiel de React

Home Page: https://fr.react.dev

License: Creative Commons Attribution 4.0 International

JavaScript 32.62% CSS 7.35% HTML 0.28% Shell 0.01% TypeScript 59.73%

fr.react.dev's Introduction

react.dev

This repo contains the source code and documentation powering react.dev.

Getting started

Prerequisites

Git
Node: any 12.x version starting with v12.0.0 or greater
Yarn: See Yarn website for installation instructions
A fork of the repo (for any contributions)
A clone of the react.dev repo on your local machine

Installation

cd react.dev to go into the project root
yarn to install the website's npm dependencies

Running locally

yarn dev to start the development server (powered by Next.js)
open http://localhost:3000 to open the site in your favorite browser

Contributing

Guidelines

The documentation is divided into several sections with a different tone and purpose. If you plan to write more than a few sentences, you might find it helpful to get familiar with the contributing guidelines for the appropriate sections.

Create a branch

git checkout main from any folder in your local react.dev repository
git pull origin main to ensure you have the latest main code
git checkout -b the-name-of-my-branch (replacing the-name-of-my-branch with a suitable name) to create a branch

Make the change

Follow the "Running locally" instructions
Save the files and check in the browser
Changes to React components in src will hot-reload
Changes to markdown files in content will hot-reload
If working with plugins, you may need to remove the .cache directory and restart the server

Test the change

If possible, test any visual changes in all latest versions of common browsers, on both desktop and mobile.
Run yarn check-all. (This will run Prettier, ESLint and validate types.)

Push it

git add -A && git commit -m "My message" (replacing My message with a commit message, such as Fix header logo on Android) to stage and commit your changes
git push my-fork-name the-name-of-my-branch
Go to the react.dev repo and you should see recently pushed branches.
Follow GitHub's instructions.
If possible, include screenshots of visual changes. A preview build is triggered after your changes are pushed to GitHub.

Translation

If you are interested in translating react.dev, please see the current translation efforts here.

License

Content submitted to react.dev is CC-BY-4.0 licensed, as found in the LICENSE-DOCS.md file.

fr.react.dev's People

Contributors

Stargazers

Watchers

Forkers

jeremiepat setheal sheplu sylvhama crakoucas thib92 nab69 geslain shinework lucasperso drenawak tlenclos bpagoaga gwendall jckr laurerc melarts lbelavoir franckboudraa charlyx pascalvaccaro robincsl gomesalexandre jibe0123 clairefritz yasakura osedea juliettelofaro adrienthiery kikou2016 sidalidev forresst hellodeloo vadimradermacher mdarfilal gustafsilva joshua444 eddy1900 gdarchen mustaphalimam ghoullier ericmorand ludolamerre oltodo smatoox maliky yannicksublime antamb guillaume-shippeo lambda2 ni-c0de-mus sbenard iverly branchard tony-truand jean-michael vinceglb elmehdibm mleralec athos7933 jdeniau weslaty vnsteven florianchevallier hamza-aziz bansel-sqli developerarnaud dm0reau benoitgossetinnovhealth corentinsardo dylanpiersanti koukihamzaa thibaultboursier artusamak mehdimaz younesh shegunmb kaci92 xtof974 christopherlkl andriamasy patricktchoupe anzart tigamadou aluckens kazydev47 yogalholic w1773nd pfongkye bertrandp dooxe59 brandonsueur semantic-project charlesdev arabakevin amen-souissi constantgillet bastienlaval urldev isabella232

fr.react.dev's Issues

npm run build

HomePage / Page d'accueil

La page d'accueil n'est pas un monolite, tous les fichiers suivant on besoin d'être traduit:

Contenus

/content/home/marketing/component-based.md
/content/home/marketing/declarative.md
/content/home/marketing/learn-once-write-anywhere.md
/content/home/examples/a-component-using-external-plugins.md
/content/home/examples/a-simple-component.md
/content/home/examples/a-stateful-component.md
/content/home/examples/an-application.md

Exemples
Pour les exemples, on ne traduit que les commentaires et les éventuel string affichées mais pas les noms de variables.

/content/home/examples/a-component-using-external-plugins.js
/content/home/examples/a-simple-component.js
/content/home/examples/a-stateful-component.js
/content/home/examples/an-application.js

Automation issues and questions

@gaearon Hey Dan! How's it been?

Finally kicking the FR re-translation effort into gear 🎉, yay!

We're getting weird GitHub Actions job failures due to oooold Node versions in there. Anything the docs team can fix? Also, any idea when can we expect weekly automated backport/sync PRs from upstream, as we had on the former docs?

Best,

react-docs

Hello World / Bonjour, Monde

Fichiers

/content/docs/hello-world.md

Recommandations
Pour les exemples, on ne traduit que les commentaires et les éventuelles string affichées mais pas les noms de variables.

[Typo]: Fix typo in `Créer un nouveau projet React` docs

Résumé

Hello !

Sur la page Créer un nouveau projet React de la documentation, il est écrit Frameworks Reaxt expérimentaux. Remarquez Reaxt dans la phrase. Le titre dans la version anglaise est Bleeding-edge React frameworks, il est donc certain que l'on souhaitait écrire React et non Reaxt.

Je ferrai une PR qui propose une correction.

Page

https://fr.react.dev/learn/start-a-new-react-project#bleeding-edge-react-frameworks:~:text=Frameworks-,Reaxt,-exp%C3%A9rimentaux

Détails

No response

Title Case or Localized title case?

Hey @gaearon a typography question here!

React's docs use “reasonable title case” (pronouns, conjunctions, etc. are usually lowercase). This is not a de-facto English standard, but is commonplace in the press and has become widespread in English tech docs.

However, title casing is pretty foreign to other roman-letters languages, such as French.

Is this an intentional design choice that you wish roman-letters languages would preserve? Or was that a sort of reflex, and you don't mind locale-aware title casing?

French translations use the same casing as English so far, but it does feel foreign.

Let us know!

/cc @JeremiePat @shinework @tesseralis

Ecriture inclusive => lecture pénible

Super doc ...
mais l'écriture inclusive est aussi pénible que le fait qu'il n'y ait qu'aussi peu de femme dans l'informatique.
Merci de ne pas combattre le feu par le feu.

Components and Props / Composants et propriétés

Fichiers

/content/docs/components-and-props.md

Recommandations
Pour les exemples, on ne traduit que les commentaires et les éventuelles string affichées mais pas les noms de variables.

New French Translation Progress

Liste des mainteneurs

@tdd

À l’intention des nouveaux·elles traducteur·rices

Pour traduire une page :

Vérifiez que personne d’autre n’a déjà pris la main dessus dans la liste de tâches et les commentaires ci-dessous.
Commentez ci-dessous avec le nom de la page que vous voulez traduire. Ne traduisez qu’une page à la fois. @tdd reportera votre nom dans la liste de tâches.
Envoyez une PR interne au fork et ajoutez-la à votre commentaire (@tdd reportera, pareil)

⚠️⚠️⚠️ Avant de continuer, lisez nos bonnes pratiques et le glossaire pour comprendre comment traduire au mieux divers sujets techniques et spécifiques à React.

Soyez diligent·e·s dans vos traductions ! Si vous vous apercevez que vous ne pouvez pas continuer ou juste aller au bout de votre page en cours, faites-le savoir à l'équipe pour que quelqu'un d'autre reprenne la main.

À l’intention des mainteneurs

Quand quelqu’un propose une traduction, mettez à jour cette issue avec son nom et le n° de la PR, par exemple :

Home Page (@tesseralis) #12345

Quand les PRs sont fusionnées, pensez à cocher la case de la page !

Main Content

To do before releasing as an "official" translation. Please translate these pages first.

Note that each section has an index page, which needs to be translated too.

Homepage (@tdd above-the-fold #449 then #568)

Learn React

API Reference

Navigation and UI

We suggest to leave most of the UI translation until the end. We plan to do some invasive changes to the website folder layout and components, so postponing this until your translation is almost complete would make it easier to merge the changes from our side later. It might make sense to translate the homepage above the fold early, but leave the rest for later. As individual pages get translated, you can change the page titles in the corresponding sidebar files. Finally, when you're translating the navigation, make sure to test both desktop and mobile layouts.

Homepage (currently in HomeContent.js)
Sidebars (currently in src/sidebar*.json)
Top-level navigation (currently in TopNav.tsx)

When You're Ready...

After everything above is translated, add your language to deployedLanguages in Seo.tsx of the original reactjs/react.dev repository.

Secondary Content

These API pages should ideally be translated too, but they're less urgent and can be done after the others:

Optional Content

These aren't the main translation targets, but if you'd like to do them, feel free to expand the list to include their subpages:

reactprojects

faute de frappes "Transfert de refs"

Bonjour,
Il y a une faute de frappe dans la traduction française de la page transferts de ref.

Dans le deuxième paragraphes :

"Bien qu’une telle encapsulation soit souhaitable pour les composants applicatifs tels que FeedStory ou Comment, elle peut être gênante pour les composants hautement réutilisables, tels que FancyButton ou MyTextInput. Ces composants ont tendance à être utilisés un peu partout dans dans l’application de manière similaire à un button ou un input, et l’accès à leurs nœuds DOM peut s’avérer nécessaire pour la gestion du focus, de la sélection ou des animations."

hope it can be useful

Git conflict syntax was not removed after before in docs/handling-events file

In the documentation you see <<<<< HEAD text.. and you have left the english original text and the ID of something

The error is founded exactly here
https://github.com/reactjs/fr.reactjs.org/blob/master/content/docs/handling-events.md#-headlorsque-vous-utilisez-react-vous-navez-g%C3%A9n%C3%A9ralement-pas-besoin-dappeler-la-m%C3%A9thode-addeventlistener-pour-ajouter-des-%C3%A9couteurs-d%C3%A9v%C3%A9nements-event-listeners-ndt-%C3%A0-un-%C3%A9l%C3%A9ment-du-dom-apr%C3%A8s-que-celui-ci-est-cr%C3%A9%C3%A9-%C3%A0-la-place-on-fournit-l%C3%A9couteur-lors-du-rendu-initial-de-l%C3%A9l%C3%A9ment

Téléchargement de la documentation ePub / PDF / HTML ?

Est-il possible de télécharger la documentation au format ePub, PDF ou encore HTML quelque part ? Ce serait très pratique !

Consistent "analyze comment" job failure on sync PRs

Hey @gaearon!

So we're getting sync PRs again 👏 but they seem to be constructed in a way that consistently wrecks the "analyze comment" job? Unlike bundle analyses, retrying this job a few times consistently fails.

Are you seeing this on other repos? It would mean the sync PRs need to be tweaked to pass that job. Otherwise there's something fishy on our side somehow…

See https://github.com/reactjs/fr.react.dev/actions/runs/4806030381/jobs/8553073969

Best,

French translation final steps!

Congrats! You all are almost done translating the React docs to French 🎉

A couple more things to do before we can mark this translation as complete:

🌍 Translation for faq-internals

Working on the translation for Virtual DOM and Internals 🙂

id: faq-internals
title: Virtual DOM and Internals
permalink: docs/faq-internals.html
layout: docs
category: FAQ

Projet_youssef

Tutoriel

Fichiers

/content/tutorial/tutorial.md
/content/tutorial/nav.yml

Recommandations
Dans le menu on ne localise que les title. On ne touche pas aux ID ni aux URL.

Pour les exemples, on ne traduit que les commentaires et les éventuelles string affichées mais pas les noms de variables.

Introducing JSX / Introduction à JSX

Fichiers

/content/docs/introducing-jsx.md

Recommandations
Pour les exemples, on ne traduit que les commentaires et les éventuelles string affichées mais pas les noms de variables.

Rendering Elements / Rendre les elements

Fichiers

/content/docs/rendering-elements.md

Recommandations
Pour les exemples, on ne traduit que les commentaires et les éventuelles string affichées mais pas les noms de variables.

madocumentreact

[Typo]: Typo in `Profiler` docs

Résumé

Hello :wave !
Petit issue de typo.

Il s'agit d'une possible erreur de frappe sur la documentation du Profiler dans la phrase 👇

Elle reçoit des informations indiquant ce qui a fait l’objet ɗ un rendu et quel temps ça a pris.

On peut y remarquer un ɗ un je pense que l'on souhaiterait écrire d'un.

Je ferai une PR pour suggérer un remplacement du ɗ un par d'un.

Page

https://fr.react.dev/reference/react/Profiler#:~:text=a%20fait%20l%E2%80%99objet-,%C9%97%20un,-rendu%20et%20quel

Détails

No response

[OLD] Legacy French Translation Progress

Liste des mainteneurs

À l’intention des nouveaux·elles traducteur·rices

Pour traduire une page :

Vérifiez que personne d’autre n’a déjà pris la main dessus dans la liste de tâches et les commentaires ci-dessous.
Commentez ci-dessous avec le nom de la page que vous voulez traduire. Ne traduisez qu’une page à la fois. @tdd reportera votre nom dans la liste de tâches.
Envoyez une PR interne au fork et ajoutez-la à votre commentaire (@tdd reportera, pareil)

Avant de continuer, lisez nos bonnes pratiques et le glossaire pour comprendre comment traduire au mieux divers sujets techniques et spécifiques à React.

Vous pouvez vous aider des traductions existantes dans Crowdin mais attention, leur qualité est très variable. Nos propres docs ont priorité sur les choix de traduction. Assurez-vous par ailleurs de vérifier que le contenu que vous y trouvez est bien à jour par rapport au contenu actuel du site, pour éviter de traduire un truc obsolète.

Soyez diligent·e·s dans vos traductions ! Si vous vous apercevez que vous ne pouvez pas continuer ou juste aller au bout de votre page en cours, faites-le savoir à l'équipe pour que quelqu'un d'autre reprenne la main.

À l’intention des mainteneurs

Quand quelqu’un propose une traduction, mettez à jour cette issue avec son nom et le n° de la PR, par exemple :

Home Page (@tesseralis) #1

Quand les PRs sont fusionnées, pensez à cocher la case de la page !

Pages Fondamentales

Ces pages doivent être finalisées avant toute sortie de traduction « officielle ». Merci de traduire ces pages en priorité.

Home Page / Page d’accueil (@JeremiePat) #9
Tutorial / Tutoriel (@tdd) #81

Basics / Les Bases

API Reference / Référence API

Navigation

Ce sont les liens de navigation qui apparaissent dans la barre latérale. Essayez d’attendre que les sections cibles soient traduites pour mettre à jour leurs liens.

tutorial/nav.yml (@tdd) #81
docs/nav.yml (@tdd) #27 + partiels au fil des trads

Étapes suivantes

Ce sont les traductions complémentaires les plus importantes, ici par ordre décroissant de priorité :

Installation

Getting Started (@kevinch) #43
Add React to a Website (@Nab69) #72
Create a New React App (@linsolas) #35
CDN Links (@linsolas) #33

Hooks

Tout le monde est accroc aux hooks ! Les gens sont super intéressés par ça et ce serait top pour de traduire cette partie. (Note de @tdd : la VF du blog Overreacted.io de @gaearon fait une excellente source d'inspiration, ahem…)

Introducing Hooks (@emmadal) #99
Hooks at a Glance (@sheplu) #78
Using the State Hook (@LaureRC) #32
Using the Effect Hook (@pascalvaccaro) #60
Rules of Hooks (@charlyx) #53
Building Your Own Hooks (@charlyx) #86
Hooks API Reference (@RobinCsl) #65
Hooks FAQ (@flightcom) #92

Warnings / Avertissements

Ce sont les pages sur lesquelles on arrive en cliquant les liens dans la console
(ex. https://reactjs.org/warnings/dont-call-proptypes.html). Les gens ont tendance à faire des recherches dessus, alors merci de ne pas traduire le message d’erreur lui-même (en tout cas pas en remplacement, mais en complément de la VO).

dont-call-proptypes (@lbelavoir) #85
invalid-aria-prop (@tdd) #88
invalid-hook-call-warning (@tdd) #88
legacy-factories (@tdd) #88
refs-must-have-owner (@tdd) #88
special-props (@tdd) #88
unknown-prop (@tdd) #88

Advanced Guides / Guides Avancés

FAQ

APIs and AJAX (@lbelavoir) #45
Babel, JSX, and Build Steps (@lbelavoir) #50
Passing Functions to Components (@thib92) #95
Component State (@lbelavoir) #57
Styling and CSS (@lbelavoir) #56
File Structure (@lbelavoir) #62
Versioning Policy (@salimbenfarhat) #91
Virtual DOM and Internals (@lbelavoir) #70

Contributing / Contribuer

Priorité : Basse

How to Contribute (@adrienthiery) #93
Codebase Overview (@lbelavoir) #98
Implementation Notes (@forresst) #96
Design Principles (@linsolas) #102

Composants (@tdd) #27

Ce sont les composants dans src/components qui comportent un peu de texte.

CodeEditor (@tdd)
CodeExample (@tdd)
ErrorDecoder (@tdd)
LayoutFooter (@tdd)
LayoutHeader (@tdd)
MarkdownPage (@tdd)
(et y'en a davantage encore, qui ont été traduits aussi…)

Traductions complémentaires

Ce ne sont clairement pas les objectifs principaux de la traduction

reactjs / fr.react.dev Goto Github PK

fr.react.dev's Introduction

react.dev

Getting started

Prerequisites

Installation

Running locally

Contributing

Guidelines

Create a branch

Make the change

Test the change

Push it

Translation

License

fr.react.dev's People

Contributors

Stargazers

Watchers

Forkers

fr.react.dev's Issues

Résumé

Page

Détails

Liste des mainteneurs

À l’intention des nouveaux·elles traducteur·rices

À l’intention des mainteneurs

Main Content

Learn React

API Reference

Navigation and UI

When You're Ready...

Secondary Content

Optional Content

Résumé

Page

Détails

Liste des mainteneurs

À l’intention des nouveaux·elles traducteur·rices

À l’intention des mainteneurs

Pages Fondamentales

Basics / Les Bases

API Reference / Référence API

Navigation

Étapes suivantes

Installation

Hooks

Warnings / Avertissements

Advanced Guides / Guides Avancés

FAQ

Contributing / Contribuer

Composants (@tdd) #27

Traductions complémentaires

Recommend Projects

Recommend Topics

Recommend Org

Jobs