Markdocは、技術文書の管理を目指しているが、目的の範囲のために使用することができます。 Markdocは、いくつかの注目すべきセールスポイントを持っています。
* Wikiはプレーンテキストファイルで完全に作られているので、あなたは簡単にバージョン管理下に置くことができます。
* Wikiはtarボールとして配布またはHTTPサーバがサービスを提供することができるスタンドアロンのHTMLディレクトリの中にコンパイルします。
*必要に応じて、すべてのレンダリングしたページと一緒にHTMLディレクトリにコンパイルされる静的な媒体を含むことができます。
* Markdocは、コンパイルされたウィキを提供するための完全に機能する純粋なPythonのWSGIアプリケーションとHTTPサーバーが付属しています。
*あなたは、このようなエトセトラPygmentsベースのコードの強調表示、定義リストのための拡張構文、TOC生成、などのMarkdownを拡張、の様々なあなたのwikiをレンダリングすることができます。
*あなたは完全にあなたのwikiが完全なHTML文書にレンダリング記法を変換するために使用Jinja2のテンプレートを編集することによってレンダリングされる方法をカスタマイズすることができます。
クイックスタート
インストール:
#!/ binに/ bashの
HGクローンのssh://hg@bitbucket.org/zacharyvoase/markdoc
CDのmarkdoc /
-r要件をインストールピップ
Pythonはsetup.py installを
ウィキを作ります
#!/ binに/ bashの
私のウィキのinit markdoc
CD私ウィキ/
VIMのwiki / somefile.md
#...いくつかのドキュメントを書きます...
markdocビルド
markdocはサーブ
#..オープンのhttp:// localhostを:8008 /ブラウザで...
レイアウト
Markdocのウィキには、次のデフォルトのレイアウトを持っています:
WIKI_ROOT /
| - .htmlの/
| - .templates /
| - の.tmp /
| - 静的/
| - ウィキ/
` - markdoc.yaml
彼らは一時的なファイルが含まれているための.html /との.tmp /ディレクトリには、任意のVCSから除外すべきです。
/ウィキ/ layout.md様々なサブディレクトリの役割の詳細については、ドキュメント内のレイアウトのドキュメントを参照してください
この要件:ます。
Pythonの
斑点
rsyncの
コメントが見つかりません