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: दस्तऐवज फक्त मानव वाचकांसाठीच नाही तर एजंटद्वारे चांगल्या प्रकारे समजून घेण्यासाठी आणि वापरण्यासाठी देखील आवश्यक आहे. 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 वेरिएबल पृष्ठावर इंटरएक्टिव्हपणे सर्व CSS वेरिएबल्सचे पूर्वावलोकन आणि समायोजन करू शकता, आणि तुम्हाला आवडणारी कॉन्फिगरेशन मिळाल्यावर ती थेट प्रकल्पात वापरण्यासाठी कॉपी करू शकता.

• BEM वर्ग नाव: अंतर्निहित घटक आता सर्व BEM नामकरण मानकांचे पालन करतात. हे एक खूपच जुने शाळेचे निवड आहे, परंतु हे आमचे विचारपूर्वक निर्णय आहे. वापरकर्ते CSS निवडकाद्वारे शैली अचूकपणे समायोजित करू शकतात, HTML संरचना अधिक स्पष्ट आहे.
• ESM पुनः निर्यात ओव्हरराईट: जर CSS वरचे बदल कस्टमायझेशन आवश्यकतांना पूर्ण करत नसतील, तर तुम्ही JS द्वारे अधिक गहन कस्टमायझेशन करू शकता. theme/index.tsx मध्ये ESM पुनः निर्याताचा वापर करून, तुम्ही Rspress च्या कोणत्याही अंतर्निहित घटकाचे ओव्हरराईट करू शकता.
• घटक निघणे: तुम्ही नवीन rspress eject [component] आदेश वापरू शकता, हा आदेश निर्दिष्ट घटकाचा स्रोत कोड theme/components/ निर्देशिकेत कॉपी करेल, तुम्ही या कोडमध्ये मुक्तपणे बदल करू शकता, अगदी AI कडे थेट बदलण्यासाठी देखील देऊ शकता, जेणेकरून गहन कस्टमायझेशन साधता येईल.

नेव्हिगेशन बार, साइडबार टॅग

Rspress 2.0 ने टॅग घटक कार्यान्वित केला आहे, आता तुम्ही frontmatter मधील टॅग गुणधर्माचा वापर करून साइडबार किंवा नेव्हिगेशन बारमध्ये 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 मजकूरात रूपांतरित करताना खालील समस्यांना सामोरे जावे लागते:

• AI ला थेट MDX इनपुट देणे म्हणजे मोठ्या प्रमाणात कोड सिंटॅक्स आवाज समाविष्ट करणे, आणि React घटक सामग्री गमावणे
• HTML ला Markdown मध्ये रूपांतरित करणे सहसा चांगले परिणाम देत नाही, माहितीची गुणवत्ता सुनिश्चित करणे कठीण आहे

या समस्येचे समाधान करण्यासाठी, Rspress 2.0 ने SSG-MD वैशिष्ट्य आणले आहे. हे एक नवीन कार्य आहे, जे स्थिर साइट निर्माण (SSG) सारखे आहे, परंतु यामध्ये तुमच्या पृष्ठाला HTML फाइलऐवजी Markdown फाइल म्हणून रेंडर केले जाते, आणि 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 इ.) मध्ये इनपुट करून स्थलांतर पूर्ण करण्यासाठी.Rspress 2.0 साठी Node.js आवृत्ती 20+ आणि React आवृत्ती 18+ आवश्यक आहे.

## पुढील पाऊल

Rspress 2.0 चा प्रकाशन हा एक नवीन प्रारंभ आहे. या प्रकाशनानंतर, Rspress सतत सुधारणा करेल:

- इकोसिस्टम एकत्रीकरण पुढे नेणे: Rslib, Rstest यांच्यासोबत अधिक गहन एकत्रीकरण, फ्रंटेंड प्रकल्प आणि घटक ग्रंथालय प्रकल्पांसाठी एकात्मिक विकास अनुभव प्रदान करणे.
- AI आणि दस्तऐवजांच्या अधिक गहन एकत्रीकरणाचा शोध घेणे: जसे की स्मार्ट प्रश्नोत्तर, स्वयंचलित सारांश इत्यादी; SSG-MD ला पूर्ण करणे जेणेकरून ते स्थिर आणि अधिक वापरण्यास सोपे होईल.

तत्काळ Rspress 2.0 वापरा किंवा अपग्रेड करा, नवीन दस्तऐवज विकास प्रवासाचा अनुभव घ्या!

npm create rspress@latest