Markowik

Markowik is 'n Python app wat Afprijzingsmanager geformateerde teks vat om Google Code wiki.
Markowik in staat is om die meeste Afprijzingsmanager konstrukte te omskep tot sy Google Code Wiki (GCW) ekwivalente. In plaas van n lys van al ondersteun doelskoppe, asseblief 'n blik op Markowik se toets suite en sy show geval.
Installasie
Begin:
PIP installeer markowik
of:
easy_install markowik
Jy kan ook gebruik Markowik sonder installasie, soos beskryf onder Dra.
Command Line Gebruik
Van die hulp afvoer:
Gebruik: markowik [h] [--mx [MX [MX ...]]] [--image-basisurl URL]
& Nbsp; [- html-beelde] [--encoding ENCODING] [--quiet]
& Nbsp; INFILE [outfile]
Skakel Afprijzingsmanager Google Code wiki.
posisionele argumente:
& Nbsp; INFILE Afprijzingsmanager lêer
& Nbsp; outfile wiki lêer (verstek: stdout)
opsionele argumente:
& Nbsp; h, help uit te voer hierdie hulp boodskap en uitgang wys
& Nbsp; - mx [MX [MX ...]] Afprijzingsmanager uitbreidings te aktiveer
& Nbsp; - beeld basisurl URL basis-URL te prefix relatiewe beeld plekke
& Nbsp; - html-beelde HTML vir die beelde gebruik altyd
& Nbsp; - enkodering ENCODING enkodering van toevoer en afvoer (verstek: UTF8)
& Nbsp; - stil afskakel inligting boodskappe
Afprijzingsmanager uitbreidings kan gegee word insgelyks as die Python Afprijzingsmanager (PyMD) command line instrument, met die uitsondering dat individuele uitbreidings moet geskei word deur 'n spasie:
markowik INPUT --mx tafels def_list
Die tans ondersteun (dws getoets) uitbreidings is abbr, tafels, en def_list. Ander uitbreidings algemeen moet te werk, maar onverwagse resultate kan oplewer in die bekeerde wiki teks.
By die opsie --html-beelde, sien die verduidelikings hieronder by Beperkings.
Programmatiese Gebruik
Markowik geïmplementeer in Python. Die markowik module bied 'n funksie genoem omskep. Semanties dit is soortgelyk aan die command line interface (navraag argumente ooreenstem line opsies te beveel). Hier is 'n kort gebruik byvoorbeeld:
>>> Invoer markowik
>>> Markowik.convert ("Sommige * Afprijzingsmanager * teks ...", mx = ['tafels'])
u'Some _markdown_ teks ... "
Page Pragmas
GCW bladsy pragmas kan ingestel word in Afprijzingsmanager bron lêers as meta data in die formaat gedefinieer deur die PyMD meta uitbreiding:
>>> Src = "" "Opsomming: bladsy opsomming
... Etikette: sommige etikette
...
... Hier begin die * bladsy * ..
... "" "
>>> Druk markowik.convert (src, mx = ['meta'])
#summary bladsy opsomming
#labels sommige etikette

Hier begin die _page_ ..
Let daarop dat die meta uitbreiding moet word uitdruklik geaktiveer is, dit wil sê deur verstek Markowik nie bladsy pragmas erken

Wat is nuut in hierdie release:.

< ul>

Wat is nuut in die weergawe 0.1.1:.

• Verbeterde dokumentasie
• Klein fixes.

Vereistes :

• Python

Beperkings :

• GCW kan nie al opmaak moontlik in Afprijzingsmanager druk. Dit beteken Afprijzingsmanager bron lêers met die volgende beperkings in gedagte geskryf word.


• URL's in skakels en beelde:
• URLs gebruik vir die skakels of beeld bronne moet absoluut wees en moet 'n spesifieke protokol kry erken deur GCW het. In die besonder, moet enige URL begin met http: //, https: //, of ftp: //. Markowik aborteer die omskakeling as dit bevind URLs nie ooreenstem met hierdie vereistes.


• Typefacing in Link Name:
• GCW ondersteun nie typefacing in skakel name. Byvoorbeeld GCW lewer die naam van die skakel in [http://foo.com _Foo_] letterlik, dws as _Foo_. Maar GCW erken typefacing in HTML skakels, dws & lt; a href = & quot; http: //foo.com" & Gt; _Foo_ & lt; / A & gt; behoorlik beklemtoon. Om hierdie rede Afprijzingsmanager bande met geneste typefacing soos [* Foo *] (http://foo.com) sal omgeskakel word na HTML skakels. As 'n resultaat, skakel etikette met sekere spesiale karakters wat moet ontsnap word in GCW behulp backtick (`) merkers sal ook lei tot HTML skakels.


• Nested Paragrawe:
• GCW nie regtig ondersteun verskeie geneste paragrawe (soos lyste of block quotes). Markowik simuleer verskeie geneste paragrawe deur die skeiding van hulle met 'n & lt; br / & gt; (Wat visueel boots paragrawe maar nie die nes omgewing breek).


• Images:
• Afprijzingsmanager toelaat alternatiewe en titel tekste vir die beelde uit te druk. GCW se beeld sintaksis ondersteun nie hierdie. Die enigste manier om hierdie tekste te bewaar, is duidelik HTML & lt te gebruik; img & gt; tags. Die opsie --html-beelde in staat stel om van hierdie metode.
• 'n Ander probleem is dat GCW verwag beeld URL's te eindig met 'n beeld lêer tipe uitbreiding. Markowik voeg kunsmatige beeld uitbreidings indien nodig, byvoorbeeld http://foo.bar/image verander word na http://foo.bar/image?x=x.png.


• Afkortings:
• GCW het geen opmaak vir afkortings ook nie ondersteun die HTML tag & lt; abbr & gt ;. Markowik vat afkortings lt om &; span & gt; -elemente wat soort van boots afkortings (in 'n beperkte manier natuurlik)
.

• HTML:
• Enige plain HTML wat in 'n Afprijzingsmanager bron eindig letterlik in GCW (met die uitsondering van die inhoud van span-vlak tags). Dit beteken dat die Afprijzingsmanager bron moet net HTML ondersteun deur GCW bevat. Nog implikasie is dat URLs gebruik in plain HTML tags word nie nagegaan word vir GCW verenigbaarheid. Met ander woorde: wanneer rou HTML jy op jou eie
!