Rspress 2.0 útgáfa: Ný uppfærsla með áherslu á reynslu og AI

Við erum ánægð með að tilkynna opinbera útgáfu Rspress 2.0!

Rspress er statískur vefsíðugenerator byggður á Rsbuild, hannaður fyrir þróunaraðila sem verkfæri fyrir skjöl. Frá því að Rspress 1.x var opinberlega gefin út árið 2023, hefur hún farið í gegnum 144 útgáfur með 125 þátttakendum sem tóku þátt í þróun verkefnisins. Æ fleiri þróunaraðilar velja Rspress, nýta sér háþróaða samsetningu, samningsbundna leiðir og forsýningu á hlutum til að byggja fallegar og áreiðanlegar vefsíður fyrir skjöl.

Byggt á endurgjöf og tillögum frá samfélaginu, hefur Rspress 2.0 tekið skref fram á við í útliti þema , AI-native , skjalavinnslu reynslu , notkun með Rslib o.fl.

Af hverju Rspress 2.0

Rspress 1.x hefur þegar leyst vandamál tengd samsetningu skjala, en enn eru til nokkur vandamál sem hafa áhrif á kjarna reynslu sem skjalavinnslutæki. 2.0 útgáfan mun ekki aðeins einbeita sér að samsetningargetu, heldur einnig að öðrum þáttum í reynslu vefsíðunnar:

• Þema stíll: Heildar fallegri sjálfgefin þema og býður upp á marga aðferðir til að sérsníða þemu, leysir vandamál 1.x um skort á stöðugum API fyrir þema sérsnið.
• AI-native: Skjöl þjónar ekki aðeins mannlegum lesendum, heldur þarf einnig að vera betur skilið og notað af Agent. Rspress hefur nú innbyggða llms.txt myndun og SSG-MD eiginleika sem eru afleiðing SSG, sem myndar hágæða Markdown efni fyrir Agent að lesa.
• Samsetning eftir þörfum, augnablik upphaf: Sjálfgefið virkjað lazyCompilation, ásamt preloading eiginleika fyrir auðlindir þegar músin er yfir tenglum, byggir aðeins nauðsynleg skjöl þegar ákveðnar leiðir eru heimsóttar, sem gerir það að verkum að óháð stærð verkefnisins, dev getur strax hafið.
• Shiki kóða hápunktur: Sjálfgefið samþætt Shiki, sem lokar á málfræði hápunkti við byggingu, styður þema skipti, transformer útvíkkanir, eins og @rspress/plugin-twoslash, sem veitir ríkari útlit fyrir kóðablokkir.
• Skjalavinnslu reynsla: Bætir HMR fyrir nav.json, meta.json o.fl. og bætir við json schema fyrir kóðavísbendingar í IDE; sjálfgefið virkjað dauð tengja skoðun; bætir við kóðablokk málfræði, styður tilvísun í ytri skrár; @rspress/plugin-preview og @rspress/plugin-playground styðja samtímis notkun o.fl.
• Rslib samþætting: Nú er hægt að velja Rspress sem skjalatæki þegar búið er til verkefni fyrir samsetningarbókasafn með create-rslib, til að byggja fljótt upp skjalasíðu fyrir hluti.

2.0 nýjar eiginleikar

Algjörlega nýtt þema

2.0 sjálfgefið þema hefur fengið kerfisbundna uppfærslu, það var hannað af teymi hönnuða @Zovn Wei, með miklum framförum í sjónrænum áhrifum og lestrarupplifun, og hver hluti er hægt að skipta út sjálfstætt, sem veitir mikla sérsniðanleika.

Þema sérsnið

Samkvæmt sérsniðsgráðu frá lágu til háu, eru fjórar aðferðir til að sérsníða þemu: CSS breytur, BEM flokknöfn, ESM endurflutningur, hluta eject.- CSS breytur: Nýja þemað afhjúpar fleiri CSS breytur, sem fela í sér þemalit, kóða blokkir, forsíðu o.s.frv. Þú getur skoðað og stillt allar CSS breytur á CSS breytusíðunni á gagnvirkan hátt, og þegar þú finnur viðunandi uppsetningu geturðu einfaldlega afritað hana í verkefnið þitt.

• BEM flokknöfn: Innbyggðu hlutirnir nota nú BEM nafngiftarregluna. Þetta er mjög Old School val, en einnig vel ígrundað ákvörðun. Notendur geta nákvæmlega stillt stíl með CSS veljum, HTML uppbyggingin er skýrari.
• ESM endurútflutningur: Ef breytingar á CSS duga ekki til að uppfylla sérsniðnar kröfur, er hægt að sérsníða dýpra með JS. Með því að nýta ESM endurútflutning í theme/index.tsx er hægt að yfirskrifa hvaða innbyggða hlut Rspress sem er.
• Hlutir útrýming: Þú getur notað nýja rspress eject [component] skipunina, þessi skipun mun afrita upphafskóðann fyrir tiltekinn hlut í theme/components/ möppuna, þú getur frjálst breytt þessum kóða, jafnvel látið AI breyta honum, til að ná dýrmætum sérsniðnum breytingum.

Vefsvæði, hliðarvefur tag

Rspress 2.0 hefur innleitt Tag hlutinn, nú er hægt að nota tag eiginleikann í frontmatter til að merkja UI í hliðarvefnum eða vefsvæðinu.

Innbyggð fjöltyngd stuðningur

Í 1.x útgáfunni hafði Rspress aðeins innbyggðan ensku texta, ef notaðar voru aðrar tungumál eins og zh, þurfti að stilla allan texta, sem var frekar flókið. Núna hefur 2.0 þemað innbyggðan þýðingatexta á zh, en, ja, ko, ru og fleiri tungumál, kerfið mun sjálfkrafa framkvæma "Tree Shaking" samkvæmt tungumálastillingum, aðeins pakka því texta og tungumálum sem þú notar.

llms.txt stuðningur

Rspress hefur nú samþætt llms.txt framleiðslugetu í kjarna sinn, og hefur innleitt nýja SSG-MD (Static Site Generation to Markdown, Static Site Markdown Generation) getu.

Í framendakerfum sem byggja á React, er oft erfitt að draga út stöðuga upplýsingar, Rspress stendur einnig frammi fyrir sömu áskorun. Rspress leyfir notendum að auka tjáningu skjala með MDX sneiðum, React hlutum, Hooks og TSX leiðum o.s.frv. en þessar dýnamísku upplýsingar standa frammi fyrir eftirfarandi vandamálum þegar þær eru breytt í Markdown texta:

• Beint að gefa MDX til AI mun innihalda mikið af kóða málfræði hávaða og tapa innihaldi React hluta
• Að breyta HTML í Markdown er oft ekki árangursríkt, gæði upplýsinganna er erfitt að tryggja

Til að leysa þetta vandamál hefur Rspress 2.0 innleitt SSG-MD eiginleikann. Þetta er nýtt virkni, það er svipað og Static Site Generation (SSG), en munurinn er að það breytir síðunni þinni í Markdown skjal, frekar en HTML skjal, og býr til llms.txt og llms-full.txt tengd skjöl.

Shiki samsetningartími kóða blokkir hámarkaRspress 2.0 notar sjálfgefið Shiki til að lýsa kóða. Í samanburði við 1.x prism keyrsluhætti, fer Shiki í gegnum lýsingarferlið við samsetningu.

• Styður margvísleg þemu, svo sem að í CSS breytum síðu er hægt að skipta á milli og skoða mismunandi Shiki þemu á gagnvirkan hátt.
• Á sama tíma leyfir Shiki einnig að nota sérsniðna transformer til að auðga skrif, svo sem twoslash o.fl.
• Innleiðir forritunarmál eftir þörfum, án þess að auka keyrslukostnað og pakka stærð.
• Byggt á TextMate málfræði til að ná nákvæmri málfræði lýsingu sem er samhæf við VS Code.

Byggingarframmistaða bætt

Rspress 2.0 er drifið af Rsbuild og Rspack 2.0 forsýningunni, og er sjálfgefið opnað fyrir samsetningu eftir þörfum og varanlegum skyndiminni.

Samsetning eftir þörfum

Sjálfgefið er dev.lazyCompilation opnað, aðeins þegar þú heimsækir ákveðna síðu verður sú síða samsett, sem eykur verulega hraða þróunarinnar, jafnvel að ná millisekúndu kalda upphafinu. Rspress hefur einnig innleitt forgangs stefnu fyrir leiðir, þegar músin er yfir tengli, verður markleiðarsíðan hlaðin fyrirfram, í samræmi við lazyCompilation til að ná óskertum þróunarupplifun.

Varanlegt skyndiminni

2.0 er einnig sjálfgefið opnað fyrir varanlegt skyndiminni, sem endurnýtir niðurstöður síðustu samsetningar í heitu upphafi, sem eykur byggingarhraða um 30%-60%. Þetta þýðir að eftir fyrstu keyrslu á rspress dev eða rspress build, munu seinni upphafshraðarnir verða verulega hraðari.

Skjalavinnsluupplifun

Sjálfgefið opnað fyrir dauð tengi skoðun

Rspress 2.0 er sjálfgefið opnað fyrir dauð tengi skoðun. Í byggingarferlinu verður sjálfkrafa athugað hvort tengin í skjölunum séu óvirk, sem hjálpar þér að uppgötva og laga þau á réttum tíma.

Skrá kóðablokkar

Þú getur notað file="./path/to/file" eiginleikann til að vísa í ytri skrár sem innihald kóðablokkar, og haldið sýnidæmunum í sérstöku skjali.

preview fleirri sveigjanlegar meta notkun

@rspress/plugin-preview notar nú meta eiginleikann, sem er sveigjanlegra, og hægt er að nota í samræmi við skrá kóðablokkar.

Rslib & Rspress

Þegar þú notar create-rslib til að búa til verkefni, geturðu nú valið Rspress verkfærið. Þetta gerir þér kleift að byggja upp skjalaheimasíður fljótt á meðan þú þróar hluta bókasafn, til að skrifa notkunarleiðbeiningar fyrir hluta, sýna API tilvísanir, eða forsýna hlutaáhrif í rauntíma.

Fleiri opinber Rspress viðbætur

Rspress 2.0 hefur bætt við mörgum opinberum viðbótum:

• @rspress/plugin-algolia: Styður að skipta út innbyggðu leit Rspress fyrir Algolia DocSearch
• @rspress/plugin-twoslash: Bætir við tegundartipum fyrir TypeScript kóðablokkar
• @rspress/plugin-llms: Veitir llms.txt framleiðslu fyrir verkefni sem styðja ekki SSG og SSG-MD
• @rspress/plugin-sitemap: Býr sjálfkrafa til Sitemap skrá, til að hámarka SEO

Breytingar sem brjóta

Frá Rspress 1.x flutningur

Ef þú ert notandi 1.x verkefnis, höfum við undirbúið ítarlega flutningsskjal, sem hjálpar þér að uppfæra frá 1.x í 2.0. Þú getur beint notað "afrita Markdown" aðgerðina á síðunni, til að slá það inn í þinn venjulega kóðunar agent (svo sem Claude Code o.fl.) til að ljúka flutningnum.### Node.js og kröfur um útgáfu á uppsprettu

Rspress 2.0 krefst Node.js útgáfu 20+ og React útgáfu 18+.

Næstu skref

Útgáfa Rspress 2.0 er aðeins nýr upphafspunktur. Eftir þessa útgáfu mun Rspress halda áfram að þróast:

• Auka samþættingu vistkerfisins: Dýrmætari samþætting við Rslib og Rstest, til að bjóða upp á samþætt þróunarupplifun fyrir framenda verkefni og hluta bókasafn.
• Kanna dýrmætari samþættingu AI við skjöl: Eins og snjallar spurningar og svör, sjálfvirkar samantektir o.s.frv.; fullkomna SSG-MD til að gera það stöðugra og auðveldara í notkun.

Notaðu eða uppfærðu strax í Rspress 2.0, upplifðu nýja ferðina í skjaldarþróun!

npm create rspress@latest