Metas åpen kildekode-team ga nylig ut Docusaurus 3.9, en nøkkeloppdatering til den populære React-baserte statiske nettstedsgeneratoren.
Den nye versjonen,annonsert 25. septemberintroduserte en betydelig ny funksjon: en AI-drevet søkeassistent.
Ved siden av nye funksjoner, moderniserer oppdateringen også den underliggende teknologien, og krever at utviklere bruker Node.js 20 og avslutter støtten for den eldre Node.js 18.
AI-drevet samtalesøk med DocSearch v4
For utviklere som vedlikeholder storskala dokumentasjon, er det fremtredende tillegget i Docusaurus 3.9 full støtte for Algolias DocSearch v4.
Oppgraderingen introduserer AskAI, en funksjon som forvandler et nettsteds standard søkefelt til en samtaleassistent.
I stedet for bare å matche søkeord, gir verktøyet syntetiserte svar, og hjelper brukere med å løse problemer mer effektivt.
Ifølge Docusaurus-teamet er målet "å la deg legge til en AI-drevet søkeassistent til Docusaurus-nettstedet ditt som kan svare på spørsmål basert på hva som er i dokumentasjonen din med en samtaleopplevelse."
Skiftet fra søkeordinnhenting til samtalesvar markerer en stor utvikling i brukeropplevelsen for teknisk dokumentasjon.
Implementering av dette avanserte søket er opt-in, noe som gir teamene kontroll over overgangen. Prosjektvedlikeholdere kan velge å forbli på DocSearch v3 eller oppgradere trinnvis for å låse opp de nye AI-funksjonene.
For de som er klare til å ta i bruk det, gir Algolia et tilgjengelig inngangspunkt. Dens offisielle prisside beskriver et gratis "Build"-nivå sominkluderer 10 000 søkeforespørsler per måned, noe som gjør funksjonen levedyktig for åpen kildekode-prosjekter og mindre team.
En slik integrasjon gjenspeiler en bredere bransjetrend med å bygge inn generativ AI direkte i utviklerplattformer for å øke produktiviteten og redusere brukerfriksjonen.
Modernisering av grunnlaget: Node.js 20 er nå påkrevd
I et trekk som tar sikte på å forbedre sikkerhet og ytelse, øker Docusaurus 3.9 kravet til minimum kjøretid til Node.js v20.0,offisielt droppe støtte for Node.js 18.
Fordi Node.js 18 har nådd sin offisielle levetid, mottar den ikke lenger sikkerhetsoppdateringer, noe som gjør den fortsatte bruken til en potensiell sårbarhet.
Docusaurus sitt team omtaler denne obligatoriske oppgraderingen som et avgjørende skritt for å opprettholde en sikker og stabil plattform.
"Å droppe End-of-Life-versjoner av Node.js på mindre versjonsutgivelser er en vanlig praksis i Node.js-økosystemet, som vi nå offisielt støtter og dokumenterer på utgivelsesprosessen vår."
Selv om denne beslutningen er en beste praksis, krever den handling fra utviklingsteam. Dens mest umiddelbare innvirkning er på CI/CD-rørledninger og lokale utviklingsmiljøer.
Et praktisk eksempel på dette dukket opp på GitHub, hvoren utvikler har levert et problembemerker at offisielle dokumentasjonseksempler for GitHub Actions fortsatt pekte på den utdaterte Node 18, som krever en oppdatering for å fungere korrekt.
Lagene må ikke bare revidere byggeskriptene sine, men også Dockerfiles og lokale miljøansvarlige for å sikre en jevn overgang og unngå byggefeil.
RELATERT:Last ned Galaxy S24 & S24 Ultra Static og levende bakgrunnsbilder
Forbedret fleksibilitet for globale dokumentasjonssider
Docusaurus 3.9 tar tak i en langvarig utfordring for flerspråklige nettsteder, og introduserer betydelige forbedringer tilinternasjonalisering (i18n) system.
Utviklere kan nå overstyre `baseUrl`- og `url`-egenskapene for hver lokalitet individuelt ved å bruke det nye `i18n.localeConfigs[locale]`-feltet.
Den gir den granulære kontrollen som trengs for komplekse distribusjoner med flere domener – for eksempel hosting av engelske dokumenter på `docs.example.com` og franske dokumenter på `docs.example.fr`, samtidig som den sikrer at alle metadata og koblinger løses riktig.
Ytterligere i18n-optimaliseringer inkluderer et nytt "oversett"-flagg, som nå er deaktivert som standard for nettsteder uten oversettelser, noe som fører til raskere byggetider ved å unngå unødvendige filsystemlesninger.
I tillegg kan et nytt "nøkkel"-attributt tildeles sidefeltelementer. Ved å legge til denne nøkkelen forhindres oversettelsesnøkkelkonflikter når flere kategorier deler samme etikett, for eksempel "API", og sikrer at hver forekomst kan oversettes unikt basert på konteksten i dokumentasjonsstrukturen.
Nøkkeloppgraderinger for diagrammer, ytelse og utvikleropplevelse
Utover overskriftene, inneholder Docusaurus 3.9 en rekke andre verdifulle forbedringer.
Blant disse er støtte tilMermaid ELK layoutalgoritme.Mermaid er et populært verktøy for å lage diagrammer fra tekst, og ELK-layoutmotoren gir mer sofistikerte gjengivelsesmuligheter, noe som er spesielt nyttig for store eller intrikate systemarkitekturdiagrammer.
Ytelsen får også et løft med en oppgradering tilRspack 1,5,som utnytter nye konfigurasjonsalternativer for å akselerere Docusaurus byggetider. Raskere bygg gir direkte høyere utviklerproduktivitet, spesielt i store prosjekter.
Andre bemerkelsesverdige endringer inkluderer nye kroker for å håndtere ødelagte Markdown-lenker, muligheten til å deaktivere emoji-gjengivelse og forbedret visuell stabilitet når du bytter mellom fargemoduser.
Disse kollektive forbedringene befester Docusaurus sin posisjon som en robust, effektiv og fleksibel plattform for å bygge moderne dokumentasjonsnettsteder.
