このサイトで使用している arctic テンプレートの設定方法について紹介します。

DokuWikiの紹介を行っているページなどでは、sidebar や monobook テンプレートを採用している所が多いですが、ここでは arctic テンプレートをお勧めします。
その理由として、

• 管理画面よりサイドバーの表示／非表示が可能
• サイドバー表示位置を左／右／両方と設定できる
• ユーザ／グループ／namespaces ごとにサイドバーを作成できる
• 目次やtrace情報もサイドバーに組み込める
• サイトの主要なレイアウト情報を設定ファイルで簡単に変更できる
• 日本語問題なし
• 更新も早く、しっかりメンテナンスされている

と、このサイトのようなサイドバーを表示した基本的なレイアウトのWikiサイトを構築しやすいからです。
（あと、せっかくテンプレート変えるなら、DokuWikiの特徴である ACL や namespaces を活かしたサイドバーを作れる方が面白いですし。）

• Step1: arcticテンプレートの最新を Download よりダウンロードして解凍します。インストールしているDokuWikiのバージョンによってダウンロードするファイルが異なりますので注意してください。
• Step2: <dokuwiki>/lib/tpl にアップロードします。
• Step3: サイト設定画面の「基本」→「テンプレート」で、arctic を選択します。
• Step4: サイト設定画面に「Arctic テンプレート設定」項目が追加されているので、サイトレイアウトに合わせて設定します。
  設定項目の説明は、arcticテンプレートページの Configuration セクションを確認してください。
• Step5: サイトにサイドバーを表示する場合は、表示したい各種サイドバーを作成します。
  各種サイドバーの作成方法は、arcticテンプレートページの Sidebar types セクションを確認してください。

このサイトのようなサイドバーを表示する場合の、実際の設定例を紹介します。

「Arctic テンプレート設定」には以下の設定をしています。

サイドバー用に以下のページを作成しています。
「pagename to use for sidebars」を sidebar から別の名前に変更した場合は、「main」や「user」のページ名も同じ名前に変更してください。

このサイトでは、Tags、Wiki、Linksの各サイドバーを固定で表示し、かつ別々のグループレイヤーで表示させたかったため、arcticテンプレートのソースに以下の修正を行っています。
具体的には「other sidebars」に設定した、tags、wiki、links のそれぞれのサイドバーを表示させるために、tpl_functions.phpの145行目と146行目の間に以下のコードを追加しています。

 case 'wiki':
     $ns_sb = 'wiki:sidebar';
     if(auth_quickaclcheck($ns_sb) >= AUTH_READ) {
         print '<div class="namespace_sidebar sidebar_box">' . DOKU_LF;
         print p_sidebar_xhtml($ns_sb) . DOKU_LF;
         print '</div>' . DOKU_LF;
     }
     break;
 case 'links':
     $ns_sb = 'links';
     if(auth_quickaclcheck($ns_sb) >= AUTH_READ) {
         print '<div class="namespace_sidebar sidebar_box">' . DOKU_LF;
         print p_sidebar_xhtml($ns_sb) . DOKU_LF;
         print '</div>' . DOKU_LF;
     }
     break;
 case 'tags':
     $ns_sb = 'tags:tag';
     if(auth_quickaclcheck($ns_sb) >= AUTH_READ) {
         print '<div class="namespace_sidebar sidebar_box">' . DOKU_LF;
         print p_sidebar_xhtml($ns_sb) . DOKU_LF;
         print '</div>' . DOKU_LF;
     }
     break;

独自サイドバーを追加したい場合は、case条件を「other sidebars」に設定する名前にし、$ns_sbの値を作成したページ名に修正したcaseブロックを、tpl_functions.phpのswitch文に追加すればOKです。

なお、arcticテンプレートフォルダ直下の left_sidebar.html(left_sidebar.html) や、arctic/sidebars/<sidebarname>/sidebar.php の追加によって独自のサイドバーを表示させることも出来ますが、上記の修正だと作成したページをそのままサイドバーとして利用でき、管理も簡単です。

« 最初の環境設定 | プラグインの設定 »