باشر بالبدأ

Astro هو باني موقع ثابت. تعرف أكثر حول ماهية Astro من خلال صفحتنا الرئيسية أو نشرة الإصدارات. تُعد هذه الصفحة نُبذة موجزة للتوثيق الخاص بـAstro وأيضًا لكل المصادر التي تتعلق به.

إن كنت تتطلع عن ملخص سريع حول ما هو Astro بشكلٍ عام؟ تفقد صفحتنا الرئيسية.

أبسط طريقة لتجرب Astro هي بتنفيذ أمر npm create astro@latest في داخل مُجلد جديد على جهازك، وسيقوم Astro CLI بمُساعدتك على بدأ مشروع Astro جديد.

لتباشر البدأ باستخدام Astro من خلال 5 خطوات سريعة وبسيطة، تفقد دليل البدأ-بسرعة.

أو إقرأ دليل التثبيت إن كنت تريد الغوص في عملية تهيئة Astro.

أمثلة على بعض المشاريع

Section titled أمثلة على بعض المشاريع

أن كنت تفضل التعلم عن طريق الأمثلة، ألقي نظرةٍ على مكتبة الأمثلة الشاملة المتواجدة على Github.

بمقدورك الإطلاع على أي من هذه الأمثلة وتجربتها مُباشرةً على جهازك، فقط نفذ الأمر npm create astro@latest متبوعًا بـ --template . الإشارة --template أيضًا تدعم الامثلة الخارجية التي يصنعها المجتمع
# أمر تهيئة أحد القوالب الرسمية التي يوفرها استرو
npm create astro@latest -- --template [OFFICIAL_EXAMPLE_NAME]
# أمر تهيئة القوالب الخارجية التي يوفرها المُجتمع
npm create astro@latest -- --template [GITHUB_USER]/[REPO_NAME]
npm create astro@latest -- --template [GITHUB_USER]/[REPO_NAME]/path/to/example

جربه على المُتصفح

Section titled جربه على المُتصفح

إن كنت مهتمًا وتريد اللعب وتجربة Astro على المتصفح، بمقدورك استخدام online code playground، جرب قالب مشروعنا “Hello World” على CodeSandbox.

ملحوظة: بعض المُميزات مُقتصرة على CodeSandbx (مثلاً: التحديث السريع “Fast Refresh”) حاليًا.

يأتي العديد الأشخاص من خلفياتِ تعلم مُختلفة إلى Astro، أيًا كانت طريقة التعليم التي تفضلها سواءً أكنت تفضل الطريقة النظرية أو الطريقة العملية، نتمنى أن تجد هذا القسم مفيدًا.

مثل أي تقنيةٍ ليست بمألوفة، Astro يأتيك بمنحنى تعليمي مختلف بعض الشيء، ولكن على أي حال، مع بعض الصبر والممارسة، نحن متأكدون بأنك ستتأقلم معه في وقتٍ هين دون أن تشعر.

تعلمُ تركيب .astro النحوي (syntax)

Section titled تعلمُ تركيب .astro النحوي (syntax)
مع بدأ تعلمك لـAstro ستلاحظ العديد من الملفات التي تنتهي بصيغة .astro هي ملفات مكتوبة بـ Astro’s Component Syntax والتي تعد: طريقة كتابة مشابهة جدًا لملفات HTML يستخدمها Astro في القوالب. صممت هذه الصيغة لتكون قريبة ومشابهة للـ HTML و JSX، إن كنت تعرف أحدهما فستتأقلم مع .astro بسهولة.

تفقد دليلنا المساعد مكونات Astro سيكون مدخل يساعدك على تعلم Astro syntax، ويعد أفضل طريقة للتعلم.

يُفيدك هذا الجزء من التوثيق حينما تريد الإطلاع أكثر بشأن تفاصيل Astro API. على سبيل المثال، يتضمن مرجع الإعداد قائمة لكل الإعدادات الممكنة المتاحة لكي تستخدمها. المكونات المصممة مسبقًا تتضمن قائمة بكل العناصر الرئيسية مثل <Markdown /> و <Code /> .

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

حساب @astrodotbuild على تويتر هو المصدر الرسمي لأخر المُستجدات من فريق Astro.

ونحن أيضًا نُعد نشرة إصدارات ونعلن عنها في مُجتمعنا على ديسكورد على قناة #announcements

ليست كل إصدارات Astro تملك تدوينة نشرةٍ خاصة بها، لكن ستجد سجلًا للتغيرات في ملف CHANGELOG.md في مستودع Astro.

إن كان هناك شيءُ ما غير مُوثق أو لو كنت تشعر بالحيرة والإرتباك من جزءٍ معين في التوثيق، لا تتردد في رفع طلب خطبٌ ما في ملف التوثيق، مع اقتراحك للتحسين، أو قم بتغريد تغريدةٍ إلى حسابنا على تويتر @astrodotbuild، نحب سماع آرائك!

دليل باشر بالبدأ معتمدٌ على دليل البدأ الخاص بـReact.