Markowik

MarkowikはGoogle CodeのウィキにMarkdownのフォーマットされたテキストに変換し、Pythonのアプリです。
MarkowikはGoogle Codeのウィキ（GCW）同等に最もMarkdownの構文を変換することができます。代わりに、サポートされているすべての変換をリストする、Markowikのテストスイートとそのショーケースを見てください。
<強い>インストールの
実行します。
markowikをインストールピップ
または：
easy_installをmarkowik
Contributeの下に説明されているように、インストールせずにMarkowikを使用することができます。
のコマンドラインの使用の
ヘルプ出力から：
用法：markowik [-h] [--mx [MX [MX ...]]] [--image-BASEURL URL]
＆NBSP; - HTML-画像] [--encoding ENCODING] [--quiet]
＆NBSP; INFILE [OUTFILE]
Google Codeのウィキにマークダウンに変換します。
位置引数：
＆NBSP; INFILEマークダウンファイル
＆NBSP; OUTFILEウィキファイル（デフォルト：標準出力）
オプションの引数：
＆NBSP; -h、このヘルプメッセージを表示して終了--help
＆NBSP; - MX [MX [MX ...]]マークダウンの拡張有効にする
＆NBSP; - 相対画像位置の前に付加する画像BASEURLのURLベースURL
＆NBSP; - HTML - 画像は、常に画像のためのHTMLを使用
＆NBSP; - 入力と出力のエンコードエンコードのエンコーディング（デフォルト：UTF8）
＆NBSP; - 静かな無効化情報メッセージ
Markdown記法の拡張機能は、個々の拡張はスペースで区切らなければならないことを除いては、Pythonの記法（PyMD）コマンドラインツールへと同様に与えられてもよい。
テーブル--mx markowik入力def_list
現在サポートされている（すなわちテスト）の拡張は略称、テーブル、およびdef_listです。他の拡張機能は、一般的にあまりにも動作するはずですが、変換されたWikiテキストに予期しない結果をもたらす可能性があります。
オプション--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はMarkdown記法で可能なすべてのマークアップを表現することはできません。これはマークダウンソースファイルが念頭に置いて、以下の制限と書かれるべきであることを意味します。

リンクと画像でのURL：
リンクや画像ソースに使用
• のURLは絶対である必要とGCWによって認識取得するために特定のプロトコルを持っている必要があります。具体的には、任意のURLは、http：//で始まる必要があります、https：//で、またはftp：//。それはこれらの要件に合致しないURLを見つけた場合Markowikは、変換を中止します。

リンク名でのTypefacing：
• GCWは、リンク名でtypefacingをサポートしていません。たとえば、GCWは、文字通り、すなわち_Foo_として[http://foo.com _Foo_]でリンク名をレンダリングします。しかし、GCWは、HTMLリンク、すなわち＆LTでtypefacingを認識します。 HREF =＆QUOT;のhttp：//foo.com"。 ＆GT; _Foo_＆LT。 /＆GT。適切に強調されている。 [*はFoo *]（http://foo.com）のようなネストされたtypefacingとマークダウンリンクはHTMLリンクに変換されます。このため。その結果、バッククォート（ `）マーカーを用いGCWでエスケープする必要が特定の特殊文字とのリンクのラベルはまたHTMLリンクになります。

ネストされた段落：
• 本当に複数のネストされた段落をサポートしていませんGCW（例えばリストや引用ブロックで）。 Markowikは＆LTで区切ることにより、複数のネストされた段落をシミュレートします。 BR /＆GT。 （その視覚的に模倣した段落が、ネスティング環境を破壊しない）します。

画像：
• Markdown記法は、画像のための代替とタイトルテキストを表現することができます。 GCWのイメージ構文はこれをサポートしていません。これらのテキストを保存する唯一の方法は、通常のHTML＆LTを使用することです。 IMG＆GT。タグ。オプション--html-画像この回避策を可能にします。
• もう一つの問題は、GCWは、画像のURLが画像ファイルタイプの拡張子で終わることを期待ということです。必要に応じてインスタンスをhttp://foo.bar/imageがhttp://foo.bar/image?x=x.pngに変更さのためにMarkowikは、人工画像の拡張子が追加されます。

略語：
• GCWは、略語のためのマークアップを持っていないまたそれは、HTMLタグの＆ltサポートしません。略称＆GT ;. Markowikは、LTを＆する略語を変換します。スパン＆GT、-elements（もちろん限られた方法で）模倣省略形の種類
。
HTML：
• Markdownのソースで発生した任意のプレーンHTMLは（スパンレベルのタグのコンテンツを除く）GCWに文字通り終わる。これはマークダウン源だけGCWによってサポートされているHTMLを含めるべきであることを意味する。もう一つの意味は、プレーンなHTMLタグで使用されるURLがGCW互換性のためにチェックされていないことである。つまり：生のHTMLを使用しているとき、あなた自身にあります。
！