Markowik

Markowik este o aplicatie Python care convertește Markdown text formatat la Google Code Wiki.
Markowik este capabil de a converti cele mai multe construcții Markdown Cod Google Wiki (GCW) echivalentele sale. În loc de o listă a tuturor conversii suportate, vă rugăm să aruncați o privire la suita de teste Markowik și cazul său spectacol.
Instalare
Rulați:
Pip instala markowik
sau:
easy_install markowik
Puteți folosi, de asemenea, Markowik fără instalare, așa cum s-a descris în Implică.
Command Line Utilizare
Din producția de ajutor:
utilizare: markowik [-h] [--mx [MX [MX ...]]] [--image-baseurl URL]
& Nbsp; [- html-imagini] [--encoding CODAREA] [--quiet]
& Nbsp; INFILE [outfile]
Conversia Markdown la Google Code Wiki.
argumente de poziție:
& Nbsp; fișier reduceri INFILE
& Nbsp; fișier wiki outfile (implicit: stdout)
Argumentele opționale:
& Nbsp; -h, help arată acest mesaj de ajutor și de ieșire
& Nbsp; - mx [MX MX [...]] extensii Markdown pentru a activa
& Nbsp; - URL URL de bază a imaginii-baseurl adauga inaintea pentru locațiile relative de imagine
& Nbsp; - html-imagini folosiți întotdeauna HTML pentru imagini
& Nbsp; - codificarea codificarea Codificare de intrare și de ieșire (implicit: UTF8)
& Nbsp; - mesaje linistite informatii dezactiva
Extensii Markdown poate fi administrat în mod similar ca la instrumentul de linie de comandă Python Markdown (PyMD), cu excepția faptului că extensiile individuale trebuie să fie separate de un spațiu:
markowik tabelele intrări --mx def_list
În acceptate în prezent extensii (de exemplu, testate) sunt abbr, mese, și def_list. Alte extensii, în general, ar trebui să funcționeze prea dar s-ar putea da rezultate neașteptate în textul wiki convertit.
În ceea ce privește opțiunea --html-imagini, a se vedea explicațiile de mai jos la Limitări.
Utilizare programatic
Markowik este implementat în Python. Modulul markowik oferă o funcție numită convertit. Semantic este similar cu interfață linie de comandă (argumente cuvinte cheie corespund comanda opțiunile de linie). Iată un exemplu de utilizare scurt:
>>> Markowik import
>>> markowik.convert ("Unele * de text * reduceri ...", MX = ['mese'])
Textul u'Some _markdown_ ... "
Pagina pragmas
Pagina GCW pragmas poate fi setat în Markdown fișierele sursă ca meta-date în formatul definit prin extinderea meta PyMD:
>>> Src = "" "Sumar: rezumat pagina
... Etichete: unele etichete,
...
... Aici începe a paginii * * ..
... "" "
>>> Markowik.convert imprimare (src, MX = ['meta'])
rezumat pagina #summary
#labels unele etichete,

Aici începe _page_ ..
Rețineți că extinderea meta trebuie să fie activat în mod explicit, adică implicit Markowik nu recunoaște pragmas pagina

Ce este nou în această versiune:.

< ul>

Ce este nou în versiunea 0.1.1:.

• documentare îmbunătățită
• stabilește minore.

Cerințe :

• Python

Limitări :

• GCW nu poate exprima toate marcare posibile în Markdown. Acest lucru înseamnă fișierele sursă Markdown ar trebui să fie scris cu următoarele limitări în minte.


• bbli adrese URL din Legaturi si imagini:
• URL-uri utilizate pentru link-uri sau surse de imagine trebuie să fie absolută și trebuie să aibă un protocol specific pentru a obține recunoscut de GCW. În special, orice URL-ul trebuie să înceapă cu http: //, https: //, sau ftp: //. Markowik intrerupe conversia cazul în care constată adrese URL nu corespund acestor cerințe.

Typefacing în Link Alte denumiri:
• GCW nu acceptă typefacing în numele link. De exemplu GCW face numele link-ul din [http://foo.com _Foo_] literal, adică în calitate de _Foo_. Cu toate acestea, GCW recunoaște typefacing în link-uri HTML, de exemplu, & lt; a href = & quot; http: //foo.com" & Gt; _Foo_ & lt; / A & gt; este accentuat în mod corespunzător. Din acest motiv, link-uri Markdown cu typefacing imbricate ca [* Foo *] (http://foo.com) vor fi convertite la link-uri HTML. Ca rezultat, etichete link cu anumite caractere speciale care trebuie scăpat în GCW folosind backtick (`) markeri va duce, de asemenea, la link-uri HTML.

imbricate Alineatele:
• GCW nu acceptă într-adevăr mai multe paragrafe imbricate (de exemplu, în liste sau blockquotes). Markowik simulează mai multe paragrafe imbricate prin separarea lor cu o & lt; br / & gt; (Care imită vizual punctele, dar nu se sparge mediul de cuibărit).

Imagini:
• Markdown permite să-și exprime texte alternative și titlu pentru imagini. Sintaxa imaginii GCW nu acceptă acest lucru. Singura modalitate de a păstra aceste texte este de a folosi HTML simplu & lt; img & gt; tag-uri. Opțiunea --html-imagini permite această soluție.
• O altă problemă este că GCW așteaptă adrese URL de imagine pentru a termina cu o extensie imagine tip de fișier. Markowik adauga extensii de imagine artificiale, dacă este necesar, de exemplu http://foo.bar/image este schimbat la http://foo.bar/image?x=x.png.

Abrevieri:
• GCW nu are nici un marcaj pentru abrevierile nici nu-l suport tag-ul HTML & lt; abbr & gt ;. Markowik convertește abrevierile la & lt; de control & gt; -elements ce fel de imită abrevieri (în mod limitat, desigur)
.
HTML:
• Orice HTML simplu au aparut la o sursă Markdown sfârșește literalmente în GCW (cu excepția conținutului de etichete interval de nivel). Acest lucru înseamnă sursa de Markdown ar trebui să conțină numai HTML susținută de GCW. O altă implicație este că URL-uri utilizate în tag-uri HTML simple nu sunt verificate pentru compatibilitate GCW. Cu alte cuvinte: atunci când se utilizează HTML brut ești pe cont propriu
!