DokuWikiのテンプレートとプラグイン

DokuWiki公式・テンプレートからDokuWikiで使用可能なテンプレート一覧が確認可能。

デフォルトのテンプレートをそのまま使うか、変更する場合はBootstrap3 Template がおすすめ。

人気のパラメーターを見るとBootstrap3が圧倒的に人気が高い。
2位と10倍以上の差をつけている。

管理　＞　拡張機能管理　＞　検索とインストール

Bootstrap3を検索。

Bootstrap3 Template（作者： Giuseppe Di Terlizzi）のインストールをクリック。

インストールしただけでは適用されない。
別途、管理画面から設定が必要。

管理　＞　サイト設定

保存をクリック。

管理　＞　サイト設定

保存をクリック。

デフォルトでは、画面の上部に[[start]]のようなテキストが表示される。
これを非表示にする。

管理　＞　サイト設定

管理　＞　拡張機能管理

インストール済みプラグインタブで、プラグインの横のアンインストールをクリック。

DokuWiki公式・Active Directory 認証プラグイン

Acrive Directoryを使用していない場合、このプラグインは不要。

DokuWiki公式・LDAP Auth plugin: Active Directory

Active Directoryなどのディレクトリーサービスを使用していなければ不要。

DokuWiki公式・authPDO Plugin

PDO（PHP Data Object）を使用していなければ不要。
PDOはMySQLなどの認証で使うもの。

DokuWiki公式・Popularity Feedback プラグイン

DokuWikiの開発元に統計データを送信するためのプラグイン。
調査に協力したければこのプラグインを利用してもいいが、アンインストールしても問題はない。

管理　＞　 拡張機能管理　＞　検索とインストール

DokuWiki公式・smtp plugin

DokuWiki公式・EditTable plugin

DokuWiki公式・socialcards plugin

DokuWiki公式・Socialite plugin

DokuWiki公式・Footer plugin

DokuWiki公式・xbr Plugin

DokuWiki公式・caption Plugin

DokuWiki公式・color Plugin

DokuWiki公式・cleanup Plugin

管理　＞　拡張機能管理　＞　検索とインストール

socialcards pluginをインストールする。

管理　＞　サイト設定

保存をクリック。

twitterNameはOGPのtwitter:siteに対応。
twitterUserNameはOGPのtwitter:creatorに対応。
一般的にどちらも同じ値を設定する。

fallbackImageはOGPのtwitter:imageに対応。

languageTerritoryはOGPのog:localeに対応。

メディアマネージャーを開く。

名前空間を選択でwikiを選択。

アップロードタブから、ogImage.jpgという名前のファイルをアップロード。

ogImage.jpgは504×264サイズの画像にする。
（縦横比1.91:1、Twitterでシェアしたときに綺麗に見えるサイズ）

デフォルトの設定では、twitter:cardの値はsummaryとなっている。
action.phpというファイルを編集することで、twitter:cardの値をsummary_large_imageに変更する。

Twitterでページがシェアされたときに、
summaryは正方形の小さな画像が、
summary_large_imageは長方形の大きな画像が表示される。

cd /home/user1/Dokuwiki/xxx
vi lib/plugins/socialcards/action.php

action.phpを開く。

action.php

        $event->data['meta'][] = array(
            'name'    => 'twitter:card',
            'content' => "summary",
        );

上記のsummaryの部分をsummary_large_imageに書き換え。

action.phpへの編集は、socailcards pluginをアップデートした際にリセットされる可能性がある。

画面右上にある

のようなアイコンをクリックすると、SNSシェアができるようになっている。

管理　＞　サイト設定

保存ボタンをクリック。

DokuWikiの管理画面から、

• SNS シェアリンクを表示するかどうか、
• どのSNS シェアリンクを表示するか

を設定できる。

管理　＞　拡張機能管理　＞　検索とインストール

Socialite Pluginを検索、インストールをクリック。

Socialite Pluginは、
最終更新日が2019-01-01となっている。
（DokuWiki 2020-07-29 “Hogfather”のリリース日よりも古い）

しかし、Compatible with DokuWikiは、
2020-07-29 “Hogfather” となっている。

DokuWiki (Hogfather)のリリースによるプラグインの更新はないが、動作確認は行っているようなので使用しても問題はない。

管理　＞　サイト設定

保存ボタンをクリック。

networksは各自の好みで設定する。
taringaやstumbleuponなど、知名度が低いものは削除。

displayはcolorがおすすめ。
iconに比べてアイコン画像の読み込みが発生しないため表示が速くなる。

wikiの編集画面で、
~~socialite~~と書くと、その位置に

• Twitter
• Facebook
• Google+
• LinkedIn
• Pinterest
• Tumblr
• Reddit
• Email

全ページに一括でSNSシェアボタンを設置する場合は、別途プラグインなどが必要。
（Footer pluginがおすすめ）

Footer pluginを導入すると、全ページまたはカテゴリー単位に一括でフッターを設置できる。

管理　＞　拡張機能管理　＞　検索とインストール

Footer pluginを検索してインストール。

cd /home/user1/Dokuwiki/xxx
vi data/pages/__footer.txt

data/pagesディレクトリに、__footer.txtというファイルを新規作成。

__footer.txt

~~socialite~~

__footer.txtに書いた内容がすべてのページに表示される。

__footer.txtの中ではDokuWikiの記法が使える。

たとえば、サイドバーにはフッターを追加したくないという場合は、
sidebarのページ編集画面に

というテキストを追加すれば、そのページには
__footer.txt
に設定した内容が表示されなくなる。

_footer.txt（アンダースコア1つ）だと、_footer.txtを設置した階層にだけフッターが追加される。
__footer.txt（アンダースコア2つ）だと、__footer.txtを設置した階層およびサブディレクトリーすべてにフッターが追加される。

data/pages/_footer.txt（アンダースコア1つ）を作成すると、

• http://example.com

には、フッターが表示されるが、

• http://example.com/aaa
• http://example.com/aaa/bbb

には、フッターが表示されない。

data/pages/__footer.txt（アンダースコア2つ）を作成すると、

• http://example.com
• http://example.com/aaa
• http://example.com/aaa/bbb

など、すべての階層にフッターが表示される。

data/pagesディレクトリは、名前空間のルート。
URLはhttp://example.com

data/pages/aaaディレクトリは、名前空間aaa
URLはhttp://example.com/aaa

data/pages/aaa/bbbディレクトリは、名前空間aaa:bbb
URLはhttp://example.com/aaa/bbb

上記のような対応関係になっている。

cd /home/user1/Dokuwiki/xxx
vi data/pages/aaa/_footer.txt

data/pages/aaa/_footer.txt（アンダースコア1つ）を作成すると、

• http://example.com/aaa

には、フッターが表示されるが、

• http://example.com
• http://example.com/aaa/bbb

には、フッターが表示されない。

data/pages/aaa/__footer.txt（アンダースコア2つ）を作成すると、

• http://example.com

には、フッターが表示されず、

• http://example.com/aaa
• http://example.com/aaa/bbb

には、フッターが表示される。
（aaa以下のすべての階層にフッターが表示される）

DokuWiki記法では、改行に\\記号を使う。

xbr Pluginを使うと、編集画面での改行が、表示画面でもそのまま改行になる。
（\\の入力をしなくてすむ）

xbr Pluginは長期間メンテナンスがされておらず、
Last updated on（最終更新日）は2012-06-30となっている。

しかし、Compatible with DokuWikiは2020-07-29 “Hogfather”となっているので、DokuWii 2020-07-29 Hogfatherでも動く。

管理　＞　拡張機能管理　＞　検索とインストール

xbrで検索、xbr Pluginをインストール。

管理　＞　サイト設定

レンダラーをxhtml（Dokuwikiコア）からXBR Plugin（プラグイン）に変更する。

保存をクリック。

DokuWiki公式・設定項目: renderer_xhtml

管理　＞　拡張機能管理

caption Pluginをインストール。

管理　＞　サイト設定

デフォルトでは、画像の下に
Figure 1: キャプション
のような表示になるのが
Fig. 1: キャプション
のような表示に変わる。

<figure>
{{http://example.com/xxx.jpg|あああ}}
<caption>いいい</caption>
</figure>

ページ編集画面で上記のような書き方をすると
imgタグのalt属性にあああというテキストが設定され、
画像の下には、Fig. 1: いいいのようなキャプションが表示さ
れる。

管理　＞　拡張機能管理

color Pluginをインストール。

<color red>aaa</color>

上記のような書き方をすると、aaaという文字が赤くなる。

DokuWiki公式・color Plugin

管理　＞　拡張機能管理

cleanup Pluginをインストール。

管理　＞　サイト設定

以前のリビジョンは

• 「過去の文書ファイル」
• 「変更履歴ファイル」

の2つからなる。

「過去の文書ファイル」は、過去の各編集時点でのページの文書ファイル。
「変更履歴ファイル」は、編集日時や編集ページ下部の「編集の概要」に入力した情報が保存されているファイル。

2か月以上経過したページの「過去の文書ファイル」が自動的に削除される。
（./data/attic/xxx.txt.gzのようなファイルが削除される）

2か月以上経過した現存しないページの「変更履歴ファイル」が自動的に削除される。
（./data/meta/xxx.changesのようなファイルが削除される）

DokuWiki公式・cleanup Plugin