差分

このページの2つのバージョン間の差分を表示します。

--- ja:template:dokuwiki [2012-10-10 14:18] – 作成 125.55.214.60
+++ ja:template:dokuwiki [2014-10-03 10:20] (現在) – [動作フック] sawachan
@@ 行 5: / 行 5: @@
 author        : Anika Henke
 email         : anika@selfthinker.org
-lastupdate    : 2012-09-08
+lastupdate    : 2014-06-04
 compatible    : (bundled)
 similar       :
-screenshot_img: :template:dokuwiki_template.png
+screenshot_img: template:dokuwiki_template.png
-tags          : default, sidebar, !bundled
+tags          : default, sidebar, !bundled, mobile, responsive
 ----
-"Adora Belle" バージョン((2012年08月リリース))以降の DokuWiki に同梱される、新しいデフォルトテンプレートです。
-[[https://github.com/splitbrain/dokuwiki|git repository of DokuWiki]] でも見ることができます。
+"Adora Belle"（2012-10-13 リリース）以降の DokuWiki に同梱される新しいデフォルトテンプレートです。
-"Adora Belle" バージョン以降の DokuWiki でないと動きません。
 [[clarencedglee@gmail.com|Clarence Lee]] がデザインしました。
+[[http://blog.selfthinker.org/2012/10/20/the-story-behind-dokuwikis-new-template/|the template's story]] を参照して下さい。
+===== 機能 =====
+  * [[ja:config:sidebar|設定項目: sidebar]] 対応
+  * モバイル対応（デスクトップ、タブレット、携帯電話サイズ）
+  * HTML5 互換
 ===== カスタマイズ =====
+簡単なカスタマイズに対応しています。
+これ以上のカスタマイズを必要とする場合、独自のテンプレートを作成すべきです。
+[[ja:devel:templates|DokuWiki テンプレート開発]]を参照して下さい。
 ==== サイドバーの追加 ====
-[[ja:config:sidebar|設定項目: sidebar]] で設定するサイドバーに対応しています。
+[[ja:config:sidebar|設定項目: sidebar]] の設定によるサイドバーに対応しています。
+==== 幅や他のスタイル要素の変更 ====
+[[devel:style.ini|style.ini]] の標準保証プレースホルダに加えて、テンプレートは次の変数を使用します：
+^プレースホルダ変数         ^意味                                       ^
+|''%%__background_site__%%''|サイト全体の背景色                         |
+|''%%__link__%%''           |リンクの色                                 |
+|''%%__existing__%%''       |既存の内部ページへのリンクの色             |
+|''%%__missing__%%''        |存在しない内部ページへのリンクの色         |
+|''%%__site_width__%%''     |サイト全体の幅                             |
+|''%%__sidebar_width__%%''  |サイドバーの幅                             |
+例えば、''%%__site_width__%%'' 変数を上書きすることで、テンプレートの幅を調整できます。
+''conf/tpl/dokuwiki/style.ini'' ファイル（Adora Belle の場合、古い場所：''lib/tpl/dokuwiki/style.local.ini''）を作成し、対応する変数を設定するだけです。
+固定値（px または em）または可変幅を望む場合はパーセント値（%）を使用できます。
+<code ini conf/tpl/dokuwiki/style.ini>
+[replacements]
+__site_width__  = "100%"
+</code>
+例えば、色の一部を変更するような ''style.ini'' の他の変数を上書きするためにもこのファイルを利用できます。
+==== ロゴの変更 ====
+ロゴ、ファビコン、Apple Touch（ブックマーク）のアイコンは、複数の場所を検索します。
+[[ja:media_manager|メディアマネージャー]]や[[ja:fullscreen_mediamanager|全画面メディアマネージャー]]を利用し正しい場所に画像ファイルをアプロードすることで、テンプレートの提供するデフォルトのアイコン（DokuWiki ロゴ）を簡単に変更できます。
+テンプレートが確認する場所は以下のとおりです：
-==== 幅の変更 ====
+  * サイトのロゴ
+    * '':wiki:logo.png''
+    * '':logo.png''
+    * ''lib/tpl/dokuwiki/images/logo.png''
+  * ファビコン
+    * '':wiki:favicon.ico''
+    * '':favicon.ico''
+    * ''lib/tpl/dokuwiki/images/favicon.ico''
+  * Apple や Android デバイスで使用されるブックマークアイコン
+    * '':wiki:apple-touch-icon.png''
+    * '':apple-touch-icon.png''
+    * ''lib/tpl/dokuwiki/images/apple-touch-icon.png''
-テンプレートの ''style.ini'' ファイルを編集し、
+==== 動作フック ====
-固定値や動的変更幅用のパーセント値を ''%%__site_width__%%'' に設定できます。
-サイドバーの幅も調整できます。
-==== ロゴの追加 ====
+テンプレートが起動するカスタム動作フックを処理する[[ja:devel:action_plugins|動作部品]]を提供することで、テンプレートを変更することなくプラグインをテンプレートに統合できます。
-[[ja:media_manager|メディアマネージャー]]を使って ":wiki:logo.png" ファイルをアップロードしてください。
+=== TEMPLATE_PAGETOOLS_DISPLAY ===
-==== Favicon の追加 ====
+この[[devel:event:TEMPLATE_PAGETOOLS_DISPLAY|イベント]]は、フローティング pagetool メニューの拡張、変更ができます。
+''%%$event->data['items']%%'' にはメニュー内の各項目の HTML の配列が含まれます。
+プラグインの作者は、既存のスタイルに合わせ必要な CSS と背景画像を提供すべきです。
+''$conf['template']'' に応じて異なるスタイル・クラス・マークアップを使用できます。
+''%%$event->data['view']%%'' には ''main'' ビューまたは ''detail'' ビューのどちらが pagetools を呼び出したのかという情報が含まれます。
-  * :wiki:favicon.ico
+==== 組込フック対応 ====
-  * :favicon.ico
-  * images/favicon.ico ((テンプレートが用意した favicon の代替))
+組込フックは、テンプレート自体を変更せずに、テンプレート更新時にも保全の必要なく、テンプレートに HTML や PHP を追加できます。
+テンプレートディレクトリ（''lib/tpl/dokuwiki/''）か ''conf/'' ディレクトリに該当するファイルを作成するだけです。
-  * :wiki:apple-touch-icon.png
+^ ファイル名               ^ 組込み HTML の位置                                          ^
-  * :apple-touch-icon.png
+| ''meta.html''          | HTML <head> の中。スタイルや metaheaders の追加に使用する。   |
-  * images/apple-touch-icon.ico ((テンプレートが用意した icon の代替))
+| ''sidebarheader.html'' | （もしあれば）サイドバーの上部。                              |
+| ''sidebarfooter.html'' | （もしあれば）サイドバーの下部。                              |
+| ''pageheader.html''    | content box の内側上部。実際の内容の上。                      |
+| ''pagefooter.html''    | content box の内側下部。実際の内容の下。                      |
+| ''header.html''        | ページの上部。ロゴや Wiki タイトルの上。                      |
+| ''footer.html''        | ページの一番最後。他の全ページの内容の後。                    |