Markowik

Markowik是一個Python應用程序，降價格式的文本轉換成谷歌代碼維基。
Markowik能夠最降價的結構轉換到谷歌代碼維基（GCW）當量。而不是列出所有支持轉換的，請看看Markowik的測試套件和展示櫃。
安裝
運行：
PIP安裝markowik
或：
easy_install的markowik
您還可以使用Markowik無需安裝，在貢獻中所述。
命令行使用
從幫助輸出：
用法：markowik [-h] [--mx [MX [MX ...]]] [--image-baseURL時URL]
＆NBSP; - HTML的圖像] [--encoding編碼] [--quiet]
＆NBSP; INFILE [OUTFILE]
轉換到降價谷歌代碼維基。
位置參數：
＆NBSP; INFILE降價文件
＆NBSP; OUTFILE維基文件（默認：標準輸出）
可選參數：
＆NBSP; -h，--help顯示此幫助信息並退出
＆NBSP; - MX [MX [MX ...]]降價擴展激活
＆NBSP; - 圖像baseURL時URL基地URL時，預先準備的相對位置的圖像
＆NBSP; - HTML，圖像總是使用HTML的圖像
＆NBSP; - 輸入和輸出的編碼編碼編碼（默認：UTF8）
＆NBSP; - 安靜禁用信息消息
降價擴展可以給出類似於到了Python降價（PyMD）的命令行工具，所不同的是單獨的擴展必須用空格隔開：
markowik INPUT --mx表def_list
當前支持（即測試）擴展簡稱，表格和def_list。其他擴展一般應太，但可能在轉換後的維基文本產生意想不到的效果。
關於選項--html，圖像，請參閱下面的說明，在限制。
編程用法
Markowik是用Python實現。該markowik模塊提供了一個命名的功能轉換。語義上是類似的命令行界面（關鍵字參數對應的命令行選項）。這裡是一個簡短的使用示例：
>>>進口markowik
>>> markowik.convert（“有些* *降價文字......”，MX = ['表']）
u'Some _markdown_文字......“
網頁編譯指示
GCW頁面編譯指示可以在降價的源文件中的PyMD元的擴展定義的格式，元數據進行設置：
>>> SRC =“”“總結：總結頁
...標籤：有的，標籤
...
...這裡開始*頁* ..
......“”“
>>>打印markowik.convert（SRC，MX = ['元']）
#summary頁面匯總
#labels一些，標籤

在這裡，開始_page_ ..
需要注意的是元擴展名必須顯式啟用，即默認Markowik不承認頁面編譯指示

什麼是此版本中的新：

< ul>

什麼在0.1.1版本新：

• 在改進的文檔
• 在小幅修正。

要求：

• 在Python中

限制：

• 在GCW無法表達的降價都標記可能。這意味著降價的源文件應寫入記住以下限制。

<李類=“bbli”>的鏈接和圖片的URL：
• 在用於鏈接或圖像源的URL必須是絕對的，必須有一個特定的協議得到了GCW認可。尤其是，任何URL必須以http：//，https：//開頭，或ftp：//。 Markowik中止轉換，如果發現不符合這些要求的URL。

<李類=“bbli”> Typefacing的鏈接名稱：
• 在GCW不支持typefacing的鏈接名稱。例如GCW在[http://foo.com _Foo_]從字面上看，即作為_Foo_呈現鏈接名稱。然而，GCW承認typefacing的HTML鏈接，即＆LT; A HREF =＆QUOT; HTTP：//foo.com" ＆GT; _Foo_＆LT; / a取代;正確地強調。為具有嵌套typefacing像[*美孚*]由於這個原因降價鏈路（http://foo.com）將被轉換為HTML鏈接。其結果是，與具有在GCW使用反引號轉義某些特殊字符鏈接標籤（`）標記物也將導致HTML鏈接。

<李類=“bbli”>嵌套段落：
• 在GCW並不真正支持多個嵌套的段落（如列表或引用文字）。 Markowik模擬多個嵌套的段落他們用＆LT分離; BR /＆GT; （這在視覺上模仿的段落，但不會打破築巢環境）。

<李類=“bbli”>圖片：
• 在降價允許表達對圖像替代和標題文本。 GCW的形象語法並不支持這一點。保留這些文本的唯一方法是使用普通的HTML＆LT; IMG＆GT;標籤。選項--html，圖像啟用此解決辦法。
• 另一個問題是，GCW期望圖像的URL，以結束與圖像文件類型擴展名。 Markowik增加了人工形象的擴展，如果有必要，例如http://foo.bar/image改為http://foo.bar/image?x=x.png。

<李類=“bbli”>縮寫：
• 在GCW沒有標記的縮寫，也不支持HTML標籤＆lt;簡稱取代。 Markowik縮寫轉換為＆lt;跨度＆GT; -elements哪一種模仿縮寫（當然，在一個有限的方式）
。
<李類=“bbli”> HTML
• 在一個降價源發生的任何普通的HTML結束了字面上的GCW（除跨級標籤的內容）。這意味著降價源應該只包含HTML通過GCW的支持。另一個含義是，在普通的HTML標記使用的URL不檢查GCW兼容性。換句話說：使用原始的HTML，當你對你自己的
！