From ff37aaecc78fba4819120371780ddca87ca7ecba Mon Sep 17 00:00:00 2001 From: Soroush Torkzadeh Date: Sun, 10 Feb 2019 11:27:03 +0330 Subject: [PATCH 1/7] Add TRANSLATION.md A reference glassory for the technical words/term --- TRANSLATION.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 TRANSLATION.md diff --git a/TRANSLATION.md b/TRANSLATION.md new file mode 100644 index 000000000..78db0b037 --- /dev/null +++ b/TRANSLATION.md @@ -0,0 +1,28 @@ +
+# واژه‌نامه + +فهرستی از واژه‌های فنی و اصطلاحات موردنیاز شما در این‌جا آورده‌ شده‌است. + +## ترجمه‌شده +ترجمه کلمه‌ها و اصطلاحاتی که معادل مناسبی در جامعه نرم‌افزاری ما برای آن‌ها تعریف شده‌است، در این جدول قرار گرفته‌است. + +اگر عبارت موردنظر را در این لیست پیدا نکردید، شاید در بخش بعدی تعریف شده‌باشد. + +| کلمه/عبارت | معادل پیشنهادی | +| ------------------ | ---------- | +| class | کلاس | +| function | تابع | +| bug | خطا | + + +## بدون تعییر + +مواردی که هنوز معادل مناسبی برای آن‌ها تعریف نشده‌است و ممکن است ترجمه آن در فهم مطلب اختلال ایجاد کند، در زیر آورده شده‌است. پیشنهاد می‌شود عین کلمه/عبارت انگلیسی در متن استفاده شود. + +| کلمه/عبارت | +| ------------------ | +| props | +| state | + + اگر فکر می‌کنید چیزی فراموش شده‌است یا نیاز به تصحیح دارد، حتما نظر خود را با ما درمیان بگذارید. +
\ No newline at end of file From 538404bafd33093301ae42052e6b1c2657ad0a3d Mon Sep 17 00:00:00 2001 From: Soroush Torkzadeh Date: Sun, 10 Feb 2019 13:29:13 +0330 Subject: [PATCH 2/7] Fix RTL problem By using html tags instaed of Markdown style --- TRANSLATION.md | 96 ++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 73 insertions(+), 23 deletions(-) diff --git a/TRANSLATION.md b/TRANSLATION.md index 78db0b037..3b234e7af 100644 --- a/TRANSLATION.md +++ b/TRANSLATION.md @@ -1,28 +1,78 @@ -
-# واژه‌نامه - +

واژه‌نامه

+

فهرستی از واژه‌های فنی و اصطلاحات موردنیاز شما در این‌جا آورده‌ شده‌است. - -## ترجمه‌شده +

+

ترجمه‌شده

+

ترجمه کلمه‌ها و اصطلاحاتی که معادل مناسبی در جامعه نرم‌افزاری ما برای آن‌ها تعریف شده‌است، در این جدول قرار گرفته‌است. - +

+

اگر عبارت موردنظر را در این لیست پیدا نکردید، شاید در بخش بعدی تعریف شده‌باشد. +

-| کلمه/عبارت | معادل پیشنهادی | -| ------------------ | ---------- | -| class | کلاس | -| function | تابع | -| bug | خطا | - - -## بدون تعییر - + + + + + + + + + + + + + + + + + + + + + +
+ کلمه/عبارت + + معادل پیشنهادی +
+ bug + + خطا +
+ class + + کلاس +
+ function + + تابع +
+

بدون تعییر

+

مواردی که هنوز معادل مناسبی برای آن‌ها تعریف نشده‌است و ممکن است ترجمه آن در فهم مطلب اختلال ایجاد کند، در زیر آورده شده‌است. پیشنهاد می‌شود عین کلمه/عبارت انگلیسی در متن استفاده شود. - -| کلمه/عبارت | -| ------------------ | -| props | -| state | - - اگر فکر می‌کنید چیزی فراموش شده‌است یا نیاز به تصحیح دارد، حتما نظر خود را با ما درمیان بگذارید. -

\ No newline at end of file +

+ + + + + + + + + + + + + + +
+ کلمه/عبارت +
+ props +
+ state +
+

+اگر فکر می‌کنید چیزی فراموش شده‌است یا نیاز به تصحیح دارد، حتما نظر خود را با ما درمیان بگذارید. +

\ No newline at end of file From 680414e4d97d63a5e39d5f53bef6bf66ed39f9d1 Mon Sep 17 00:00:00 2001 From: Soroush Torkzadeh Date: Sun, 10 Feb 2019 23:00:50 +0330 Subject: [PATCH 3/7] Add STYLE-GUID.md --- STYLE-GUIDE.md | 109 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 109 insertions(+) create mode 100644 STYLE-GUIDE.md diff --git a/STYLE-GUIDE.md b/STYLE-GUIDE.md new file mode 100644 index 000000000..debc8b44f --- /dev/null +++ b/STYLE-GUIDE.md @@ -0,0 +1,109 @@ +

شیوه‌ نگارش

+ +

+برای حفظ یکپارچگی ترجمه در تمام صفحات و همچنین میان سایر زبان‌ها، لطفا قوانین زیر را مدنظر داشته‌باشید. +

+ +

آی‌دی عنوان‌ها

+ +

هر عنوانی یک آی‌دی منحصربه‌فرد دارد، مانند زیر:

+ +```md +## Try React {#try-react} +``` +

از ترجمه آی‌دی‌ها بپرهیزید! از آن‌ها برای هدایت به بخش‌های مختلف یک صفحه استفاده می‌شود. به خصوص اگر کاربر از یک لینک خارجی به یک بخش مورد نظر از صفحه هدایت شده‌باشد، این قابلیت از کار خواهد افتاد. برای مثال:

+ +```md +See the [beginning section](/getting-started#try-react) for more information. +``` + +

✅ صحیح:

+ +```md +## ری‌اکت را امتحان کنید {#try-react} +``` + +

❌ غلط:

+ +```md +## ری‌اکت را امتحان کنید {#react-ra-emtehan-konid} +``` +

ترجمه باعث از کار افتادن لینک بالا شده‌است.

+ + +

متن در کد

+

+فقط کامنت‌های یک کد را ترجمه کنید. شاید در بعضی موارد نیاز به ترجمه string باشد، اما نسبت به مواردی که ممکن است در منطق کد تغییر ایجاد کند آگاه باشید! +

+ +

مثال:

+ +```js +// Example +const element =

Hello, world

; +ReactDOM.render(element, document.getElementById('root')); +``` + +

✅ صحیح:

+ +```js +// مثال +const element =

Hello, world

; +ReactDOM.render(element, document.getElementById('root')); +``` + +

✅ صحیح:

+ +```js +// مثال +const element =

سلام، دنیا

; +ReactDOM.render(element, document.getElementById('root')); +``` + +

❌ غلط:

+ +```js +// مثال +const element =

سلام، دنیا

; +// "root" به آی‌دی یک تگ اشاره دارد +// نباید آن را ترجمه کرد! +ReactDOM.render(element, document.getElementById('ریشه')); +``` + +

❌ کاملا غلط:

+ +```js +// مثال +const eleman =

سلام، دنیا

; +ReactDOM.render(eleman, sanad.yaftanElemeanBaId('ریشه')); + +``` +

لینک‌های خارجی

+

+اگر یک لینک خارجی به یک مقاله از منابعی مانند شبکه توسعه‌دهنگان موزیلا (MDN) و ویکی‌پدیا (Wikipedia) ارجاع داده‌ شده‌است، در صورتی که نسخه فارسی آن مقاله موجود و از کیفیت مناسبی برخوردار است، به نسخه فارسی ارجاع داده‌شود. +

+ +

مثال:

+ +

+A stateful component inherits Component class. +

+ + + +

✅ صحیح:

+

+یک کامپوننت دارای state از کلاس Component ارث می‌برد. +

+
+

+برای لینک‌هایی که معادل فارسی ندارند مثل Stack Overflow و ویدیو‌های YouTube، از همان لینک انگلیسی استفاده‌شود. +

+ +

زبان فارسی

+

+هدف تمام مشارکت‌کنندگان تولید محتوای فارسی با بهترین کیفیت ممکن است تا به منبعی قابل استفاده برای همگان تبدیل شود. قطعا دستیابی به این هدف بدون رعایت شیوه‌ نگارش استاندارد فارسی میسر نخواهد‌شد. اگر نیاز به یک یادآوری داشتید، مقاله شیوه‌نامۀ «ویراستاران» برای نگارش در وب منبع مناسبی است. +

+

+اگر فکر می‌کنید چیزی فراموش شده‌است یا نیاز به تصحیح دارد، حتما نظر خود را با ما درمیان بگذارید. +

\ No newline at end of file From 4050dec6617153d92a54881b0ee733ae8d0ca562 Mon Sep 17 00:00:00 2001 From: Soroush Torkzadeh Date: Mon, 11 Feb 2019 12:45:59 +0330 Subject: [PATCH 4/7] Fix STYLE-GUIDE.md - Fix ID translation - Just translate comments of a code block and leave the other parts --- STYLE-GUIDE.md | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/STYLE-GUIDE.md b/STYLE-GUIDE.md index debc8b44f..81cf2ed52 100644 --- a/STYLE-GUIDE.md +++ b/STYLE-GUIDE.md @@ -4,18 +4,15 @@ برای حفظ یکپارچگی ترجمه در تمام صفحات و همچنین میان سایر زبان‌ها، لطفا قوانین زیر را مدنظر داشته‌باشید.

-

آی‌دی عنوان‌ها

+

شناسه عنوان‌ها

-

هر عنوانی یک آی‌دی منحصربه‌فرد دارد، مانند زیر:

+

هر عنوانی یک شناسه منحصربه‌فرد دارد، مانند زیر:

```md ## Try React {#try-react} ``` -

از ترجمه آی‌دی‌ها بپرهیزید! از آن‌ها برای هدایت به بخش‌های مختلف یک صفحه استفاده می‌شود. به خصوص اگر کاربر از یک لینک خارجی به یک بخش مورد نظر از صفحه هدایت شده‌باشد، این قابلیت از کار خواهد افتاد. برای مثال:

+

از ترجمه شناسه‌ها بپرهیزید! از آن‌ها برای هدایت به بخش‌های مختلف یک صفحه استفاده می‌شود. به خصوص اگر کاربر از یک لینک خارجی به یک بخش مورد نظر از صفحه هدایت شده‌باشد، این قابلیت از کار خواهد افتاد.

-```md -See the [beginning section](/getting-started#try-react) for more information. -```

✅ صحیح:

@@ -33,7 +30,7 @@ See the [beginning section](/getting-started#try-react) for more information.

متن در کد

-فقط کامنت‌های یک کد را ترجمه کنید. شاید در بعضی موارد نیاز به ترجمه string باشد، اما نسبت به مواردی که ممکن است در منطق کد تغییر ایجاد کند آگاه باشید! +فقط کامنت‌های یک کد را ترجمه کنید. از ترجمه دیگر بخش‌های کد بپرهیزید.

مثال:

@@ -52,7 +49,7 @@ const element =

Hello, world

; ReactDOM.render(element, document.getElementById('root')); ``` -

✅ صحیح:

+

❌ غلط:

```js // مثال @@ -65,7 +62,7 @@ ReactDOM.render(element, document.getElementById('root')); ```js // مثال const element =

سلام، دنیا

; -// "root" به آی‌دی یک تگ اشاره دارد +// "root" به شناسه یک تگ اشاره دارد // نباید آن را ترجمه کرد! ReactDOM.render(element, document.getElementById('ریشه')); ``` From af28db58135a1bea4a528f3679515b2015801649 Mon Sep 17 00:00:00 2001 From: Soroush Torkzadeh Date: Mon, 11 Feb 2019 19:39:54 +0330 Subject: [PATCH 5/7] Update README.md Translate the original version and add some new sections to help new contributors --- README.md | 184 +++++++++++++++++++++++++++++++++--------------------- 1 file changed, 114 insertions(+), 70 deletions(-) diff --git a/README.md b/README.md index ed0651b9f..6ec6046da 100644 --- a/README.md +++ b/README.md @@ -1,70 +1,114 @@ -# reactjs.org - -This repo contains the source code and documentation powering [reactjs.org](https://reactjs.org/). - -## Getting started - -### Prerequisites - -1. Git -1. Node: any 8.x version starting with 8.4.0 or greater -1. Yarn: See [Yarn website for installation instructions](https://yarnpkg.com/lang/en/docs/install/) -1. A fork of the repo (for any contributions) -1. A clone of the [reactjs.org repo](https://github.com/reactjs/reactjs.org) on your local machine - -### Installation - -1. `cd reactjs.org` to go into the project root -1. `yarn` to install the website's npm dependencies - -### Running locally - -1. `yarn dev` to start the hot-reloading development server (powered by [Gatsby](https://www.gatsbyjs.org)) -1. `open http://localhost:8000` 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](https://github.com/reactjs/reactjs.org/blob/master/CONTRIBUTING.md#guidelines-for-text) for the appropriate sections. - -### Create a branch - -1. `git checkout master` from any folder in your local `reactjs.org` repository -1. `git pull origin master` to ensure you have the latest main code -1. `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 - -1. Follow the "Running locally" instructions -1. Save the files and check in the browser - 1. Changes to React components in `src` will hot-reload - 1. Changes to markdown files in `content` will hot-reload - 1. If working with plugins, you may need to remove the `.cache` directory and restart the server - -### Test the change - -1. If possible, test any visual changes in all latest versions of common browsers, on both desktop and mobile. -1. Run `yarn check-all` from the project root. (This will run Prettier, ESLint, and Flow.) - -### Push it - -1. `git add -A && git commit -m "My message"` (replacing `My message` with a commit message, such as `Fixed header logo on Android`) to stage and commit your changes -1. `git push my-fork-name the-name-of-my-branch` -1. Go to the [reactjs.org repo](https://github.com/reactjs/reactjs.org) and you should see recently pushed branches. -1. Follow GitHub's instructions. -1. If possible, include screenshots of visual changes. A Netlify build will also be automatically created once you make your PR so other people can see your change. - -## Translation - -If you are interesting in translating `reactjs.org`, please see the current translation efforts at [isreacttranslatedyet.com](https://www.isreacttranslatedyet.com/). - - -If your language does not have a translation and you would like to create one, please follow the instructions at [reactjs.org Translations](https://github.com/reactjs/reactjs.org-translation#translating-reactjsorg). - -## Troubleshooting - -- `yarn reset` to clear the local cache - -## License -Content submitted to [reactjs.org](https://reactjs.org/) is CC-BY-4.0 licensed, as found in the [LICENSE-DOCS.md](https://github.com/open-source-explorer/reactjs.org/blob/master/LICENSE-DOCS.md) file. +

نسخه فارسی reactjs.org

+ +

+اگر این صفحه را مشاهده می‌کنید، احتمالا به ترجمه فارسی اسناد ری‌اکت (react) علاقه‌مند هستید. پس خوش‌ آمدید! +

+ +

+این رپو (repo) با هدف توسعه اسناد ری‌اکت به زبان فارسی، از reactjs/reactjs.org فورک (fork) شده‌است و هر روز با نسخه اصلی همگام‌سازی می‌شود. +

+ +

+پیشرفت نسخه فارسی را از isreacttranslatedyet.com دنبال کنید. +

+ +

چگونه مشارکت کنم؟

+ +

+پیشنهاد می‌شود به‌ترتیب از لینک‌های زیر شروع کنید: +

+ + +

+دریافت کد +

+ +

+پیش‌نیارها +

+ +
    +
  • + Git +
    • +
  • + Node.js نسخه ۸ (بعد از ۸.۴.۰) +
    • +
  • + Yarn +
    • +
+ +

نصب

+ +```bash +# 1. Clone the repo +git clone git@github.com:reactjs/fa.reactjs.org.git + +# 2. Go into the project root +cd fa.reactjs.org + +# 3. Install the website's npm dependencies +yarn +``` + +

اجرا

+ +```bash +# Start the hot-reloading development server (powered by Gatsby) +yarn dev +``` + +

+حالا آدرس http://localhost:8000 را در مرورگر دلخواه خود باز کنید و تمام! +

+ +

سوالی دارید؟

+ +‌

+اگر سوالی دارید با نگاه‌دارندگان تماس بگیرید یا یک مورد (issue) جدید ثبت کنید! +

+ +

نگاه‌دارندگان

+ + + + +

مجوز

+ +

+محتوایی که در reactjs.org قرار می‌گیرد، تخت مجوز CC-BY-4.0 منتشر می‌شود که جزئیات آن در LICENSE-DOCS.md آمده‌است. +

From f8a9c04b63b77b09c9cbd1caacd4f87994997321 Mon Sep 17 00:00:00 2001 From: Soroush Torkzadeh Date: Mon, 11 Feb 2019 20:18:31 +0330 Subject: [PATCH 6/7] Use a better word for "repo" translation --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6ec6046da..24a8382cf 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@

-این رپو (repo) با هدف توسعه اسناد ری‌اکت به زبان فارسی، از reactjs/reactjs.org فورک (fork) شده‌است و هر روز با نسخه اصلی همگام‌سازی می‌شود. +این مخزن (repo) با هدف توسعه اسناد ری‌اکت به زبان فارسی، از reactjs/reactjs.org فورک (fork) شده‌است و هر روز با نسخه اصلی همگام‌سازی می‌شود.

From 6838cde74ce3244448b6637135a57b6fb991c875 Mon Sep 17 00:00:00 2001 From: Soroush Torkzadeh Date: Mon, 11 Feb 2019 23:56:20 +0330 Subject: [PATCH 7/7] Apply @masoud-bahrami comments on README.md --- README.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 24a8382cf..2aa24eb71 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@

-این مخزن (repo) با هدف توسعه اسناد ری‌اکت به زبان فارسی، از reactjs/reactjs.org فورک (fork) شده‌است و هر روز با نسخه اصلی همگام‌سازی می‌شود. +این مخزن کد (repo) با هدف توسعه اسناد ری‌اکت به زبان فارسی، از reactjs/reactjs.org انشعاب (fork) گرفته‌است و پیوسته با نسخه اصلی همگام‌سازی می‌شود.

@@ -58,20 +58,20 @@

نصب

```bash -# 1. Clone the repo +# 1. یک کپی از مخزن کد بگیرید git clone git@github.com:reactjs/fa.reactjs.org.git -# 2. Go into the project root +# 2. به شاخه اصلی پروژه بروید cd fa.reactjs.org -# 3. Install the website's npm dependencies +# 3. وابستگی‌های npm سایت را نصب کنید yarn ```

اجرا

```bash -# Start the hot-reloading development server (powered by Gatsby) +# سرور توسعه با قابلیت بارگذاری خودکار را اجرا کنید (قدرت گرفته از Gatsby) yarn dev ``` @@ -82,7 +82,7 @@ yarn dev

سوالی دارید؟

‌

-اگر سوالی دارید با نگاه‌دارندگان تماس بگیرید یا یک مورد (issue) جدید ثبت کنید! +اگر سوالی دارید با نگاه‌دارندگان تماس بگیرید یا یک موضوع (issue) جدید ثبت کنید!

نگاه‌دارندگان