Ekipi me burim të hapur të Meta lëshoi së fundmi Docusaurus 3.9, një përditësim kyç për gjeneratorin e saj të njohur të faqeve statike të bazuar në React.
Versioni i tij i ri, shpallur më 25 shtator, inconduced new searchability: asistent.
Përveç veçorive të reja, përditësimi modernizon gjithashtu teknologjinë bazë, duke kërkuar që zhvilluesit të përdorin Node.js 20 dhe të përfundojë mbështetjen për Node.js 18 më të vjetër.
Për zhvilluesit që mbajnë dokumentacion në shkallë të gjerë, shtesa e spikatur në Docusaurus 3.9 është mbështetje e plotë për DocSearch v4 të Algolisë.
Përmirësimi prezanton AskAI, një veçori që transformon shiritin standard të kërkimit të një sajti në një mjet të vetëm për përputhjen e fjalëve
. përgjigjet e sintetizuara, duke ndihmuar përdoruesit zgjidh problemet në mënyrë më efikase.
Sipas ekipit të Docusaurus, qëllimi është”t’ju lejojë të shtoni një asistent kërkimi të fuqizuar nga AI në faqen tuaj të Docusaurus, i cili mund t’u përgjigjet pyetjeve bazuar në atë që është në dokumentacionin tuaj me një përvojë bashkëbisedimi.”
Kalimi nga marrja e fjalëve kyçe në përgjigjet bisedore shënon një përvojë të madhe
të përdoruesit për evoluimin teknik
. kërkimi i avancuar është zgjedh, duke u dhënë skuadrave kontroll mbi tranzicionin. Mbajtësit e projektit mund të zgjedhin të qëndrojnë në DocSearch v3 ose të përmirësojnë gradualisht për të zhbllokuar aftësitë e reja të AI.
Për ata që janë të gatshëm ta miratojnë atë, Algolia ofron një pikë hyrjeje të aksesueshme. Faqja e saj zyrtare e çmimeve detajon një nivel pa pagesë”Ndërtimi”që përfshin 10,000 kërkesa kërkimi në muaj, duke e bërë funksionin të zbatueshëm për projektet me burim të hapur dhe ekipet më të vogla.
Një integrim i tillë pasqyron një tendencë të integruar të platformës së AI-së drejtpërsëdrejti në industrinë e zhvillimit më të gjerë në zhvillim më të gjerë në industrinë e zhvilluar më gjerë. produktivitetit dhe të zvogëlojë fërkimin e përdoruesit.
Modernizimi i Fondacionit: Node.js 20 Tani kërkohet
Në një lëvizje që synon përmirësimin e sigurisë dhe performancës, Docusaurus 3.9 rrit kërkesën e tij minimale për kohën e funksionimit në Node.js v20.0, duke hequr zyrtarisht mbështetjen për Node.js 18.
Për shkak se Node.js 18 ka arritur fundin zyrtar të jetës së tij, ai nuk merr më përditësime sigurie, duke e bërë përdorimin e tij të vazhdueshëm një dobësi të mundshme.
Ekipi i Docusaurus e kornizon këtë platformë të detyrueshme
të sigurtë dhe të mirëmbajtur si një përmirësim të detyrueshëm dhe të sigurt>.
“Fundi i fundit i jetës versionet e Node.js në versionet e vogla të versioneve është një praktikë e zakonshme në ekosistemin Node.js, të cilën ne tani e miratojmë zyrtarisht dhe e dokumentojmë mbi procesin tonë të lëshimit.”
Megjithëse ky vendim është praktika më e mirë, ai kërkon veprim nga ekipet e zhvillimit. Ndikimi i tij më i menjëhershëm është në tubacionet CI/CD dhe mjediset e zhvillimit lokal.
Një shembull praktik i kësaj u shfaq në GitHub, ku një zhvillues paraqiti një problem duke vënë në dukje se aktet e dokumentacionit zyrtar i parashtronte akoma aktet e Gub-it për Nyja 18, që kërkon një përditësim për të funksionuar siç duhet.
Ekipet do të duhet të auditojnë jo vetëm skriptet e tyre të ndërtimit, por edhe Dockerfiles dhe menaxherët e mjedisit lokal të tyre për të siguruar një tranzicion të qetë dhe për të shmangur dështimet e ndërtimit.
Fleksibilitet i zgjeruar për faqet e dokumentacionit global
sfida e shumëfishtë e faqeve të dokumentacionit, astanded. Docusaurus 3.9 prezanton të rëndësishme përmirësime në .
Zhvilluesit tani mund të anashkalojnë veçoritë”baseUrl”dhe”url”për secilin lokal në mënyrë individuale duke përdorur fushën e re”i18n.localeConfigs[locale]”.
Ai siguron kontrollin granular të nevojshëm për vendosje komplekse, me shumë domene. dhe frëngjisht do.css, hosting do.cs. në `docs.example.fr`, duke siguruar që të gjitha meta të dhënat dhe lidhjet të zgjidhen në mënyrë korrekte.
Optimizimet e mëtejshme i18n përfshijnë një flamur të ri `përktheje`, i cili tani është i çaktivizuar si parazgjedhje për sajtet pa përkthime, duke çuar në kohë më të shpejta ndërtimi duke shmangur leximet e panevojshme të sistemit të skedarëve.
Atributi i një artikulli anësor mund t’i caktohet në mënyrë të re. Shtimi i këtij çelësi parandalon kyçet e përkthimit bien ndesh kur disa kategori ndajnë të njëjtën etiketë, si p.sh.”API”, duke siguruar që çdo shembull mund të përkthehet në mënyrë unike bazuar në kontekstin e tij brenda strukturës së dokumentacionit.
Përmirësimet kryesore për diagramet, performancën dhe përvojën e zhvilluesit
Përtej veçorive të titujve,
përmirëson një bujqësi të tjera të vlefshme
Docusaurus.
Ndër këto është mbështetja për algoritmin e paraqitjes Mermaid ELK. Mermaid është një mjet popullor për krijimin e diagrameve nga teksti dhe motori i tij i paraqitjes ELK ofron aftësi më të sofistikuara të interpretimit, që është veçanërisht i dobishëm për arkitekturën e madhe diagramet.
Performanca gjithashtu përmirësohet me një përmirësim në Rspack 1.5, i cili shfrytëzon opsionet e reja të konfigurimit për të përshpejtuar kohën e ndërtimit të Docusaurus. Ndërtimet më të shpejta përkthehen drejtpërdrejt në produktivitet më të lartë të zhvilluesve, veçanërisht në projekte të mëdha.
Ndryshime të tjera të dukshme përfshijnë grepa të reja për trajtimin e lidhjeve të prishura Markdown, aftësinë për të çaktivizuar paraqitjen e emoji-ve dhe përmirësimin e qëndrueshmërisë vizuale kur kaloni midis mënyrave të ngjyrave.
Këto përmirësime kolektive forcojnë pozicionin e Docusaurus si një platformë e fuqishme, performuese dhe fleksibël për ndërtimin e faqeve moderne të dokumentacionit.
