Woodcut

。

木版はマコのソースファイルからの静的なWebサイトを構築するためのアプリ＆NBSPであり、それはあなたのソースディレクトリ、プロセス、見つかったすべてのテンプレートを歩く、そして、ビルドディレクトリ内のウェブサーバーにrsyncが実行準備ができて完全なウェブサイトが生成されます。
各ページのマコテンプレートを行うことで、木版はあなたの実践的な直接HTMLファイルだけでなく、テンプレートのフルパワーを編集するのシンプルさを提供します。あなたは他の、グローバルテンプレートでサイトのレイアウトやナビゲーションを取り除くためにマコ継承を使用することができます。あなたは、任意の複雑なサイト構造を構築するために、継承の連鎖と呼び出し可能なブロックを使用することができます。
.makoで終わるすべてのファイルは、テンプレートとみなされ、ビルドディレクトリ内の対応するファイルとしてレンダリングされます（ただし、.mako拡張子をドロップします）。ソースディレクトリのディレクトリ構造全体がビルドディレクトリに複製され、すべての非テンプレートファイルは、ソースファイル（または必要に応じて、完全なコピー）にシンボリックリンクとしてビルドディレクトリに表示されます。各テンプレートは、それが行くページを生じたのと同じ場所にディレクトリ構造内に住んでいるので、彼らが構築されたファイルにそうであるように、相対パスは、ソースファイルで作業する。
テンプレートは、最も一般的にHTMLファイルを生成するために使用されているが、彼らは同じように簡単に.htaccess、CSS、Javascriptの、または完成したウェブサイトの一部であってもよい任意の他の種類のファイルを生成するために使用することができる。
静的なサイトのの利点の
- 高速サーブへ
- 非常に基本的なサーバーの要件
- シンプルで安全な
- 簡単にクローンとプロトタイプ
- ローカルファイルシステムからのアクセスのサイトをあなたが（開発のため、アーカイブなど）をしたい場合
のテンプレートの利点の
- 一つの場所に定型的なコードの定義
- プログラムによる反復的なコードを生成
- 自動生成サイトマップまたはインデックスへの埋め込みPythonコード
- そのようなマークダウンまたはtypogrifyとしてインポート他のPythonモジュール
とそれ以上はあります！の
- あなたのウェブサイトのための活用ソースコントロール
- あなたのテキストエディタではなく、Webインターフェイスでの書き込み内容
- 実践的なコード - テストとある。いいえCMSはあなたの方法で取得しないように
ののはじめに
インストール
あなたが利用可能なピップがある場合：
＆NBSP;木版画をインストールピップ
それ以外の場合は、最新のタグをダウンロードし、実行します。
＆NBSP; Pythonがインストールsetup.py
使用法
あなたは例のソースツリー上でそれを試すことができます。
MBP：木版画ルークます$のCD例/
MBP：例のルークの$木版画のビルドのsrc /ビルド/
htaccess.confレンダリング
index.htmlをレンダリング
レンダリングfoo.htmlが
あなたは、ビルドディレクトリにレンダリングファイルを検索します。

のこのリリースのの新機能：ます。

• 全UTF-8のUnicodeサポートします。
• はそれらをシンボリックリンクするのではなく、ビルドディレクトリに非テンプレートファイルをコピーする--copyフラグを追加しました。
• バイナリを削除し、代わりにsetuptoolsの「entry_pointを使用します。
• PyPIの上で利用可能な

の要件の

• のPythonます。