Η ομάδα ανοιχτού κώδικα της Meta κυκλοφόρησε πρόσφατα το Docusaurus 3.9, μια βασική ενημέρωση της δημοφιλής δημιουργίας στατικών ιστότοπων που βασίζεται σε React.
Η νέα της έκδοση, ανακοινώθηκε στις 25 Σεπτεμβρίου,
Μαζί με τις νέες δυνατότητες, η ενημέρωση εκσυγχρονίζει επίσης την υποκείμενη τεχνολογία, απαιτώντας από τους προγραμματιστές να χρησιμοποιούν το Node.js 20 και τερματίζει την υποστήριξη για το παλαιότερο Node.js 18.
Για προγραμματιστές που διατηρούν τεκμηρίωση μεγάλης κλίμακας, η ξεχωριστή προσθήκη στο Docusaurus 3.9 είναι η πλήρης υποστήριξη για το DocSearch v4 της Algolia.
Η αναβάθμιση εισάγει το AskAI, μια δυνατότητα που μετατρέπει την τυπική γραμμή αναζήτησης ενός ιστότοπου σε ένα εργαλείο συνομιλίας που μόλις έγινε αντιστοίχιση λέξεων.
απαντήσεις, βοηθώντας τους χρήστες επιλύστε τα προβλήματα πιο αποτελεσματικά.
Σύμφωνα με την ομάδα Docusaurus, ο στόχος είναι”να σας επιτρέψουμε να προσθέσετε έναν βοηθό αναζήτησης με τεχνητή νοημοσύνη στον ιστότοπό σας στο Docusaurus που μπορεί να απαντά σε ερωτήσεις με βάση αυτό που υπάρχει στην τεκμηρίωσή σας με μια εμπειρία συνομιλίας.”
Η μετάβαση από την ανάκτηση λέξεων-κλειδιών σε απαντήσεις συνομιλίας σηματοδοτεί μια σημαντική εμπειρία για την τεχνική εξέλιξη της τεκμηρίωσης χρήστη
. προχωρημένη αναζήτηση είναι opt-in, δίνοντας στις ομάδες τον έλεγχο της μετάβασης. Οι συντηρητές του έργου μπορούν να επιλέξουν να παραμείνουν στο DocSearch v3 ή να αναβαθμιστούν σταδιακά για να ξεκλειδώσουν τις νέες δυνατότητες τεχνητής νοημοσύνης.
Για όσους είναι έτοιμοι να το υιοθετήσουν, η Algolia παρέχει ένα προσβάσιμο σημείο εισόδου. Η επίσημη σελίδα τιμολόγησής του περιγράφει μια δωρεάν βαθμίδα”Δημιουργία”που περιλαμβάνει 10.000 αιτήματα αναζήτησης ανά μήνα, καθιστώντας τη δυνατότητα βιώσιμη για έργα ανοιχτού κώδικα και μικρότερες ομάδες.
Μια τέτοια ενσωμάτωση αντανακλά μια τάση ενσωμάτωσης της πλατφόρμας σε ευρύτερη ανάπτυξη της πλατφόρμας σε ευρύτερη ανάπτυξη του κλάδου. παραγωγικότητα και να μειώσει την τριβή των χρηστών.
Εκσυγχρονισμός του Θεμελίου: Το Node.js 20 πλέον απαιτείται
Σε μια κίνηση που αποσκοπεί στη βελτίωση της ασφάλειας και της απόδοσης, το Docusaurus 3.9 αυξάνει την ελάχιστη απαίτηση χρόνου εκτέλεσης σε Node.js v20.0, επίσημη κατάργηση της υποστήριξης για το Node.js 18.
Επειδή το Node.js 18 έφτασε στο επίσημο τέλος της ζωής του, δεν λαμβάνει πλέον ενημερώσεις ασφαλείας, γεγονός που καθιστά τη συνεχή χρήση του μια πιθανή ευπάθεια.
Η ομάδα του Docusaurus ορίζει αυτήν την υποχρεωτική και διατηρούμενη πλατφόρμα ως μια υποχρεωτική και διατηρούμενη αναβάθμιση ως μια υποχρεωτική αναβάθμιση.
“Πτώση Οι εκδόσεις στο τέλος της ζωής του Node.js σε εκδόσεις δευτερεύουσας σημασίας είναι μια κοινή πρακτική στο οικοσύστημα Node.js, την οποία τώρα εγκρίνουμε επίσημα και τεκμηριώνουμε τη διαδικασία κυκλοφορίας μας.”
Αν και αυτή η απόφαση αποτελεί βέλτιστη πρακτική, απαιτεί δράση από τις ομάδες ανάπτυξης. Ο πιο άμεσος αντίκτυπός του είναι στους αγωγούς CI/CD και στα περιβάλλοντα τοπικής ανάπτυξης.
Ένα πρακτικό παράδειγμα αυτού εμφανίστηκε στο GitHub, όπου ένας προγραμματιστής υπέβαλε ένα ζήτημα σημειώνοντας ότι η επίσημη τεκμηρίωση παρέπεμψε ακόμη τα παραδείγματα της GitHub για Κόμβος 18, που απαιτεί ενημέρωση για να λειτουργήσει σωστά.
Οι ομάδες θα πρέπει να ελέγχουν όχι μόνο τα σενάρια έκδοσης, αλλά και τα Dockerfiles και τους διαχειριστές τοπικού περιβάλλοντος για να διασφαλίσουν την ομαλή μετάβαση και την αποφυγή αστοχιών κατασκευής.
Βελτιωμένη ευελιξία για τοποθεσίες παγκόσμιας τεκμηρίωσης
Το Docusaurus 3.9 εισάγει σημαντικά βελτιώσεις στο Αλγόριθμος διάταξης Mermaid ELK. Το Mermaid είναι ένα δημοφιλές εργαλείο για τη δημιουργία διαγραμμάτων από κείμενο και η μηχανή διάταξης ELK του παρέχει πιο εξελιγμένες δυνατότητες απόδοσης., η οποία είναι ιδιαίτερα χρήσιμη για την αρχιτεκτονική συστήματος
Η απόδοση ενισχύεται επίσης με μια αναβάθμιση στο Rspack 1.5, που αξιοποιεί νέες επιλογές διαμόρφωσης για να επιταχύνει τους χρόνους κατασκευής του Docusaurus. Οι ταχύτερες εκδόσεις μεταφράζονται απευθείας σε υψηλότερη παραγωγικότητα προγραμματιστών, ιδιαίτερα σε μεγάλα έργα.
Άλλες αξιοσημείωτες αλλαγές περιλαμβάνουν νέες. γάντζοι για το χειρισμό σπασμένων συνδέσμων Markdown, δυνατότητα απενεργοποίησης της απόδοσης emoji και βελτιωμένη οπτική σταθερότητα κατά την εναλλαγή μεταξύ των χρωματικών λειτουργιών.
Αυτές οι συλλογικές βελτιώσεις ενισχύουν τη θέση του Docusaurus ως ισχυρής, αποτελεσματικής και ευέλικτης πλατφόρμας για τη δημιουργία σύγχρονων ιστότοπων τεκμηρίωσης.
