Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adding translated pages for README.md #32073

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,3 +76,14 @@ To help you get your feet wet and get you familiar with our contribution process
### License

React is [MIT licensed](./LICENSE).

## Translations

* [Arabic / العربية](https://github.com/iLihiS/react/blob/main/i18n/README.ar.md)
* [Chinese / 中文](https://github.com/iLihiS/react/blob/main/i18n/README.zh.md)
* [English](https://github.com/iLihiS/react/blob/main/i18n/README.en.md)
* [Hebrew / עברית](https://github.com/iLihiS/react/blob/main/i18n/README.he.md)
* [Japanese / 日本語](https://github.com/iLihiS/react/blob/main/i18n/README.ja.md)
* [Portuguese / Português](https://github.com/iLihiS/react/blob/main/i18n/README.pt.md)
* [Russian / Русский](https://github.com/iLihiS/react/blob/main/i18n/README.ru.md)
* [Spanish / Español](https://github.com/iLihiS/react/blob/main/i18n/README.sp.md)
78 changes: 78 additions & 0 deletions i18n/README.ar.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
# [React](https://react.dev/) · [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/facebook/react/blob/main/LICENSE) [![npm version](https://img.shields.io/npm/v/react.svg?style=flat)](https://www.npmjs.com/package/react) [![(Runtime) Build and Test](https://github.com/facebook/react/actions/workflows/runtime_build_and_test.yml/badge.svg)](https://github.com/facebook/react/actions/workflows/runtime_build_and_test.yml) [![(Compiler) TypeScript](https://github.com/facebook/react/actions/workflows/compiler_typescript.yml/badge.svg?branch=main)](https://github.com/facebook/react/actions/workflows/compiler_typescript.yml) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://legacy.reactjs.org/docs/how-to-contribute.html#your-first-pull-request)

React هي مكتبة JavaScript لبناء واجهات المستخدم.

* **الإعلانية:** تجعل React إنشاء واجهات مستخدم تفاعلية أمرًا سهلاً. قم بتصميم واجهات بسيطة لكل حالة في تطبيقك، وستقوم React بتحديث وعرض المكونات الصحيحة عند تغيير بياناتك بكفاءة. تجعل الواجهات الإعلانية الكود الخاص بك أكثر توقعًا وأسهل للفهم وأسهل لإصلاح الأخطاء.
* **قائمة على المكونات:** قم بإنشاء مكونات مغلقة تدير حالتها الخاصة، ثم قم بتجميعها لإنشاء واجهات مستخدم معقدة. نظرًا لأن منطق المكونات مكتوب في JavaScript بدلاً من القوالب، يمكنك تمرير بيانات غنية بسهولة عبر تطبيقك والحفاظ على الحالة خارج DOM.
* **تعلم مرة واحدة، اكتب في أي مكان:** نحن لا نفترض أي شيء عن بقية تقنياتك، لذا يمكنك تطوير ميزات جديدة باستخدام React دون الحاجة إلى إعادة كتابة الكود الحالي. يمكن أيضًا لـ React العرض على الخادم باستخدام [Node](https://nodejs.org/en) وتشغيل تطبيقات الأجهزة المحمولة باستخدام [React Native](https://reactnative.dev/).

[تعرف على كيفية استخدام React في مشروعك](https://react.dev/learn).

## التثبيت

تم تصميم React لاعتماد تدريجي منذ البداية، و**يمكنك استخدامها بقدر ما تحتاج أو ترغب:**

* استخدم [البدء السريع](https://react.dev/learn) للحصول على فكرة عن React.
* [أضف React إلى مشروع قائم](https://react.dev/learn/add-react-to-an-existing-project) لاستخدام React جزئيًا أو بالكامل.
* [أنشئ تطبيق React جديد](https://react.dev/learn/start-a-new-react-project) إذا كنت تبحث عن مجموعة أدوات JavaScript قوية.

## الوثائق

يمكنك العثور على وثائق React [على الموقع الإلكتروني](https://react.dev/).

اطلع على صفحة [البدء السريع](https://react.dev/learn) لمحة عامة سريعة.

تنقسم الوثائق إلى عدة أقسام:

* [البدء السريع](https://react.dev/learn)
* [الدليل](https://react.dev/learn/tutorial-tic-tac-toe)
* [التفكير في React](https://react.dev/learn/thinking-in-react)
* [التثبيت](https://react.dev/learn/installation)
* [وصف واجهة المستخدم](https://react.dev/learn/describing-the-ui)
* [إضافة التفاعلية](https://react.dev/learn/adding-interactivity)
* [إدارة الحالة](https://react.dev/learn/managing-state)
* [الأدلة المتقدمة](https://react.dev/learn/escape-hatches)
* [مرجع API](https://react.dev/reference/react)
* [أين تحصل على الدعم](https://react.dev/community)
* [دليل المساهمة](https://legacy.reactjs.org/docs/how-to-contribute.html)

يمكنك تحسينه عن طريق إرسال طلبات السحب إلى [هذا المستودع](https://github.com/reactjs/react.dev).

## الأمثلة

لدينا العديد من الأمثلة [على الموقع الإلكتروني](https://react.dev/). إليك الأول لتبدأ:

```jsx
import { createRoot } from 'react-dom/client';

function HelloMessage({ name }) {
return <div>Hello {name}</div>;
}

const root = createRoot(document.getElementById('container'));
root.render(<HelloMessage name="Taylor" />);
```

سيقوم هذا المثال بعرض "Hello Taylor" داخل حاوية على الصفحة.

لاحظ أننا استخدمنا بناء جملة يشبه HTML؛ [نسميه JSX](https://react.dev/learn#writing-markup-with-jsx). JSX ليس مطلوبًا لاستخدام React، لكنه يجعل الكود أكثر قابلية للقراءة، وكتابته يشبه كتابة HTML.

## المساهمة

الهدف الرئيسي من هذا المستودع هو الاستمرار في تطوير نواة React، مما يجعلها أسرع وأسهل في الاستخدام. يتم تطوير React علنًا على GitHub، ونحن ممتنون للمجتمع على مساهماتهم في إصلاح الأخطاء والتحسينات. اقرأ أدناه لتتعلم كيف يمكنك المشاركة في تحسين React.

### [مدونة السلوك](https://code.fb.com/codeofconduct)

اعتمدت Facebook مدونة سلوك نتوقع من المشاركين في المشروع الالتزام بها. يُرجى قراءة [النص الكامل](https://code.fb.com/codeofconduct) لتفهم ما هي الإجراءات المقبولة وغير المقبولة.

### [دليل المساهمة](https://legacy.reactjs.org/docs/how-to-contribute.html)

اقرأ [دليل المساهمة](https://legacy.reactjs.org/docs/how-to-contribute.html) لتتعلم عن عملية التطوير الخاصة بنا، وكيفية اقتراح إصلاحات الأخطاء والتحسينات، وكيفية بناء واختبار تغييراتك لـ React.

### [قضايا جيدة للمبتدئين](https://github.com/facebook/react/labels/good%20first%20issue)

لمساعدتك على البدء والتعرف على عملية المساهمة، لدينا قائمة بـ [القضايا الجيدة للمبتدئين](https://github.com/facebook/react/labels/good%20first%20issue) التي تحتوي على أخطاء ذات نطاق محدود نسبيًا. هذا مكان رائع للبدء.

### الرخصة

React مرخصة تحت [رخصة MIT](./LICENSE).
78 changes: 78 additions & 0 deletions i18n/README.es.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
# [React](https://react.dev/) &middot; [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/facebook/react/blob/main/LICENSE) [![npm version](https://img.shields.io/npm/v/react.svg?style=flat)](https://www.npmjs.com/package/react) [![(Runtime) Build and Test](https://github.com/facebook/react/actions/workflows/runtime_build_and_test.yml/badge.svg)](https://github.com/facebook/react/actions/workflows/runtime_build_and_test.yml) [![(Compiler) TypeScript](https://github.com/facebook/react/actions/workflows/compiler_typescript.yml/badge.svg?branch=main)](https://github.com/facebook/react/actions/workflows/compiler_typescript.yml) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://legacy.reactjs.org/docs/how-to-contribute.html#your-first-pull-request)

React es una biblioteca de JavaScript para construir interfaces de usuario.

* **Declarativo:** React facilita la creación de interfaces de usuario interactivas. Diseña vistas simples para cada estado de tu aplicación, y React actualizará y renderizará de manera eficiente los componentes correctos cuando los datos cambien. Las vistas declarativas hacen que tu código sea más predecible, más fácil de entender y de depurar.
* **Basado en componentes:** Crea componentes encapsulados que gestionen su propio estado y compón estos para crear interfaces de usuario complejas. Dado que la lógica de los componentes está escrita en JavaScript en lugar de plantillas, puedes pasar datos enriquecidos fácilmente a través de tu aplicación y mantener el estado fuera del DOM.
* **Aprende una vez, escribe en cualquier lugar:** No hacemos suposiciones sobre el resto de tu tecnología, por lo que puedes desarrollar nuevas características en React sin reescribir el código existente. React también puede renderizar en el servidor usando [Node](https://nodejs.org/en) y potenciar aplicaciones móviles usando [React Native](https://reactnative.dev/).

[Aprende cómo usar React en tu proyecto](https://react.dev/learn).

## Instalación

React ha sido diseñado para una adopción gradual desde el principio, y **puedes usar tan poco o tanto React como necesites:**

* Usa [Inicio rápido](https://react.dev/learn) para probar React.
* [Añade React a un proyecto existente](https://react.dev/learn/add-react-to-an-existing-project) para usar tan poco o tanto React como necesites.
* [Crea una nueva aplicación React](https://react.dev/learn/start-a-new-react-project) si buscas una poderosa herramienta de JavaScript.

## Documentación

Puedes encontrar la documentación de React [en el sitio web](https://react.dev/).

Consulta la página [Inicio rápido](https://react.dev/learn) para una visión general rápida.

La documentación está dividida en varias secciones:

* [Inicio rápido](https://react.dev/learn)
* [Tutorial](https://react.dev/learn/tutorial-tic-tac-toe)
* [Pensando en React](https://react.dev/learn/thinking-in-react)
* [Instalación](https://react.dev/learn/installation)
* [Describiendo la interfaz de usuario](https://react.dev/learn/describing-the-ui)
* [Agregando interactividad](https://react.dev/learn/adding-interactivity)
* [Gestionando el estado](https://react.dev/learn/managing-state)
* [Guías avanzadas](https://react.dev/learn/escape-hatches)
* [Referencia de API](https://react.dev/reference/react)
* [Dónde obtener soporte](https://react.dev/community)
* [Guía de contribución](https://legacy.reactjs.org/docs/how-to-contribute.html)

Puedes mejorar la documentación enviando solicitudes de extracción a [este repositorio](https://github.com/reactjs/react.dev).

## Ejemplos

Tenemos varios ejemplos [en el sitio web](https://react.dev/). Aquí está el primero para comenzar:

```jsx
import { createRoot } from 'react-dom/client';

function HelloMessage({ name }) {
return <div>Hello {name}</div>;
}

const root = createRoot(document.getElementById('container'));
root.render(<HelloMessage name="Taylor" />);
```

Este ejemplo renderizará "Hello Taylor" en un contenedor en la página.

Notarás que usamos una sintaxis similar a HTML; [la llamamos JSX](https://react.dev/learn#writing-markup-with-jsx). JSX no es obligatorio para usar React, pero hace que el código sea más legible y escribirlo se siente como escribir HTML.

## Contribución

El propósito principal de este repositorio es continuar evolucionando el núcleo de React, haciéndolo más rápido y fácil de usar. El desarrollo de React ocurre abiertamente en GitHub, y estamos agradecidos con la comunidad por contribuir con correcciones de errores y mejoras. Lee a continuación para aprender cómo puedes participar en mejorar React.

### [Código de conducta](https://code.fb.com/codeofconduct)

Facebook ha adoptado un código de conducta que esperamos que los participantes del proyecto sigan. Por favor, lee [el texto completo](https://code.fb.com/codeofconduct) para entender qué acciones se permitirán y cuáles no.

### [Guía de contribución](https://legacy.reactjs.org/docs/how-to-contribute.html)

Lee nuestra [guía de contribución](https://legacy.reactjs.org/docs/how-to-contribute.html) para aprender sobre nuestro proceso de desarrollo, cómo proponer correcciones de errores y mejoras, y cómo construir y probar tus cambios en React.

### [Problemas para principiantes](https://github.com/facebook/react/labels/good%20first%20issue)

Para ayudarte a empezar y familiarizarte con nuestro proceso de contribución, tenemos una lista de [problemas para principiantes](https://github.com/facebook/react/labels/good%20first%20issue) que contienen errores con un alcance relativamente limitado. Este es un excelente punto de partida.

### Licencia

React tiene licencia bajo [MIT](./LICENSE).
78 changes: 78 additions & 0 deletions i18n/README.he.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
# [React](https://react.dev/) &middot; [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/facebook/react/blob/main/LICENSE) [![npm version](https://img.shields.io/npm/v/react.svg?style=flat)](https://www.npmjs.com/package/react) [![(Runtime) Build and Test](https://github.com/facebook/react/actions/workflows/runtime_build_and_test.yml/badge.svg)](https://github.com/facebook/react/actions/workflows/runtime_build_and_test.yml) [![(Compiler) TypeScript](https://github.com/facebook/react/actions/workflows/compiler_typescript.yml/badge.svg?branch=main)](https://github.com/facebook/react/actions/workflows/compiler_typescript.yml) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://legacy.reactjs.org/docs/how-to-contribute.html#your-first-pull-request)

React היא ספריית JavaScript לבניית ממשקי משתמש.

* **הצהרתיות:** React הופכת את תהליך יצירת ממשקי משתמש אינטראקטיביים לפשוט. עיצבו תצוגות פשוטות לכל מצב באפליקציה שלכם, ו-React תעדכן ותציג בצורה יעילה את הרכיבים הנכונים כאשר הנתונים שלכם משתנים. תצוגות הצהרתיות הופכות את הקוד שלכם ליותר צפוי, פשוט להבנה וקל לדיבוג.
* **מבוססת רכיבים:** בנו רכיבים מבודדים המנהלים את המצב שלהם בעצמם, ואז חברו אותם כדי ליצור ממשקי משתמש מורכבים. מכיוון שהלוגיקה של הרכיבים נכתבת ב-JavaScript ולא בתבניות, ניתן להעביר בקלות נתונים עשירים דרך האפליקציה ולשמור על המצב מחוץ ל-DOM.
* **למדו פעם אחת, כתבו בכל מקום:** אנחנו לא מניחים הנחות לגבי ערימת הטכנולוגיה שלכם, כך שתוכלו לפתח תכונות חדשות ב-React מבלי לשכתב קוד קיים. React יכולה גם להציג בצד השרת באמצעות [Node](https://nodejs.org/en) ולהפעיל אפליקציות מובייל באמצעות [React Native](https://reactnative.dev/).

[למדו כיצד להשתמש ב-React בפרויקט שלכם](https://react.dev/learn).

## התקנה

React עוצבה מראש כך שתתאים לשילוב הדרגתי, ו**ניתן להשתמש בה בכל היקף שתרצו:**

* השתמשו ב[התחלה מהירה](https://react.dev/learn) כדי להתנסות ב-React.
* [הוסיפו React לפרויקט קיים](https://react.dev/learn/add-react-to-an-existing-project) כדי להשתמש ב-React באופן חלקי או מלא.
* [צרו אפליקציית React חדשה](https://react.dev/learn/start-a-new-react-project) אם אתם מחפשים ערכת כלים עוצמתית ל-JavaScript.

## תיעוד

ניתן למצוא את התיעוד של React [באתר](https://react.dev/).

עיינו בעמוד [התחלה מהירה](https://react.dev/learn) לסקירה מהירה.

התיעוד מחולק למספר חלקים:

* [התחלה מהירה](https://react.dev/learn)
* [מדריך](https://react.dev/learn/tutorial-tic-tac-toe)
* [חשיבה ב-React](https://react.dev/learn/thinking-in-react)
* [התקנה](https://react.dev/learn/installation)
* [תיאור ממשק המשתמש](https://react.dev/learn/describing-the-ui)
* [הוספת אינטראקטיביות](https://react.dev/learn/adding-interactivity)
* [ניהול מצב](https://react.dev/learn/managing-state)
* [מדריכים מתקדמים](https://react.dev/learn/escape-hatches)
* [התייחסות ל-API](https://react.dev/reference/react)
* [איפה לקבל תמיכה](https://react.dev/community)
* [מדריך לתרומות](https://legacy.reactjs.org/docs/how-to-contribute.html)

ניתן לשפר את התיעוד באמצעות שליחת Pull Requests ל[מאגר הזה](https://github.com/reactjs/react.dev).

## דוגמאות

יש לנו מספר דוגמאות [באתר](https://react.dev/). הנה הראשונה כדי להתחיל:

```jsx
import { createRoot } from 'react-dom/client';

function HelloMessage({ name }) {
return <div>Hello {name}</div>;
}

const root = createRoot(document.getElementById('container'));
root.render(<HelloMessage name="Taylor" />);
```

דוגמה זו תציג את "Hello Taylor" בתוך מיכל בדף.

תשימו לב שהשתמשנו בתחביר דמוי HTML; [אנחנו קוראים לזה JSX](https://react.dev/learn#writing-markup-with-jsx). JSX אינו נדרש לשימוש ב-React, אך הוא הופך את הקוד לקריא יותר, וכתיבתו מרגישה כמו כתיבת HTML.

## תרומות

המטרה המרכזית של מאגר זה היא להמשיך לפתח את הליבה של React, להפוך אותה למהירה וקלה יותר לשימוש. הפיתוח של React מתבצע בצורה פתוחה ב-GitHub, ואנחנו אסירי תודה לקהילה על תרומתם לתיקון באגים ושיפורים. קראו בהמשך כיצד תוכלו לקחת חלק בשיפור React.

### [קוד ההתנהגות](https://code.fb.com/codeofconduct)

פייסבוק אימצה קוד התנהגות שאנו מצפים שמשתתפי הפרויקט יעמדו בו. אנא קראו את [הטקסט המלא](https://code.fb.com/codeofconduct) כדי להבין אילו פעולות יתקבלו ואילו לא.

### [מדריך לתרומות](https://legacy.reactjs.org/docs/how-to-contribute.html)

קראו את [מדריך התרומות](https://legacy.reactjs.org/docs/how-to-contribute.html) כדי ללמוד על תהליך הפיתוח שלנו, כיצד להציע תיקוני באגים ושיפורים, וכיצד לבנות ולבדוק את השינויים שלכם ל-React.

### [בעיות למתחילים](https://github.com/facebook/react/labels/good%20first%20issue)

כדי לעזור לכם להתחיל ולהכיר את תהליך התרומה, יש לנו רשימה של [בעיות למתחילים](https://github.com/facebook/react/labels/good%20first%20issue) שכוללות באגים בהיקף מוגבל יחסית. זהו מקום מצוין להתחיל ממנו.

### רישיון

React היא תחת רישיון [MIT](./LICENSE).
Loading