{{tag>software}}
====== DokuWiki ======

===== インストール =====

  * ドメイン・サーバの設定
  * 設置
  * (ドメイン).install.phpにアクセス
  * サイトについて入力
  * 元からあるindex.htmlを削除
  * 設定を行う()
  * startページを作成
  * sidebarページを作成
  * サイト設定 → useheading(最初の見出しをページ名とする) → 常に表示する
  * プラグイン導入
  * ページの権限を変える(userだけページ編集できるように)
  * 必要ならアップデートのメッセージを消す→updatecheckをオフにする
===== 拡張プラグイン =====

  * Searchindex Manager → タグを一気に更新
  * Tag Plugin → タグ
  * Discussion → ディスカッション機能
  * Googleanalytics
  * Blog → ブログ
  * Include → ブログ一覧表示
  * indexmenu → 一覧表示

===== Discussion設定 =====

サイト設定 → Discussionから、「すべてのページでdiscussionをオン」にチェックを入れる。

===== サイドバーにタイトルを入れる =====

プラグインのindexmenuはサイドバーにコンテンツの一覧表示するのに便利だ。
しかしそのままではファイル名がそのまま表示されてわかりにくい。ページの最初の見出しがタイトルになるようにする。

管理→サイト設定→「最初の見出しをページ名とする」を「常に使用する」へ。

※外部編集でファイルを追加すると反映されないため、追加したあとブラウザ上で編集を行う。

===== プレフィクスキー =====

ブラウザで編集のとき、ショートカットは
FirefoxだとAlt+Shift+...で、
ChromeだとAlt+...で行える。

MacだとCtrl + Option。いまいましい。

===== ローカルにインストールにするときのパーミッション =====

サーバに設置したときは特に何もしなかった気がするが、ローカルにインストールするときに''install.php''が動かなくて困った。
''777 -R''でパーミッションを設定する。ここらへん行き当たりばったりなのでちゃんとしなきゃな…。
===== テンプレートを作るとき =====

css.phpでテーマ内含むすべてのcssを読み込んでいる模様。開発ツールで見るとcss.phpが巨大ファイルになっていることがわかる。
場所がわからないので、ディレクトリ内検索をして探す。

テーマのcssの例…
  * structure→ヘッダーの長さなど
  * print→見出しなど

後に読み込まれる？ようで、css.phpをそのままにするとbootstrapが効かない。一時的にオフにした。正しいやり方ではない。

===== 横の長さ =====

サイトの横の長さを調整するときは、サイト設定→デザイン→サイトの幅から。
bootstrapを使っているので自動で調整させたいので、ここを空欄にした→エラーになる。

css.phpを読み込まなくてもいけるが、再利用したいところもある。
どうすればいいんだろう？

基本的にすべてテーマの中にcssが入っているハズだから、それらをいじればどうにかなるはずなのだが、見つけられない。

テーマ内を検索してみる。
''width: @ini_site_width''
と書いてある箇所がある。ここだろう。定数、とくにiniから読み取ってるのはこういう特徴があるから、検索するヒントになるな。

ヒットしたiniの箇所を書き換えたが、変わらない！もう強引に''tpl_header''で指定しているであろうclassの箇所を削除した。拡張性一切なし。だけど、テーマ導入だけで見た目が変わるのでまだOK。
本体をいじるのはダメだと思うけど、これぐらいなら。
===== ヘッダーの変なグラデーション =====

モノクロの、ビミョーなグラデーションは画像。
''basic.css''の''body''で指定されているのでコメントアウトした。

===== 目次 =====

目次を右サイドメニューを表示させたい。が、目次はテーマの範囲以上？みたいなので少し考える。

専用の関数があるらしいので、組み込みをオフにして、新しい専用関数をセットしてBootstrapで覆ってあげればよい。
https://www.dokuwiki.org/ja:devel:templates#tpl_toc

===== Blogの日付形式 =====

  %Y:%m%d_
  
===== 簡易カスタマイズ =====

わざわざテーマを作る必要はないけどちょっといじりたいとき。
dokuwikiの、''conf/userstyle.css''を編集する。