差分

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

--- ja:template:dokuwiki [2013-08-03 13:09] – 202.215.220.54
+++ ja:template:dokuwiki [2014-10-03 10:20] (現在) – [動作フック] sawachan
@@ 行 1: / 行 1: @@
-====== DokuWiki テンプレート======
+====== DokuWiki テンプレート ======
 ---- template ----
@@ 行 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, mobile
+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]] の選択可能
+  * [[ja:config:sidebar|設定項目: sidebar]] 対応
   * モバイル対応（デスクトップ、タブレット、携帯電話サイズ）
   * HTML5 互換
@@ 行 26: / 行 26: @@
 ===== カスタマイズ =====
-いくつかの簡単なカスタマイズには対応しています。
+簡単なカスタマイズに対応しています。
-それ以上のカスタマイズを必要とする場合、独自のテンプレートを作成してください。
+これ以上のカスタマイズを必要とする場合、独自のテンプレートを作成すべきです。
-テンプレート作成は[[ja:devel:templates|DokuWiki テンプレート開発]]を読んでください。
+[[ja:devel:templates|DokuWiki テンプレート開発]]を参照して下さい。
 ==== サイドバーの追加 ====
-[[ja:config:sidebar|設定項目: sidebar]] で設定するサイドバーに対応しています。
+[[ja:config:sidebar|設定項目: sidebar]] の設定によるサイドバーに対応しています。
 ==== 幅や他のスタイル要素の変更 ====
-''%%__site_width__%%'' スタイル変数を上書きすることで、テンプレートの幅を変更できます。
+[[devel:style.ini|style.ini]] の標準保証プレースホルダに加えて、テンプレートは次の変数を使用します：
-''lib/tpl/dokuwiki/style.local.ini'' ファイルを作成し、必要な変数を設定するだけです。
-固定値だけでなく動的幅にしたい場合はパーセント値を使用できます。
-<code ini lib/tpl/dokuwiki/style.local.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__  = "90%"
+__site_width__  = "100%"
 </code>
-幅と同じように ''style.ini'' の他の変数も、このファイルを利用して上書きすることができます。
+例えば、色の一部を変更するような ''style.ini'' の他の変数を上書きするためにもこのファイルを利用できます。
-例えば、一部の色を変更する。
-==== ロゴの追加 ====
+==== ロゴの変更 ====
-ロゴ、ファビコン、Apple Touch（ブックマーク）のアイコンは、複数の場所から検索されます。
+ロゴ、ファビコン、Apple Touch（ブックマーク）のアイコンは、複数の場所を検索します。
-テンプレートの提供するデフォルトのアイコン（DokuWiki ロゴ）は、
+[[ja:media_manager|メディアマネージャー]]や[[ja:fullscreen_mediamanager|全画面メディアマネージャー]]を利用し正しい場所に画像ファイルをアプロードすることで、テンプレートの提供するデフォルトのアイコン（DokuWiki ロゴ）を簡単に変更できます。
-[[ja:media_manager|メディアマネージャー]]を使って正しい場所に画像ファイルをアプロードすることで
-簡単に変更できます。
-テンプレートのコードが見ている場所はここです：
+テンプレートが確認する場所は以下のとおりです：
   * サイトのロゴ
@@ 行 65: / 行 72: @@
     * '':favicon.ico''
     * ''lib/tpl/dokuwiki/images/favicon.ico''
-  * AppleとAndroidデバイスで使用されるブックマークのアイコン
+  * Apple や Android デバイスで使用されるブックマークアイコン
     * '':wiki:apple-touch-icon.png''
     * '':apple-touch-icon.png''
     * ''lib/tpl/dokuwiki/images/apple-touch-icon.png''
-==== 組込フック対応 ====
+==== 動作フック ====
-組込フックによって、
+テンプレートが起動するカスタム動作フックを処理する[[ja:devel:action_plugins|動作部品]]を提供することで、テンプレートを変更することなくプラグインをテンプレートに統合できます。
-テンプレートファイル自身を変更することなく HTML や PHP をテンプレートに追加することができ、
-その追加要素はテンプレートのアップデートに影響されず安全になります。
-テンプレートディレクトリ (''lib/tpl/dokuwiki/'') か ''conf/'' ディレクトリに
-該当するファイルを作成するだけです。
-^ ファイル名               ^ 組込の位置                                                ^
+=== TEMPLATE_PAGETOOLS_DISPLAY ===
-| ''meta.html''          | HTML <head> の中。追加のスタイル、metaheaders の追加に使用する |
-| ''sidebarheader.html'' | （もしあれば）サイドバーの上部 |
+この[[devel:event:TEMPLATE_PAGETOOLS_DISPLAY|イベント]]は、フローティング pagetool メニューの拡張、変更ができます。
-| ''sidebarfooter.html'' | （もしあれば）サイドバーの下部 |
+''%%$event->data['items']%%'' にはメニュー内の各項目の HTML の配列が含まれます。
-| ''pageheader.html''    | content box の内側上部。実際の内容の上 |
+プラグインの作者は、既存のスタイルに合わせ必要な CSS と背景画像を提供すべきです。
-| ''pagefooter.html''    | content box の内側下部。実際の内容の下 |
+''$conf['template']'' に応じて異なるスタイル・クラス・マークアップを使用できます。
-| ''header.html''        | ページの上部。ロゴや Wiki タイトルの上 |
+''%%$event->data['view']%%'' には ''main'' ビューまたは ''detail'' ビューのどちらが pagetools を呼び出したのかという情報が含まれます。
-| ''footer.html''        | ページの一番最後。他の全ページの内容の後 |
+==== 組込フック対応 ====
-==== 議論 ====
+組込フックは、テンプレート自体を変更せずに、テンプレート更新時にも保全の必要なく、テンプレートに HTML や PHP を追加できます。
+テンプレートディレクトリ（''lib/tpl/dokuwiki/''）か ''conf/'' ディレクトリに該当するファイルを作成するだけです。
-[[template:dokuwiki#discussion|Discussion]]（英語）参照。
+^ ファイル名               ^ 組込み HTML の位置                                          ^
+| ''meta.html''          | HTML <head> の中。スタイルや metaheaders の追加に使用する。   |
+| ''sidebarheader.html'' | （もしあれば）サイドバーの上部。                              |
+| ''sidebarfooter.html'' | （もしあれば）サイドバーの下部。                              |
+| ''pageheader.html''    | content box の内側上部。実際の内容の上。                      |
+| ''pagefooter.html''    | content box の内側下部。実際の内容の下。                      |
+| ''header.html''        | ページの上部。ロゴや Wiki タイトルの上。                      |
+| ''footer.html''        | ページの一番最後。他の全ページの内容の後。                    |