AsciiDoc Website Builder

AsciiDocはウェブサイトBuilderは、ほとんどプレーンテキスト（すなわちAsciiDocは）、プラスいくつかの簡単な設定ファイルにウェブサイトを作成することができますPythonで書かれたプログラムです。それは私がすぐにぶっきらぼうな私は新しいページを追加するために必要なすべての変更および特定の書式を覚えていなかったため（PHPの多くを使用した）私自身のウェブサイトを更新したことがないの私の問題を解決するために存在している。
ここで、「AsciiDocはホームページビルダー」のある主要な機能は次のとおりです。
·柔軟なテンプレートシステム
·ブログの生成
·画像ギャラリーの生成
·sitemap.xmlに生成
·AsciiDocはすべておいしいの特徴を
入門：
AWBの使用を開始するには、ユーザーAWB設定ファイルで少なくとも一つのウェブサイトを設定する必要があります。これは、それがこのようなものを見ることができる〜/ .awb / awb.conf次の場所にあります。
----
[名前がMyWebSite]
siteroot：/ホーム/ ME /名前がMyWebSite
BASEURLます。http：//my.web.site
AsciiDocはオプション：-dブック-b HTML4
----
これは単に「名前がMyWebSite」としてAWBに知られているウェブサイトを定義します。オプションは次のとおりです。
siteroot ::
AWBウェブサイトのルートディレクトリ。 AsciiDocはソースは+ siteroot / SRC +に住んでいる、とhtml出力が+ siteroot / HTML +に行く。
BASEURL ::
ウェブサイトのルートのURL。これはsitemap.xmlにを生成するために使用される。
AsciiDocはオプション::
AsciiDocはに渡されるオプション。私は、例に示されているオプションに加え、カスタムhtml4.confファイルを指定するために、これを使用しています。
あなたが書かれて構成されたウェブサイトといくつかのソースファイルを入手したら、単純にコマンドを発行する
----
％AWB名前がMyWebSite
----
AWBは時代遅れになっているHTMLファイルを再生成します。これはいくつかの理由で動作しない場合、オプション-rはそれを修正するために使用することができる。
----
％AWB -r名前がMyWebSite
----
これは、ファイルシステムのどこからでも行うことができます。 AWBはどこから読み取りおよび書き込みをするために、その構成ファイルから知っている。
awbdir.conf
-----------
ソースツリー内の各ディレクトリはawbdir.confという名前の設定ファイルを含むことができる。このファイルには、AWBが使用するディレクトリ固有のオプションを指定します。
[DIRセットアップ]セクション
タイプ::
「通常」、「ブログ」の1、または「ギャラリー」することができます。 「正常な」デフォルトです。タイプの意味について説明する。
名::
パンくずリストのようにディレクトリの記述名、。
awbdir.conf [ブログ]セクション
この項では、ディレクトリタイプがブログであれば使用する設定を定義します。
NUMメインの記事::
ブログのindex.htmlページに表示する投稿の数。
NUM最近の投稿::
ポストタイトル数は「最近の投稿」リストに表示するとともに、雑誌のタイトル数は、「最近の雑誌」リストに表示する。
[ユーザー]セクション
ここではあなたが好きな任意のオプションを定義することができます。これは、テンプレートで参照することができる。あなたはサイト全体で同じテンプレートを使用したいが、それの小さな部品（例えば画像）を変更する場合に便利です。
その子のディレクトリからawbdir.confオプションカスケード。子ディレクトリにのみ適用されません親オプションを上書きする必要が、これは、非常に便利です。唯一の例外は、ディレクトリ名、カスケードしませんです。

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

• この更新プログラムには、修正その設定ディレクトリの位置を決定しながら、AWBが失敗する原因となった最近のPythonのリリースによって公開され問題ます。
• 修正はのpython-xdgの新しいdepenendencyを、紹介します。

-lオプションはすべてのサイトをリストに追加されました。

のバージョン0.3.1でのの新機能であるます。

• ブログポストフォーマットがポスト日付を使用するように修正されました、ではないのmtimeます。
• サイトマップのタイムスタンプでの問題が修正されました。
• は使用法の文字列を更新しました。
• 空のメタ記述が挿入されませんします。

空のファイルのタイトルを取得中に
• クラッシュは回避されます。
• はマニュアルは、別の場所に移動したします。
• はコマンドが追加されました。
• ドキュメンテーション文字列のクリーンアップが行われていたします。

のバージョン0.3のの新機能：

• 今回のリリースでは、大規模なリファクタリングの最終産物である<。 / LI>
• 0.3シリーズは、安定した1.0のリリースへのパスとなります。