Astro 5.0 نسخه بتا | Astro

اولین نسخه بتا Astro 5.0 اکنون در دسترس است! این نسخه شامل لایه محتوای Astro است که اکنون پایدار است، آخرین تکرار ما در مورد مدیریت محتوا در پروژههای Astro و جزیرههای سرور، روشی جدید برای ترکیب محتوای ثابت و شخصیشده در سایت شما برای بهترینها از هر دو دنیا.
برای کسب اطلاعات بیشتر در مورد ویژگیها و بهبودهای جدید در Astro 5.0 بتا به ادامه مطلب بروید!
این نسخه شامل نکات برجسته زیر است:
برای ارتقاء یک پروژه موجود، از خودکار استفاده کنید @astrojs/upgrade ابزار CLI. همچنین، میتوانید با اجرای دستور install برای مدیریت بسته خود، بهصورت دستی ارتقا دهید beta برچسب زدن
npx @astrojs/upgrade beta
برای شروع یک پروژه جدید با استفاده از نسخه 5.0 بتا، اجرا کنید create astro دستور برای مدیر بسته شما:
npm create astro@latest -- --ref next
برای جزئیات کامل و دستورالعملهای ارتقای جداگانه برای هر تغییر در این نسخه، به راهنمای ارتقا در اسناد بتا نسخه 5.0 مراجعه کنید.
پایدار: لایه محتوا
Astro 5.0 لایه محتوای Astro را معرفی می کند، روشی جدید برای مدیریت محتوا در پروژه Astro شما. لایه محتوا روشی انعطافپذیر و توسعهپذیر برای تعامل با محتوا است که به لطف لودرهای قدرتمند، یک API یکپارچه و ایمن برای دسترسی و تعریف محتوای شما در پروژه Astro شما ارائه میکند – مهم نیست از کجا آمده است.
همانطور که وب سایت شما رشد می کند، نگهداری محتوای خود در فایل های Markdown دنج در یک مخزن Git می تواند کمتر و کمتر کاربردی شود. شاید بخواهید از CMS استفاده کنید. شاید برخی از بخشهای وبسایت شما توسط یک REST API در جایی پشتیبانی میشوند، یا تصاویر بهینهسازی شدهای از یک سیستم مدیریت دارایی مانند Cloudinary دارید. این می تواند به سرعت به یک آشفتگی برای مدیریت تبدیل شود و به طیف وسیعی از API های مختلف و استراتژی های استخراج داده نیاز دارد.
لایه محتوا توسط لودرها تغذیه میشود، که توابع قابل اتصالی هستند که دادهها را از هر منبعی به یک قالب یکپارچه و ایمن تبدیل میکنند که میتوانید در پروژه Astro خود استفاده کنید تا با اطمینان کامل از شکل و نوع آن، از هر کجا به دادههای خود دسترسی داشته باشید.
import { defineCollection } from "astro:content";
import { notionLoader } from "notion-astro-loader";
const database = defineCollection({
// Automatically fetch content from Notion in one line
// using the 'notion-astro-loader' npm package!
loader: notionLoader({ /* ... */ })
// optionally, define a schema for the content or let the loader infer it
// schema: z.object({ /* ... */ })
export const collections = {
این فقط سطح احتمالاتی را که لایه محتوا برای پروژه شما باز می کند، خراش می دهد. برای کسب اطلاعات بیشتر در مورد این ویژگی، این هفته با ما همراه باشید و راهنمای ما در مورد مجموعههای محتوای جدید در اسناد بتا نسخه 5.0 را بررسی کنید تا نحوه شروع کار را بیاموزید.
پایدار: جزایر سرور
جزایر سرور یک بدوی جدید هستند که در Astro 5 آمده است که به شما امکان می دهد رندر محتوای پویا را تا بارگذاری اولیه صفحه به تاخیر بیندازید. این به شما امکان میدهد تا صفحات استاتیک را با محتوای سفارشی که بعداً تزریق میشود، ارائه دهید و بهترینهای هر دو جهان را ارائه دهید: صفحات استاتیک سریع و ذخیرهشده CDN با محتوای سفارشی و پویا.
جزایر سرور بر اساس معماری جزیره موجود در Astro هستند. تعریف جزیره سرور به سادگی تعریف جزیره مشتری است، اما با استفاده از آن server:defer در عوض دستورالعمل:
UserButton server:defer />
این به Astro میگوید که از رندر کردن آن مؤلفه در پاسخ اولیه صرفنظر کرده و رندر کردن آن را به بعد «به تعویق میاندازد». این به شما این امکان را می دهد که صفحه استاتیک پشت یک CDN را با برخی از محتوای ذخیره شده اولیه در حافظه پنهان ذخیره کنید. هنگامی که HTML پویا بارگذاری می شود، یک اسکریپت درون خطی کوچک جزیره سرور صفحه را با نتیجه HTML رندر معوق جایگزین می کند.
این ویژگی به ویژه برای وب سایت های محتوا محور که محتوای پویا و ثابت را در صفحه ترکیب می کنند مفید است. به عنوان مثال، برای یک سایت تجارت الکترونیک، می توانید ارائه توصیه های محصول را تا پس از بارگذاری اولیه صفحه به تاخیر بیندازید و زمان بارگذاری اولیه صفحه سریع تری را ارائه دهید و در عین حال محتوای شخصی سازی شده را ارائه دهید.
برای جزئیات بیشتر در مورد استفاده از این ویژگی، از مستندات جزیره سرور در اسناد بتا 5.0 دیدن کنید.
حالت های خروجی ترکیبی استاتیک و هیبریدی
در Astro 5، اکنون ساده تر از هر زمان دیگری ایجاد یک وب سایت با صفحات استاتیک، حافظه پنهان، عملکرد و صفحات پویا که بر حسب تقاضا ارائه می شوند، شده است. Astro جدید output: 'static' حالت، بهطور پیشفرض، اکنون به شما امکان میدهد تا مسیرهای جداگانه را در زمان اجرا سرور تنها با افزودن یک آداپتور، بدون نیاز به پیکربندی دیگر، رندر کنید.
این مشابه قبلی ما است hybrid حالت: بهطور پیشفرض، هر صفحه بهصورت ایستا تولید میشود تا زمانی که از اجرای پیشاجرا انصراف دهید:
export const prerender = false; // Render at request time
اگر بیشتر صفحات شما نیاز به رندر شدن دارند، همچنان می توانید تنظیم کنید output: 'server' در پیکربندی رندر سرور پیشفرض Astro:
import { defineConfig } from 'astro/config';
export default defineConfig({
هنگامی که آماده استقرار سایت خود برای تولید هستید، Astro به طور خودکار خروجی صحیح را برای هر صفحه بر اساس آن تولید می کند prerender ثابت و output پیکربندی هنوز هم به یک آداپتور برای ارائه صفحاتی که در هر دو درخواست ارائه شده اند نیاز است static و server حالت هایی که می توانید با استفاده از آنها به پروژه خود اضافه کنید astro add، مانند قبل
برای اطلاعات بیشتر در مورد پیش رندر و رندر سمت سرور در Astro، به مستندات ما در مورد حالت های رندر در اسناد بتا 5.0 مراجعه کنید.
پایدار: astro:env
متغیرهای محیطی این روزها مشکل هستند! همانطور که پروژه شما رشد می کند، به راحتی می توان ردیابی متغیرهای مورد نیاز، اختیاری و/یا حساس بودن را از دست داد. Astro 5.0 روش جدیدی را برای مدیریت متغیرهای محیطی معرفی می کند astro:env، یک ماژول داخلی است که روشی مطمئن برای تعریف و دسترسی به متغیرهای محیطی ارائه می دهد.
ابتدا، متغیرهای محیطی را در پیکربندی Astro خود با استفاده از نحو طرحواره آشنا تعریف کنید:
import { defineConfig, envField } from "astro/config"
export default defineConfig({
CLIENT_API_URL: envField.string({ context: "client", access: "public" }),
SERVER_API_URL: envField.string({ context: "server", access: "public" }),
API_SECRET: envField.string({ context: "server", access: "secret" }),
سپس با استفاده از پروژه Astro به متغیرهای محیطی دسترسی پیدا کنید astro:env ماژول:
import { SERVER_API_URL, API_SECRET, PORT } from "astro:env/server";
const data = await fetch(`${SERVER_API_URL}/api`, {
Authorization: `Bearer ${API_SECRET}`
import { CLIENT_API_URL } from "astro:env/client";
const clientData = await fetch(CLIENT_API_URL);
برای اطلاعات بیشتر در مورد مدیریت متغیرهای محیطی در Astro، به راهنمای ما در مورد انواع متغیرهای محیط امن در اسناد بتا 5.0 مراجعه کنید.
و بیشتر!
اینها تنها تعدادی از تغییرات این Astro 5.0 بتا هستند. یادداشتهای انتشار کامل را ببینید و برای کسب اطلاعات بیشتر به سایت اسناد بتا 5.0 مراجعه کنید.
با تشکر از همه کسانی که در این نسخه مشارکت کردند، و ما نمی توانیم منتظر باشیم تا ببینیم با Astro 5.0 بتا چه چیزی ایجاد می کنید!


