hello astro تحميل - hello astro تحميل كود المصدر

hello astro

فئات أخرى

v4.0.0

تنزيل

مرحبا استرو

Hello Astro عبارة عن سمة Astro كاملة الميزات ومتعددة الأغراض مكتوبة بلغة Typescript وTailwindCSS. وهو يدعم الصفحات والمدونات المستندة إلى Markdown وMDX.

ضوء

مظلم

منارة

يمكن استخدام Hello Astro لأي من/كل ما يلي:

موقع الشركة/التسويق
مدونة
موقع التوثيق
موقع المحفظة يدعم معارض الصور

يستخدم التكاملات التالية:

@astrojs/mdx
@astrojs/markdoc
@astrojs/خريطة الموقع
@astrojs/rss
@astrojs/tailwind
@astrojs/alpinejs
رمز الفلكية
استرو سيو
الروبوتات الفلكية-txt

بالإضافة إلى ذلك، تم الحصول على الرسوم التوضيحية بتنسيق SVG وPNG من Undraw

بدأ هذا المشروع في البداية كمنفذ أساسي لـ hello-gatsby-starter، ولكنه يحتوي الآن على المزيد من الميزات (الأوضاع الفاتحة/المظلمة، وصفحات الفئات، والبحث، والرسوم البيانية، والرياضيات، والمزيد!)

سمات

مدونة كاملة المواصفات مع المادة الأساسية (العنوان، الوصف، المؤلف، التاريخ، الصورة، العلامات)
أداء عالٍ ومنخفض الحمل مع الحد الأدنى من Javascript (AlpineJS)
البحث المستند إلى عميل النص الكامل لصفحات المدونة عبر lunrjs (يتم تحميل فهرس البحث فقط عند الاستدعاء الأول للبحث على الصفحة)
صفحة الفهرس والصفحات الفردية للمؤلفين والفئات والعلامات، بما في ذلك ترقيم الصفحات
دعم موجز RSS وخريطة الموقع وملف robots.txt
تصميم SVG (إلغاء الرسم، أنماط البطل، Iconify)
دعم لتسليط الضوء على بناء جملة التعليمات البرمجية
دعم كامل لتحسين محركات البحث بما في ذلك Open Graph وبطاقات Twitter وSchema.org عبر JSON-LD
الدعم الكامل لأوضاع واجهة المستخدم الفاتحة والداكنة، بالإضافة إلى تفضيلات النظام التالية، وفقًا لتوصية TailwindCSS
صفحة خطأ 404 مخصصة
عرض المعادلات الرياضية باستخدام KaTeX عبر comment-math/rehype-katex (مرفق بـ $ ... $ أو $$ ... $$ )
عرض الرسوم البيانية لـ Mermaid وMarkmap وPlantumUML (تم تأليفها ككتلة تعليمات برمجية تحتوي على لغة mermaid و markmap و plantuml )
عرض الخريطة بالإحداثيات الجغرافية ومستوى التكبير/التصغير باستخدام مكون Map (يلزم أيضًا تضمين extra: ['map'] هي المادة الأمامية لتحميل أصول CSS/JS للصفحة)
حساب وإظهار وقت القراءة لمشاركات المدونة
يتم تحميل أصول CSS/JS الخاصة بالمكتبات الخارجية فقط عند الحاجة إليها على أساس كل صفحة ولكل حزمة - لا يوجد تضخم غير ضروري
معرض الصور والعرض المبسط باستخدام PhotoSwipe (بما في ذلك عرض علامات EXIF)
مكون دائري باستخدام Swiper
صفحات التوثيق (تم تصميمها على غرار برنامج Astro Docs Starter ولكن باستخدام Tailwind)

الحزم الخارجية

تستخدم البداية الحزم الخارجية التالية:

استرو
تايب سكريبت
TailwindCSS وTailwindUI
أيقونة
أنماط البطل
قم بإلغاء الرسم للحصول على الرسوم التوضيحية
MDX و تخفيض السعر
Schema.org وJSON لربط البيانات، تم التحقق من النوع باستخدام schema-dts
افتح الرسم البياني الذي يستخدمه الفيسبوك
بطاقات تويتر
AlpineJS
البحث عن النص الكامل المحلي باستخدام Lunr
المعادلات الرياضية باستخدام KaTeX عبر comment-math وrehype-katex
المخططات باستخدام Mermaid وMarkmap وPlantUML
افتح خريطة الشارع باستخدام النشرة
وقت القراءة
مسح الصور
com.exifr
سوايبر
ملاحظة الرموز التعبيرية

إنه يتبع بنية JAMstack من خلال إنشاء إصدار ثابت تلقائيًا من مستودع Git. يتم نشر العرض التوضيحي على صفحات جيثب.

هيكل المشروع

داخل هذا المبدئ، سترى المجلدات والملفات التالية:

 /
├── public/
│   └── favicon.ico
├── src/
│   ├── assets/
│   │   ├── image.png
│   │   └── gallery/
│   │       └── gallery-name/
│   │           └── image.jpg
│   ├── components/
│   │   └── header.astro
│   ├── content/
│   │   ├── blog/
│   │   |   └── 2022-08-01-post.md
│   │   ├── doc/
│   │   |   └── documentation-page.md
|   │   └── config.ts
│   ├── layouts/
│   │   ├── base.astro
│   │   ├── blog.astro
│   │   └── doc.astro
│   ├── pages/
│   │   ├── index.astro
│   │   └── contact.astro
│   └── config.ts
└── package.json

يبحث Astro عن ملفات .astro أو .md أو .mdx في الدليل src/pages/ . يتم عرض كل صفحة كمسار بناءً على اسم الملف الخاص بها.

src/components/ هو المكان الذي نضع فيه أي مكونات Astro وكذلك src/layouts/ للتخطيطات.

يمكن وضع الصور في src/assets/ .

يتم إنشاء محتوى المدونة والوثائق كمجموعات من ملفات Markdown أو MDX في src/content .

أي أصول ثابتة، على سبيل المثال. الصور، يمكن وضعها في الدليل public/ .

؟ الأوامر

يتم تشغيل جميع الأوامر من جذر المشروع، من المحطة:

يأمر	فعل
`pnpm install`	تثبيت التبعيات
`pnpm dev`	يبدأ تشغيل خادم التطوير المحلي على `localhost:3000`
`pnpm build`	أنشئ موقع الإنتاج الخاص بك إلى `./dist/`
`pnpm preview`	قم بمعاينة البناء الخاص بك محليًا، قبل النشر
`pnpm lint`	جميلة طباعة التعليمات البرمجية المصدر
`pnpm check`	تحقق من الكود المصدري بحثًا عن الأخطاء
`pnpm astro ...`	قم بتشغيل أوامر CLI مثل `astro add` و `astro preview`
`pnpm astro --help`	احصل على المساعدة باستخدام Astro CLI

تاريخ الإصدار

1.0.0: الإصدار الأولي
1.0.1: تم نقل الصور الاجتماعية إلى src، وتحسين معالجة صورة الغلاف
1.0.2: ترقية الحزم إلى الأحدث
1.1.0: التحديث إلى astro v2.x، يعمل الآن مع العقدتين 18 و19
2.0.0: إصدار جديد يدعم مجموعات Astro! وأوضح أيضًا أن هذا موضوع متعدد الأغراض. يمكن أن يتضمن البحث الآن كلاً من صفحات Markdown وMDX!
2.0.1: لقطات شاشة محدثة، وتحسين الصفحة المقصودة.
2.1.0: تم التحديث إلى أحدث الحزم، وروابط التطوير الثابتة، والميزات ذات النقل الخلفي من المدونة الشخصية، بما في ذلك الروابط التالية/السابقة، ودعم معرض الصور في Markdown، وتحسين التحكم في ترقيم الصفحات.
2.2.0: تم إصلاح أخطاء الوبر، وإعادة تنفيذ الخريطة، والعرض المبسط والعرض الدائري لاستخدام حزم المنشورات ومسح الصور والمسح بدلاً من الاعتماد على CDN خارجي.
2.2.1: التحديث إلى Astro 2.0.10، مشكلة تحميل الأصول الثابتة مع القاعدة
2.3.0: تمت إزالة التخطيط من محتوى المدونة والمستندات
2.4.0: @astrojs/images يدعم الآن svg لذا لا حاجة إلى معالجة خاصة
2.4.1: استخدم المادة الأمامية المعروضة لمشاركات المدونات والمستندات، وإصلاح مشكلة عدم عرض المخططات.
2.4.2: الحزم المحدثة
3.0.0: التحديث الرئيسي:
- استخدم دعم الأصول المحسّن الجديد من Astro
- شعار استرو الجديد
- الأمثل بعد مسودة التصفية
- تنظيف المعرض
- إصلاح أخطاء SEO
- تنظيف أخطاء الوبر
- تم ترحيل المؤلفين والفئات إلى المجموعات واستخدام التكامل المرجعي استنادًا إلى Astro 2.5.0
- تحويل الروابط الاجتماعية إلى مجموعة بيانات (يتطلب Astro > 2.5.0)
- تحديث الأيقونة المفضلة والبيانات الوصفية للرأس
- تحسين البحث ليشمل الوثائق
3.1.0: تحديث التحسين:
- تم ترحيل مدير الحزم من الغزل إلى pnpm
- قاعدة مرجعية لروابط الرأس
- تمت إضافة إسلينت وأجمل مع الإضافات
- تم إصلاح خطأ في سمات الصورة في مكون SEO
- تم تحديث tsconfig ليتوافق مع Astro الصارم
- قم بتحديث رابط Katex CSS
- تم إصلاح عدم ظهور المؤلف في بطاقة المدونة
- تمت إضافة دعم ماركدوك
3.1.1: تحديث بسيط:
- تحميل الصور كسول
- دعم Github emoji عبر الملاحظة-emoji
3.1.2: إصلاحات طفيفة:
- التحقق من وجود فئات فارغة
- صفحة اتصال محسنة قليلاً
- تحسين المعالجة التالية/السابقة
- الحزم المحدثة
- تقليل حجم زر البحث لاستيعاب العرض الأدنى
- تم تغيير خيار الصورة للصفحات من محتوى الكائن إلى غلاف الكائن
- تم إصلاح site.webmanifest
3.1.3: إصلاحات طفيفة:
- قم بالترقية إلى @astrojs/markdoc 0.4.x وأحدث إصدار من Astro
- تم إصلاح إعلان الدعائم في [slug].astro
- تم تعطيل ملف نموذج Markdoc بسبب هذه المشكلة: withastro/astro#7520
3.1.4: تحسين طفيف:
- معالجة الصور الموحدة لـ svg والصور النقطية
- تمكين عرض التحولات
3.1.5: تحسينات طفيفة:
- الترقية إلى أحدث إصدار من الحزم
- تم إصلاح خطأ بسيط في التحقق الفلكي
3.2.0: التحسينات الرئيسية:
- تم التحديث إلى Astro 3.x
- تنفيذ سياسة أمان المحتوى المسموح بها
3.2.1: تحسين طفيف:
- تم تحديث الحزم وحل أخطاء الفحص الفلكي
3.2.2: تحسينات طفيفة:
- الحزم المحدثة
- تم إصلاح نوع الإرجاع json.ts للبحث
3.2.3: الصيانة:
- تم إصلاح حورية البحر v9 التي لم تعد تعمل عن طريق الترقية إلى أحدث إصدار من حورية البحر
- ترقية الحزم
3.2.4: تحسينات طفيفة:
- الترقية إلى أسترو 4.x
3.2.5: تحسينات طفيفة:
- ترقية الحزم
- إزالة mermaid.initialize()
3.2.6: الصيانة:
- قم بتعطيل ViewTransition لأنه لا يعمل مع حورية البحر
3.3.0: الصيانة:
- تمت الترقية إلى أحدث الحزم والأيقونة الفلكية 1.x
3.3.1: الصيانة:
- تمت الترقية إلى أحدث الحزم وأخطاء التحقق الفلكية الثابتة
3.3.2: الصيانة:
- تمت الترقية إلى أحدث الحزم
- البحث الثابت لا يعمل بسبب فحص جبال الألب الأكثر صرامة
- تم الترحيل إلى معيار astro tsconfig.json
- أخطاء التحقق الفلكية الثابتة
3.4.0: تغييرات طفيفة:
- الحزم المحدثة
- تم استبدال الأبطال إلى الإصدار 2
- تحسين RSS وفهارس البحث لتشمل اسم المؤلف والبريد الإلكتروني
- اجعل BlogHero يقبل المنشور كدعائم بدلاً من أن يكون عنصرًا رئيسيًا
- تم نقل صفحات Markdown إلى مجموعة المحتوى
- تمت إزالة نوع Frontmatter
4.0.0: التغييرات الرئيسية:
- الحزم المحدثة
- تمت إزالة @types/photoswipe وphotoswipe tsconfig
- تم النقل إلى مخطط RSS
- وظيفة getPosts ().
- علامات المخطط
- روابط الشريط الجانبي التي يتم إنشاؤها تلقائيًا
- تحسين RSS وبيانات تعريف البحث