مقالات

Starlight 0.28 | Astro


Starlight نسخه 0.28 اکنون منتشر شده است! آخرین نسخه سازنده سایت اسناد همه‌جانبه رسمی Astro منتشر شد. بیایید نگاهی به برخی از نکات برجسته آخرین نسخه های Starlight بیندازیم.

برای ارتقاء یک پروژه موجود، خودکار را اجرا کنید @astrojs/upgrade CLI از ترمینال شما:

بومی سازی سطح بعدی

Starlight از روز اول چند زبانه بوده است و نسخه 0.28 آن را به سطح بعدی می برد.
سیستم محلی سازی داخلی Starlight اکنون توسط اولین در کلاس تغذیه می شود i18next کتابخانه و در دسترس برای استفاده در هر نقطه از سایت شما.

از جدید استفاده کنید Astro.locals.t() روشی از هر مؤلفه Astro برای رندر کردن برچسب‌های UI داخلی Starlight یا رشته‌های سفارشی خود، از جمله پشتیبانی از درون یابی و چندگانه:

p>{Astro.locals.t('404.text')}p>

p>{Astro.locals.t('componentCount', { count: 99 })}p>

این به روز رسانی استارلایت را به گزینه ای بی نظیر برای ویژگی های بین المللی سازی خارج از جعبه تبدیل می کند.
همین امروز با یک زبان شروع کنید و با اطمینان خاطر آماده باشید که اسناد خود را در زمان مناسب ترجمه کنید.

پشتیبانی رندر بر حسب تقاضا

از نسخه 0.27، Starlight در صورت نیاز از رندر سمت سرور کاملاً پویا پشتیبانی می کند.
کیت prerender: false در گزینه های Starlight برای غیرفعال کردن تولید استاتیک صفحات خود و رفتن به حالت رندر درخواستی Astro:

این ویژگی هایی مانند احراز هویت و سفارشی سازی کاربر را باز می کند و Starlight را حتی انعطاف پذیرتر می کند.
برای مشاهده برخی از قابلیت ها در عمل، نسخه ی نمایشی Docs on Demand را بررسی کنید.
با تشکر از Fryuni برای پیاده سازی این ویژگی!

بخش هایی که شما را به یاد می آورند

نور ستاره این مؤلفه اکنون از یادآوری ترجیحات کاربر در پیمایش صفحه پشتیبانی می کند. این به خواننده شما اجازه می‌دهد تا گزینه‌هایی مانند مدیر بسته ترجیحی یا سیستم عامل خود را یک بار انتخاب کند و آن اولویت را در جای دیگری در اسناد شما منعکس کند. برای فعال کردن این ویژگی، یک مطابقت اضافه کنید syncKey صفات به شما :

import { Tabs, TabItem } from '@astrojs/starlight/components';

Tabs syncKey="package-manager">

TabItem label="npm">npm install @astrojs/starlightTabItem>

TabItem label="pnpm">pnpm add @astrojs/starlightTabItem>

TabItem label="yarn">yarn add @astrojs/starlightTabItem>

Starlight مبتنی بر فناوری وب آزمایش شده و آزمایش شده است، HTML ساده و ایستا را با حداقل جاوا اسکریپت برای عملکرد بهینه ارائه می دهد.ما بازخوردهایی از کاربران شنیده‌ایم که پیمایش کامل صفحه می‌تواند مخل باشد زیرا وضعیت نوار کناری در هر بار بارگذاری صفحه از بین می‌رود.

از نسخه 0.26 به بعد، Starlight به لطف یک عنصر سفارشی سبک وزن، وضعیت نوار کناری را در مسیریابی ها ادامه می دهد و بازیابی می کند و مرور را روان تر می کند. این یک پیشرفت تدریجی است – اگر جاوا اسکریپت در دستگاه کاربر در دسترس نباشد، نوار کناری به طور معمول ارائه می شود و تجربه پایداری را برای همه تضمین می کند.

در نسخه‌های قبلی Starlight، تنظیم پیکربندی نوار کناری شما می‌تواند کمی پیچیده باشد:

title: 'Old Skool Starlight',

{ label: 'Page one', link: '/one' },

{ label: 'Page two', link: '/two' },

با Starlight نسخه 0.25 این کار برای پیوندهای داخلی بسیار آسان تر شده است.
اکنون می‌توانید حلزون را در صفحه‌ای که به آن پیوند می‌دهید مشخص کنید، و Starlight به طور خودکار از عنوان صفحه به عنوان برچسب پیوند استفاده می‌کند:

title: 'Cutting Edge Starlight',

به عنوان یک امتیاز، با این نحو، تأیید پیوند رایگان دریافت می‌کنید – دیگر خبری از 404های تصادفی نیست! با تشکر از لورنزو برای اضافه کردن این ویژگی.

اسناد تازه درخشان

و ما هم روی کاغذهای خودمان کار می کنیم!
مستندات اجزای داخلی Starlight را بازبینی کرد.
اکنون هر جزء دارای یک صفحه اختصاصی شامل مثال‌های استفاده رایج و یک مرجع کامل است.

برای مشاهده اجزای موجود، از راهنمای جدید “استفاده از اجزا” دیدن کنید.

البته، بدون ترجمه اسناد Astro نخواهد بود.
فریاد بزن @dreyfus92، @jsparkdev، @dragomano، @liruifengv، @zhoushengdao، @Nin3lee، @casungo، @at-the-vr، و @thomasbnt برای به روز رسانی اسناد ما به زبان های اسپانیایی، کره ای، روسی، چینی ساده شده، ایتالیایی، هندی و فرانسوی!

از پیش تنظیم Markdoc برای ماجراجویان

کاربران Starlight علاقه مند به Markdoc می توانند از جدید استفاده کنند @astrojs/starlight-markdoc بسته ای برای پیکربندی سریع تمام اجزای داخلی Starlight برای استفاده در فایل های Markdoc.
برای جزئیات بیشتر به راهنمای تنظیم Markdoc ما مراجعه کنید.

امروز Starlight را امتحان کنید!

ما از دیدن شرکت‌هایی مانند Cloudflare، Crowdin، StackBlitz، Sentry، Font Awesome و SST هیجان‌زده شدیم که Starlight را در ساخت اسناد استفاده می‌کنند. به آنها بپیوندید و به پروژه‌های منبع باز مانند FreeCodeCamp، RealWorld Apps، Biome، Jimp، Shepherd، Block و Knip بپیوندید. – و همین امروز شروع کنید.

از اسناد Starlight دیدن کنید یا یک سایت جدید درست از ترمینال خود ایجاد کنید:

npm create astro@latest -- --template starlight


Source link

نوشته های مشابه

دیدگاهتان را بنویسید

دکمه بازگشت به بالا