Astro 4.14 | Astro

Astro 4.14 اکنون در دسترس است! این نسخه شامل اولین نسخه آزمایشی Content Layer API، راه حل جدید مدیریت محتوای فوق انعطاف پذیر ما در پروژه های Astro، پشتیبانی از Intellisense در فایل های محتوا و موارد دیگر است.
این نسخه شامل نکات برجسته زیر است:
برای ارتقاء یک پروژه موجود، از خودکار استفاده کنید @astrojs/upgrade ابزار CLI. از طرف دیگر، می توانید با اجرای دستور ارتقاء برای مدیر بسته خود، به صورت دستی ارتقا دهید:
pnpm upgrade astro --latest
yarn upgrade astro --latest
تجربی: Content Layer API
در Astro 2.0، Content Collections را معرفی کردیم، روشی قدرتمند برای مدیریت محتوای محلی در پروژههای Astro. در حالی که به صدها هزار توسعهدهنده کمک کرده تا با Astro سایتهای مبتنی بر محتوا بسازند، بازخورد شما را شنیدهایم که میخواهید در مدیریت محتوای خود انعطافپذیری و قدرت بیشتری داشته باشید. ما بسیار هیجانزده هستیم که انتشار آزمایشی نسل بعدی مجموعههای محتوا در Astro را اعلام کنیم: Content Layer API.
API لایه محتوای جدید بر روی مجموعههای محتوا ساخته میشود و آنها را فراتر از فایلهای محلی میآورد src/content/ و به شما امکان می دهد محتوا را از هر جایی، از جمله API های راه دور، بازیابی کنید. این مجموعههای جدید در کنار مجموعههای محتوای موجود شما کار میکنند و میتوانید با سرعت دلخواه آنها را به API جدید منتقل کنید. ما فکر می کنیم به زودی می خواهید، زیرا آنها مزایای زیادی دارند، اما عجله ای وجود ندارد – مجموعه های موجود مانند همیشه به کار خود ادامه می دهند.
اعدام
Content Layer API اولین گام در مقیاس گذاری Astro برای پشتیبانی از ساخت سریع برای سایت هایی با ده ها یا صدها هزار صفحه است. API جدید به گونه ای طراحی شده است که در نحوه بارگذاری محتوا کارآمدتر و کارآمدتر باشد. این محتوا را به صورت محلی ذخیره می کند تا مجبور نباشد به API ادامه دهد و کار با فایل های Markdown و MDX محلی را به طرز چشمگیری بهبود بخشیده است. این معیار عملکرد را هنگام ساخت یک سایت 10000 صفحه ای در Macbook Air M1 نشان می دهد:
| Astro 4.13 | Astro 4.14 (لایه محتوا) | |||
|---|---|---|---|---|
| مارک داون | زمان ساختن | 136.29s | 25.96 ثانیه | 5.3 برابر سریعتر |
| حافظه | 763.50 مگابایت | 276.22 مگابایت | 64 درصد کمتر | |
| MDX | زمان ساختن | 129.82 ثانیه | 66.70 | 1.9 برابر سریعتر |
| حافظه | 897.91 مگابایت | 674.39 مگابایت | 25 درصد کمتر |
ما قصد داریم به بهبود عملکرد Content Layer API در نسخههای بعدی ادامه دهیم، از جمله افزودن پشتیبانی SQLite برای مدیریت سایتهای بزرگتر.
اولین قدم ها
برای آزمایش Content Layer API جدید، آن را در پیکربندی Astro خود فعال کنید:
import { defineConfig } from 'astro/config';
export default defineConfig({
سپس می توانید مجموعه هایی را در خود ایجاد کنید src/content/config.ts با استفاده از Content Layer API.
محتوای شما در حال بارگیری است
هسته API لایه محتوای جدید لودر است، تابعی که محتوا را از یک منبع بازیابی می کند و آن را در یک فروشگاه داده محلی ذخیره می کند. Astro 4.14 دارای یک داخلی است glob() و file() لودرها برای پردازش فایل های Markdown، MDX، Markdoc و JSON محلی شما:
import { defineCollection, z } from 'astro:content';
import { glob } from 'astro/loaders';
const blog = defineCollection({
// The ID is a slug generated from the path of the file relative to `base`
loader: glob({ pattern: "**/*.md", base: "./src/data/blog" }),
publishDate: z.coerce.date(),
export const collections = { blog };
سپس می توانید از محتوای سایت خود استفاده کنید:
import { getEntry, render } from 'astro:content';
const post = await getEntry('blog', Astro.params.slug);
const { Content } = await render(entry);
ایجاد لودر
شما محدود به بوت لودرهای داخلی نیستید – امیدواریم سعی کنید خودتان را بسازید. می توانید محتوا را از هر جایی دریافت کنید و مجموعه ای از رکوردها را برگردانید:
const countries = defineCollection({
const response = await fetch("https://restcountries.com/v3.1/all");
const data = await response.json();
// Must return an array of entries with an id property,
// or an object with IDs as keys and entries as values
return data.map((country) => ({
// optionally add a schema to validate the data and make it type-safe for users
export const collections = { countries };
برای منطق بارگذاری پیشرفته تر، می توانید بارگذاری شی را تعریف کنید. این امکان به روز رسانی تدریجی و بارگذاری مشروط را فراهم می کند و در عین حال دسترسی کامل به دیتا استور را می دهد. همچنین به لودر اجازه می دهد تا طرحواره خود را تعریف کند، از جمله تولید آن به صورت پویا بر اساس API منبع. برای جزئیات بیشتر به Content Layer API RFC مراجعه کنید.
لودرهای خود را به اشتراک بگذارید
لودرها وقتی به اشتراک گذاشته شوند بهتر هستند! شما می توانید یک ماژول ایجاد کنید که یک لودر را صادر می کند و آن را به npm منتشر می کند، سپس هر کسی می تواند از آن در سایت خود استفاده کند. بسته های خود را با یک کلمه کلیدی تگ کنید astro-loader بنابراین می توان آنها را پیدا کرد. ما برای دیدن آنچه که انجمن می آید با هیجان زده! برای شروع، به چند نمونه نگاه کنید. در اینجا نحوه بارگیری محتوا با استفاده از بارگذار فید RSS/Atom آورده شده است:
import { defineCollection } from "astro:content";
import { feedLoader } from "@ascorbic/feed-loader";
const podcasts = defineCollection({
url: "https://feeds.99percentinvisible.org/99percentinvisible",
export const collections = { podcasts };
بیشتر بدانید
برای کسب اطلاعات بیشتر در مورد استفاده از Content Layer API، Content Layer RFC را بررسی کنید و بازخورد خود را به اشتراک بگذارید.
تجربی: Intellisense در فایل های محتوا
Astro 4.14 پشتیبانی آزمایشی را برای Intellisense در هسته محتوای شما معرفی می کند. این ویژگی به شما کمک میکند تا فایلهای محتوا را با ارائه تکمیلها، اعتبارسنجی، اطلاعات شناور و موارد دیگر برای کلیدها و مقادیر مقدماتی بنویسید. این ابزارها بر اساس طرحواره های محتوای شما هستند و مستقیماً در ویرایشگر شما در دسترس هستند.
این ویژگی در VS Code و سایر ویرایشگرهایی که از پروتکل سرور زبان برای فایلهای Markdown، MDX و Markdoc پشتیبانی میکنند، موجود است.
برای فعال کردن intellisense برای یک فایل محتوا، موارد زیر را به پیکربندی Astro خود اضافه کنید:
import { defineConfig } from 'astro';
export default defineConfig({
contentIntellisense: true
و در VS Code را فعال کنید astro.content-intellisense تنظیم برای ویرایشگرهای دیگر، پاس کنید contentIntellisense: true به پارامترهای مقداردهی اولیه سرور زبان Astro.
"astro.content-intellisense": true
این ویژگی در حال حاضر فقط در ویرایشگر کار می کند و در آن فعال خواهد شد astro check در نسخه آینده
پشتیبانی از پویا را رها کنید prerender ارزش ها
برای بهبود قابلیتهای خوشهبندی و تکان دادن درخت، Astro 4.14 پشتیبانی از استفاده از مقادیر پویا را کاهش میدهد. prerender گزینه ای در صفحات Astro شما.
اکنون می توان این ویژگی را با ویژگی جدید جایگزین کرد astro:route:setup به ادغام های Astro متصل شوید و به شما این امکان را می دهد که به صورت پویا پیش رندر صفحات خاص را کنترل کنید.
export const prerender = import.meta.env.PROD;
import { defineConfig } from 'astro/config';
export default defineConfig({
integrations: [setPrerender()],
function setPrerender() {
'astro:route:setup': ({ route }) => {
if (route.component.endsWith('/blog/[slug].astro')) {
جدید injectTypes یکپارچه سازی API
نسل تایپ در سال های اخیر مد شده است و Astro نیز از این قاعده مستثنی نیست! ما از تولید نوع بهطور گسترده برای ویژگیهایی مانند Astro DB و مجموعههای محتوا (یا API لایه محتوای جدید) استفاده میکنیم.
به لطف @florian-lefebvre، ادغامهای Astro اکنون میتوانند به سرگرمیهای جدید بپیوندند injectTypes یکپارچه سازی API! این API به ادغام ها اجازه می دهد تا انواع را به پروژه کاربر تزریق کنند و ارائه تعاریف نوع برای عملکردهای ادغام شما را آسان می کند.
'astro:config:done': ({ injectTypes }) => {
content: "declare module 'virtual:my-integration' {}"
برای اطلاعات بیشتر در مورد این ویژگی، به مستندات Astro Integration API مراجعه کنید.
Astro 4.14 پشتیبانی را اضافه می کند meta ویژگی ج Code جزء برای مثال، این ویژگی استفاده از ویژگی های بلوک کد را در Markdown شبیه سازی می کند ```js astro=cool، که سپس می تواند توسط ترانسفورماتورهای شیکی برای اعمال تبدیل های سفارشی به بلوک کد استفاده شود.
import { Code } from "astro:components";
import { transformerMetaHighlight } from '@shikijs/transformers';
transformers={[transformerMetaHighlight()]}
با تشکر از @jcayzac برای این مشارکت!
رفع اشکال و تشکر ویژه
مانند ما، Astro 4.14 شامل رفع اشکال بیشتر و بهبودهای کوچکتر است که نمی توانند در این پست قرار بگیرند! برای کسب اطلاعات بیشتر، یادداشتهای انتشار کامل را ببینید.
از سارا رینزبرگر (@sarah11918)، جان (@yanthomasdev)، بیورن لو (@bluwy) و همه کسانی که در این نسخه مشارکت داشتند، تشکر میکنیم.



