New French Translation Progress

[gaearon]

Liste des mainteneurs

• @tdd

À l’intention des nouveaux·elles traducteur·rices

Pour traduire une page :

1. 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.
2. 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.
3. 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 Homepage: traduction au-dessus du fold #449 then Translation of the remainder of the homepage #568)

Learn React

• Quick Start (@tdd - index - Getting started #450)

  • Tutorial: Tic Tac Toe (@tdd Translation of the "tutorial" page #546)
  • Thinking in React (@tdd Translation of the "Thinking in React" page #508)

• Installation (@tdd Translation of the "installation" page #504)

  • Start a New React Project (@emmadal Translation: Start a New Project #487)
  • Add React to an Existing Project (@hakimLyon 27/05 Translation of the 'Add React to an Existing Project' page #483)
  • Editor Setup (@paulus85 Translation of the "Editor Config" page #475)
  • Using TypeScript (@tdd Translation of the "Using TypeScript" page #559)
  • React Developer Tools (@Ameliegre Translation of the “React Developer Tools” page #479)
  • React Compiler (@tdd copy(l10n): final set of FR translations #675)

• Describing the UI (@tdd Translation of the "Describing the UI" page #505)

  • Your First Component (@tdd Translation of the "Your first component" page #506)
  • Importing and Exporting Components (@YannBirba Translation of the “Importing and Exporting Components” page #494)
  • Writing Markup with JSX (@tdd Translation of the "Writing Markup in JSX" page #538)
  • JavaScript in JSX with Curly Braces (@tdd Translation of the "JavaScript in JSX with Curly Braces" page #539)
  • Passing Props to a Component (@tdd Translation of the "Passing Props to a Component" page #540)
  • Conditional Rendering (@tdd Translation of the "Conditional rendering" page #541)
  • Rendering Lists (@tdd Translation of the "Rendering lists" page #543)
  • Keeping Components Pure (@tdd Translation of the "Keeping components pure" page #510)
  • Your UI as a Tree (@tdd Translation of the "Your UI as a tree" page #606)

• Adding Interactivity (@pfongkye doc(adding_interactivity): translate in french the index #468)

  • Responding to Events (@pfongkye doc(responding_to_events): translate in french #498)
  • State: A Component's Memory (@tdd Translation of the "State: a component's memory" page #509)
  • Render and Commit (@tdd Translation: Render and Commit #486)
  • State as a Snapshot (@tdd Translation of the "State as a snapshot" page #502)
  • Queueing a Series of State Updates (@tdd Translation of the "Queuing an Series of State Updates" page #503)
  • Updating Objects in State (@LaureRC Translation of the “Updating Objects in State” page #495)
  • Updating Arrays in State (@LaureRC Translation of the “Updating Arrays in State” page #542)

• Managing State (@KohdeAvekLeQ Traduction of the "Managing state" page #458)

  • Reacting to Input with State (@KohdeAvekLeQ Traduction of the "Reacting to input with state" page #461)
  • Choosing the State Structure (@KohdeAvekLeQ Translation of 'Choosing the state structure' page #513)
  • Sharing State Between Components (@linsolas Traduction de Sharing State Between Components  #515)
  • Preserving and Resetting State (@linsolas Translation of Preserving and Resetting State #518)
  • Extracting State Logic into a Reducer (@linsolas Extracting state logic into a reducer #497)
  • Passing Data Deeply with Context (@linsolas translation of Passing Data Deeply with Context #493)
  • Scaling Up with Reducer and Context (@linsolas Scaling up with reducer and context #511)

• Escape Hatches (@tdd Translation: Escape Hatches (index page) #474)

  • Referencing Values with Refs (@tdd Translation of the "Referencing Values With Refs" page #480)
  • Manipulating the DOM with Refs (@tdd Translation: Manipulating the DOM with refs #485)
  • Synchronizing with Effects (@tdd Synchronizing with Effects #457)
  • You Might Not Need an Effect (@tdd Translation: You might not need an effect #473)
  • Lifecycle of Reactive Effects (@linsolas Translation: Lifecycle of Reactive Effects page #491)
  • Separating Events from Effects (@linsolas doc(separating-events): french translation #471)
  • Removing Effect Dependencies (@tdd Translation: Removing Effect Dependencies #477)
  • Reusing Logic with Custom Hooks (@linsolas Reusing logic with custom hooks #466)

API Reference

• react (chapter index) (@tdd Sync with react.dev @ a8790ca8 #611)

  • Hooks (@emmadal 27/04 react:Hooks index page translation #464)
  • useActionState (@tdd Translation of the latest Canary API pages #610)
  • useCallback (@tdd Translation of the "useCallback" page #557)
  • useContext (@linsolas Translation of useContext #521)
  • useDebugValue (@MatteoGauthier Translation of the "useDebugValue" page from API references #507)
  • useDeferredValue (@nina-alin Translation of the 'useDeferredValue' page #484)
  • useEffect (@tdd Translation of the "useEffect" page #514)
  • useId (@MatteoGauthier Translation of the "useId" page from API references #467)
  • useImperativeHandle (@tdd Translation of the useImperativeHandle page #500)
  • useInsertionEffect (@tdd Translation of the "useInsertionEffect" page #516)
  • useLayoutEffect (@tdd Translation of the "useLayoutEffect" page #517)
  • useMemo (@tdd Translation of the "useMemo" page #558)
  • useOptimistic (@tdd Translation of the latest Canary API pages #610)
  • useReducer (@linsolas Traduction de useReducer #533)
  • useRef (@tdd Translation of the "useRef" page #501)
  • useState (@nina-alin Translation of the 'useState' page #490)
  • useSyncExternalStore (@tdd Translation of the useSyncExternalStore page #528)
  • useTransition (@tdd Translation of the useTransition page #523)

• react: Components (@bastiendmt Translation of the "react: Components" page #465)

  • <Fragment> (<>) (@bastiendmt Translation of the "Fragment" page #455 et Translation of the "Fragment" page #460)
  • <Profiler> (@bastiendmt Translation of the "Profiler" page #469)
  • <StrictMode> (@linsolas translation of StrictMode #569)
  • <Suspense> (@tdd Translation of the <Suspense> page #519)

• react: APIs (@adevinwild Translation of the “createContext” page #489)

  • act (@tdd)
  • cache (@tdd Use #587)
  • createContext (@adevinwild Translation of the “createContext” page #489)
  • forwardRef (@tdd Translation of the "forwardRef" page #512)
  • lazy (@emmadal translate lazy page #522)
  • memo (@emmadal add translation of memo page #564)
  • startTransition (@tdd Translation of the startTransition page #520)
  • use (@linsolas Use #587)
  • experimental_taintObjectReference (@tdd Translate the "experimental_taintObjectReference" page #602)
  • experimental_taintUniqueValue (@tdd Translate "experimental_taintUniqueValue" page #603)

• react-dom: Hooks (@tdd Translation of the React-DOM > Hooks chapter page #607)

  • useFormStatus (@tdd Translation of the useFormStatus page #608)

• react-dom: Components (@tdd Translation of the "React DOM > Components" page #524)

  • Common (e.g. <div>) (@linsolas React dom common #584)
  • <form> (@tdd Translation of the latest Canary API pages #610)
  • <input> (@nina-alin Provide translation of the input page #577)
  • <option> (@paulus85 Translation of "<option>" page #547)
  • <progress> (@tdd Translation of the "<progress>" page #573)
  • <select> (@tdd Translation of the "<select>" page #574)
  • <textarea> (@nina-alin Translation of "<textarea>" page #551)
  • <link> (@tdd)
  • <meta> (@tdd)
  • <script> (@tdd)
  • <style> (@tdd)
  • <title> (@tdd)

• react-dom: APIs (@tdd Translation of the "React DOM > APIs" page #525)

  • createPortal (@nina-alin Translation of create portal #563)
  • flushSync (@tdd Translation of the flushSync page #530)
  • findDOMNode (@emmadal add french translation for findDOMNode #582)
  • hydrate (@tdd Translation of the hydrate page #531)
  • preconnect (@tdd)
  • prefetchDNS (@tdd)
  • preinit (@tdd)
  • preinitModule (@tdd)
  • render (@tdd Translation of the render page #532)
  • unmountComponentAtNode (@tdd Translation of the unmountComponentAtNode page #537)

• react-dom/client: Client APIs (@tdd Translation of the "react-dom/client" page #526)

  • createRoot (@tdd Translation of the "createRoot" page #561)
  • hydrateRoot (@tdd Translation of the "hydrateRoot" page #562)

• react-dom/server: Server APIs (@tdd Translation of the react-dom/server page #527)

  • renderToNodeStream (@tdd Translation of the "renderToNodeStream" page #566)
  • renderToPipeableStream (@tdd Translation of the renderToPipeableStream page #570)
  • renderToReadableStream (@tdd Translation of the renderToReadableStream page #571)
  • renderToStaticMarkup (@tdd Translation of the renderToStaticMarkup page #535)
  • renderToStaticNodeStream (@tdd Translation of the renderToStaticNodeStream page #536)
  • renderToString (@tdd Translation of the "renderToString" page #567)

• Rules of React: chapter index (@tdd)

  • Components and Hooks must be pure (@tdd)
  • React calls Components and hooks (@tdd)
  • Rules of Hooks (@tdd)

• React Server Components (@tdd RSC Reference pages #673)

  • Server Components (@tdd RSC Reference pages #673)
  • Server Actions (@tdd RSC Reference pages #673)
  • Directives (@tdd Translations of the "directives" pages #560)
    • 'use client' (@tdd Translations of the "directives" pages #560, Translation of the fleshed-out "use client" directive page #613)
    • 'use server' (@tdd Translations of the "directives" pages #560, Translation of the fleshed-out 'use server' directive page #612)

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:

• Legacy React APIs (@tdd Translation of the "Legacy React API" index page #549)
  • Children (@tdd Translation of the "Children" page #578)
  • cloneElement (@tdd Translation of the "cloneElement" page #576)
  • Component (@tdd Translation of the "Component" page #580)
  • createElement (@tdd Translation of the "createElement" page #550)
  • createFactory (@tdd Translation of the "createFactory" page #552)
  • createRef (@tdd Translation of the "createRef" page #553)
  • isValidElement (@tdd Translation of the isValidElement page #554)
  • PureComponent (@tdd Translation of the "PureComponent" page #555)

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:

• Community (index page - @tdd Partial translation of community contents #572)
  • Conferences (@tdd Partial translation of community contents #572)
  • Meetups (@tdd Partial translation of community contents #572)
  • Videos (@tdd Partial translation of community contents #572 et Translation of the remaining parts of the Videos community page #589)
  • Meet the team (@tdd Partial translation of community contents #572 et Translate remaining "Core team" contents (bios) #588)
  • Doc contributors (@tdd Partial translation of community contents #572)
  • Translations (@tdd)
  • Acknowledgments (@tdd Partial translation of community contents #572)
  • Versioning policy (@linsolas Versioning policy #599)
• Blog (index page - @tdd Partial translation of community contents #572)
  • React Compiler Beta Release (@tdd copy(l10n): final set of FR translations #675)
  • React Conf 2024 Recap (@tdd)
  • React 19 RC (@tdd copy(l10n): final set of FR translations #675)
  • React 19 RC Upgrade Guide (@tdd copy(l10n): final set of FR translations #675)
  • React Labs: February 2024 (@tdd)
  • React Canaries (2023-05-03) (@tdd Translation of the "React Canaries" blog post #581)
  • React Labs: March 2023 (2023-03-22) (@tdd Translation of the March 2023 React Labs blog post #583)
  • Introducing react.dev (2023-03-16) (@tdd Translation of the "Introducing react.dev" blog post #591)
  • React Labs: June 2022 (2022-06-15) (@tdd Translation of the "React Labs June 2022" blog post #592)
  • React v18.0 (2022-03-29) (@tdd Translation of the "React v18.0" blog post #593)
  • How to upgrade to React 18 (2022-03-08) (@tdd Translation of the "How to migrate to React 18" blog post #594)
  • React Conf 2021 Recap (2021-12-17 @tdd Translation of the "React Conf 2021 Recap" blog post #595)
  • The plan for React 18 (2021-06-08 @tdd Translation of the "Our Plan for React 18" blog post #596)
  • Introducing Zero-Bundle-Size React Server Components (2020-12-21) (@tdd Translation of the "Intro to RSC" blog post #597)
• Versions (@tdd)
• Warnings
  • Invalid ARIA props (@tdd Translations of the warning pages #575)
  • Invalid Hook call (@tdd Translations of the warning pages #575)
  • React DOM Test Utils (@tdd)
  • React Test Renderer (@tdd)
  • Special props (@tdd Translations of the warning pages #575)
  • Unknown prop (@tdd Translations of the warning pages #575)

[tdd]

Salut @ninofiliu ! 👋🏻

Je dois prendre cette semaine le temps de battre le rappel des éléments noyau de l'équipe originale pour commencer à répartir le travail.

Il me semble que tu viens d'arriver ? Pense à bien lire les bonnes pratiques et le glossaire dont les liens sont dans le texte initial de l'issue (sinon va directement dans le wiki) avant de t'y mettre.

Ensuite, quand tu auras fini, ouvre une PR soignée, en vérifiant que tes commits sont bien à jour par-dessus la branche principale (rebase ta branche si besoin), et mets-moi en Reviewer, comme ça je pourrai te faire un retour circonstancié.

Bonne trad ! 😉

[tdd]

@ninofiliu tu as pris un gros morceau, donc n'hésite pas à faire une PR par sous-page / section, ou à ouvrir ta PR en draft une fois que tu penses avoir assez de matériau pour une revue, histoire notamment de bénéficier au plus tôt d'éventuels ajustements / recadrages.

[MatteoGauthier]

Salut 👋 !

J'aimerais participer à la traduction de cette nouvelle docs tant attendus ! Si c'est possible, j'aimerais traduire les pages useDebugValue et useId de la section React Hooks ⚛️ pour commencer.

[sheplu]

Hello ! toujours la pour reprendre le project de traduire la doc :)

@NAB va prendre le tic tac toe
Je vais prendre le thinking in react

[tdd]

Coucou @MatteoGauthier 👋

OK pour moi, tu es nouveau je crois, pense donc d'abord à bien lire le Glossaire et les Bonnes pratiques du wiki. Ensuite comme d'hab, PR qui me met en Reviewer, etc.

Bonne trad ! 👍

[tdd]

Hello @sheplu et @Nab69 ça va les vétérans ? 😉

Pas de souci, je vous attribue ça. You know the drill!

[sheplu]

en forme et toi ?
Faudrait qu'on se croise sur un meetup a Paris depuis le temps :D

[tdd]

Ouais mais avec Node.js Paris qui n'existe plus et Paris.js qui est un peu comateux, pas évident :)

[ceIia]

hello ✌️
je serais ravie de contribuer à la traduction, en commençant par la section "Describing the UI", si c'est ok !

@tdd j'ai bien pensé à check le glossaire & les bonnes pratiques :)

[tdd]

Coucou @ceIia 👋

Avec plaisir, je t'attribue ça ! Si tu as des hésitations n'hésite pas à demander (ouvre ta PR en Draft et pose-nous tes questions sur les lignes à soucis), ok ?

[tdd]

Heu @celia en fait il serait préférable que tu ne prennes pas une énorme section comme ça, travaille chapitre par chapitre. Je t'attribue du coup l'index et le premier chapitre, ok ?

[ceIia]

ok !