初期バージョン から バージョン 1 における更新: TracDoc/BlogParts

更新日時:

2008/07/05 04:08:19 (16 年 前)

更新者:

hirobe (IP アドレス: 133.6.203.10)

コメント:

--

TracDoc/BlogParts

@@ +1 @@
+= ブログパーツを Wikiで表示する Blog Parts プラグイン =
+== 概要 ==
+Tracのwikiやチケットには、scriptタグやobjectタグを
+書くことは許されていません。
+これは、悪意のあるユーザがいたずらするのを防ぐためですが、
+これによって、ブログパーツを貼り付けることもできません。
+
+このプラグインは、ブログパーツを管理ページで登録することによって
+wikiの中にマクロとして貼り付けることができるようにするものです。
+
+== ダウンロード ==
+Trac-HacksのDownloadよりダウンロードしてください。
+http://trac-hacks.org/wiki/BlogPartsMacro
+
+== 使い方 ==
+eggをつくって、プラグインフォルダにおいてください。
+最初にTracEnvのupgradeが必要です。
+=== ブログパーツの登録 ===
+管理ページの{{{BlogParts}}}に、ブログパーツを登録します。
+各項目には、以下のように値を入力してください。
+ Name ::
+  ブログパーツを識別する名前。半角英数で。[[BR]]
+  例：{{{twitter}}}
+ Description ::
+  ブログパーツの説明をwiki形式で。マクロの使い方も書くとよいでしょう。[[BR]]
+ Body HTML ::
+  ブログパーツのHTML。%arg_n%(nは1から始まる連番)の形で、マクロを記載するときの変数を埋め込むことができます。
+
+=== wikiの中で使う ===
+wikiの中では、マクロとして登録したブログパーツを呼び出すことができます。
+wikiに以下のように書きます。
+{{{
+[[BlogParts(ブログパーツの名前,引数)]]
+}}}
+引数は複数指定可能です。ただし、登録時のHTMLに%arg_n%(nは1から始まる連番)という変数で登録しておく必要があります。
+なお、引数の値はquoteされます。これは'<'みたいな危険な文字をそのまま表示しないための措置です。
+
+
+