mdi : vstavljanje kode v markdown / številka različice / markdown ...

Predgovor

Vstavljanje številk različic in demo kode v spletno mesto readme.md je zelo pogosta zahteva.

Na trgu je nekaj podobnih orodij, vendar ne delujejo dobro. Zato sem ga napisal sam (velikost izvedljive datoteke 256 KB).

Funkcionalnost je takšna, da se z zapisom izjave, kot je > ./demo.js, v markdown vgradi koda, nastala vsebina pa je prikazana na spodnji zaslonski sliki :

Poleg tega je z orodjem za prevajanje markdown, ki temelji na deepl, ki sem ga napisal, mogoče samodejno prevesti in prikazati kitajščino in angleščino v isti datoteki readme.md.

Uporabniška izkušnja bo zelo dobra, saj bo na vrhu besedila v besedilu readme githuba (spodaj) nameščena sidrna točka, na katero lahko kliknete, da preidete na različne jezikovne različice navodil.

Namestitev

Prenesite iz githuba ali cargo install mdi

Naslov baze kode

Uporabite

mdi [dir]

Preiskal bo imenik xxx.mdi.md in nadomestil > ./xxx.rs z vsebino vgrajene kode ter jo izpisal na naslov xxx.md.

Če je vstavljena datoteka markdown, bo rekurzivno prikazal reference nanjo.

Oglejte si demo datoteko readme.mdi.md