Merge branch 'main' into update-editor-setup-i18n

withastro · Apr 29, 2024 · 5651ac9 · 5651ac9
2 parents ca0901e + 393e60e
commit 5651ac9
Show file tree

Hide file tree

Showing 7 changed files with 704 additions and 277 deletions.
diff --git a/src/content/docs/ar/contribute.mdx b/src/content/docs/ar/contribute.mdx
@@ -44,14 +44,9 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
 
 لدينا العديد من الأدلة التي تحتوي على معلومات حول كيفية البدء في المساهمة في أسترو!
 
-- [دليل المساهمة الرئيسي](https://github.com/withastro/docs/blob/main/CONTRIBUTING.md) - يرجى تفقد هذا الدليل أولًا!
-- [دليل الكتابة](https://contribute.docs.astro.build/guides/writing-style/) - نصائح للكتابة بأسلوب مستندات أسترو.
-- [دليل الترجمة](https://contribute.docs.astro.build/guides/i18n/) - معلومات حول كيفية المساعدة في ترجمة مستندات أسترو إلى لغتك.
-- [دليل الوصفة](https://contribute.docs.astro.build/guides/recipe-writing/) - تعرف على كيفية كتابة الوصفة والمساهمة فيها.
-
-هذه إرشادات لمستودع المستندات لأدوار  محددة داخل مجتمع أسترو.
-- [دليل المشرف](https://contribute.docs.astro.build/roles/maintainers/) - كيفية الحفاظ على هذا المستودع بصفتك مشرف أسترو.
-- [دليل فريق الدعم](https://contribute.docs.astro.build/roles/support-squad/) - كيفية مساعدة فريق المستندات كجزء من دورك في فريق الدعم.
+سواء كانت مساهمتك الأولى في المشاريع المفتوحة المصدر ، أو تحتاج إلى إضافة مستندات لميزة أسترو الجديدة التي قمت بإنشائها للتو ، أو أنك مترجم متمرس يبحث عن الصفحة التالية للترجمة ، أو ترغب في معرفة المزيد عن كيفية المساعدة كمراجِع للعلاقات العامة ... لقد حصلت التغطية !
+
+يرجى زيارة موقعنا المخصص [*Astro Docs* Docs](https://contribute.docs.astro.build) ، حيث ستجد وثائقنا لمساعدتك في المساهمة في مستندات أسترو كإصلاح مطبعي ، كاتب ، مترجم ، بناء ميزة ، وحتى كمراجع العلاقات العامة.
 
 ## مساهمينا
 

diff --git a/src/content/docs/ar/getting-started.mdx b/src/content/docs/ar/getting-started.mdx
@@ -1,117 +1,68 @@
 ---
-title: دليل البداية
-description: مقدمة بسيطة عن أسترو.
+title: ابدء
+description: مقدمة أساسية إلى أسترو.
+i18nReady: true
+tableOfContents: false
+editUrl: false
+next: false
+banner:
+  content: |
+    <a href="https://astro.build/blog/astro-4/"> الإصدار 4.0 لأسترو هنا!</a>
+    هل أنت مستعد للترقية؟ <a href="/ar/guides/upgrade-to/v4/">اقرأ دليل الترقية الخاص بنا</a>.
+hero:
+  title: مستندات أسترو
+  tagline: المرشدين والموارد ومراجع API لمساعدتك في البناء مع أسترو.
+  actions:
+    - text: البدء
+      icon: rocket
+      link: /ar/install/auto/
+      variant: primary
+    - text: تعرف على ميزات أسترو
+      icon: right-arrow
+      link: /ar/concepts/why-astro/
+  facepile:
+    tagline: مدعوم من أسترو ومساهمي البرامج المفتوحة المصدر.
+    linkText: انضم إلينا!
+    link: /ar/contribute/
 ---
-import Button from '~/components/Button.astro'
-import TranslatorList from '~/components/TranslatorList.astro'
-import ContributorList from '~/components/ContributorList.astro'
-import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
 
-
-:::tip[نسخة أسترو 3.0 هنا!]
-**ما الجديد في نسخة أسترو 3.0?** [
-اقرأ المدونة الخاصة بالإعلان
-](https://astro.build/blog/astro-3/).  
-**مستعد للترقية؟** [تابع دليلنا للترقية](/ar/guides/upgrade-to/v3/).
-:::
-
-<h2>ما هو أسترو؟</h2>
-
-أسترو هو إطار عمل ويب **شامل** لبناء مواقع ويب **سريعة** تركز على **المحتوى**.
-
-## أهم المميزات
-
-- **Component Islands (جُزر المكونات)**: معمارية ويب جديدة لبناء مواقع سريعة كالبرق.
-- **Server-first API (مبدأ على الخادم أولًا)**: نقلنا التروية المكلفة عن أجهزة المستخدم.
-- **صفر-جافاسكربت بشكل افتراضي**: لا يوجد حِمل جافاسكربت إضافي وقت الشتغيل لإبطائك.
-- **Edge-ready**: انشر في أي مكان، حتى في بيئات تشغيل حواف عالمية مثل Deno أو Cloudflare.
-- **قابل للتخصيص**: Tailwind, MDX, وأكثر من 100+ إضافة أخرى لتختار منها.
-- **محايد لأطر عمل الواجهات البرمجية**: قابل للاستخدام مع أي إطار واجهة مستخدم مثل: React و Preact و Svelte و Vue و Solid و Lit وأكثر.
-
-ألقِ نظرة على تحليلنا التفصيلي [لماذا أسترو](/ar/concepts/why-astro/) لمعرفة المزيد عن ما يجعل أسترو مميزًا. ✨
-
-## جرب أسترو على متصفحك
-
-قم بزيارة [astro.new](https://astro.new/) واختر من بين مجموعة متنوعة من القوالب للبدء. يمكنك تجربة نسخة كاملة من أسترو مباشرة في متصفحك!
-
-<div style="display: flex; flex-wrap: wrap; gap: 0.5rem;">
-    <Button link="https://astro.new/basics?on=stackblitz">جرب قالب بسيط</Button>
-    <Button variant="secondary" link="https://astro.new/">تفقد جميع القوالب ←</Button>
-</div>
-
-## ابدأ مشروعك الاول مع أسترو
-
-<PackageManagerTabs>
-  <Fragment slot="npm">
-  ```shell
-  # create a new project with npm
-  npm create astro@latest
-  ```
-  </Fragment>
-  <Fragment slot="pnpm">
-  ```shell
-  # create a new project with pnpm
-  pnpm create astro@latest
-  ```
-  </Fragment>
-  <Fragment slot="yarn">
-  ```shell
-  # create a new project with yarn
-  yarn create astro
-  ```
-  </Fragment>
-</PackageManagerTabs>
-
-يحتوي [دليل التثبيت](/ar/install/auto/) الخاص بنا على إرشادات كاملة خطوة بخطوة لتثبيت أسترو باستخدام CLI الخاص بنا، وإنشاء مشروع جديد من مستودع GitHub، ولتثبيت أسترو يدويًا.
-
-## تعلم أسترو
-
-أمثلة لبعض المفاهيم الأساسية والأنماط المتعلقة بأسترو!
-
-📚 [انشئ أول صفحة](/ar/basics/astro-pages/) في موقعك.
-
-📚 اقرأ أكثر عن [هياكل مشاريع](/ar/basics/project-structure/) أسترو.
-
-📚 تعلم أكثر عن [التوجيه القائم على الملفات](/ar/guides/routing/) في أسترو.
-
-*... تفقد التوثيق الكامل للـ API عبر خانة  **مراجع** أعلى الصفحة.*
-
-## ابحر مع أسترو
-
-🧰 ابدأ مشروعك القادم باستخدام إحدى [القوالب المبنية مسبقًا](https://astro.build/themes/).
-
-🧰 
-خصص موقعك، عبر عشرات الإضافات التي يوفرها أسترو ومجتمعه، [تصفح الإضافات](https://astro.build/integrations/).
-
-🧰 احصل على الإلهام من خلال زيارة [معرض مواقعنا](https://astro.build/showcase/).
-
-*... تفقد [دليل التعامل مع الإضافات](/ar/guides/integrations-guide/)*.
-
-## انضم إلى مجتمعنا
-
-انضم إلى مجتمع [أسترو على ديسكورد](https://astro.build/chat) للمشاركة والحصول على المساعدة من مجتمع نشط وودود!
-
-💬 رحّب وعرف بنفسك على قناة `#general`!
-
-💬 اطرح أسئلتك على فريق المساعدة في قناة `#support`!
-
-💬 شاركنا ما تعمل عليه على قناة `#showcase`!
-
-## ما الجديد؟
-
-[مدونة أسترو](https://astro.build/blog/)
-
-[سجل تغييرات أسترو](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md)
-
-<TranslatorList githubRepo="withastro/docs">
-
-## الترجمة
-
-تراجم هذه المستندات مقدمة إليكم بسبب هؤلاء الأشخاص الرائعين. [ساعدنا!](https://contribute.docs.astro.build/guides/i18n/)
-</TranslatorList>
-
-## ساهم
-
-أنت تُطالع هذا التوثيق بفضل كل هؤلاء المساهمين، [انضم إلينا على GitHub!](https://github.com/withastro/docs)
-
-<ContributorList githubRepo="withastro/docs" />
+import { CardGrid } from '@astrojs/starlight/components'
+import Card from '~/components/Landing/Card.astro'
+import ListCard from '~/components/Landing/ListCard.astro'
+import SplitCard from '~/components/Landing/SplitCard.astro'
+import Discord from '~/components/Landing/Discord.astro'
+
+<CardGrid>
+  <Card title="ماذا ستبني مع أسترو" icon="laptop">
+    استكشف [Astro starter themes](https://astro.build/themes/) للمدونات ، المحافظ ، المستندات ، الصفحات المقصودة ، SaaS ، التسويق ، مواقع التجارة الإلكترونية ، والمزيد!
+  </Card>
+
+  <Card title="قم بجولة إرشاد" icon="star">
+    أكمل التمهيدية لدينا [بناء برنامج تعليمي للمدونة](/ar/tutorial/0-introduction/) لتعلم الأساسيات وإنشاء موقع أسترو الأول.
+  </Card>
+
+  <SplitCard title="ابدأ مشروعًا جديدًا" icon="rocket">
+    ```sh
+    # create a new project with npm
+    npm create astro@latest
+    ```
+
+    [دليلنا للتثبيت](/ar/install/auto/) لديه إرشادات خطوة بخطوة لتثبيت أسترو باستخدام معالج CLI الخاص بنا ، وإنشاء مشروع جديد من مستودع Astro Github موجود ، ولتثبيت أسترو يدويًا.
+  </SplitCard>
+
+  <ListCard title="تعلم" icon="open-book">
+    - [ميزات أسترو الرئيسية](/ar/concepts/why-astro/)
+    - [الهندسة المعمارية الجزيرة](/ar/concepts/islands/)
+    - [مكونات أسترو](/ar/basics/astro-components/)
+    - [بناء جملة قالب أسترو](/ar/basics/astro-syntax/)
+  </ListCard>
+
+  <ListCard title="امتداد" icon="puzzle">
+    - [أضف تكاملًا مثل React و Tailwind](/ar/guides/integrations-guide/)
+    - [قم بإنشاء مجموعات محتوى آمنة النوع](/ar/guides/content-collections/)
+    - [تعزيز التنقل مع view transitions](/ar/guides/view-transitions/)
+    - [قم بربط headless CMS إلى مشروعك](/ar/guides/cms/)
+  </ListCard>
+</CardGrid>
+
+<Discord title="هل لديك سؤال أو تريد المشاركة؟" cta="انضم إلينا على Discord"/>
diff --git a/src/content/docs/ko/guides/dev-toolbar.mdx b/src/content/docs/ko/guides/dev-toolbar.mdx
@@ -3,10 +3,11 @@ title: 개발 툴바
 description: Astro의 개발 툴바 사용 가이드
 i18nReady: true
 ---
+import RecipeLinks from "~/components/RecipeLinks.astro";
 
 개발 서버가 실행되는 동안에는 로컬 브라우저 미리보기의 모든 페이지 하단에 개발 툴바가 포함되어 있습니다.
 
-개발 툴바에는 개발 중 사이트를 디버깅하고 검사하는 데 유용한 여러 도구가 포함되어 있으며, 통합 디렉터리에서 [더 많은 개발 툴바 앱으로 확장](#개발-툴바-앱-확장)할 수 있습니다. [개발 툴바 API](/ko/reference/dev-toolbar-app-reference/)를 사용하여 나만의 앱을 만들 수도 있습니다!
+개발 툴바에는 개발 중 사이트를 디버깅하고 검사하는 데 유용한 여러 도구가 포함되어 있으며, 통합 디렉터리에서 [더 많은 개발 툴바 앱으로 확장](#개발-툴바-앱-확장)할 수 있습니다. [개발 툴바 API](/ko/reference/dev-toolbar-app-reference/)를 사용하여 [나만의 개발 툴바 앱을 만들 수도 있습니다](/ko/recipes/making-toolbar-apps/)!
 
 이 툴바는 기본적으로 활성화되어 있으며 페이지 하단에 마우스를 올리면 나타납니다. 이는 개발자 도구로써만 사용되며 게시된 사이트에는 나타나지 않습니다.
 
@@ -43,6 +44,8 @@ Astro 통합은 새로운 앱을 개발 툴바에 추가하여 프로젝트에
 
 프로젝트에 추가적인 개발 툴바 앱 통합을 설치하려면 다른 [Astro 통합](/ko/guides/integrations-guide/)과 마찬가지로 해당 설치 지침에 따라 설치할 수 있습니다.
 
+<RecipeLinks slugs={["ko/recipes/making-toolbar-apps"]} />
+
 ## 개발 툴바 비활성화
 
 개발 툴바는 기본적으로 모든 사이트에 대해 활성화되어 있습니다. 필요에 따라 개별 프로젝트 및/또는 사용자를 위해 비활성화할 수 있습니다.