
*** Weasy 1.4dev ***



*------------------------------------------------------------
*  1. Weasyとは
*------------------------------------------------------------


  Weasyとは、Weasy文法(下の方に詳細があります)をHTMLに変換するソフトウェアです。
  ページの一部に組み込むことを想定しています。

  指定されたページがない、GETパラメータがきちんとセットされていない場合には、
  404エラーを送信します。







*------------------------------------------------------------
*  2. ファイル・ディレクトリの構成
*------------------------------------------------------------


  ┌-- index.php        ページを表示するプログラム
  |-- parse.php        ページを分析するプログラム
  |-- LICENCE          Weasyのライセンス
  |-- README           このファイル
  |-- test.html        ページを表示する例 (削除しても構いません)
  └-- pages 　         ページを保存するディレクトリ
       └-- test.wp    テストページ        (削除しても構いません)






*------------------------------------------------------------
*  3. 使い方
*------------------------------------------------------------


   *ページの作成

     Weasy文法(下の方に詳細があります)に従いテキストエディタで記述し、
        ページ名.wp  というファイル名でpagesディレクトリに保存してください。



   *HTMLに組み込む

     HTMLにiframeを使ってWeasyのページを組み込むコードは下記のとおりです。

       <iframe src="index.phpへのパス?p=ページ名&s=セクション"></iframe>

     ページ名はpagesディレクトリ内のファイル名です。(拡張子の.wpは除く)
     セクションは表示するページの情報を指定します。セクションは以下のとおりです。

       title  - タイトル
       date   - 日付
       body   - 本文


     例: 本文を表示する

       <html>
         <body>
           <iframe src="index.php?p=test&s=body" frameborder="0" scrolling="no" width="100%"></iframe>
         </body>
       </html>






*------------------------------------------------------------
*  4. Weasy文法
*------------------------------------------------------------


  Weasy文法は簡単に覚えやすい文法です。これらは「bodyセクションのみ」適用されます。

   *セクション

     wpファイル(Weasy文法で書かれたファイル)には以下のセクションがあります。

       title  - タイトル
       date   - 日付
       body   - 本文


     セクションは  セクション名: 内容  と記述します。
     :の後ではbodyセクションのみ改行可能です。また、セクション名の前、内容の後の空白は無視されます。



   *修飾

     *文字列*  - 文字列を太字にします
     _文字列_  - 文字列に下線を引きます
     =文字列=  - 文字列を見出しにします



   *ヒアドキュメント

     {コード等
}

       ヒアドキュメント内の文字列はそのまま(修飾などをせずに)表示されます。
       また、 } は行の最初(改行してすぐ)に前に空白等を置かずに書いてください。



  *エスケープ

     \エスケープしたい文字

      *や[などのWeasyが修飾したりする文字を無効化します。

   *リンク

     [URL(http://を含む):リンク名]

       リンクを作成します。":リンク名"のところを省略すると、リンク名はURLとなります。



   *改行

     wpファイル内の改行がそのまま改行されます。


   例:

     title: テストページ
     date:  2011 3月 20日
     body:
         [http://example.com:リンク] _下線_や_太い文字。また、[http://example.com:_*組合わることも可能です。*_]
          {_ヒアドキュメン内では下線が引かれません_}\_エスケープしても引かれません\_







*------------------------------------------------------------
*  5. Weasy文法で作成されるHTML
*------------------------------------------------------------

  *文字列*       ->   <b>文字列</b>
  _文字列_       ->   <u>文字列</u>
  =文字列=       ->   <h3>文字列</h3>
  {文字列}       ->   <pre>文字列</pre>
  [URL:リンク名] ->   <a href="URL">リンク名</a>
                       ※リンク名が省略されている場合は <a href="URL">URL</a>

