Markowik yra Python programa, kuri konvertuoja markdown suformatuotą tekstą į Google Kodas Wiki.
Markowik sugeba paversti labiausiai sumažina jį stato savo "Google Kodas Wikipedija (GCW) ekvivalentais. Vietoj sąrašą visų palaikomų konversijas, prašome turėti ne Markowik anketa bandymų komplektą ir jos šou atveju išvaizdą.
Diegimas
Pradėti:
PIP įdiegti markowik
arba:
easy_install markowik
Taip pat galite naudoti Markowik be įrenginio, kaip aprašyta prisidėti.
Komandinės eilutės naudojimas
Nuo pagalbos produkcijos:
naudojimas: markowik [-h] [--mx [MX [MX ...]]] [--image-baseURL URL]
& Nbsp; [- HTML vaizdai] [--encoding KODAVIMAS] [--quiet]
& Nbsp; INFILE [OUTFILE]
Konvertuoti reklamos kainos "Google Code Wiki.
poziciniai argumentai:
& Nbsp; INFILE markdown failą
& Nbsp; OUTFILE wiki failas (pagal nutylėjimą: stdout)
neprivaloma argumentai:
& Nbsp; -h, help parodyti šią pagalbos pranešimą ir išeiti
& Nbsp; - x [MX [MX ...]] markdown plėtiniai aktyvuoti
& Nbsp; - vaizdo baseURL URL bazė URL pridėkite santykinių vaizdo vietose
& Nbsp; - HTML vaizdai visada naudoti HTML vaizdų
& Nbsp; - kodavimas kodavimo įvesties ir išvesties (pagal nutylėjimą: UTF8)
& Nbsp; - rami išjungti informacija pranešimus
Markdown plėtiniai gali būti panašiai kaip su Python reklamos kainos (PyMD) komandinės eilutės įrankis, išskyrus tai, kad atskiri papildymai turi būti atskirta tarpu:
markowik įvesties --mx lenteles def_list
Šiuo metu palaikomų (ty bandytas) plėtiniai yra abbr, stalai, ir def_list. Kiti terminai paprastai turėtų dirbti per bet gali duoti netikėtų rezultatų konvertuotų wiki tekstą.
Apie galimybę --html-vaizdų, pamatyti žemiau paaiškinimus ne apribojimai.
Programinis naudojimas
Markowik įgyvendinama Python. Markowik modulis suteikia funkcija pavadinta konvertuoti. Semantiškai jis yra panašus į komandinės eilutės sąsaja (vardinius argumentus atitinka komandų eilutės parinktis). Štai trumpas naudojimo pavyzdys:
>>> Import markowik
>>> markowik.convert ("Kai * markdown * Tekstas ...", mx = ['stalai'])
u'Some _markdown_ tekstas ... "
Pragmas
GCW puslapis pragma galima nustatyti reklamos kainos šaltinio failus kaip meta duomenų formatu nustatytame PyMD meta pratęsimo:
>>> Src = "" "Santrauka: puslapio santrauka
... Etiketės: kai, etiketės
...
... Čia prasideda * puslapį * ..
... "" "
>>> Print markowik.convert (src, mx = ['meta'])
#summary puslapis santrauka
#labels kai, etiketes
Čia prasideda _page_ ..
Atkreipkite dėmesį, kad meta plėtinys turi būti įjungtas aiškiai, ty pagal nutylėjimą Markowik nepripažįsta puslapis Pragmas
Kas naujo , šioje laidoje:.
< ul>
Kas naujo versijos 0.1.1:.
- Geresnis dokumentus
- Nedideli pataisymai.
Reikalavimai :
- Python
Apribojimai :
- GCW negali išreikšti visą įmanomą žymėjimą į reklamos kainos. Tai reiškia, kad reklamos kainos kodo failai turi būti parašyta omenyje šiuos apribojimus.
- URL Nuorodos ir vaizdai:
- URL naudojamos nuorodos ar vaizdo šaltinių turi būti absoliuti ir turi konkretų protokolą gauti pripažintą GCW. Visų pirma, bet URL turi prasidėti http: //, https: //, ftp: //. Markowik nutraukia konversiją, jei ji nustato URL nėra atitikimo šiuos reikalavimus.
- Typefacing LINK vardų:
- GCW nepalaiko typefacing LINK pavadinimus. Pavyzdžiui GCW teikia nuorodą vardą [http://foo.com _Foo_] pažodžiui, ty kaip _Foo_. Tačiau GCW pripažįsta typefacing HTML nuorodas, ty & lt; a href = & quot; http: //foo.com" & Gt; _Foo_ & lt; / & Gt; yra tinkamai pabrėžti. Dėl šios priežasties sumažina jį ryšius su įdėtos typefacing kaip [* Foo *] (http://foo.com) bus konvertuoti į HTML nuorodas. Kaip rezultatas, nuoroda etiketės tam tikrų specialių simbolių, kurie turi būti išsigelbėjo GCW naudojant gravis (`) žymekliai taip pat lems HTML nuorodas.
- Lizdinė dalys: "
- GCW tikrai ne palaikyti keletą įdėtos dalių (pvz sąrašus ar blockquotes). Markowik imituoja kelis įdėtos pastraipas atskiriant juos su & lt; br / & gt; (Kuri vizualiai imituoja punktai, bet nenutrūksta lizdus aplinką).
- vaizdai:
- reklamos kainos leidžia išreikšti alternatyvius pavadinimą ir tekstus vaizdų. GCW įvaizdis sintaksė nepalaiko tai. Vienintelis būdas išsaugoti šiuos tekstus yra naudoti paprastą HTML & lt; img & gt; žymės. Galimybė --html-vaizdai leidžia šį būdą.
- Kitas klausimas yra tai, kad GCW tikisi vaizdo URL baigti su vaizdo failo tipo išplėtimo. Markowik prideda dirbtinių vaizdo plėtinius, jei reikia, pavyzdžiui http://foo.bar/image pakeistas į http://foo.bar/image?x=x.png.
- Santrumpos:
- GCW neturi žymėjimo už santrumpos, nei ji remti HTML tegus & lt; abbr & gt ;. Markowik konvertuoja santrumpas, kad & lt; span & gt; -elementai kokios imituoja santrumpos (ribotai mados žinoma) .
- HTML:
- Bet paprasto HTML vyksta į vadove elektroniniu šaltinio baigiasi pažodžiui GCW (su perdangos lygio žymės turinį, išskyrus). Tai reiškia, kad reklamos kainos šaltinis turėtų būti tik HTML remiamą GCW. Kitas reiškia, kad URL naudojami paprasto HTML žymes nėra patikrinta GCW suderinamumą. Kitaip tariant: kai naudojant žalią HTML esate ant savo !
Komentarai nerastas