mdi : ενσωμάτωση κώδικα σε markdown / αριθμός έκδοσης / markdown ...

Πρόλογος

Αποτελεί κοινή απαίτηση η ενσωμάτωση αριθμών εκδόσεων και κώδικα επίδειξης στο readme.md.

Υπάρχουν κάποια παρόμοια εργαλεία στην αγορά, αλλά δεν λειτουργούν καλά. Έτσι έγραψα ένα μόνος μου (μέγεθος εκτελέσιμου αρχείου 256 KB).

Η λειτουργικότητα είναι τέτοια που γράφοντας μια δήλωση όπως > ./demo.js στο markdown θα ενσωματώσει τον κώδικα, και το περιεχόμενο που προκύπτει φαίνεται στο παρακάτω στιγμιότυπο :

Εναλλακτικά, με το εργαλείο μετάφρασης markdown που έγραψα με βάση το deepl, μπορείτε να μεταφράσετε αυτόματα από τα κινέζικα στα αγγλικά και να το παρουσιάσετε στο ίδιο αρχείο readme.md.

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

Εγκατάσταση

Κατεβάστε από το github ή cargo install mdi

Διεύθυνση βάσης κώδικα

Χρήση

mdi [dir]

Θα αναζητήσει τον κατάλογο xxx.mdi.md και θα αντικαταστήσει το > ./xxx.rs με το περιεχόμενο του ενσωματωμένου κώδικα και θα το εκδώσει στο xxx.md.

Εάν η ενσωμάτωση είναι ένα αρχείο markdown, θα κάνει αναδρομικές αναφορές σε αυτό.

Δείτε το αρχείο επίδειξης readme.mdi.md