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 వేరియబుల్స్ పేజీలో ఇంటరాక్టివ్గా అన్ని CSS వేరియబుల్స్ను ప్రివ్యూ మరియు సర్దుబాటు చేయవచ్చు, మీకు నచ్చిన కాన్ఫిగరేషన్ను కనుగొనిన తర్వాత ప్రాజెక్ట్లో ఉపయోగించడానికి నేరుగా కాపీ చేయవచ్చు.
- BEM క్లాస్ నామాలు: అంతర్గత భాగాలు ఇప్పుడు BEM నామకరణ ప్రమాణాన్ని అనుసరిస్తున్నాయి. ఇది చాలా పాత పాఠశాల ఎంపిక, కానీ ఇది మా ఆలోచనాత్మక నిర్ణయం కూడా. వినియోగదారులు CSS ఎంపికదారుల ద్వారా శైలిని ఖచ్చితంగా సర్దుబాటు చేయవచ్చు, HTML నిర్మాణం మరింత స్పష్టంగా ఉంటుంది.
- ESM పునఃరూపాంతరం కవర్: CSS పై మార్పులు అనుకూలీకరణ అవసరాలను తీర్చకపోతే, JS ద్వారా మరింత లోతైన అనుకూలీకరణ చేయవచ్చు. theme/index.tsx లో ESM పునఃరూపాంతరాన్ని ఉపయోగించి, మీరు Rspress యొక్క అంతర్గత భాగాలను కవర్ చేయవచ్చు.
- భాగం eject: మీరు కొత్త rspress eject [component] ఆదేశాన్ని ఉపయోగించవచ్చు, ఈ ఆదేశం నిర్దిష్ట భాగం యొక్క మూల కోడ్ను theme/components/ డైరెక్టరీకి కాపీ చేస్తుంది, మీరు ఈ కోడ్ను స్వేచ్ఛగా సవరించవచ్చు, లేదా AI కు నేరుగా సవరించడానికి ఇవ్వవచ్చు, లోతైన అనుకూలీకరణను సాధించడానికి.
నావిగేషన్ బార్, సైడ్ బార్ ట్యాగ్
Rspress 2.0 ట్యాగ్ భాగాన్ని అమలు చేసింది, ఇప్పుడు మీరు frontmatter లో ట్యాగ్ లక్షణాన్ని ఉపయోగించి, సైడ్ బార్ లేదా నావిగేషన్ బార్లో UI గుర్తింపును చేయవచ్చు.
అంతర్గత బహుభాషా మద్దతు
1.x వెర్షన్లో, Rspress కేవలం ఇంగ్లీష్ పాఠ్యాన్ని అంతర్గతంగా కలిగి ఉంది, ఇతర భాషలు ఉదాహరణకు zh ఉపయోగించినప్పుడు, అన్ని పాఠ్యాలను కచ్చితంగా కాన్ఫిగర్ చేయాలి, ఉపయోగించడానికి కాస్త కష్టంగా ఉంటుంది. ఇప్పుడు 2.0 థీమ్ zh, en, ja, ko, ru వంటి అనేక భాషల అనువాద పాఠ్యాలను అంతర్గతంగా కలిగి ఉంది, వ్యవస్థ భాషా కాన్ఫిగరేషన్ ప్రకారం ఆటోమేటిక్గా "ట్రీ షేకింగ్" చేస్తుంది, మీరు ఉపయోగించే పాఠ్యాలు మరియు భాషలను మాత్రమే ప్యాక్ చేస్తుంది.
llms.txt మద్దతు
Rspress ఇప్పుడు llms.txt ఉత్పత్తి సామర్థ్యాన్ని కోర్లో సమీకరించింది మరియు కొత్త SSG-MD (స్టాటిక్ సైట్ జనరేషన్ టు మార్క్డౌన్, స్టాటిక్ సైట్ మార్క్డౌన్ ఉత్పత్తి) సామర్థ్యాన్ని అమలు చేసింది.
React డైనమిక్ రెండరింగ్ ఆధారిత ఫ్రంట్ ఎండ్ ఫ్రేమ్వర్క్లలో, సాధారణంగా స్థిరమైన సమాచారాన్ని పొందడం కష్టంగా ఉంటుంది, Rspress కూడా అదే సవాలును ఎదుర్కొంటుంది. Rspress వినియోగదారులకు MDX భాగాలు, React భాగాలు, హుక్స్ మరియు TSX మార్గాలు వంటి డైనమిక్ లక్షణాలను ఉపయోగించి డాక్యుమెంట్ వ్యక్తీకరణను పెంచడానికి అనుమతిస్తుంది. కానీ ఈ డైనమిక్ కంటెంట్ మార్క్డౌన్ పాఠ్యంగా మార్చేటప్పుడు క్రింది సమస్యలను ఎదుర్కొంటుంది:
- MDXను AI కు నేరుగా ఇవ్వడం అనేక కోడ్ సింటాక్స్ శబ్దాన్ని కలిగి ఉంటుంది మరియు React భాగాల కంటెంట్ కోల్పోతుంది
- HTMLని మార్క్డౌన్గా మార్చడం సాధారణంగా మంచి ఫలితాలను ఇవ్వదు, సమాచార నాణ్యతను నిర్ధారించడం కష్టం
ఈ సమస్యను పరిష్కరించడానికి, Rspress 2.0 SSG-MD లక్షణాన్ని ప్రవేశపెట్టింది. ఇది ఒక కొత్త ఫీచర్, ఇది స్టాటిక్ సైట్ జనరేషన్ (SSG) కు సమానమైనది, కానీ మీ పేజీని HTML ఫైల్గా కాకుండా మార్క్డౌన్ ఫైల్గా రాండర్ చేస్తుంది మరియు llms.txt మరియు llms-full.txt సంబంధిత ఫైళ్లను ఉత్పత్తి చేస్తుంది.
