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

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

Open
wants to merge 9 commits into
base: master
Choose a base branch
from
Open
2 changes: 1 addition & 1 deletion docs/contributing/code-of-conduct.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ title: Gatsby Contributor Covenant Code of Conduct

## الإطار

تنطبق قواعد السلوك هذه على حد سواء داخل مساحات المشروع والمساحات العامة عندما يمثل الفرد المشروع أو مجتمعه. أمثلة على ذلك تشمل استخدام البريد الإلكتروني الرسمي للمشروع، أو النشر عبر الحساب الرسمي لوسائل التواصل الاجتماعي، أو التصرف كَممثل مُعَين في حدث عبر الإنترنت أو خارجه. وللمشرفين تعريف وتوضيح معنى تمثيل المشروع بشكل أوسع.
تنطبق قواعد السلوك هذه على حد سواء داخل مساحات المشروع والمساحات العامة عندما يمثل الفرد المشروع أو مجتمعه. أمثلة على ذلك تشمل استخدام البريد الإلكتروني الرسمي للمشروع، أو النشر عبر الحساب الرسمي لوسائل التواصل الاجتماعي، أو التصرف كَممثل مُعَين في حدث عبر الإنترنت أو خارجه. وللمشرفين تعريف وتوضيح معنى تمثيل المشروع بشكل أوسع.

## التنفيذ

Expand Down
16 changes: 9 additions & 7 deletions docs/docs/quick-start.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,43 +13,45 @@ title: بداية سريعة

**ملاحظة**: يستخدم هذا الفيديو `npx` ، وهي أداة لتنفيذ حزمة npm دون تثبيتها أولاً على جهازك. إن تشغيل الأمر `npx gatsby new` هو نفسه تشغيل `gatsby new` بعد تثبيت gatsby-cli على جهاز الكمبيوتر الخاص بك.

### تثبيت Gatsby CLI.
### تثبيت Gatsby CLI

```shell
npm install -g gatsby-cli
```

### انشاء موقع جديد.
> The above command installs Gatsby CLI globally on your machine.
asantarissy marked this conversation as resolved.
Show resolved Hide resolved

### انشاء موقع جديد

```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
Expand Down
4 changes: 4 additions & 0 deletions docs/tutorial/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,11 @@ disableTableOfContents: true

تقوم ثيمات Gatsby باختصار جميع الإعدادت الافتراضية (الدَوَالّ المشتركة ، البحث عن مصادر البيانات ، التصميم) خارج موقعك وفي حزمة قابلة للتثبيت.

<<<<<<< HEAD
هذا يعني أن الإعدادت والدَوَالّ لم تتم كتابتهما مباشرةً في مشروعك ، ولكنهما تداران مركزيًا وتثبتهما كتبعية (dependency). يمكنك تحديث ثيمة بسلاسة ، وإنشاء الثيمات معًا ، وحتى تبديل ثيمة متوافقة لأخرى.
=======
This means that the configuration and functionality aren’t directly written into your project, but rather versioned, centrally managed, and installed as a dependency. You can seamlessly update a theme, compose themes together, and even swap out one compatible theme for another.
>>>>>>> 90932a06db2e297cf416552b84e48b4b82e56fbc

تعلم اكثر حول استخدام وبناء الثيمات باستخدام [الدليل التطبيقي لثيمات Gatsby](/tutorial/theme-tutorials/).

Expand Down
32 changes: 32 additions & 0 deletions docs/tutorial/part-one/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,11 @@ gatsby new hello-world https://github.com/gatsbyjs/gatsby-starter-hello-world
gatsby new [SITE_DIRECTORY_NAME] [URL_OF_STARTER_GITHUB_REPO]
```

<<<<<<< HEAD
إذا حذفت عنوان URL من النهاية، سيتم تلقائيا إنشاء موقع Gatsby لك بإستخدام [**عدة البدء الإفتراضية**](https://github.com/gatsbyjs/gatsby-starter-default). بالنسبة إلى هذا القسم من الدليل التطبيقي، سنستمر بموقع “Hello World” الذي قمت بإنشائه بالفعل في الدليل التطبيقي السابق.
=======
If you omit a URL from the end, Gatsby will automatically generate a site for you based on the [**default starter**](https://github.com/gatsbyjs/gatsby-starter-default). For this section of the tutorial, stick with the “Hello World” site you already created in tutorial part zero. You can learn more about [modifying starters](/docs/modifying-a-starter) in the docs.
>>>>>>> 90932a06db2e297cf416552b84e48b4b82e56fbc

### ✋ افتح الشيفرة

Expand Down Expand Up @@ -165,7 +169,11 @@ export default () => (
)
```

<<<<<<< HEAD
2. انتقل إلى http://localhost:8000/about/.
=======
2. Navigate to `http://localhost:8000/about/`
>>>>>>> 90932a06db2e297cf416552b84e48b4b82e56fbc

![صفحة عن الجديدة](05-about-page.png)

Expand Down Expand Up @@ -230,7 +238,11 @@ export default () => (

### ماذا تكون الخصائص “props”?

<<<<<<< HEAD
لقد قمت في وقت سابق بتعريف مكونات React على أنها أجزاء قابلة لإعادة الاستخدام من الشيفرة تصف واجهة المستخدم. لجعل هذه القطع القابلة لإعادة الاستخدام ديناميكية، يجب أن تكون قادرًا على تزويدها ببيانات مختلفة. يمكنك القيام بذلك مع إدخال يسمى الخصائص “props". الخصائص (appropriately enough) المقدمة لمكونات React.
=======
Earlier, you defined React components as reusable pieces of code describing a UI. To make these reusable pieces dynamic you need to be able to supply them with different data. You do that with input called "props". Props are (appropriately enough) properties supplied to React components.
>>>>>>> 90932a06db2e297cf416552b84e48b4b82e56fbc

في ملف `about.js` لقد مررت الخاصية `headerText` prop مع قيمة `"عن Gatsby"` إلى المكون الفرعي المستوردة `Header`:

Expand Down Expand Up @@ -324,20 +336,34 @@ export default () => (
)
```

<<<<<<< HEAD
بعد أن تقوم بحفظ الملف، يجب أن ترى صفحة الاتصال وتكون قادرًا على الارتباط بينها وبين الصفحة الرئيسية.

<video controls="controls" loop="true">
<source type="video/mp4" src="./10-linking-between-pages.mp4"></source>
<p>المعذرة! متصفحك لا يدعم هذا الفيديو.</p>
=======
After you save the file, you should see the contact page and be able to follow the link to the homepage.

<video controls="controls" loop="true">
<source type="video/mp4" src="./10-linking-between-pages.mp4"></source>
<p>Sorry! Your browser doesn't support this video.</p>
>>>>>>> 90932a06db2e297cf416552b84e48b4b82e56fbc
</video>

المكون `<Link />` في Gatsby يقوم بعملية الربط بين الصفحات في موقعك. لربط صفحات خارجية لربط الصفحات الخارجية الغير مبنية في موقع Gatsby خاصتك. إستخدم وسم HTML الإعتيادي `<a>`.

## نشر موقع Gatsby

<<<<<<< HEAD
يعتبر Gatsby.js _مولد مواقع ساكنة_، بمعنى أنه لا توجد خوادم لإعدادها او قواعد بيانات معقده لنشرها. بدلاً عن ذلك، فالامر `build` في Gatsby ينتج مجلد يحتوي على ملفات HTML و JavaScript ساكنة والتي يمكن نشرها في خدمات إستضافة المواقع الساكنة.

جرب إستخدام [Surge](http://surge.sh/) لنشر موقعك الاول بإستخدام Gatsby. Surge يُعتبر واحد من العديد من "إستضافات المواقع الساكنة (static) " التي جعلت نشر مواقع Gatsby ممكنة.
=======
Gatsby.js is a _modern site generator_, which means there are no servers to set up or complicated databases to deploy. Instead, the Gatsby `build` command produces a directory of static HTML and JavaScript files which you can deploy to a static site hosting service.

Try using [Surge](http://surge.sh/) for deploying your first Gatsby website. Surge is one of many "static site hosts" which makes it possible to deploy Gatsby sites.
>>>>>>> 90932a06db2e297cf416552b84e48b4b82e56fbc

إذا لم تكن قد قمت بتثبيت &amp; إعداد Surge، افتح نافذة طرفية جديدة وقم بتثبيت أداة سطر الأوامر الخاصة به:

Expand Down Expand Up @@ -368,7 +394,13 @@ ls public
surge public/
```

<<<<<<< HEAD
بمجرد الانتهاء من تشغيل هذا، يجب أن تشاهد في جهاز الكمبيوتر الخاص بك شيء مثل:
=======
> 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.

Once this finishes running, you should see in your terminal something like:
>>>>>>> 90932a06db2e297cf416552b84e48b4b82e56fbc

![لقطة شاشة لنشر موقع Gatsby مع Surge](surge-deployment.png)

Expand Down
8 changes: 7 additions & 1 deletion docs/tutorial/part-three/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -270,9 +270,15 @@ export default ({ children }) => (
)
```

![with-navigation2](with-navigation2.png)
![with-navigation2](with-navigation.png)

<<<<<<< HEAD
وهناك لديك! موقع من ثلاث صفحات مع تنقل شامل أساسي.
=======
And there you have it! A three page site with basic global navigation.

_Challenge:_ With your new "layout component" powers, try adding headers, footers, global navigation, sidebars, etc. to your Gatsby sites!
>>>>>>> 90932a06db2e297cf416552b84e48b4b82e56fbc

__تحدي: _بفضل قوى "مكون التخطيط" الجديدة ، حاول إضافة الرؤوس والتذييلات والتنقل الشامل والأشرطة الجانبية وما إلى ذلك إلى مواقع Gatsby الخاصة بك!

Expand Down
24 changes: 24 additions & 0 deletions docs/tutorial/part-two/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,11 @@ import "./src/styles/global.css";
// require('./src/styles/global.css')
```

<<<<<<< HEAD
> ملاحظة: يعمل بناء جملة CommonJS (`requ`) و ES Module (`import`) هنا. إذا لم تكن متأكدًا من الخيار ، فسنستخدم "استيراد" معظم الوقت.
=======
> Note: Both CommonJS (`require`) and ES Module (`import`) syntax work here. If you’re not sure which to choose, `import` is usually a good default. When working with files that are only run in a Node.js environment however (like `gatsby-node.js`), `require` will need to be used.
>>>>>>> 90932a06db2e297cf416552b84e48b4b82e56fbc

3. ابدأ خادوم التطوير:

Expand Down Expand Up @@ -143,9 +147,15 @@ Gatsby يعمل خارج المألوف مع CSS Modules. ينصح بشدة هذ

1. قم بإنشاء دليل جديد على `src/components` ثم ، في هذا الدليل الجديد ، قم بإنشاء ملف باسم`container.js` ولصق ما يلي:

<<<<<<< HEAD
```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"
>>>>>>> 90932a06db2e297cf416552b84e48b4b82e56fbc

export default ({ children }) => (
<div className={containerStyles.container}>{children}</div>
Expand All @@ -167,8 +177,13 @@ export default ({ children }) => (

3. قم بإنشاء مكون صفحة جديد عن طريق إنشاء ملف في `src/pages/about-css-module.js`:

<<<<<<< HEAD
```javascript:title=src/pages/about-css-modules.js
import React from "react";
=======
```jsx:title=src/pages/about-css-modules.js
import React from "react"
>>>>>>> 90932a06db2e297cf416552b84e48b4b82e56fbc

import Container from "../components/container";

Expand Down Expand Up @@ -238,16 +253,25 @@ import Container from "../components/container";
console.log(styles);
```

<<<<<<< HEAD
ستقوم شفرة `console.log(styles)` بتسجيل الاستيراد الناتج حتى تتمكن من رؤية نتيجة ملفك المعالج`./about-css-modules.module.css` إذا قمت بفتح وحدة تحكم مطوّر البرامج (باستخدام أدوات مطوري Firefox أو Chrome) في متصفحك ، فسترى:
=======
The `console.log(styles)` code will log the resulting import so you can see the result of your processed `./about-css-modules.module.css` file. If you open the developer console (using e.g. Firefox or Chrome's developer tools, often by the F12 key) in your browser, you'll see:
>>>>>>> 90932a06db2e297cf416552b84e48b4b82e56fbc

![استيراد نتيجة وحدة CSS في وحدة التحكم](css-modules-console.png)

إذا قارنت ذلك بملف CSS الخاص بك ، فسترى أن كل فصل دراسي أصبح الآن مفتاحًا في الكائن المستورد يشير إلى سلسلة طويلة على سبيل المثال `avatar` تشير إلى صفحات src---- about-css-modules-module---avatar---2lRF7`. هذه هي أسماء الفئات التي تنشئها وحدات CSS. أنها مضمونة لتكون فريدة من نوعها عبر موقعك. ولأنه يتعين عليك استيرادها لاستخدام الفصول الدراسية ، فلا يوجد أي سؤال حول مكان استخدام بعض CSS.

<<<<<<< HEAD
4. قم بإنشاء مكون `User`.

قم بإنشاء مكون جديد `<User />` مضمن في صفحة`about-css-modules.js`
مكون. تعديل `about-css-modules.js` بحيث يبدو كما يلي:
=======
4. Create a new `<User />` component inline in the `about-css-modules.js` page
component. Modify `about-css-modules.js` so it looks like the following:
>>>>>>> 90932a06db2e297cf416552b84e48b4b82e56fbc

```jsx:title=src/pages/about-css-modules.js
import React from "react";
Expand Down
Loading