Markowik

Markowik ay isang Python app na-convert Markdown-format ng teksto sa Google Code Wiki.
Markowik ay magagawang i-convert ang pinaka-constructs Markdown sa kanyang Google Code Wiki (GCW) katumbas. Sa halip na naglilista ng lahat ng mga suportadong mga conversion, mangyaring magkaroon ng isang pagtingin sa test suite Markowik at nito palabas kaso.
Pag-install
Patakbuhin:
buto ng bungang-kahoy-install markowik
o:
easy_install markowik
Maaari mo ring gamitin Markowik nang walang pag-install, tulad ng inilarawan sa ilalim ambag.
Paggamit ng Command Line
Mula sa tulong output:
paggamit: markowik [-h] [--mx [MX [MX ...]]] [--image-baseurl URL]
& Nbsp; [- html-larawan] [--encoding pag-encode] [--quiet]
& Nbsp; INFILE [OUTFILE]
I-convert ang Markdown sa Google Code Wiki.
posisyonal mga argumento:
& Nbsp; INFILE markdown file
& Nbsp; OUTFILE wiki file (default: stdout)
opsyonal na mga argumento:
& Nbsp; -h, --help ipakita ang help mensahe at lumabas
& Nbsp; - MX [MX [MX ...]] markdown extension upang i-activate
& Nbsp; - imahe-baseurl URL base URL upang i-prepend sa kaugnay na mga lokasyon ng larawan
& Nbsp; - laging gumamit ng html-larawan HTML para sa mga larawan
& Nbsp; - pag-encode sa pag-encode sa pag-encode ng input at output (default: UTF8)
& Nbsp; - tahimik na huwag paganahin ang mga mensahe ng impormasyon
Markdown mga extension ay maaaring naibigay na bilang katulad sa Python Markdown (PyMD) command line tool, na may pagbubukod na dapat na pinaghiwalay indibidwal na extension sa pamamagitan ng puwang:
markowik mga talahanayan INPUT --mx def_list
Ang kasalukuyang sinusuportahan (yan ay nasubok) mga extension ang abbr, mga talahanayan, at def_list. Sa pangkalahatan ay dapat na gumana Iba pang mga extension ng masyadong ngunit maaaring magbunga ng mga hindi inaasahang resulta sa convert na teksto wiki.
Tungkol sa pagpipiliang --html-larawan, tingnan ang mga paliwanag sa ibaba sa Limitasyon.
program Paggamit
Markowik ay ipinapatupad sa Python. Nagbibigay ang module markowik isang function na may pangalang convert. Magkakahulugang mga ito ay katulad ng interface command line (mga argumento keyword ay tumutugma sa mga pagpipilian sa command na linya). Narito ang isang maikling halimbawa ng paggamit:
>>> Import markowik
>>> Markowik.convert ("Ang ilan * * markdown text ...", MX = ['talahanayan'])
u'Some _markdown_ teksto ... '
Pahina Pragmas
GCW pragmas pahina ay maaaring itakda sa Markdown mapagkukunan ng mga file bilang meta data sa format na tinukoy ng PyMD meta extension:
>>> Src = "" "Buod: buod pahina
... Mga Label: ilan, mga label
...
... Narito nagsisimula ang * * pahina ..
... "" "
>>>-Print markowik.convert (src, MX = ['meta'])
#summary buod pahina
#labels ilan, mga label

Narito nagsisimula ang _page_ ..
Tandaan na ang meta extension ay ma-enable ang tahasan, ibig sabihin, sa pamamagitan ng default Markowik ay hindi kilala pragmas pahina

Ano ang bagong sa paglabas:.

< ul>

Ano ang bagong sa bersyon 0.1.1:.

• Pinahusay na dokumentasyon
• Maliliit na pag-aayos.

Mga Kinakailangan :

• Python

Mga Limitasyon :

• GCW maaaring hindi ipahayag ang lahat ng mga markup maaari sa Markdown. Ang ibig sabihin nito Markdown source file ay dapat na nakasulat na may sumusunod na mga limitasyon na nasa isip.


• mga URL sa Mga Link at Mga Larawan:
• mga URL na ginagamit para sa mga link o mga mapagkukunan ng imahe kailangang maging ganap na at dapat ay may isang tiyak na protocol upang makilala sa pamamagitan ng GCW. Sa partikular, ay dapat magsimula ng anumang mga URL sa http: //, https: //, o ftp: //. Markowik aborts ang conversion kung nahahanap nito URL na hindi tumutugma sa mga pangangailangan.


• Typefacing sa Link Pangalan:
• Hindi sinusuportahan ng GCW ay typefacing sa mga pangalan link. Halimbawa-render GCW ang pangalan link sa [http://foo.com _Foo_] literal, ibig sabihin, bilang _Foo_. Gayunpaman, kinikilala GCW typefacing sa mga link na HTML, ie & lt; a href = & quot; http: //foo.com" & Gt; _Foo_ & lt; / A & gt; ay bigyang-diin ng maayos. Para sa kadahilanang ito Markdown link sa Nested typefacing tulad ng [* Foo *] (http://foo.com) ay mako-convert sa mga link na HTML. Bilang resulta, ang link label na may ilang mga espesyal na character kung saan ay mayroon na nakatakas sa GCW gamit backtick (`) marker ay magreresulta din sa mga link na HTML.


• Nested Mga Talata:
• GCW ay hindi talagang sumusuporta sa maramihang mga Nested mga talata (eg sa listahan o blockquotes). Markowik simulates maramihang mga talata Nested sa pamamagitan ng paghihiwalay ng mga ito sa isang & lt; br / & gt; (Na biswal na Ginagaya ang mga talata ngunit hindi masira ang nesting kapaligiran).


• Mga Larawan:
• Binibigyang-daan ka Markdown upang ipahayag ang alternatibong at pamagat ng teksto para sa mga imahe. Hindi sinusuportahan ng ang syntax na ito imaheng GCW iyon. Ang tanging paraan upang mapanatili ito teksto ay ang gamitin sa simpleng HTML & lt; img & gt; mga tag. Ang pagpipiliang --html-larawan Nagbibigay-daan ang workaround.
• Ang isa pang isyu na GCW Inaasahan ng mga URL ng imahe upang magtapos sa isang extension ng uri ng file na imahe. Nagdaragdag ang Markowik artipisyal na extension ng imahe kung kinakailangan, halimbawa http://foo.bar/image ay pinalitan sa http://foo.bar/image?x=x.png.


• abbreviation:
• GCW ay walang markup para sa mga pagdadaglat hindi rin sinusuportahan ito ng tag na & lt HTML; abbr & gt ;. Markowik Kino-convert ng mga pagdadaglat sa & lt; span & gt; -elements kung anong uri ng Ginagaya ang mga pagdadaglat (sa isang limitadong fashion siyempre)
.

• HTML:
• Anumang nagtatapos sa simpleng HTML na nagaganap sa isang pinagmulan Markdown up literal sa GCW (na may pagbubukod sa mga nilalaman ng mga tag span antas ng). Nangangahulugan ito na ang pinagmulan Markdown dapat lamang maglaman ng HTML suportado ng GCW. Isa pang implikasyon ay na ang mga URL na ginamit sa simpleng mga tag na HTML ay hindi naka-check para sa compatibility GCW. Sa ibang salita: kapag gumagamit ng raw na HTML ikaw ay nasa iyong sariling
!