mdi : koda iestrādāšana markdown / versijas numurs / markdown ...
Priekšvārds
Bieži tiek prasīts, lai vietnē readme.md
tiktu iestrādāti versiju numuri un demonstrācijas kods.
Tirgū ir daži līdzīgi rīki, taču tie nedarbojas labi. Tāpēc es pats uzrakstīju vienu (izpildāmā faila izmērs 256 KB).
Funkcionalitāte ir tāda, ka, rakstot izteikumu, piemēram, > ./demo.js
, Markdown tiks iestrādāts kods, un iegūtais saturs ir redzams zemāk redzamajā ekrānšāviņā :
Alternatīvi, izmantojot zīmju tulkošanas rīku, ko es uzrakstīju, pamatojoties uz deepl, ķīniešu un angļu valodu var automātiski tulkot un atveidot tajā pašā readme.md
failā.
Lietotāja pieredze būs ļoti laba, jo github readme augšpusē (zemāk) ir teksta enkurpunkts, uz kura var noklikšķināt, lai pārietu uz instrukciju dažādo valodu versijām.
Uzstādīšana
Lejupielādēt no github vai cargo install mdi
Izmantojiet
mdi [dir]
Tas meklēs direktoriju xxx.mdi.md
un aizstās > ./xxx.rs
ar iegulto koda saturu un izvadīs to uz xxx.md
.
Ja ievietotais fails ir markdown fails, tas rekursīvi attēlos atsauces uz to.
Apskatīt demo failu readme.mdi.md