Rspress 2.0 La Daabacay: Casriyeyn Cusub oo Diiradda Saareysa Khibradda iyo AI

Waxaan ku faraxsanahay inaan ku dhawaaqno daabacaadda rasmiga ah ee Rspress 2.0!

Rspress waa Rsbuild ku saleysan qalab abuurista bogagga statik ah, oo si gaar ah loogu talagalay qalabka dukumiintiyada ee horumariyeyaasha. Tan iyo markii la daabacay rasmiga ah ee 2023, Rspress 1.x waxay soo martay 144 nooc oo la cusbooneysiiyay, iyadoo 125 qof ay ka qayb qaateen horumarinta mashruuca. Horumariyeyaasha badan ayaa doortay Rspress, iyagoo ka faa'iideysanaya waxqabadka wax-soo-saarka sare, waddooyinka la isku raacay iyo muuqaalka maktabadda qaybaha si ay u dhisaan bogag dukumiinti oo qurux badan oo la isku halleyn karo.

Iyada oo ku saleysan jawaab celinta iyo talooyinka bulshada, Rspress 2.0 waxay ka sii horumartay dhinacyada muuqaalka mawduuca, AI-native, khibradda horumarinta dukumiintiga, iyo isticmaalka Rslib.

Maxaa Sabab U Ah Rspress 2.0

Rspress 1.x waxay horey u xallisay dhibaatooyinka waxqabadka ee qaab-dhismeedka dukumiintiga, laakiin weli waxaa jiray dhibaatooyin qaar oo saameynaya khibradda aasaasiga ah ee qalab horumarineed. Nooca 2.0 maahan oo kaliya in la raadiyo waxqabadka wax-soo-saarka, laakiin sidoo kale waxay diiradda saareysaa dhinacyada kale ee khibradda bogga dukumiintiga:

• Qaabka Mawduuca: Set mowduuc default ah oo ka qurux badan, oo bixiya siyaabo kala duwan oo lagu habeyn karo mawduuca, si loo xalliyo dhibaatooyinka 1.x ee ku saabsan xasilloonida API ee habeynta mawduuca.
• AI-native: Dukumiintiyada ma aha oo kaliya inay u adeegaan akhristayaasha bini'aadamka, laakiin sidoo kale waxay u baahan yihiin in si wanaagsan loo fahmo oo loo isticmaalo Agent. Rspress hadda waxay ku dhex jirtaa llms.txt abuurista iyo SSG ka soo baxa SSG-MD, abuurista waxyaabo Markdown tayo sare leh oo loogu talagalay in Agent uu akhriyo.
• Compilation on Demand, Instant Start: LazyCompilation ayaa si default ah loo hawlgeliyay, iyadoo la kaashanayo hawsha preload ee ilaha marka la dul saaro xiriiriyeyaasha, oo kaliya marka la booqdo waddooyinka gaarka ah ayaa la dhisaa faylasha loo baahan yahay, taasoo xaqiijinaysa in, iyadoon loo eegin cabbirka mashruuca, dev uu si degdeg ah u bilaabi karo.
• Shiki Code Highlighting: Si default ah Shiki ayaa lagu dhex daray, iyadoo la dhammeeyo iftiinka naxwaha waqtiga dhismaha, taageeraya beddelka mawduuca, ballaarinta transformer, sida @rspress/plugin-twoslash, taasoo keentay in la helo muuqaalka xariifka ah ee qaybaha koodhka.
• Khibradda Horumarinta Dukumiintiga: Hagaajinta HMR ee faylasha nav.json, meta.json iyo ku darista json schema si loogu talagalay tilmaamaha koodhka ee gudaha IDE; hawsha hubinta xiriirada dhintay ayaa si default ah loo hawlgeliyay; ku darista naxwaha qaybaha faylasha, taageeraya tixraaca faylasha dibadda; @rspress/plugin-preview iyo @rspress/plugin-playground ayaa taageeraya in si wadajir ah loo isticmaalo iwm.
• Isku-dhafka Rslib: Hadda waxaad dooran kartaa Rspress sidii qalab dukumiinti markaad isticmaalayso create-rslib si aad u abuurto mashruuca maktabadda qaybaha, si degdeg ah u dhis bogga dukumiintiga qaybaha.

2.0 Astaamaha Cusub

Mawduuc Cusub

Mawduuca default ee 2.0 wuxuu helay casriyeyn nidaamsan, oo ay naqshadeeyeen kooxda naqshadeeyayaasha @Zovn Wei, iyadoo kor loo qaaday muuqaalka iyo khibradda akhriska, iyo waliba qayb kasta oo si madax banaan loo beddeli karo, taasoo leh heer sare oo habeyn ah.

Habeynta Mawduuca

Iyada oo loo eegayo heerka habeynta laga bilaabo hoose ilaa sare, waxaa jira afar siyaabood oo habeyn mawduuc ah: CSS variables, BEM class names, ESM re-export overrides, iyo component eject.- CSS Isbeddel: Mawduuca cusub wuxuu soo bandhigay isbeddelo badan oo CSS ah, oo daboolaya midabka mawduuca, qaybaha koodhka, bogga hore iwm. Waxaad si firfircoon u daawan kartaa oo aad u hagaajin kartaa dhammaan isbeddelada CSS bogga isbeddelada CSS, ka dib markaad hesho qaab ku qanacsan waxaad si toos ah ugu nuqulan kartaa mashruucaaga.

• BEM Magacyada Fasalka: Qaybaha ku dhex jira hadda waxay isticmaalaan nidaamka magacyada BEM. Tani waa doorasho aad u Old School ah, laakiin sidoo kale waa go'aan aan si qoto dheer u fikirnay. Isticmaalayaashu waxay si sax ah u hagaajin karaan qaabka iyada oo loo marayo CSS selectors, qaab dhismeedka HTML-na wuxuu noqdaa mid cad.
• ESM Dib-u-soo-dejinta: Haddii isbeddelada CSS aysan buuxin baahiyaha gaarka ah, waxaa lagu samayn karaa hab qoto dheer oo loo marayo JS. Isticmaal ESM dib-u-soo-dejinta gudaha theme/index.tsx, waxaad ka beddeli kartaa qayb kasta oo ka mid ah qaybaha ku dhex jira Rspress.
• Qaybaha Eject: Waxaad isticmaali kartaa amarka cusub ee rspress eject [component], amarkan wuxuu nuqul ka sameyn doonaa koodhka isha ee qaybta la tilmaamay kuna kaydin doonaa theme/components/ directory, waxaad si xor ah u beddeli kartaa koodhkan, xitaa waxaad si toos ah ugu dhiiban kartaa AI si loo sameeyo habeyn qoto dheer.

Navigation Bar, Sidebar Tag

Rspress 2.0 wuxuu hirgeliyay qaybta Tag, hadda waxaad isticmaali kartaa astaanta tag ee ku jirta frontmatter si aad u muujiso UI ee dhinaca ama navigation bar.

Taageerada Luqadaha Dhisan

Nooca 1.x, Rspress kaliya wuxuu lahaa qoraal Ingiriisi ah, haddii aad isticmaasho luqado kale sida zh, waa inaad qaabeyso dhammaan qoraallada, taasoo adkeyneysa isticmaalka. Hadda mawduuca 2.0 wuxuu leeyahay qoraallo tarjumid ah oo ku jira luqadaha zh, en, ja, ko, ru iwm, nidaamku wuxuu si otomaatig ah u sameyn doonaa "Tree Shaking" iyadoo loo eegayo qaabeynta luqadda, kaliya wuxuu ururin doonaa qoraallada iyo luqadaha aad isticmaasho.

llms.txt Taageero

Rspress hadda wuxuu ku daray awoodda llms.txt gudaha core, wuxuuna hirgeliyay awood cusub oo SSG-MD (Static Site Generation to Markdown, Abuurista Goobta Joogtada ah ee Markdown).

Marka laga hadlayo qaab-dhismeedka hore ee React, waxaa badanaa jira dhibaatooyin ku saabsan helitaanka macluumaadka joogtada ah, Rspress sidoo kale wuxuu wajahaya caqabaddan. Rspress wuxuu u oggolaanayaa isticmaalayaasha inay ku xoojiyaan waxqabadka dukumintiga iyada oo loo marayo MDX qaybo, qaybaha React, Hooks iyo TSX waddooyinka iwm. Laakiin maaddooyinkan firfircoon marka la beddelayo qoraalka Markdown waxay wajahaan dhibaatooyinka soo socda:

• Si toos ah MDX u gelinta AI waxay ka koobnaan doontaa buuq badan oo ku saabsan syntax koodhka, waxayna lumin doontaa waxyaabaha qaybaha React
• Beddelida HTML ilaa Markdown badanaa ma fiicna, tayada macluumaadka ma la hubin karo

Si loo xalliyo dhibaatadan, Rspress 2.0 wuxuu keenay sifo SSG-MD. Tani waa hawl cusub, waxay la mid tahay abuurista goobta joogtada ah (SSG), laakiin farqiga ayaa ah in ay boggaaga u beddesho faylasha Markdown, halkii ay ka noqon lahayd faylasha HTML, waxayna abuurtaa faylasha llms.txt iyo llms-full.txt.

Shiki Isku-dhafka Waqtiga KoodhkaRspress 2.0 waxay si toos ah u isticmaashaa Shiki si ay u muujiso koodhka. Marka loo eego qorshaha muujinta waqtiga ee prism 1.x, Shiki waxay dhamaystirtaa muujinta waqtiga dhismaha.

• Waxay taageertaa qaabab mawduucyo kala duwan, tusaale ahaan, bogga isbeddelka CSS waxaad si firfircoon u beddeli kartaa oo aad u arki kartaa mawduucyo kala duwan oo Shiki ah.
• Isla markaana Shiki waxay sidoo kale oggolaaneysaa in la isticmaalo transformer gaar ah si loo ballaariyo qorista, tusaale ahaan twoslash iwm.
• Luqadaha barnaamijka waxaa lagu soo rogaa baahida, iyada oo aan la kordhin kharashka waqtiga socodka iyo cabbirka xirmada.
• Waxay ku saleysan tahay syntax TextMate si ay u hirgeliso muujinta saxda ah ee syntax oo la mid ah VS Code.

Horumarinta Waxqabadka

Rspress 2.0 waxaa hoos u haya Rsbuild iyo Rspack 2.0 nooca horudhaca ah, isla markaana si toos ah ayaa loo furaa dhismaha baahida iyo kaydinta joogtada ah.

Dhismaha Baahida

Si toos ah ayaa loo furaa dev.lazyCompilation, kaliya marka aad gasho bog gaar ah, boggaas ayaa la dhisi doonaa, taasoo si weyn u kordhinaysa xawaaraha bilowga horumarinta, xitaa waxay gaari kartaa bilowga qabow ee millisecond. Rspress sidoo kale waxay hirgelisaa istiraatiijiyadda preload ee waddooyinka, marka mouse-kaagu ku dul socdo xiriirinta, waxay si hore u soo dejin doontaa bogga waddada bartilmaameedka, iyadoo la adeegsanayo lazyCompilation si loo helo khibrad horumarineed oo aan waxyeello lahayn.

Kaydinta Joogtada ah

2.0 sidoo kale si toos ah ayaa loo furaa kaydinta joogtada ah, iyadoo la dib u isticmaalayo natiijada dhismaha ee la soo dhaafay, taasoo kordhinaysa xawaaraha dhismaha 30%-60%. Tani waxay ka dhigan tahay in markii ugu horreysay ee aad ordo rspress dev ama rspress build, xawaaraha bilowga ee xiga si cad ayaa loo kordhin doonaa.

Khibradda Horumarinta Dukumentiga

Si toos ah ayaa loo furaa baaritaanka xiriirinta dhimatay

Rspress 2.0 si toos ah ayaa loo furaa shaqada baaritaanka xiriirinta dhimatay. Inta lagu jiro dhismaha, waxay si otomaatig ah u baaraysaa xiriirinta aan saxda ahayn ee dukumentiga, taasoo kaa caawinaysa inaad si degdeg ah u ogaato oo aad u hagaajiso.

Qaybaha Koodhka Faylka

Waxaad isticmaali kartaa file="./path/to/file" sifo si aad u tixraacdo faylasha dibadda sida nuxurka qaybaha koodhka, adigoo ku haynaya koodhka tusaalaha fayl gooni ah.

preview isticmaalka meta oo ka dabacsan

@rspress/plugin-preview hadda waxay ku saleysan tahay sifooyinka meta, taasoo ka dhigaysa mid ka dabacsan, sidoo kale waxay la shaqayn kartaa qaybaha koodhka faylka.

Rslib & Rspress

Markaad isticmaasho create-rslib si aad u abuurto mashruuc, hadda waxaad dooran kartaa qalabka Rspress. Tani waxay kuu oggolaaneysaa inaad si degdeg ah u dhisto goobaha dukumentiga ee la xiriira, adigoo horumarinaya maktabadda qaybaha, si loogu qoro tilmaamaha isticmaalka qaybaha, muujinta tixraaca API, ama si toos ah u aragista saamaynta qaybaha.

Plugins-ka Rspress ee Rasmiga ah

Rspress 2.0 waxay ku dartay plugins badan oo rasmiga ah:

• @rspress/plugin-algolia: waxay taageertaa beddelka raadinta dhisan ee Rspress oo ah Algolia DocSearch
• @rspress/plugin-twoslash: waxay ku darsataa tilmaamaha noocyada qaybaha TypeScript
• @rspress/plugin-llms: waxay bixisaa awoodda abuurista llms.txt ee mashaariicda aan taageerin SSG iyo SSG-MD
• @rspress/plugin-sitemap: si otomaatig ah u abuurta faylka Sitemap, si loo hagaajiyo SEO

Isbeddelada Jabinta

Ka guurista Rspress 1.x

Haddii aad tahay isticmaale mashruuc 1.x, waxaan diyaarinay dukumeenti faahfaahsan oo ku saabsan guurista, si aan kaaga caawino inaad ka guurto 1.x ilaa 2.0. Waxaad si toos ah u isticmaali kartaa shaqada "nuqul Markdown" ee bogga, si aad ugu geliso agent-kaaga koodhka caadiga ah (sida Claude Code iwm) si aad u dhamaystirto guurista.### Node.js iyo Shuruudaha Noocyada Ku Tiirsan ee Sare

Rspress 2.0 waxay u baahan tahay nooca Node.js 20+, nooca React 18+.

Tallaabada Xigta

Soo saarista Rspress 2.0 kaliya waa bilow cusub. Ka dib soo saarista, Rspress waxay sii wadi doontaa in ay horumariso:

• Horumarinta Isku-dhafka Deegaanka: Si qoto dheer ula shaqeynta Rslib, Rstest, si loo bixiyo khibrad horumarineed oo isku dhafan oo loogu talagalay mashaariicda hore iyo mashaariicda maktabadda qaybaha.
• Baadhitaanka AI iyo Isku-dhafka Dukumentiyada: Sida su'aalaha caqliga leh, soo koobid otomaatig ah; hagaajinta SSG-MD si ay u noqoto mid deggan oo sahlan in la isticmaalo.

Si degdeg ah u isticmaal ama u cusbooneysii Rspress 2.0, si aad u hesho safar cusub oo horumarinta dukumentiyada!

npm create rspress@latest