Rspress 2.0 പുറത്തിറക്കൽ: അനുഭവവും AI-യും ലക്ഷ്യമിട്ട പുതിയ അപ്ഡേറ്റ്
Rspress 2.0 പുറത്തിറക്കൽ: അനുഭവവും AI-യും ലക്ഷ്യമിട്ട പുതിയ അപ്ഡേറ്റ്
ഞങ്ങൾ Rspress 2.0-ന്റെ ഔദ്യോഗിക പുറത്തിറക്കൽ പ്രഖ്യാപിക്കാൻ സന്തോഷിക്കുന്നു!
Rspress Rsbuild-ൽ അടിസ്ഥാനമാക്കിയുള്ള സ്റ്റാറ്റിക് സൈറ്റുകൾ നിർമ്മിക്കുന്ന ഉപകരണമാണ്, വികസനക്കാർക്കായി രൂപകൽപ്പന ചെയ്ത ഡോക്യുമെന്റ് സൈറ്റുകൾക്കായുള്ള ഉപകരണം. 2023-ൽ ഔദ്യോഗികമായി പുറത്തിറങ്ങിയതിന്റെ ശേഷം, Rspress 1.x-ൽ 144 പതിപ്പുകൾ സംയോജിപ്പിച്ചു, 125 പേർ പദ്ധതിയുടെ വികസനത്തിൽ പങ്കെടുത്തു. കൂടുതൽ വികസനക്കാർ Rspress തിരഞ്ഞെടുക്കുന്നു, അതിന്റെ പ്രവർത്തനക്ഷമമായ സംയോജനം, കരാറിന്റെ അടിസ്ഥാനത്തിലുള്ള റൂട്ടിംഗ്, കൂടാതെ ഘടകങ്ങളുടെ ലൈവ് പ്രദർശനം പോലുള്ള സവിശേഷതകളുടെ സഹായത്തോടെ മനോഹരവും വിശ്വസനീയവുമായ ഡോക്യുമെന്റ് സൈറ്റുകൾ നിർമ്മിക്കാൻ.
സമൂഹത്തിന്റെ പ്രതികരണങ്ങളും നിർദ്ദേശങ്ങളും അടിസ്ഥാനമാക്കി, Rspress 2.0 തീമിന്റെ ആകർഷണം, AI-നേറ്റീവ്, ഡോക്യുമെന്റ് വികസന അനുഭവം, Rslib-നൊപ്പം ഉപയോഗിക്കുന്നത് തുടങ്ങിയ മേഖലകളിൽ കൂടുതൽ മുന്നോട്ട് പോയിട്ടുണ്ട്.
Rspress 2.0-ന്റെ കാരണം
Rspress 1.x ഡോക്യുമെന്റ് സൈറ്റിന്റെ ഫ്രെയിംവർക്കിന്റെ സംയോജനം സംബന്ധിച്ച പ്രശ്നങ്ങൾ പരിഹരിച്ചിട്ടുണ്ടെങ്കിലും, ഒരു ഡോക്യുമെന്റ് വികസന ഉപകരണത്തിന്റെ ആധികാരിക അനുഭവത്തെ ബാധിക്കുന്ന ചില പ്രശ്നങ്ങൾ ഇപ്പോഴും നിലനിൽക്കുന്നു. 2.0 പതിപ്പ് സംയോജനം സംബന്ധിച്ച ലക്ഷ്യത്തിലേക്ക് മാത്രമല്ല, ഡോക്യുമെന്റ് സൈറ്റിന്റെ അനുഭവത്തിന്റെ മറ്റ് വശങ്ങൾക്കുമാണ് ശ്രദ്ധ കേന്ദ്രീകരിക്കുന്നത്:
- തീമിന്റെ ശൈലി: ഒരു കൂടുതൽ ആകർഷകമായ ഡിഫോൾട്ട് തീം, കൂടാതെ നിരവധി കസ്റ്റമൈസ് ചെയ്യാനുള്ള മാർഗങ്ങൾ നൽകുന്നു, 1.x-ൽ തീം കസ്റ്റമൈസേഷനിൽ സ്ഥിരതയുള്ള API-യുടെ അഭാവം പരിഹരിക്കുന്നു.
- AI-നേറ്റീവ്: ഡോക്യുമെന്റുകൾ മനുഷ്യ വായനക്കാർക്കായി മാത്രമല്ല, ഏജന്റുകൾക്കായി മികച്ച രീതിയിൽ മനസ്സിലാക്കാനും ഉപയോഗിക്കാനും ആവശ്യമാണ്. Rspress ഇപ്പോൾ llms.txt സൃഷ്ടിക്കുകയും SSG-യിൽ നിന്നുള്ള SSG-MD ഫീച്ചർ ഉൾക്കൊള്ളുകയും ചെയ്യുന്നു, ഏജന്റുകൾ വായിക്കാൻ ഉയർന്ന നിലവാരത്തിലുള്ള Markdown റെൻഡർ ഉള്ളടക്കം സൃഷ്ടിക്കുന്നു.
- ആവശ്യത്തിന് സംയോജനം, ഉടൻ ആരംഭിക്കുക: ഡിഫോൾട്ടായി lazyCompilation സജീവമാക്കുന്നു, ലിങ്ക് ഹോവറിംഗ് സമയത്ത് വിഭവങ്ങളുടെ പ്രീലോഡ് ഫീച്ചർ ഉപയോഗിച്ച്, പ്രത്യേക റൂട്ടുകൾ സന്ദർശിക്കുന്നതിന്റെ അടിസ്ഥാനത്തിൽ ആവശ്യമായ ഫയലുകൾ നിർമ്മിക്കുന്നു, പദ്ധതിയുടെ വലിപ്പം എത്ര വലിയതായാലും, dev ഉടൻ ആരംഭിക്കാൻ കഴിയും.
- Shiki കോഡ് ഹൈലൈറ്റ്: ഡിഫോൾട്ടായി Shiki സംയോജിപ്പിച്ചിരിക്കുന്നു, നിർമ്മാണ സമയത്ത് സങ്കേതം ഹൈലൈറ്റ് പൂർത്തിയാക്കുന്നു, തീം മാറ്റങ്ങൾ, ട്രാൻസ്ഫോർമർ വിപുലീകരണങ്ങൾ എന്നിവ പിന്തുണയ്ക്കുന്നു, ഉദാഹരണത്തിന് @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 വേരിയബ്ലുകൾ, BEM ക്ലാസ് നാമങ്ങൾ, ESM പുനർനിർമ്മാണം, ഘടകങ്ങൾ എജക്ട് എന്നിവയുള്ള നാല് തരത്തിലുള്ള കസ്റ്റം തീം മാർഗങ്ങൾ ഉണ്ട്.- CSS വ്യത്യാസങ്ങൾ: പുതിയ തീം കൂടുതൽ CSS വ്യത്യാസങ്ങൾ പുറത്തുവിട്ടു, തീം നിറം, കോഡ് ബ്ലോക്ക്, ഹോംപേജ് തുടങ്ങിയ ശൈലികൾ覆蓋 ചെയ്യുന്നു. നിങ്ങൾ CSS വ്യത്യാസങ്ങൾ പേജിൽ ഇന്ററാക്ടീവ് ആയി പ്രിവ്യൂ ചെയ്യാനും ക്രമീകരിക്കാനും കഴിയും, നിങ്ങൾക്ക് ഇഷ്ടമുള്ള കോൺഫിഗറേഷൻ കണ്ടെത്തിയാൽ അത് പ്രോജക്ടിൽ ഉപയോഗിക്കാൻ നേരിട്ട് പകർപ്പിക്കാൻ കഴിയും.
- BEM ക്ലാസ് നാമം: ഇൻബിൽട്ട് ഘടകങ്ങൾ ഇപ്പോൾ എല്ലാം BEM നാമനിർമ്മാണ മാനദണ്ഡം പിന്തുടരുന്നു. ഇത് വളരെ പഴയ സ്കൂൾ തിരഞ്ഞെടുപ്പാണ്, എന്നാൽ ഇത് ഞങ്ങളുടെ ആലോചിച്ച തീരുമാനമാണ്. ഉപയോക്താക്കൾ CSS തിരഞ്ഞെടുക്കുന്ന വഴി ശൈലികൾ കൃത്യമായി ക്രമീകരിക്കാം, HTML ഘടകം കൂടുതൽ വ്യക്തമായിരിക്കും.
- ESM重导出覆盖: CSS-ൽ മാറ്റങ്ങൾ ഇഷ്ടാനുസൃത ആവശ്യങ്ങൾ നിറവേറ്റാൻ കഴിയുന്നില്ലെങ്കിൽ, JS വഴി കൂടുതൽ ആഴത്തിലുള്ള ഇഷ്ടാനുസൃതീകരണം നടത്താം. theme/index.tsx-ൽ ESM重导出 ഉപയോഗിച്ച്, നിങ്ങൾക്ക് Rspress-ന്റെ ഇൻബിൽട്ട് ഘടകങ്ങളിൽ ഏതെങ്കിലും ഒരു ഘടകം覆蓋 ചെയ്യാൻ കഴിയും.
- ഘടകങ്ങൾ eject: നിങ്ങൾക്ക് പുതിയ rspress eject [component] കമാൻഡ് ഉപയോഗിച്ച്, ഈ കമാൻഡ് നിർദ്ദിഷ്ട ഘടകത്തിന്റെ ഉറവിട കോഡ് theme/components/ ഡയറക്ടറിയിലേക്ക് പകർപ്പിക്കും, നിങ്ങൾക്ക് ഈ കോഡ് സ്വതന്ത്രമായി മാറ്റം വരുത്താൻ കഴിയും,甚至直接交给 AI 修改，以实现深度定制。
导航栏、侧边栏 tag
Rspress 2.0 标签组件实现了，现在可以使用 frontmatter 中的 tag 属性，在侧边栏或导航栏进行 UI 标注。
内置多语言支持
在 1.x 版本中，Rspress 仅内置了英文文本，如果使用其他语言例如 zh，必须对所有的文本都进行配置，使用起来较为繁琐。现在 2.0 主题内置了 zh、en、ja、ko、ru 等多种语言的翻译文本，系统会根据语言配置自动进行 "Tree Shaking"，仅打包你使用到的文本及语言。
llms.txt 支持
Rspress 现在将 llms.txt 生成能力集成到 core 中，并实现了全新的 SSG-MD（Static Site Generation to Markdown，静态站点 Markdown 生成）能力。
在基于 React 动态渲染的前端框架中，往往存在静态信息难以提取的问题，Rspress 也面临同样的挑战。Rspress 允许用户通过 MDX 片段、React 组件、Hooks 以及 TSX 路由等动态特性来增强文档表现力。但这些动态内容在转换为 Markdown 文本时会面临以下问题：
- 直接将 MDX 输入给 AI 会包含大量代码语法噪音，并丢失 React 组件内容
- 将 HTML 转为 Markdown 往往效果不佳，信息质量难以保证
为了解决这个问题，Rspress 2.0 引入了 SSG-MD 特性。这是一个全新的功能，它类似于静态站点生成（SSG），但不同之处在于它将你的页面渲染为 Markdown 文件，而非 HTML 文件，并生成 llms.txt 及 llms-full.txt 相关文件。
Shiki 编译时代码块高亮Rspress 2.0 ഡിഫോൾട്ട് ആയി Shiki ഉപയോഗിച്ച് കോഡ് ഹൈലൈറ്റ് ചെയ്യുന്നു. 1.x ന്റെ prism പ്രവർത്തനസാധ്യത ഹൈലൈറ്റിംഗ് പദ്ധതിയുമായി താരതമ്യം ചെയ്യുമ്പോൾ, Shiki കോഡിന്റെ ഹൈലൈറ്റിംഗ് പ്രോസസ്സ് കംപൈൽ ചെയ്യുമ്പോൾ പൂർത്തിയാക്കുന്നു.
- CSS വേരിയബിൾ പേജിൽ വ്യത്യസ്ത Shiki തീമുകൾ ഇടയിലായി മാറ്റാനും പ്രിവ്യൂ ചെയ്യാനും സഹായിക്കുന്ന നിരവധി തീമുകൾ പിന്തുണയ്ക്കുന്നു.
- Shiki ഇഷ്ടാനുസൃത ട്രാൻസ്ഫോർമർ ഉപയോഗിച്ച് എഴുതലിനെ സമ്പന്നമാക്കാൻ അനുവദിക്കുന്നു, ഉദാഹരണത്തിന് twoslash മുതലായവ.
- ആവശ്യത്തിന് പ്രോഗ്രാമിംഗ് ഭാഷകൾ ഉൾപ്പെടുത്തുക, പ്രവർത്തനസാധ്യതയുടെ ചെലവുകളും പാക്കേജ് വലുപ്പവും കൂട്ടിച്ചേർക്കാതെ.
- TextMate വ്യാകരണത്തെ അടിസ്ഥാനമാക്കി VS Code നോട് പൊരുത്തമുള്ള കൃത്യമായ വ്യാകരണ ഹൈലൈറ്റിംഗ് നടപ്പിലാക്കുന്നു.
### നിർമ്മാണ പ്രകടന മെച്ചപ്പെടുത്തലുകൾ
Rspress 2.0 അടിസ്ഥാനം Rsbuild ഉം Rspack 2.0 പ്രിവ്യൂ പതിപ്പും ഉപയോഗിക്കുന്നു, കൂടാതെ ഡിഫോൾട്ട് ആയി ആവശ്യത്തിന് കംപൈലിംഗും സ്ഥിരമായ കാഷെയും പ്രവർത്തനക്ഷമമാക്കുന്നു.
#### ആവശ്യത്തിന് കംപൈലിംഗ്
ഡിഫോൾട്ട് ആയി dev.lazyCompilation പ്രവർത്തനക്ഷമമാക്കുന്നു, നിങ്ങൾ ഒരു പേജ് സന്ദർശിക്കുമ്പോൾ മാത്രമേ ആ പേജ് കംപൈൽ ചെയ്യപ്പെടുകയുള്ളു, ഇത് വികസന ആരംഭത്തിന്റെ വേഗതയിൽ വലിയ വർദ്ധനവുണ്ടാക്കുന്നു, മില്ലിസെക്കൻഡ് തലത്തിൽ തണുത്ത ആരംഭം നേടുന്നു. Rspress റൂട്ടിന്റെ പ്രീലോഡ് തന്ത്രം നടപ്പിലാക്കുന്നു, നിങ്ങൾ ലിങ്കിൽ മൗസ് ഹോവർ ചെയ്യുമ്പോൾ ലക്ഷ്യ റൂട്ടിന്റെ പേജ് മുൻകൂട്ടി ലോഡ് ചെയ്യും, lazyCompilation ഉപയോഗിച്ച് നഷ്ടമില്ലാത്ത വികസന അനുഭവം നേടുന്നു.
#### സ്ഥിരമായ കാഷെ
2.0 ഡിഫോൾട്ട് ആയി സ്ഥിരമായ കാഷെ പ്രവർത്തനക്ഷമമാക്കുന്നു, ചൂടായ ആരംഭത്തിൽ കഴിഞ്ഞ കംപൈലിന്റെ ഫലങ്ങൾ പുനരുപയോഗിക്കുന്നു, 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 ഔദ്യോഗിക പ്ലഗിനുകൾ
Rspress 2.0 പുതിയ നിരവധി ഔദ്യോഗിക പ്ലഗിനുകൾ ചേർത്തിട്ടുണ്ട്:
- @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 പകർപ്പിക്കുക" ഫംഗ്ഷൻ നേരിട്ട് ഉപയോഗിച്ച്, ഇത് നിങ്ങളുടെ സാധാരണ കോഡിംഗ് ഏജന്റിന് (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
