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: દસ્તાવેજો માત્ર માનવ વાંચકો માટે જ નથી, પરંતુ એજન્ટ દ્વારા વધુ સારી રીતે સમજવા અને ઉપયોગમાં લેવા માટે પણ જરૂરી છે. 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 એ ટેગ ઘટકને અમલમાં મૂક્યું છે, હવે તમે ફ્રન્ટમેટરમાં ટેગ ગુણધર્મનો ઉપયોગ કરી શકો છો, સાઇડ બાર અથવા નૅવિગેશન બારમાં UI ટૅગિંગ માટે.
બિલ્ટ-ઇન બહુભાષી સપોર્ટ
1.x સંસ્કરણમાં, Rspress માં ફક્ત અંગ્રેજી લખાણ હતું, જો તમે અન્ય ભાષાઓ જેમ કે zh નો ઉપયોગ કરો છો, તો તમામ લખાણને કન્ફિગર કરવું પડશે, જે ઉપયોગમાં થોડી મુશ્કેલી છે. હવે 2.0 થીમમાં zh, en, ja, ko, ru વગેરેની અનેક ભાષાઓના અનુવાદ લખાણને બિલ્ટ-ઇન કરવામાં આવ્યું છે, સિસ્ટમ ભાષા કન્ફિગરેશનના આધારે આપમેળે "ટ્રી શેકિંગ" કરશે, ફક્ત તમે ઉપયોગમાં લેતા લખાણ અને ભાષાને પેક કરશે.
llms.txt સપોર્ટ
Rspress હવે llms.txt જનરેશન ક્ષમતા કોરમાં એકીકૃત કરે છે, અને નવી SSG-MD (સ્ટેટિક સાઇટ જનરેશન ટુ માર્કડાઉન, સ્ટેટિક સાઇટ માર્કડાઉન જનરેશન) ક્ષમતા પ્રાપ્ત કરે છે.
રિએક્ટ આધારિત ડાયનામિક રેન્ડરિંગ ફ્રેમવર્કમાં, ઘણીવાર સ્થિર માહિતી કાઢવામાં મુશ્કેલી હોય છે, Rspress ને પણ આ જ પડકારનો સામનો કરવો પડે છે. Rspress વપરાશકર્તાઓને MDX ટુકડાઓ, રિએક્ટ ઘટકો, હૂક્સ અને TSX રૂટિંગ જેવા ડાયનામિક લક્ષણો દ્વારા દસ્તાવેજની અભિવ્યક્તિ વધારવા માટે મંજૂરી આપે છે. પરંતુ આ ડાયનામિક સામગ્રીને માર્કડાઉન લખાણમાં રૂપાંતરિત કરતી વખતે નીચેના પ્રશ્નોનો સામનો કરવો પડે છે:
- સીધા MDX ને AI ને આપવાથી ઘણું કોડ વ્યાકરણ અવાજ અને રિએક્ટ ઘટકની સામગ્રી ગુમ થાય છે
- HTML ને માર્કડાઉનમાં રૂપાંતરિત કરવું ઘણીવાર સારું પરિણામ નથી આપતું, માહિતીની ગુણવત્તા જાળવવી મુશ્કેલ છે
આ સમસ્યાનો ઉકેલ લાવવા માટે, Rspress 2.0 એ SSG-MD લક્ષણને રજૂ કર્યું છે. આ એક નવીન કાર્ય છે, જે સ્થિર સાઇટ જનરેશન (SSG) સમાન છે, પરંતુ ભિન્નતા એ છે કે તે તમારા પૃષ્ઠને HTML ફાઇલના બદલે માર્કડાઉન ફાઇલ તરીકે રેન્ડર કરે છે, અને llms.txt અને llms-full.txt સંબંધિત ફાઇલો બનાવે છે.
