mdi : kodo įterpimas į markdown / versijos numeris / markdown ...

Įžanga

Įprastai reikalaujama, kad į svetainę readme.md būtų įterpti versijų numeriai ir demonstracinis kodas.

Rinkoje yra panašių įrankių, tačiau jie neveikia gerai. Todėl pats parašiau vieną (vykdomojo failo dydis 256 KB).

Funkcijos tokios, kad parašius tokį teiginį kaip > ./demo.js į "Markdown" bus įterptas kodas, o gautas turinys parodytas toliau pateiktoje ekrano kopijoje :

Arba naudodami " deepl" pagrindu parašytą " markdown" vertimo įrankį galite automatiškai versti iš kinų į anglų kalbą ir pateikti jį tame pačiame readme.md faile.

Naudotojo patirtis bus labai gera, nes "github" readme viršuje (toliau) bus pateiktas teksto atramos taškas, kurį spustelėjus galima pereiti prie instrukcijų versijų įvairiomis kalbomis.

Įrengimas

Atsisiųsti iš github arba cargo install mdi

Kodų bazės adresas

Naudokite

mdi [dir]

Jis ieškos kataloge xxx.mdi.md, pakeis > ./xxx.rs įterpto kodo turinį ir išves jį į xxx.md.

Jei įterptasis failas yra markdown failas, bus rekursiškai atvaizduojamos nuorodos į jį.

Peržiūrėkite demonstracinį failą readme.mdi.md