باشر بالبدأ
Astro هو باني موقع ثابت. تعرف أكثر حول ماهية Astro من خلال صفحتنا الرئيسية أو نشرة الإصدارات. تُعد هذه الصفحة نُبذة موجزة للتوثيق الخاص بـAstro وأيضًا لكل المصادر التي تتعلق به.
إن كنت تتطلع عن ملخص سريع حول ما هو Astro بشكلٍ عام؟ تفقد صفحتنا الرئيسية.
جرب Astro
Section titled جرب 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
Section titled تعلمُ Astroيأتي العديد الأشخاص من خلفياتِ تعلم مُختلفة إلى Astro، أيًا كانت طريقة التعليم التي تفضلها سواءً أكنت تفضل الطريقة النظرية أو الطريقة العملية، نتمنى أن تجد هذا القسم مفيدًا.
- إن كُنت تُفضل التعلم من خلال التجربة العملية، أبدأ من خلال مكتبتنا للأمثلة.
- إن كُنت تُفضل التعلم من خلال الفهم خطوةً بخطوة، أبدأ من خلال دليل المفاهيم الأساسية والإرشادات.
مثل أي تقنيةٍ ليست بمألوفة، Astro يأتيك بمنحنى تعليمي مختلف بعض الشيء، ولكن على أي حال، مع بعض الصبر والممارسة، نحن متأكدون بأنك ستتأقلم معه في وقتٍ هين دون أن تشعر.
تعلمُ تركيب .astro
النحوي (syntax)
Section titled تعلمُ تركيب .astro النحوي (syntax)
.astro
هي ملفات مكتوبة بـ Astro’s Component Syntax والتي تعد: طريقة كتابة مشابهة جدًا لملفات HTML يستخدمها Astro في القوالب.
صممت هذه الصيغة لتكون قريبة ومشابهة للـ HTML و JSX، إن كنت تعرف أحدهما فستتأقلم مع
.astro
بسهولة.
تفقد دليلنا المساعد مكونات Astro سيكون مدخل يساعدك على تعلم Astro syntax، ويعد أفضل طريقة للتعلم.
مرجع للـAPI
Section titled مرجع للـAPI<Markdown />
و
<Code />
.
إصدارات التوثيق
Section titled إصدارات التوثيقهذا التوثيق يُسلط الضوء دومًا على أخر إصدار مستقر من Astro، وريثما نصل إلى إصدار 1.0 الرئيسي سنقوم بإضافة القابلية لتصفح اللإصدارات المختلفة من التوثيق.
أبقى مُطلعًا
Section titled أبقى مُطلعًاحساب @astrodotbuild على تويتر هو المصدر الرسمي لأخر المُستجدات من فريق Astro.
ونحن أيضًا نُعد نشرة إصدارات ونعلن عنها في مُجتمعنا على ديسكورد على قناة #announcementsليست كل إصدارات Astro تملك تدوينة نشرةٍ خاصة بها، لكن ستجد سجلًا للتغيرات في ملف CHANGELOG.md
في مستودع Astro.
شيءٌ ما ناقص؟
Section titled شيءٌ ما ناقص؟إن كان هناك شيءُ ما غير مُوثق أو لو كنت تشعر بالحيرة والإرتباك من جزءٍ معين في التوثيق، لا تتردد في رفع طلب خطبٌ ما في ملف التوثيق، مع اقتراحك للتحسين، أو قم بتغريد تغريدةٍ إلى حسابنا على تويتر @astrodotbuild، نحب سماع آرائك!
التَقدِير
Section titled التَقدِيردليل باشر بالبدأ معتمدٌ على دليل البدأ الخاص بـReact.