Markowik

Markowik adalah aplikasi Python yang mengkonversi penurunan harga teks berformat ke Google Code Wiki.
Markowik dapat mengkonversi sebagian penurunan harga konstruksi ke Google Code Wiki (GCW) setara kas. Alih-alih daftar semua konversi didukung, silakan lihat di Markowik itu test suite dan kasus acara tersebut.
Instalasi
Jalankan:
pip menginstal markowik
atau:
easy_install markowik
Anda juga dapat menggunakan Markowik tanpa instalasi, seperti yang dijelaskan di bawah Berkontribusi.
Penggunaan Command Line
Dari output bantuan:
Penggunaan: markowik [h] [--mx [MX [MX ...]]] [--image-baseurl URL]
& Nbsp; [- html-gambar] [--encoding ENCODING] [--quiet]
& Nbsp; infile [OUTFILE]
Mengkonversi penurunan harga ke Google Code Wiki.
argumen posisi:
& Nbsp; infile berkas penurunan harga
& Nbsp; OUTFILE berkas wiki (default: stdout)
argumen opsional:
& Nbsp; h, help menunjukkan pesan bantuan ini dan keluar
& Nbsp; - mx [MX [MX ...]] penurunan harga ekstensi untuk mengaktifkan
& Nbsp; - URL gambar-baseurl basis URL untuk tambahkan ke lokasi gambar relatif
& Nbsp; - html-gambar selalu menggunakan HTML untuk gambar
& Nbsp; - encoding ENCODING pengkodean input dan output (default: UTF8)
& Nbsp; - tenang pesan info menonaktifkan
Ekstensi penurunan harga dapat diberikan sama untuk Python penurunan harga (PyMD) command line tool, dengan pengecualian bahwa ekstensi individu harus dipisahkan oleh spasi:
markowik tabel INPUT --mx def_list
Saat ini didukung (yaitu diuji) ekstensi Singkatan, meja, dan def_list. Ekstensi lain pada umumnya harus bekerja juga, tapi mungkin menghasilkan hasil yang tidak diharapkan dalam teks wiki dikonversi.
Mengenai pilihan --html-gambar, lihat penjelasan di bawah ini di Keterbatasan.
Programatik Penggunaan
Markowik diimplementasikan di Python. Modul markowik menyediakan fungsi bernama mengkonversi. Semantik itu mirip dengan antarmuka baris perintah (argumen kata kunci sesuai dengan perintah opsi baris). Berikut adalah contoh penggunaan singkat:
>>> Impor markowik
>>> Markowik.convert ("Beberapa * penurunan harga * teks ...", mx = ['tabel'])
Teks u'Some _markdown_ ... '
Page pragmas
GCW Halaman pragmas dapat diatur dalam file sumber penurunan harga sebagai meta data dalam format yang ditetapkan oleh meta ekstensi PyMD:
>>> Src = "" "Ringkasan: Ringkasan halaman
... Label: beberapa, label
...
... Di sini mulai halaman * * ..
... "" "
>>> Print markowik.convert (src, mx = ['meta'])
Ringkasan halaman #summary
#labels beberapa, label

Berikut dimulai _page_ tersebut ..
Perhatikan bahwa perpanjangan meta harus diaktifkan secara eksplisit, yaitu secara default Markowik tidak mengakui pragmas halaman

Apa yang baru dalam rilis ini:.

< ul>

Apa yang baru dalam versi 0.1.1:.

• Peningkatan dokumentasi
• perbaikan kecil.

Persyaratan :

• Python

Keterbatasan :

• GCW tidak bisa mengungkapkan semua markup mungkin dalam penurunan harga. Ini berarti file sumber penurunan harga harus ditulis dengan keterbatasan berikut dalam pikiran.


• URL di Link dan Gambar:
• URL yang digunakan untuk link atau sumber gambar harus mutlak dan harus memiliki protokol khusus untuk mendapatkan diakui oleh GCW. Secara khusus, setiap URL harus dimulai dengan http: //, https: //, atau ftp: //. Markowik dibatalkan konversi jika menemukan URL tidak sesuai persyaratan ini.


• Typefacing di Link Nama:
• GCW tidak mendukung typefacing dalam nama link yang. Misalnya GCW membuat nama link dalam [http://foo.com _Foo_] harfiah, yaitu sebagai _Foo_. Namun, GCW mengakui typefacing di link HTML, yaitu & lt; a href = & quot; http: //foo.com" & Gt; _Foo_ & lt; / A & gt; ditekankan benar. Untuk alasan ini link penurunan harga dengan typefacing bersarang seperti [* Foo *] (http://foo.com) akan diubah menjadi link HTML. Akibatnya, label hubungan dengan karakter khusus tertentu yang harus melarikan diri di GCW menggunakan backtick (`) penanda akan juga menghasilkan link HTML.


• Bersarang Paragraf:
• GCW tidak benar-benar mendukung beberapa paragraf bersarang (misalnya dalam daftar atau blockquotes). Markowik mensimulasikan beberapa paragraf bersarang dengan memisahkan mereka dengan & lt; br / & gt; (Yang secara visual meniru paragraf tetapi tidak melanggar lingkungan bersarang).


• Foto:
• penurunan harga memungkinkan untuk mengekspresikan alternatif dan judul teks untuk gambar. Sintaks gambar GCW tidak mendukung hal ini. Satu-satunya cara untuk melestarikan teks-teks ini adalah dengan menggunakan plain HTML & lt; img & gt; tag. Pilihan --html-gambar memungkinkan pemecahan masalah ini.
• Masalah lainnya adalah bahwa GCW mengharapkan URL gambar untuk mengakhiri dengan ekstensi gambar jenis file. Markowik menambahkan ekstensi gambar buatan jika diperlukan, misalnya http://foo.bar/image diubah menjadi http://foo.bar/image?x=x.png.


• Singkatan:
• GCW tidak memiliki markup untuk singkatan juga tidak mendukung tag HTML & lt; abbr & gt ;. Markowik mengkonversi singkatan untuk & lt; rentang & gt; -elements yang jenis meniru singkatan (secara terbatas saja)
.

• HTML:
• Setiap HTML biasa terjadi di sumber penurunan harga berakhir harfiah di GCW (dengan pengecualian dari isi tag span-level). Ini berarti sumber penurunan harga hanya harus berisi HTML yang didukung oleh GCW. Implikasi lain adalah bahwa URL yang digunakan dalam tag HTML biasa tidak diperiksa untuk kompatibilitas GCW. Dengan kata lain: ketika menggunakan HTML mentah Anda berada pada Anda sendiri
!