Rspress 2.0 ထုတ်ပြန်ခြင်း - အတွေ့အကြုံနှင့် AI ကို ရည်ညွှန်းသော အသစ်အဆန်းများ
Rspress 2.0 ထုတ်ပြန်ခြင်း - အတွေ့အကြုံနှင့် AI ကို ရည်ညွှန်းသော အသစ်အဆန်းများ
Rspress 2.0 ၏ တရားဝင်ထုတ်ပြန်မှုကို ကြေညာရတာ ဝမ်းသာပါတယ်!
Rspress သည် Rsbuild အခြေခံထားသော သက်တမ်းတစ်ခုအတွင်း ဖွံ့ဖြိုးရေးသူများအတွက် ဖန်တီးထားသော စာရွက်စာတမ်းဆိုဒ်ကွန်ယက်တစ်ခုဖြစ်သည်။ 2023 ခုနှစ်မှ စတင်ထုတ်ပြန်ခဲ့ပြီး Rspress 1.x သည် 144 ဗားရှင်း ကို စုစည်းခဲ့ပြီး 125 ဦး ၏ အထောက်အကူပြုသူများသည် စီမံကိန်းဖွံ့ဖြိုးရေးတွင် ပါဝင်ခဲ့ကြသည်။ ဖွံ့ဖြိုးရေးသူများစွာသည် Rspress ကို ရွေးချယ်ပြီး ၎င်း၏ ထိရောက်သော ကွန်ပျူတာစွမ်းဆောင်ရည်၊ သဘောတူလမ်းကြောင်းနှင့် ကွန်ပျူတာပုံစံကြည့်ရှုမှု စသည့် လုပ်ဆောင်ချက်များကို အသုံးပြု၍ လှပပြီး ယုံကြည်စိတ်ချရသော စာရွက်စာတမ်းဆိုဒ်များကို တည်ဆောက်နေကြသည်။
အသိုင်းအဝိုင်းမှ တုံ့ပြန်ချက်များနှင့် အကြံပြုချက်များအပေါ် အခြေခံ၍ Rspress 2.0 သည် အကြောင်းအရာအလှအပ၊ AI-native၊ စာရွက်စာတမ်းဖွံ့ဖြိုးရေးအတွေ့အကြုံ၊ Rslib နှင့် အတူသုံးခြင်း စသည့် အပိုင်းများတွင် ပိုမိုတိုးတက်လာသည်။
Rspress 2.0 အကြောင်း
Rspress 1.x သည် စာရွက်စာတမ်းဆိုဒ်ကွန်ယက်၏ ကွန်ပျူတာစွမ်းဆောင်ရည်ပြဿနာကို ဖြေရှင်းခဲ့ပြီး သို့သော် စာရွက်စာတမ်းဖွံ့ဖြိုးရေးကိရိယာအဖြစ် အခြေခံအတွေ့အကြုံကို ထိခိုက်စေသော ပြဿနာအချို့ရှိနေသည်။ 2.0 ဗားရှင်းသည် ကွန်ပျူတာစွမ်းဆောင်ရည်ကို ရှာဖွေရန်သာမက စာရွက်စာတမ်းဆိုဒ်အတွေ့အကြုံ၏ အခြားအပိုင်းများကိုလည်း ဦးတည်ထားသည်။
- အကြောင်းအရာပုံစံ: ပိုမိုလှပသော အခြေခံအကြောင်းအရာပုံစံ တစ်ခုနှင့် အမျိုးမျိုးသော အထူးပြုအကြောင်းအရာပုံစံများကို ပံ့ပိုးပေးပြီး 1.x တွင် အကြောင်းအရာကို အထူးပြုလုပ်ရာတွင် အတည်ပြု API မရှိခြင်းကို ဖြေရှင်းသည်။
- AI-native: စာရွက်စာတမ်းများသည် လူသားဖတ်ရှုသူများအတွက်သာမက Agent များအတွက်လည်း ပိုမိုသိရှိနိုင်ရန် လိုအပ်သည်။ Rspress သည် ယခု llms.txt ဖန်တီးခြင်းနှင့် SSG မှ SSG-MD ကို ထုတ်လုပ်ခြင်းတို့ကို အထူးပြုလုပ်ထားပြီး Agent များဖတ်ရှုရန် အရည်အသွေးမြင့် Markdown ဖျော်ဖြေရန် အကြောင်းအရာများကို ထုတ်လုပ်သည်။
- လိုအပ်သလို ကွန်ပျူတာလုပ်ဆောင်ခြင်း၊ အချိန်တိုင်း စတင်ခြင်း: lazyCompilation ကို အခြေခံထားပြီး လင့်ခ် hover အချိန်တွင် အရင်းအမြစ်များကို preload လုပ်ခြင်းဖြင့် သတ်မှတ်ထားသော လမ်းကြောင်းများကို သာသာ ဖွင့်လှစ်သောအခါ လိုအပ်သော ဖိုင်များကို တည်ဆောက်ပြီး အစီအစဉ်၏ အရွယ်အစားမည်မျှဖြစ်စေ dev သည် အချိန်တိုင်း စတင်နိုင်သည်။
- Shiki ကုဒ်အလှဆင်ခြင်း: Shiki ကို အခြေခံထားပြီး အခြေခံအဆင့်တွင် ဘာသာစကားအလှဆင်ခြင်း ပြုလုပ်သည်၊ အကြောင်းအရာပုံစံပြောင်းလဲခြင်း၊ transformer တိုးချဲ့ခြင်းကို ပံ့ပိုးသည်၊ ဥပမာ @rspress/plugin-twoslash သည် ကုဒ်အပိုင်းများကို ပိုမိုအထူးပြုလုပ်ရန် အထောက်အကူပြုသည်။
- စာရွက်စာတမ်းဖွံ့ဖြိုးရေးအတွေ့အကြုံ: nav.json၊ meta.json စသည့် ဖိုင်များ၏ HMR ကို တိုးတက်စေပြီး IDE အတွင်း ကုဒ်အကြံပြုရန် json schema အသစ်ကို ထည့်သွင်းသည်။ သေဆုံးသောလင့်ခ်စစ်ဆေးမှုကို အလိုအလျောက် ဖွင့်ထားသည်။ အပြင် ဖိုင်ကုဒ်အပိုင်းအဆင့်အသစ်ကို ထည့်သွင်းပြီး အပြင်ဖိုင်များကို ကိုးကားနိုင်သည်။ @rspress/plugin-preview နှင့် @rspress/plugin-playground ကို တစ်ပြိုင်နက် အသုံးပြုနိုင်သည်။
- Rslib ပေါင်းစပ်ခြင်း: create-rslib ကို အသုံးပြု၍ ကွန်ပျူတာပုံစံစီမံကိန်းကို ဖန်တီးသောအခါ Rspress ကို စာရွက်စာတမ်းကိရိယာအဖြစ် ရွေးချယ်နိုင်ပြီး အမြန်ဆုံး ကွန်ပျူတာစာရွက်စာတမ်းဆိုဒ်ကို တည်ဆောက်နိုင်သည်။
2.0 အသစ်အဆန်းများ
အသစ်အဆန်းအကြောင်းအရာ
2.0 အခြေခံအကြောင်းအရာသည် စနစ်တကျ အဆင့်မြှင့်တင်မှုကို ရရှိခဲ့ပြီး၊ ၎င်းကို အဖွဲ့မှ ဒီဇိုင်နာ @Zovn Wei က အပြုံးအဆင်ပြေစွာ ဒီဇိုင်းဆွဲထားပြီး၊ မြင်ကွင်းအရ အလှအပနှင့် ဖတ်ရှုမှုအတွေ့အကြုံတို့တွင် အထူးပြုလုပ်ထားသည်။ ၎င်းသည် အစိတ်အပိုင်းတိုင်းကို သီးသန့် အစားထိုးနိုင်ပြီး အထူးပြုလုပ်နိုင်မှုရှိသည်။
အကြောင်းအရာကို အထူးပြုလုပ်ခြင်း
အထူးပြုလုပ်မှုအဆင့်အလိုက် အဆင့်မြင့်မှ အနိမ့်အထိ CSS variable၊ BEM class name၊ ESM ပြန်လည်ထုတ်လုပ်မှု၊ အစိတ်အပိုင်း eject စသည်ဖြင့် အကြောင်းအရာကို အထူးပြုလုပ်နိုင်သည်။- CSS 变量：အသစ်သောအကြောင်းအရာသည် CSS 变量 များကို ပိုမိုဖွင့်လှစ်ထားပြီး၊ အထူးသဖြင့် theme color၊ code block၊ homepage စသည်တို့၏ စတိုင်များကို အပြောင်းအလဲပြုလုပ်နိုင်သည်။ သင်သည် CSS 变量 စာမျက်နှာတွင် အပြန်အလှန်ကြည့်ရှု၍ CSS 变量 များအားလုံးကို ပြင်ဆင်နိုင်ပြီး၊ သင့်နှစ်သက်သော ကွန်ဖစ်ကို ရှာဖွေပြီး တိုက်ရိုက် ကူးယူနိုင်သည်။
- BEM class name：Built-in components များသည် ယခု BEM naming convention ကို အသုံးပြုနေပါသည်။ ၎င်းသည် အထူးသဖြင့် Old School ရွေးချယ်မှုဖြစ်သော်လည်း၊ ကျွန်ုပ်တို့၏ အတွေးအခေါ်များကို သေချာစွာ ဆုံးဖြတ်ခဲ့သည်။ အသုံးပြုသူများသည် CSS selector များမှတဆင့် စတိုင်များကို တိကျစွာ ပြင်ဆင်နိုင်ပြီး၊ HTML ဖွဲ့စည်းမှုသည် ပိုမိုရှင်းလင်းလာသည်။
- ESM 重导出覆盖：CSS တွင် ပြင်ဆင်မှုများသည် အထူးသဖြင့် စိတ်ကြိုက်လိုအပ်ချက်များကို ဖြည့်ဆည်းနိုင်မည်မဟုတ်ပါက JS ဖြင့် ပိုမိုနက်ရှိုင်းစွာ စိတ်ကြိုက်ပြုလုပ်နိုင်သည်။ theme/index.tsx တွင် ESM 重导出 ကို အသုံးပြု၍ Rspress ၏ built-in component များကို 覆蓋 ပြုလုပ်နိုင်သည်။
- 组件 eject：သင်သည် အသစ်သော rspress eject [component] command ကို အသုံးပြုနိုင်ပြီး၊ ဤ command သည် သတ်မှတ်ထားသော component ၏ source code ကို theme/components/ ဒါရိုက်ထဲသို့ ကူးယူပါမည်၊ သင်သည် ဤ code များကို အခွင့်အရေးရှိစွာ ပြင်ဆင်နိုင်ပြီး၊ AI ကို တိုက်ရိုက် ပြင်ဆင်ရန်လည်း ပေးနိုင်သည်။
导航栏、侧边栏 tag
Rspress 2.0 သည် Tag component ကို အကောင်အထည်ဖော်ခဲ့ပြီး၊ ယခု frontmatter တွင် tag property ကို အသုံးပြု၍ sidebar သို့မဟုတ် navigation bar တွင် UI အမှတ်အသားပြုနိုင်သည်။
内置多语言支持
1.x version တွင် Rspress သည် အင်္ဂလိပ်စာသားကိုသာ built-in ထားပြီး၊ အခြားဘာသာစကားများကို အသုံးပြုလိုပါက zh ကဲ့သို့သော အချက်အလက်များကို configuration ပြုလုပ်ရမည်ဖြစ်ပြီး၊ အသုံးပြုရခက်ခဲသည်။ ယခု 2.0 theme သည် zh၊ en၊ ja၊ ko၊ ru စသည့် ဘာသာစကားများ၏ ဘာသာပြန်စာသားများကို built-in ထားပြီး၊ စနစ်သည် ဘာသာစကား configuration အရ အလိုအလျောက် "Tree Shaking" ပြုလုပ်ပြီး သင်အသုံးပြုသော စာသားနှင့် ဘာသာစကားများကိုသာ package ပြုလုပ်သည်။
llms.txt 支持
Rspress သည် ယခု llms.txt ဖန်တီးနိုင်မှုကို core ထဲသို့ ပေါင်းစပ်ပြီး၊ အထူးသဖြင့် SSG-MD (Static Site Generation to Markdown) အင်္ဂါရပ်အသစ်ကို ဖန်တီးခဲ့သည်။
React အခြေခံ dynamic rendering frontend framework များတွင် အမြဲ static information များကို ထုတ်ယူရန် အခက်အခဲများရှိပြီး၊ Rspress သည် အထူးသဖြင့် ဤအခက်အခဲကို ရင်ဆိုင်နေရသည်။ Rspress သည် အသုံးပြုသူများကို MDX fragment များ၊ React component များ၊ Hooks နှင့် TSX routing စသည့် dynamic features များကို အသုံးပြု၍ စာရွက်စာတမ်း၏ ဖျော်ဖြေရန် အားပေးသည်။ သို့သော် ဤ dynamic အကြောင်းအရာများကို Markdown စာသားသို့ ပြောင်းလဲရာတွင် အောက်ပါပြဿနာများကို ရင်ဆိုင်ရသည်။
- MDX ကို AI သို့ တိုက်ရိုက် ထည့်သွင်းပါက code syntax noise များစွာ ပါဝင်ပြီး React component အကြောင်းအရာများကို လွတ်လပ်စွာ ပျောက်ဆုံးသွားသည်။
- HTML ကို Markdown သို့ ပြောင်းလဲခြင်းသည် အများအားဖြင့် အကျိုးသက်ရောက်မှု မကောင်းပါ၊ အချက်အလက်အရည်အသွေးကို သေချာမထားနိုင်ပါ။
ဤပြဿနာကို ဖြေရှင်းရန် Rspress 2.0 သည် SSG-MD အင်္ဂါရပ်ကို မိတ်ဆက်ခဲ့သည်။ ၎င်းသည် static site generation (SSG) နှင့် ဆင်တူသော်လည်း၊ သင့်စာမျက်နှာကို HTML ဖိုင်အစား Markdown ဖိုင်အဖြစ် render လုပ်ပြီး llms.txt နှင့် llms-full.txt သက်ဆိုင်ရာ ဖိုင်များကို ဖန်တီးသည်။
Shiki 编译时代码块高亮Rspress 2.0 သည် Shiki ကို ကုဒ် အထူးအလှဆင်မှုအတွက် မူလတန်း အသုံးပြုသည်။ 1.x ၏ prism အချိန်အတွင်း အထူးအလှဆင်မှု အစီအစဉ်နှင့် နှိုင်းယှဉ်ပါက Shiki သည် ကုဒ်ကို compile လုပ်သောအခါ အထူးအလှဆင်မှုကို ပြုလုပ်သည်။
- CSS အပြောင်းအလဲများ စာမျက်နှာတွင် အပြောင်းအလဲများကို အပြန်အလှန် ပြောင်းလဲပြီး Shiki အထူးအလှဆင်မှုများကို ကြည့်ရှုနိုင်သည်။
- Shiki သည် twoslash စ much အစီအစဉ်များကဲ့သို့ အရေးအသားများကို တိုးချဲ့ရန် ကိုယ်ပိုင် transformer များကို အသုံးပြုခွင့်လည်း ပေးသည်။
- လိုအပ်သလို programming language များကို ထည့်သွင်းပြီး အချိန်အတွင်း အထူးအလှဆင်မှုနှင့် package အရွယ်အစားကို မတိုးမြှင့်ပါ။
- TextMate သင်္ကေတအခြေခံပြီး VS Code နှင့် အတူတူ အတိအကျ သင်္ကေတ အထူးအလှဆင်မှုကို အကောင်အထည်ဖော်သည်။
တည်ဆောက်မှု စွမ်းဆောင်ရည် တိုးတက်မှု
Rspress 2.0 ၏ အခြေခံသည် Rsbuild နှင့် Rspack 2.0 ကြိုတင်ထုတ်ဝေမှုဖြင့် အလုပ်လုပ်ပြီး၊ လိုအပ်သလို compile လုပ်ခြင်းနှင့် အမြဲတမ်း cache ကို မူလတန်း ဖွင့်ထားသည်။
လိုအပ်သလို compile လုပ်ခြင်း
မူလတန်း dev.lazyCompilation ကို ဖွင့်ထားပြီး၊ သင်သည် တစ်ခုခုစာမျက်နှာကို ဝင်ရောက်ကြည့်ရှုသောအခါသာ အဆိုပါစာမျက်နှာကို compile လုပ်မည်ဖြစ်သည်။ ၎င်းသည် ဖွံ့ဖြိုးမှု စတင်မှု အမြန်နှုန်းကို တိုးတက်စေပြီး၊ မီလီစက္ကန့်အဆင့် အအေးစတင်မှုကို အောင်မြင်စေသည်။ Rspress သည် လင့်ခ်ပေါ်တွင် မျက်နှာပြင်ကို ရှိသောအခါ အထက်ပါ route စာမျက်နှာကို ကြိုတင် load လုပ်ရန် preload မူဝါဒကို လည်း အကောင်အထည်ဖော်ထားသည်။ lazyCompilation နှင့် တွဲဖက်၍ ဖွံ့ဖြိုးမှု အတွေ့အကြုံကို အထိခိုက်မှုမရှိစေရန် အောင်မြင်စေသည်။
အမြဲတမ်း cache
2.0 သည် အမြဲတမ်း cache ကို မူလတန်း ဖွင့်ထားပြီး၊ အပူစတင်မှုတွင် ယခင် compile လုပ်မှု၏ ရလဒ်ကို အသုံးပြု၍ တည်ဆောက်မှု အမြန်နှုန်းကို 30%-60% တိုးတက်စေသည်။ ၎င်းသည် rspress dev သို့မဟုတ် rspress build ကို ပထမဆုံး လည်ပတ်သောအခါ၊ နောက်ထပ် စတင်မှု အမြန်နှုန်းသည် အထူးသဖြင့် တိုးတက်လာမည်ကို ဆိုလိုသည်။
စာရွက်စာတမ်း ဖွံ့ဖြိုးမှု အတွေ့အကြုံ
မူလတန်း သေဆုံးသော လင့်ခ် စစ်ဆေးမှု ဖွင့်ထားသည်
Rspress 2.0 သည် သေဆုံးသော လင့်ခ် စစ်ဆေးမှု လုပ်ဆောင်ချက်ကို မူလတန်း ဖွင့်ထားသည်။ တည်ဆောက်မှု လုပ်ငန်းစဉ်တွင် စာရွက်စာတမ်းအတွင်း မသင့်လျော်သော လင့်ခ်များကို အလိုအလျောက် စစ်ဆေးပြီး သင့်ကို အချိန်မီ ရှာဖွေရန်နှင့် ပြုပြင်ရန် ကူညီသည်။
ဖိုင် ကုဒ်အပိုင်း
သင်သည် file="./path/to/file" အင်္ဂါရပ်ကို အသုံးပြု၍ အပြင်ဖိုင်ကို ကုဒ်အပိုင်းအဖြစ် ကိုးကားနိုင်ပြီး၊ ဥပမာကုဒ်ကို သီးသန့် ဖိုင်တစ်ခုတွင် ထားရှိနိုင်သည်။
preview ၏ ပို၍ 유연한 meta အသုံးပြုမှု
@rspress/plugin-preview သည် meta အင်္ဂါရပ်အပေါ် အခြေခံပြီး အသုံးပြုမှု ပို၍ 유연하게 ဖြစ်လာသည်။ ဖိုင် ကုဒ်အပိုင်းနှင့် တွဲဖက်၍လည်း အသုံးပြုနိုင်သည်။
Rslib & Rspress
create-rslib ဖြင့် စီမံကိန်းတစ်ခု ဖန်တီးသောအခါ၊ သင်သည် Rspress ကိရိယာကို ရွေးချယ်နိုင်သည်။ ၎င်းသည် သင့်ကို ကုန်ပစ္စည်းစာရင်း ဖွံ့ဖြိုးမှုနှင့် အတူ သက်ဆိုင်ရာ စာရွက်စာတမ်းဆိုက်ကို အမြန်တည်ဆောက်ရန် ခွင့်ပြုသည်။ ကုန်ပစ္စည်းအသုံးပြုမှု အကြောင်းအရာများရေးသားရန်၊ API ကို ရှင်းလင်းရန် သို့မဟုတ် ကုန်ပစ္စည်း အကျိုးသက်ရောက်မှုကို တိုက်ရိုက် ကြည့်ရှုရန် အသုံးပြုနိုင်သည်။
Rspress ၏ အခြားသော အထောက်အကူပြု plugin များ
Rspress 2.0 သည် အများအပြား အထောက်အကူပြု plugin များကို အသစ်ထည့်သွင်းခဲ့သည်။
- @rspress/plugin-algolia: Rspress ၏ အတွင်းပိုင်း ရှာဖွေရန် Algolia DocSearch ဖြင့် အစားထိုးရန် ထောက်ပံ့သည်။
- @rspress/plugin-twoslash: TypeScript ကုဒ်အပိုင်းများအတွက် အမျိုးအစား အကြံပြုချက်များ ထည့်သွင်းသည်။
- @rspress/plugin-llms: SSG နှင့် SSG-MD ကို မထောက်ပံ့သော စီမံကိန်းများအတွက် llms.txt ဖန်တီးနိုင်မှုကို ပံ့ပိုးသည်။
- @rspress/plugin-sitemap: SEO ကို တိုးတက်စေရန် Sitemap ဖိုင်ကို အလိုအလျောက် ဖန်တီးသည်။
ပြောင်းလဲမှုများ
Rspress 1.x သို့ ပြောင်းရွှေ့ခြင်း
သင်သည် 1.x စီမံကိန်း၏ အသုံးပြုသူဖြစ်ပါက၊ 1.x မှ 2.0 သို့ ပြောင်းရွှေ့ရန် ကူညီရန် ကျွန်ုပ်တို့သည် အသေးစိတ် ပြောင်းရွှေ့မှုစာရွက်စာတမ်းကို ပြင်ဆင်ထားသည်။ သင်သည် စာမျက်နှာအတွင်းရှိ "Markdown ကူးယူရန်" လုပ်ဆောင်ချက်ကို တိုက်ရိုက် အသုံးပြုနိုင်ပြီး၊ သင်၏ အထူးသဖြင့် အသုံးပြုသော ကုဒ် agent (Claude Code စသည်တို့) သို့ ထည့်သွင်းနိုင်သည်။### Node.js နှင့် အထက်မြှောက် အထောက်အကူ အမျိုးအစား လိုအပ်ချက်များ
Rspress 2.0 သည် Node.js ဗားရှင်း 20+ နှင့် React ဗားရှင်း 18+ ကို လိုအပ်သည်။
နောက်ထပ် အဆင့်များ
Rspress 2.0 ၏ ထုတ်ဝေမှုသည် အသစ်သော စတင်မှုတစ်ခုသာ ဖြစ်သည်။ ဤထုတ်ဝေမှုအပြီးတွင် Rspress သည် ဆက်လက်တိုးတက်မှုများကို ဆောင်ရွက်မည် -
- အင်တာနက်ပတ်ဝန်းကျင် ပေါင်းစည်းမှုကို တိုးတက်စေခြင်း: Rslib နှင့် Rstest နှင့် နက်ရှိုင်းစွာ ပေါင်းစည်းပြီး အရှေ့ဘက်ပရိုဂျက်နှင့် ကုန်ပစ္စည်းစာရင်းပရိုဂျက်များအတွက် တစ်ခုတည်းသော ဖွံ့ဖြိုးမှု အတွေ့အကြုံကို ပံ့ပိုးပေးမည်။
- AI နှင့် စာရွက်စာတမ်းများကို နက်ရှိုင်းစွာ ပေါင်းစည်းမှုကို ရှာဖွေရန်: ဥပမာ၊ ဉာဏ်ရည်ဖြေဆိုမှု၊ အလိုအလျောက် အကျဉ်းချုပ်များ စသည်တို့; SSG-MD ကို ပြုပြင်ပြီး တည်ငြိမ်ပြီး ပိုမိုအသုံးပြုရလွယ်ကူစေရန်။
npm create rspress@latest
