reactjs/ca.reactjs.org

(Work in progress) React documentation website in Catalan

reactjs.org

Aquest repositori conté tant el codi font com la documentació necessària per a impulsar reactjs.org.

Per a començar

Requisits previs

1. Git
2. Node: qualsevol versió 12.x començant per v12.0.0 o superior
3. Yarn: Veure Lloc web de Yarn amb instruccions d'instal·lació
4. Un fork del repositori (per a contribucions)
5. Un clon de reactjs.org repo a la teva màquina local

Instal·lació

1. cd reactjs.org per anar a l'arrel del projecte
2. yarn per a instal·lar les dependències del lloc web

Executant localment

1. yarn dev per a iniciar el servidor hot-reloading de desenvolupament (per Gatsby)
2. open http://localhost:8000 per a obrir el lloc web al teu navegador

Contribuir

Directrius

La documentació està dividida en diferents seccions amb diferent to i propòsit. Si planeja en fer una traducció extensa, pot trobar útil estar familiaritzat amb les directrius de contribució contributing guidelines per a la secció apropiada.

Crear una branca

1. git checkout master des de qualsevol directori dins del teu repositori local de reactjs.org
2. git pull origin master per a assegurar que el codi està actualitzat amb els canvis més recents
3. git checkout -b nom-de-la-meva-branca (reemplaça nom-de-la-meva-branca amb el nom adient) per a crear una nova branca

Fer canvis

1. Seguir les instruccions "Executant localment"
2. Guarda els fitxers i comprova el navegador
3. Canvis de components de React dins del directori src s'aplicaran automàticament
4. Canvis de fitxers de markdown dins el directori content s'aplicaran automàticament
5. Si treballa amb plugins, pot ser que hagi d'eliminar el directori .cache i reiniciar el servidor de desenvolupament

Provar els canvis

1. Si li és possible, provi qualsevol canvi visual en totes les últimes versions dels navegadors més comuns, tant en versió d'escriptori com mòbil.
2. Executi la comanda yarn check-all des del directori arrel del projecte. (Aquesta comanda executarà Prettier, ESLint, i Flow.)

Afegeix els canvis

1. git add -A && git commit -m "El meu missatge" (canviï El meu missatge amb un missatge de commit, tal com Solucionar logotip en Android) per a afegir i actualitzar el repositori
2. git push el-meu-fork nom-de-la-meva-branca
3. Vagi a reactjs.org repo i podrà veure els canvis mes recents a qualsevol de les branques actualitzades.
4. Segueixi les instruccions de GitHub.
5. A ser possible, inclogui captures de pantalla dels canvis visuals. Una build de Netlify es crearà automàticament quan enviï la PR per tal que altra gent pugui visualitzar els canvis.

Traduccions

Si està interessat a traduir reactjs.org, si us plau, comprovi l'estat actual de la traducció a isreacttranslatedyet.com.

Resolució de problemes

• yarn reset per a buidar la caché local

Llicència

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

ca.reactjs.org's Issues

https://ca.reactjs.org/ is down

URL from https://reactjs.org/languages/
https://ca-reactjs.netlify.com/ --> not found

Catalan Translation Progress

Maintainer List

• @pepjo
• @seraco

For New Translators

To translate a page:

1. Check that no one else has claimed your page in the checklist and comments below.
2. Comment below with the name of the page you would like to translate. Please take only one page at a time.
3. Clone this repo, translate your page, and submit a pull request!

Before contributing, read the glossary and style guide (once they exist) to understand how to translate various technical and React-specific terms.

Please be prompt with your translations! If you find find that you can't commit any more, let the maintainers know so they can assign the page to someone else.

For Maintainers

When someone volunteers, edit this issue with the username of the volunteer, and with the PR. Ex:

• Home Page (@tesseralis) #1

When PRs are merged, make sure to mark that page as completed!

Core Pages

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

• Home Page (@ragafus) #11
• Tutorial (@pepjo) #12

Basics

• Hello World (@pepjo) #13
• Introducing JSX (@seraco) #16
• Rendering Elements (@pepjo) #14
• Components and Props (@pepjo) #15
• State and Lifecycle (@pepjo) #18
• Handling Events (@seraco) #20
• Conditional Rendering (@seraco) #22
• Lists and Keys (@nglvnyls) #77
• Forms (@pepjo) #21
• Lifting State Up (@seraco) #30
• Composition vs Inheritance (@seraco) #31
• Thinking in React (@seraco) #32

API Reference

• React (@nglvnyls)
• React.Component (@jvidalv)
• ReactDOM (@nglvnyls) #80
• ReactDOMServer (@nglvnyls) #82
• DOM Elements (@nglvnyls) #83
• SyntheticEvent (@nglvnyls) #86
• Test Utilities (@nglvnyls) #87
• Shallow Renderer
• Test Renderer (@nglvnyls) #88
• JS Environment Requirements (@nglvnyls) #90
• Glossary (@nglvnyls) #91

Navigation

These are the navigation links that appears in the sidebar. Possibly wait until
the corresponding sections are translated to do these.

• tutorial/nav.yml (@pepjo) #12
• docs/nav.yml (@seraco)

Next Steps

These are the next most important translations, ordered by importance:

Installation

• Getting Started
• Add React to a Website
• Create a New React App
• CDN Links

Hooks

Everyone is hooked on hooks! People are really excited for these and it would be great for them to be translated.

• Introducing Hooks
• Hooks at a Glance
• Using the State Hook
• Using the Effect Hook
• Rules of Hooks
• Building Your Own Hooks
• Hooks API Reference
• Hooks FAQ

Warnings

These are the pages that you get when you click the links in the console (e.g. https://reactjs.org/warnings/dont-call-proptypes.html). People tend to search these, so please don't translate the error message itself.

• dont-call-proptypes
• invalid-aria-prop
• invalid-hook-call-warning
• legacy-factories
• refs-must-have-owner
• special-props
• unknown-prop

Advanced Guides

• Accessibility (@nglvnyls) #76
• Code-Splitting
• Context
• Error Boundaries
• Forwarding Refs (@nglvnyls) #79
• Fragments
• Higher-Order Components
• Integrating with Other Libraries
• JSX In Depth
• Optimizing Performance
• Portals
• React Without ES6
• React Without JSX
• Reconciliation
• Refs and the DOM
• Render Props
• Static Type Checking
• Strict Mode
• Typechecking With PropTypes
• Uncontrolled Components
• Web Components

FAQ

• APIs and AJAX
• Babel, JSX, and Build Steps
• Passing Functions to Components
• Component State
• Styling and CSS
• File Structure
• Versioning Policy
• Virtual DOM and Internals

Contributing

Priority: Low

• How to Contribute
• Codebase Overview
• Implementation Notes
• Design Principles

Components

Components in src/components that have some text in them.

• CodeEditor
• CodeExample
• ErrorDecoder
• LayoutFooter
• LayoutHeader
• MarkdownPage

Additional Translations

These are not the primary translation targets.

• Blog
• Community

Harmonise the translation using "tu" (colloquial form of you)

The home page was translated (#11) using vós (formal form of you). Lately it has been agreed to use the colloquial form tu (#18 (comment)). So, we need to go back to harmonise the home page translation and it would we great to check the use of tu in the whole translation.