DokuWiki（メモ）

このマイウィキという場所（当サイト）はDokuWikiを使って文書を作成。公開しています。

そのウィキソフトウェアであるDokuWikiに関する備忘メモ

DokuWikiの日本語による公式ページ
DokuWikiは、WordPressなどに使用されるMySQLのようなデータベースを前提（必要）としないオープンソースのウィキソフトウェアです。

DokuWikiのシステム要件
DokuWiki は PHP に対応していれば、どんなウェブサーバー上でも動作しますとのことです。

当サイトではWindows系の「IIS（Internet Infomation Services）」での動作確認もしたが、実際的な運用には「.htaccess」を代替する対応が必要になる。
※IISの「Rewriteモジュール」のインストールや「.htaccess」のようにサーバーに置かれる「web.config」ファイルの編集など

Dokuwiki 構文（書き方）
プラグインの記録

パーミッション

ローカルテストサーバーにおけるパーミッション例。

chmod -R 777 data
chmod 777 lib/plugins/
chmod 777 lib/tpl/
chmod 777 conf
chmod 666 conf/*
chmod 777 conf/tpl/

セキュリティ

外部公開されている場合、Webから以下のディレクトリが見えないようにする。
「bin」「conf」「data」「inc」

WebサーバーにApacheの使用を前提としているところがありますが、DokuWikiにデフォルトで設置されている「.htaccess」を有効化します。

確認例
ブラウザから「自分のドメイン/data/pages/wiki/dokuwiki.txt」などにアクセスする。403エラー（アクセス拒否）になればOK

HTTPのステータスコード

DokuWikiのセキュリティのページ

必須バックアップディレクトリ

「data」ディレクトリ
「conf」ディレクトリ
※ とのことですが迅速なリストアの為に、全てバックアップを推奨します。

ロゴの変更

サイトロゴ「/lib/tpl/dokuwiki/images/logo.png」
ファビコン「/lib/tpl/dokuwiki/images/favicon.ico」
スマートフォン「/lib/tpl/dokuwiki/images/apple-touch-icon.png」

を変更する

※ しかしアップデート時に再びデフォルトのロゴに戻ってしまうので…
メディアマネージャから名前空間「Wiki」に画像ファイルをアップロードする。
「/data/media/wiki/」

画像の表示が遅い

「サイト設定」の「メディア」セクションでデフォルトで使用されているPHPのlibGDライブラリからImageMagicのconvertコマンドへ変更する。

※ImageMagicがインストールされている必要があります。
※convertコマンドはmagickコマンドへと置き換えが進められている

カスタムCSS

方式１

conf ディレクトリ直下にCSSファイルを作成する。
「/conf/userall.css」全モード用
「/conf/userstyle.css」ブラウザ表示用
「/conf/userprint.css」印刷用

方式２

dokuwikiテンプレートのCSSディレクトリに作成する。
「/lib/tpl/dokuwiki/css/任意名前.css」を作成
「/lib/tpl/dokuwiki/style.ini」にファイル名とモードを登録

カスタムJS

方式１

conf ディレクトリ直下にJSファイルを作成する。
「/conf/userscript.js」

方式２

dokuwikiテンプレートのJSファイルを直接編集する。
「/lib/tpl/dokuwiki/script.js」

※ DokuWikiは標準でjQueryをサポート。他のライブラリとの競合を避けるため「$()」を使用せず「jQuery()」とする。

<head>タグへのコードの埋め込み

「Google Analytics」や「Google Fonts」などの<head>タグに埋め込むコードは「/lib/tpl/dokuwiki/meta.html」に挿入記述する。

例：Googleタグとウェブフォント読み込みコードを挿入

<?php
    global $INFO;
    if (!$INFO['isadmin']) {
?>

<!-- Googleのタグ (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'G-XXXXXXXXXX');
</script>

<!-- ウェブフォントの読み込み （例：Noto Sans JP）-->
<link href="https://fonts.googleapis.com/css?family=Noto+Sans+JP" rel="stylesheet">

<?php
    }
?>

以前のリビジョンを削除

以前のリビジョンをクリーンアップ

文書ファイル

過去の文書ファイルの場所
「/data/attic/」以下にあるディレクトリとファイルの削除

過去の文書ファイルの変更履歴の場所
「/data/meta/」以下にあるディレクトリとファイルの削除

メディアファイル

過去のメディアファイルの場所
「data/media_attic/」以下にあるディレクトリとファイルの削除

過去のメディアファイルの変更履歴の場所
「/data/media_meta/」以下にあるディレクトリとファイルの削除

キャッシュの削除

DokuWikiの挙動に不調が疑われる場合など有効かもしれません
「/data/cache/」以下にあるディレクトリとファイルの削除

マイウィキ

目次