Echipa Open-source a lui Meta a lansat recent Docusaurus 3.9, o actualizare cheie a popularului său generator de site-uri static bazat pe React.
Noua sa versiune, a anunțat pe 25 septembrie, a introdus o nouă capacitate de căutare semnificativă.
Pe lângă noile funcții, actualizarea modernizează și tehnologia de bază, solicitând dezvoltatorilor să folosească Node.js 20 și terminând suportul pentru Node.js 18 mai vechi.
AI <-h2.js 18.jpg DocSearch v4
Pentru dezvoltatorii care mențin documentație la scară largă, adăugarea remarcabilă în Docusaurus 3.9 este suportul complet pentru DocSearch v4 de la Algolia.
Actualizarea introduce AskAI, o caracteristică care transformă bara de căutare standard a site-ului într-un asistent conversațional.
În loc de instrumentul de potrivire, cuvinte cheie sintetizate. ajutarea utilizatorilor rezolva problemele mai eficient.
Conform echipei Docusaurus, scopul este „să-ți permită să adaugi un asistent de căutare bazat pe inteligență artificială pe site-ul tău Docusaurus, care poate răspunde la întrebări pe baza documentației tale cu o experiență conversațională.”
Trecerea de la preluarea cuvintelor cheie la răspunsurile conversaționale marchează o evoluție majoră în experiența de căutare a utilizatorului. opt-in, oferind echipelor control asupra tranziției. Responsabilii de proiect pot alege să rămână pe DocSearch v3 sau să facă upgrade progresiv pentru a debloca noile capabilități AI.
Pentru cei gata să o adopte, Algolia oferă un punct de intrare accesibil. Pagina sa oficială de prețuri detaliază un nivel gratuit „Build” care include 10.000 de solicitări de căutare pe lună, făcând funcția viabilă pentru proiecte open-source și echipe mai mici.
O astfel de integrare reflectă o tendință mai largă de integrare directă a platformelor de dezvoltare generatoare a IA în platformele de dezvoltare a IA. productivitatea și reducerea frecării utilizatorilor.
Modernizarea fundației: Node.js 20 acum necesar
Într-o mișcare menită să îmbunătățească securitatea și performanța, Docusaurus 3.9 își ridică cerințele minime de rulare la Node.js v20.0, renunțarea oficială a suportului pentru Node.js 18.
Deoarece Node.js 18 și-a atins finalul oficial de viață, nu mai primește actualizări de securitate, ceea ce face ca utilizarea sa continuă să fie o potențială vulnerabilitate.
Echipa Docusaurus încadrează această actualizare obligatorie ca un pas crucial pentru menținerea și menținerea stabilă a platformei. Versiunile la sfârșitul vieții de Node.js pe versiunile minore sunt o practică obișnuită în ecosistemul Node.js, pe care acum o susținem și o documentăm oficial cu privire la procesul nostru de lansare.”
Deși această decizie este cea mai bună practică, necesită acțiuni din partea echipelor de dezvoltare. Impactul său cel mai imediat este asupra conductelor CI/CD și asupra mediilor de dezvoltare locală.
Un exemplu practic în acest sens a apărut pe GitHub, unde un dezvoltator a depus o problemă menționând că exemplele de documentație oficială pentru GitHub încă a indicat deprețul pentru GitHub. Nodul 18, care necesită o actualizare pentru a funcționa corect.
Echipele vor trebui să-și auditeze nu numai scripturile de compilare, ci și fișierele Dockerfile și managerii de mediu local pentru a asigura o tranziție ușoară și pentru a evita eșecurile de construire.
Flexibilitate îmbunătățită pentru site-urile de documentare globale
Abordarea unei provocări de lungă durată pentru Docusaurus. îmbunătățiri ale .
Dezvoltatorii pot anula acum proprietățile `baseUrl` și `url` pentru fiecare localitate în mod individual, folosind noul câmp `i18n.localeConfigs[locale]`.
Oferă controlul granular necesar pentru implementări complexe, pe mai multe domenii, de exemplu, găzduirea de documente în limba engleză la docs.com`. `docs.example.fr`, asigurându-se în același timp că toate metadatele și legăturile se rezolvă corect.
Alte optimizări i18n includ un nou semnal „traducere”, care este acum dezactivat implicit pentru site-urile fără traduceri, ceea ce duce la timpi de compilare mai rapidi, evitând citirile inutile ale sistemului de fișiere.
În mod suplimentar, elementelor laterale noi pot fi atribuite elemente noi. Adăugarea acestei chei împiedică traducerea conflicte cheie atunci când mai multe categorii au aceeași etichetă, cum ar fi „API”, asigurându-se că fiecare instanță poate fi tradusă în mod unic, pe baza contextului său în structura documentației.
Actualizări cheie pentru diagrame, performanță și experiență dezvoltatorului
Dincolo de caracteristicile de titlu, Docusaurus 3.9 este o serie de îmbunătățiri ale celorlalte găzduiri de valoare 3.9. este sprijinul pentru Algoritmul de aspect Mermaid ELK. Mermaid este un instrument popular pentru crearea de diagrame din text, iar motorul său de aspect ELK oferă capabilități de randare mai sofisticate, care este util în special pentru diagramele de arhitectură de sistem mari sau complicate.
Performanța primește, de asemenea, un impuls cu o actualizare la Rspack 1.5, care folosește noi opțiuni de configurare pentru a accelera timpul de construire a Docusaurus. Build-urile mai rapide se traduc direct la o productivitate mai mare a dezvoltatorului, în special în proiectele mari.
Alte modificări notabile includ noi cârlige pentru gestionarea legăturilor Markdown întrerupte, capacitatea de a dezactiva redarea emoji și stabilitatea vizuală îmbunătățită la comutarea între modurile de culoare.
Aceste perfecționări colective consolidează poziția Docusaurus ca platformă robustă, performantă și flexibilă pentru construirea de site-uri web moderne de documentare.
