(sync) Resolve conflicts with gatsby-i18n-source @ 90932a0

docs/contributing/code-of-conduct.md

@@ -32,7 +32,7 @@ title: Gatsby Contributor Covenant Code of Conduct
 
 ## الإطار
 
-تنطبق قواعد السلوك هذه على حد سواء داخل مساحات المشروع والمساحات العامة عندما يمثل الفرد المشروع أو مجتمعه. أمثلة على ذلك تشمل استخدام البريد الإلكتروني الرسمي للمشروع، أو النشر عبر الحساب الرسمي لوسائل التواصل الاجتماعي، أو التصرف كَممثل مُعَين في حدث عبر الإنترنت أو خارجه.  وللمشرفين تعريف وتوضيح معنى تمثيل المشروع بشكل أوسع.
+تنطبق قواعد السلوك هذه على حد سواء داخل مساحات المشروع والمساحات العامة عندما يمثل الفرد المشروع أو مجتمعه. أمثلة على ذلك تشمل استخدام البريد الإلكتروني الرسمي للمشروع، أو النشر عبر الحساب الرسمي لوسائل التواصل الاجتماعي، أو التصرف كَممثل مُعَين في حدث عبر الإنترنت أو خارجه. وللمشرفين تعريف وتوضيح معنى تمثيل المشروع بشكل أوسع.
 
 ## التنفيذ
 

docs/docs/quick-start.md

@@ -13,43 +13,45 @@ title: بداية سريعة
 
 **ملاحظة**: يستخدم هذا الفيديو `npx` ، وهي أداة لتنفيذ حزمة npm دون تثبيتها أولاً على جهازك. إن تشغيل الأمر `npx gatsby new` هو نفسه تشغيل `gatsby new` بعد تثبيت gatsby-cli على جهاز الكمبيوتر الخاص بك.
 
-### تثبيت Gatsby CLI.
+### تثبيت Gatsby CLI
 
 ```shell
 npm install -g gatsby-cli
 ```
 
-### انشاء موقع جديد.
+> يقوم الأمر أعلاه بتثبيت Gatsby CLI على جهازك.
+
+### انشاء موقع جديد
 
 ```shell
 gatsby new gatsby-site
 ```
 
-### تغيير الدلائل إلى مجلد الموقع.
+### تغيير الدلائل إلى مجلد الموقع
 
 ```shell
 cd gatsby-site
 ```
 
-### بدء خادم التطوير.
+### بدء خادم التطوير
 
 ```shell
 gatsby develop
 ```
 
-سيبدأ Gatsby في بيئة تطوير سريعة التحميل (hot-reloading) يمكن الوصول إليها افتراضيًا على `localhost:8000`.
+سيبدأ Gatsby في بيئة تطوير سريعة التحميل (hot-reloading) يمكن الوصول إليها افتراضيًا على `http://localhost:8000`.
 
 حاول تحرير صفحات JavaScript في `src / pages`. سيتم حفظ التغييرات بشكل مباشر في المتصفح.
 
-### إنشاء بناء الإنتاج.
+### إنشاء بناء الإنتاج
 
 ```shell
 gatsby build
 ```
 
 ستعمل Gatsby على إنشاء إنتاج مُحسّن لموقعك ، من خلال إنشاء حزم HTML ثابتة وحزم شفرة JavaScript.
 
-### خدمة إنتاج البناء محليا.
+### خدمة إنتاج البناء محليا
 
 ```shell
 gatsby serve

docs/tutorial/part-one/index.md

@@ -20,7 +20,7 @@ gatsby new hello-world https://github.com/gatsbyjs/gatsby-starter-hello-world
 gatsby new [SITE_DIRECTORY_NAME] [URL_OF_STARTER_GITHUB_REPO]
 ```
 
-إذا حذفت عنوان URL من النهاية، سيتم تلقائيا إنشاء موقع Gatsby لك بإستخدام [**عدة البدء الإفتراضية**](https://github.com/gatsbyjs/gatsby-starter-default). بالنسبة إلى هذا القسم من الدليل التطبيقي، سنستمر بموقع “Hello World” الذي قمت بإنشائه بالفعل في الدليل التطبيقي السابق.
+إذا حذفت عنوان URL من النهاية، سيتم تلقائيا إنشاء موقع Gatsby لك بإستخدام [**عدة البدء الإفتراضية**](https://github.com/gatsbyjs/gatsby-starter-default). بالنسبة إلى هذا القسم من الدليل التطبيقي، سنستمر بموقع “Hello World” الذي قمت بإنشائه بالفعل في الدليل التطبيقي السابق. من هنا يمكنك التعلم أكثر عن [تعديل عدة البدء الإفتراضية](/docs/modifying-a-starter)
 
 ### ✋ افتح الشيفرة
 
@@ -165,7 +165,7 @@ export default () => (
 )
 ```
 
-2. انتقل إلى http://localhost:8000/about/.
+2. انتقل إلى `http://localhost:8000/about/`
 
 ![صفحة عن الجديدة](05-about-page.png)
 
@@ -370,6 +370,8 @@ surge public/
 
 بمجرد الانتهاء من تشغيل هذا، يجب أن تشاهد في جهاز الكمبيوتر الخاص بك شيء مثل:
 
+> Note that you will have to press the `enter` key after you see the `domain: some-name.surge.sh` information on your command-line interface.
+
 ![لقطة شاشة لنشر موقع Gatsby مع Surge](surge-deployment.png)
 
 قم بفتح رابط عنوان الويب في السطر السفلي (في هذه الحاله `lowly-pain.surge.sh`) وسترى موقعك المنشور حديثًا! عمل عظيم!

docs/tutorial/part-three/index.md

@@ -270,7 +270,7 @@ export default ({ children }) => (
 )
 ```
 
-![with-navigation2](with-navigation2.png)
+![with-navigation2](with-navigation.png)
 
 وهناك لديك! موقع من ثلاث صفحات مع تنقل شامل أساسي.
 

docs/tutorial/part-two/index.md

@@ -105,7 +105,7 @@ import "./src/styles/global.css";
 // require('./src/styles/global.css')
 ```
 
-> ملاحظة: يعمل بناء جملة CommonJS (`requ`) و ES Module (`import`) هنا. إذا لم تكن متأكدًا من الخيار ، فسنستخدم "استيراد" معظم الوقت.
+> ملاحظة: يعمل بناء جملة CommonJS (`require`) و ES Module (`import`) هنا. إذا لم تكن متأكدًا من الخيار ، فسنستخدم `import` معظم الوقت. يتوجب عليك استخدام `require` عند العمل على ملفات تعمل فقط على بيئة عمل `Node.js` (مثل `gatsby-node.js`)
 
 3. ابدأ خادوم التطوير:
 
@@ -143,9 +143,9 @@ Gatsby يعمل خارج المألوف مع CSS Modules. ينصح بشدة هذ
 
 1. قم بإنشاء دليل جديد على `src/components` ثم ، في هذا الدليل الجديد ، قم بإنشاء ملف باسم`container.js` ولصق ما يلي:
 
-```javascript:title=src/components/container.js
-import React from "react";
-import containerStyles from "./container.module.css";
+```jsx:title=src/components/container.js
+import React from "react"
+import containerStyles from "./container.module.css"
 
 export default ({ children }) => (
   <div className={containerStyles.container}>{children}</div>
@@ -167,8 +167,8 @@ export default ({ children }) => (
 
 3. قم بإنشاء مكون صفحة جديد عن طريق إنشاء ملف في `src/pages/about-css-module.js`:
 
-```javascript:title=src/pages/about-css-modules.js
-import React from "react";
+```jsx:title=src/pages/about-css-modules.js
+import React from "react"
 
 import Container from "../components/container";
 
@@ -244,9 +244,7 @@ console.log(styles);
 
 إذا قارنت ذلك بملف CSS الخاص بك ، فسترى أن كل فصل دراسي أصبح الآن مفتاحًا في الكائن المستورد يشير إلى سلسلة طويلة على سبيل المثال `avatar` تشير إلى صفحات src---- about-css-modules-module---avatar---2lRF7`. هذه هي أسماء الفئات التي تنشئها وحدات CSS. أنها مضمونة لتكون فريدة من نوعها عبر موقعك. ولأنه يتعين عليك استيرادها لاستخدام الفصول الدراسية ، فلا يوجد أي سؤال حول مكان استخدام بعض CSS.
 
-4. قم بإنشاء مكون `User`.
-
-قم بإنشاء مكون جديد `<User />` مضمن في صفحة`about-css-modules.js`
+4. قم بإنشاء مكون جديد `<User />` مضمن في صفحة`about-css-modules.js`
 مكون. تعديل `about-css-modules.js` بحيث يبدو كما يلي:
 
 ```jsx:title=src/pages/about-css-modules.js

docs/tutorial/part-zero/index.md

@@ -12,44 +12,84 @@ disableTableOfContents: true
 
 نتوقف لحظة لتحديد مكان وفتح واجهة سطر الأوامر (CLI) في جهاز الحاسب الخاص بك. اعتمادًا على نظام التشغيل الذي تستخدمه ، راجع [**إرشادات لنظام التشغيل Mac**](http://www.macworld.co.uk/feature/mac-software/how-use-terminal-on-mac-3608274/) أو [**تعليمات لنظام التشغيل Windows**](https://www.quora.com/How-do-I-open-terminal-in-windows) أو [**تعليمات لنظام التشغيل Linux**](https://www.howtogeek.com/140679/beginner-geek-how-to-start-using-the-linux-terminal/).
 
-## تثبيت Homebrew لـ Node.js
+_Note: If you’re new to the command line, "running" a command, means "writing a given set of instructions in your command prompt, and hitting the Enter key". Commands will be shown in a highlighted box, something like `node --version`, but not every highlighted box is a command! If something is a command it will be mentioned as something you have to run/execute._
+
+## Install Node.js for your appropriate operating system
+
+Node.js is an environment that can run JavaScript code outside of a web browser. Gatsby is built with Node.js. To get up and running with Gatsby, you’ll need to have a recent version installed on your computer. npm comes bundled with Node.js so if you don't have npm, chances are that you don't have Node.js either.
+
+### تعليمات مستخدمو Mac
 
 لتثبيت Gatsby و Node.js ، يوصى باستخدام [Homebrew](https://brew.sh/). مجموعة تنصيبات صغيرة في البداية يمكن أن تجنبك بعض الصداع في وقت لاحق!
 
-كيفية تثبت أو تتحقق من Homebrew على جهازك:
+#### كيفية تثبت أو تتحقق من Homebrew على جهازك:
 
 1. قم بفتح "الطرفية Terminal".
-1. تاكد ما إذا تم تثبيت Homebrew عن طريق تنفيذ `brew -v`. يجب أن تشاهد "Homebrew" ورقم الإصدار.
-1. اذا لم يظهر لك, حمل ونصب [Homebrew باتباع التعليمات](https://docs.brew.sh/Installation) لنظام التشغيل الخاص بك (Mac أو Linux أو Windows).
-1. بمجرد تثبيت Homebrew ، كرر الخطوة رقم 2 للتحقق.
+2. تاكد ما إذا تم تثبيت Homebrew عن طريق تنفيذ `brew -v`. يجب أن تشاهد "Homebrew" ورقم الإصدار.
+3. اذا لم يظهر لك، حمل ونصب [Homebrew باتباع التعليمات](https://docs.brew.sh/Installation).
+4. بمجرد تثبيت Homebrew ، كرر الخطوة رقم 2 للتحقق.
 
-### مستخدمو Mac: قم بتثبيت أدوات سطر أوامر Xcode
+#### قم بتثبيت أدوات سطر أوامر Xcode:
 
 1. قم بفتح "الطرفية Terminal".
-1. على نظام Mac ، قم بتثبيت أدوات سطر أوامر Xcode عن طريق تشغيل `xcode-select --install`.
-   1. إذا فشل ذلك ، قم بتنزيله [مباشرةً من موقع Apple](https://developer.apple.com/download/more/) ، بعد تسجيل الدخول باستخدام حساب مطور Apple
-1. بعد مطالبتك ببدء التثبيت ، ستتم مطالبتك مرة أخرى بقبول ترخيص برنامج للأدوات المراد تنزيلها.
+2. قم بتثبيت أدوات سطر أوامر Xcode عن طريق تشغيل `xcode-select --install`.
+   - إذا فشل ذلك، قم بتنزيله [مباشرةً من موقع Apple](https://developer.apple.com/download/more/) بعد تسجيل الدخول باستخدام حساب مطور Apple
+3. بعد مطالبتك ببدء التثبيت ، ستتم مطالبتك مرة أخرى بقبول ترخيص برنامج للأدوات المراد تنزيلها.
 
-## ⌚ تثبيت Node.js و npm
+#### Install Node
 
-Node.js عبارة عن بئية لتشغيل شيفرة JavaScript خارج المتصفح. Gatsby مبنية بإستخدام Node.js. لتشغيل Gatsby, ستحتاج إلى تثبيت إصدار حديث على جهاز الحاسب الخاص بك.
-_ملاحظة: الاصدار الادنى المتوافق مع Gatsby هو الاصدار 8, وبالامكان إستخدام أصدارات أحدث_
+1. Open your Terminal
+2. Run `brew install node`
+   - If you don't want to install it through Homebrew, download the latest Node.js version from [the official Node.js website](https://nodejs.org/en/), double click on the downloaded file and go through the installation process.
 
-1. قم بفتح "الطرفية Terminal".
-1. نفذ `brew update` للتأكد من أن لديك أحدث إصدار من Homebrew.
-1. قم بتنفيذ هذا الأمر لتثبيت Node و npm دفعة واحدة: `brew install node`
+### Windows Instructions
 
-بمجرد اتباع خطوات التثبيت ، تأكد من تثبيت كل شيء بشكل صحيح:
+- Download and install the latest Node.js version from [the official Node.js website](https://nodejs.org/en/)
 
-### تحقق من تثبيت Node.js الخاص بك
+### Linux Instructions
 
-1. قم بفتح "الطرفية Terminal".
-2. نفذ `node --version`. (اذا كنت مبتدى مع سطر الاوامر, “نفذ `الامر`” يقصد بها “إكتب `node --version` في موجه الأوامر "الطرفية Terminal", واضغط على مفتاح Enter”. من هنا ، هذا ما نعنيه “بنفذ `الامر`”).
-3. نفذ `npm --version`.
+Install nvm (Node Version Manager) and needed dependencies. nvm is used to manage Node.js and all its associated versions.
+
+_💡 If when installing a package, it asks for confirmation, type `y` and press enter._
+
+#### Ubuntu, Debian, and other `apt` based distros:
+
+1. Run `sudo apt update` and then `sudo apt -y upgrade` to make sure your Linux distribution is ready to go.
+2. Run `sudo apt-get install curl` to install curl which allows you to transfer data and download additional dependencies.
+3. After it finishes installing, run `curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.1/install.sh | bash` to download the latest nvm version.
+4. To confirm this has worked, use the following command. `nvm --version`. The output should be a version number.
+5. [Set default Node.js version](#set-default-nodejs-version)
+
+#### Arch, Manjaro and other `pacman` based distros:
+
+1. Run `sudo pacman -Sy` to make sure your distribution is ready to go.
+2. These distros come installed with curl, so you can use that to download nvm.
+   `curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.1/install.sh | bash`
+3. Before using nvm, you need to install additional dependencies by running `sudo pacman -S grep awk tar`.
+4. To confirm this has worked, use the following command. `nvm --version`. The output should be a version number.
+5. [Set default Node.js version](#set-default-nodejs-version)
+
+#### Fedora, RedHat, and other `dnf` based distros:
+
+1. These distros come installed with curl, so you can use that to download nvm.
+   `curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.1/install.sh | bash`
+2. To confirm this has worked, use the following command. `nvm --version`. The output should be a version number.
+3. [Set default Node.js version](#set-default-nodejs-version)
+
+If the Linux distribution you are using is not listed here, please find instructions on the web.
+
+#### Set default Node.js version
+
+When nvm is installed, it does not default to a particular node version. You’ll need to install the version you want and give nvm instructions to use it. This example uses the latest release of version 10, but more recent version numbers can be used instead.
+
+```shell
+nvm install 10
+nvm use 10
+```
 
-مخرجات الاوامر السابقة يجيب انت تكون رقم الاصدار. قد لا تتماثل اصداراتك مع الاصدارات الظاهرة بالاسفل! واذا كان تنفيذ الاوامر السابقة لا يعرض لك رقم اصدار, عد وتاكد من من تثبيت Node.js.
+To confirm that this worked, you can run `npm --version` and `node --version`. The output should look similar to the screenshot below, showing version numbers in response to the commands.
 
-![تحقق إصدارات العقدة و npm في "الطرفية Terminal"](01-node-npm-versions.png)
+Once you have followed the installation steps and you have checked everything is installed properly, you can continue to the next step.
 
 ## تثبيت Git
 
@@ -113,15 +153,15 @@ gatsby develop
 
 ### عرض موقعك محليا
 
-افتح علامة تبويب جديدة في متصفحك وانتقل إلى الرابط [**http://localhost:8000**](http://localhost:8000/).
+افتح علامة تبويب جديدة في متصفحك وانتقل إلى الرابط `http://localhost:8000/`
 
 ![تحقق من الصفحة الرئيسية](04-home-page.png)
 
 مبروك! هذه هي بداية موقعك Gatsby الأول! 🎉
 
-ستتمكن من زيارة الموقع محليًا على [**_http://localhost:8000_**](http://localhost:8000/) طالما أن خادم التطوير الخاص بك يعمل. هذه هي العملية التي بدأت بتنفيذ الامر `gatsby develop`. لوقف تشغيل هذه العملية (أو “للتوقف عن تشغيل خادم التطوير”), العودة إلى النافذة الطرفية الخاصة بك ، اضغط باستمرار على مفتاح “التحكم”, ثم إضغط على “c” (ctrl-c). لبدء ذلك مرة أخرى, نفذ `gatsby develop` مرة أخرى!
+ستتمكن من زيارة الموقع محليًا على `http://localhost:8000/` طالما أن خادم التطوير الخاص بك يعمل. هذه هي العملية التي بدأت بتنفيذ الامر `gatsby develop`. لوقف تشغيل هذه العملية (أو “للتوقف عن تشغيل خادم التطوير”), العودة إلى النافذة الطرفية الخاصة بك ، اضغط باستمرار على مفتاح “التحكم”, ثم إضغط على “c” (ctrl-c). لبدء ذلك مرة أخرى, نفذ `gatsby develop` مرة أخرى!
 
-**ملاحظة:** إذا كنت تستخدم إعداد VM مثل `vagrant` و / أو ترغب في الاستماع على عنوان IP المحلي الخاص بك, نفذ `gatsby develop -- --host=0.0.0.0`. الآن، يستمع خادم التطوير على كل من localhost و IP المحلي الخاص بك.
+**ملاحظة:** إذا كنت تستخدم إعداد VM مثل `vagrant` و / أو ترغب في الاستماع على عنوان IP المحلي الخاص بك, نفذ `gatsby develop -- --host=0.0.0.0`. الآن، يستمع خادم التطوير على كل من `http://localhost` و IP المحلي الخاص بك.
 
 ## إعداد محرر الشيفرة البرمجية