Markowik egy Python app, hogy átalakítja Markdown formázott szöveget Google Code Wiki.
Markowik képes átalakítani a legtöbb Markdown konstrukciókat annak Google Code Wiki (GCW) egyenértékű. Ahelyett, hogy felsorolja az összes támogatott átalakításokat, kérjük, vessen egy pillantást a Markowik a tesztsorozat és show-ügyben.
Telepítés
Fuss:
pip telepíteni markowik
vagy:
easy_install markowik
Ön is használja Markowik telepítés nélkül, pontban leírtak szerint járulnia.
parancssor használata
A segítség kimenet:
Használat: markowik [-h] [--mx [MX [MX ...]]] [--image-baseurl URL]
& Nbsp; [- html-képek] [--encoding ENCODING] [--quiet]
& Nbsp; INFILE [OUTFILE]
Convert Markdown a Google Code Wiki.
pozicionális érvek:
& Nbsp; INFILE árleszállítás fájl
& Nbsp; OUTFILE wiki fájlban (alapértelmezett: stdout)
opcionális érvek:
& Nbsp; -h, --help e segítség üzenetet és kilép
& Nbsp; - mx [MX [MX ...]] árleszállítás kiterjesztések aktiválásához
& Nbsp; - image-baseurl URL alap-URL neve elé a relatív image helyeken
& Nbsp; - html-képek mindig HTML képek
& Nbsp; - kódolás ENCODING kódolást a bemeneti és kimeneti (alapértelmezett: UTF8)
& Nbsp; - csendes disable info üzenetek
Árleszállítás kiterjesztések adható hasonlóan a Python Markdown (PyMD) parancssori eszköz, azzal a kivétellel, hogy egyes bővítményeket kell szóközzel elválasztva:
markowik INPUT --mx asztalok def_list
A jelenleg támogatott (azaz vizsgálatnak) kiterjesztések rövidítve, asztalok, és def_list. Egyéb kiterjesztések általában is működnie kell, de talán váratlan eredményeket az átalakított wiki szöveget.
Ami a lehetőség --html-képek, lásd az alábbi magyarázatok a korlátai.
Automatizált Használat
Markowik valósul Python. A markowik modul egy függvényt megtért. Szemantikailag is hasonló a parancssori felület (kulcsszó érvek megfelelnek Command Line Options). Itt egy rövid használati például:
>>> Import markowik
>>> Markowik.convert ("Egyes * * árleszállítás szöveget ...", mx = ['asztal'])
u'Some _markdown_ szöveget ... "
Page pragmák
GCW oldal pragmák állítható Markdown forrás fájlokat metaadatokként a formátum, amely az PyMD meta kiterjesztése:
>>> Src = "" "Összegzés: összefoglalás
... Címkék: egyes, címkék
...
... Itt kezdődik a * oldal * ..
... "" "
>>> Print markowik.convert (src, mx = ['meta'])
#summary összefoglalás
#labels néhány, címkék
Itt kezdődik a _page_ ..
Ne feledje, hogy a meta kiterjesztése engedélyezni kell kifejezetten, azaz alapértelmezés szerint Markowik nem ismeri az oldal pragmák.
Mi az új ebben a kiadásban:
< ul>
Mi az új verzióban 0.1.1:
- Továbbfejlesztett dokumentációt.
- Kisebb javítások.
követelmények :
- Python
korlátai :
- GCW nem képes kifejezni az összes jelölő lehetséges Markdown. Ez azt jelenti, Markdown forrás fájlokat kell írni a következő megkötésekkel szem előtt.
- URL-ek linkek és képek:
- URL használt linkek illetve kép forrásokból kell abszolút és kell egy bizonyos protokollt ismernek a GCW. Különösen olyan URL kell kezdeni http: //, https: // vagy ftp: //. Markowik megszakítja az átalakítás, ha úgy találja URL-ek nem felel meg ezeknek a követelményeknek.
- Typefacing Link Nevek:
- GCW nem támogatja typefacing a linket neveket. Például GCW teszi a link nevét a [http://foo.com _Foo_] szó, azaz _Foo_. Azonban GCW felismeri typefacing HTML linkeket, azaz & lt; a href = & quot; http: //foo.com" & Gt; _Foo_ & lt; / A & gt; Hangsúlyozzuk megfelelően. Emiatt Markdown kapcsolatok beágyazott typefacing mint a [* Foo *] (http://foo.com) kell átalakítani, hogy a HTML-linkeket. Ennek eredményeként, link címkék bizonyos speciális karaktereket, amelyeket be kell elmenekült GCW segítségével backtick (`) markerek is eredményez HTML linkeket.
- Beágyazott bekezdés:
- GCW nem igazán támogatja a többszörös beágyazott § (pl listák vagy blockquotes). Markowik szimulálja több beágyazott bekezdések elválasztva őket a & lt; br / & gt; (Amely vizuálisan utánozza bekezdések, de nem szakítja meg a fészkelési környezet).
- Kép:
- Markdown lehetővé teszi, hogy kifejezze az alternatív és címe szövegek képek. GCW imázsát szintaxis nem támogatja. Az egyetlen módja annak, hogy megőrizzük ezeket a szövegeket, hogy használja a sima HTML & lt; img & gt; címkék. Az opció --html-képek lehetővé teszi ezt a megoldást.
- A másik kérdés az, hogy GCW számít kép URL-ek a végére egy kép állomány kiterjesztését. Markowik Mesterséges image kiterjesztések ha szükséges, például http://foo.bar/image változik http://foo.bar/image?x=x.png.
- rövidítések:
- GCW nincs jelölés a rövidítések és nem támogatja a HTML & lt; rövidítve & gt ;. Markowik alakítja rövidítések a & lt; span & gt; -Méret milyen utánozza rövidítések (korlátozott módon persze).
- HTML:
- Bármilyen egyszerű HTML előforduló egy Markdown forrás végül szó szerint GCW (kivéve a tartalma span szintű címkék). Ez azt jelenti, a Markdown forrás csak tartalmazhat HTML támogatja GCW. Egy másik következmény az, hogy URL-eket használnak egyszerű HTML-címkék nem ellenőrzi GCW kompatibilitás. Más szóval: ha a nyers HTML-t a saját!
Hozzászólás nem található