Question 1

Τι είναι το Mermaid;

Accepted Answer

Το Mermaid είναι μια γλώσσα διαγραμμάτων ανοιχτού κώδικα που επιτρέπει τη δημιουργία διαγραμμάτων από απλό κείμενο, παρόμοια με το Markdown. Περιγράφετε κόμβους και συνδέσεις με απλή σύνταξη και ο renderer σχεδιάζει το διάγραμμα αυτόματα.

Question 2

Ποιοι τύποι διαγραμμάτων υποστηρίζονται;

Accepted Answer

Ο επεξεργαστής περιλαμβάνει παραδείγματα για διαγράμματα ροής, ακολουθίας, κλάσεων, καταστάσεων, ER, Gantt, κυκλικά, νοητικούς χάρτες και χρονογραμμές. Το Mermaid 11 υποστηρίζει και άλλους τύπους που μπορείτε να πληκτρολογήσετε.

Question 3

Πώς δημιουργώ διάγραμμα;

Accepted Answer

Επιλέξτε παράδειγμα από τη λίστα ή πληκτρολογήστε τον κώδικά σας στον αριστερό επεξεργαστή. Η προεπισκόπηση αποδίδεται ξανά περίπου 350 ms μετά το σταμάτημα της πληκτρολόγησης· σε σφάλμα σύνταξης, κόκκινο πάνελ δείχνει το ακριβές σφάλμα ενώ το προηγούμενο διάγραμμα παραμένει.

Question 4

Αποστέλλεται ο κώδικάς μου κάπου;

Accepted Answer

Όχι. Όλα αποδίδονται τοπικά στον browser σας με JavaScript. Ο κώδικάς σας δεν φεύγει ποτέ από τη συσκευή σας.

Question 5

Πώς εξάγω το διάγραμμα;

Accepted Answer

Χρησιμοποιήστε Λήψη SVG για επεκτάσιμο διάνυσμα ή Λήψη PNG για εικόνα διπλής ανάλυσης, με προαιρετικό διαφανές φόντο. Η Αντιγραφή κώδικα τοποθετεί την πηγή Mermaid στο πρόχειρο.

Question 6

Γιατί η εξαγωγή PNG αποτυγχάνει μερικές φορές;

Accepted Answer

Ορισμένες λειτουργίες του Mermaid αποδίδονται μέσω foreignObject, που τα browsers μπορεί να αρνηθούν να ραστεροποιήσουν. Τότε η εξαγωγή PNG εμφανίζει σφάλμα, αλλά η λήψη SVG λειτουργεί πάντα αφού δεν απαιτείται ραστεροποίηση.

Question 7

Πώς λειτουργεί το zoom;

Accepted Answer

Η προεπισκόπηση υποστηρίζει κλίμακα 0,5x έως 2x. Τα κουμπιά + και - βηματίζουν κατά 10%, η Προσαρμογή μετράει το διάγραμμα στην περιοχή προεπισκόπησης και το 100% επαναφέρει το αρχικό μέγεθος.

Question 8

Μπορώ να χρησιμοποιήσω Mermaid στη δική μου τεκμηρίωση;

Accepted Answer

Ναι. Το GitHub, το GitLab και πολλά εργαλεία τεκμηρίωσης αποδίδουν μπλοκ Mermaid εγγενώς: τυλίξτε τον κώδικα σε μπλοκ κώδικα mermaid και θα σχεδιαστεί αυτόματα στη σελίδα.

Question 9

Υποστηρίζει ο επεξεργαστής σκούρα θεματολογία;

Accepted Answer

Ναι. Το διάγραμμα ακολουθεί το θέμα της πλατφόρμας: με μετάβαση σε σκούρη λειτουργία αποδίδεται ξανά αυτόματα με τη σκούρα θεματολογία του Mermaid.

Question 10

Συμβουλές για ευανάγνωστα διαγράμματα;

Accepted Answer

Σύντομες ετικέτες κόμβων, κατάλληλη κατεύθυνση για το περιεχόμενο (TD κάθετα ή LR οριζόντια), διαίρεση πολύ μεγάλων γράφων σε υπογράφους και χρήση των ενσωματωμένων παραδειγμάτων ως προτύπου για κάθε τύπο.

Επεξεργαστής Mermaid

Πώς να χρησιμοποιήσετε το Επεξεργαστής Mermaid