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，当你对你自己的
！