差分
このページの2つのバージョン間の差分を表示します。
両方とも前のリビジョン 前のリビジョン 次のリビジョン | 前のリビジョン | ||
dokuwiki:dokuwiki_memo [2009/06/12 00:10] kaburaya |
dokuwiki:dokuwiki_memo [2012/03/07 14:28] (現在) kaburaya |
||
---|---|---|---|
行 1: | 行 1: | ||
====== DokuWiki 覚書 ====== | ====== DokuWiki 覚書 ====== | ||
+ | この覚書は 2009 年前半に DokuWiki Release 2008-05-05 および Release 2009-02-14 を導入したときに書き始めたもので、その後ときどき加筆しています。 | ||
+ | |||
===== 要点 ===== | ===== 要点 ===== | ||
行 11: | 行 13: | ||
* ページ右下の「索引」ボタンで、**記事一覧**を表示。 | * ページ右下の「索引」ボタンで、**記事一覧**を表示。 | ||
* 見出しごとにアンカーが作成されるが、そのラベルが見出しの内容になり、日本語の場合は日本語になる。 | * 見出しごとにアンカーが作成されるが、そのラベルが見出しの内容になり、日本語の場合は日本語になる。 | ||
- | * 「サイト設定」でページ名を「ローマナイズ」にすると、アンカーラベルのひらがながローマ字になるが、漢字はそのままなので、利点がない。 | + | * 「サイト設定」でページ名を「ローマナイズ」にすると、ページ名やアンカーラベルのひらがな・カタカナがローマ字になるが、漢字はそのままなので、利点がない。 |
* アンカーが日本語でも「目次」の一覧からのジャンプなどはできている。 | * アンカーが日本語でも「目次」の一覧からのジャンプなどはできている。 | ||
* 編集ウィンドウの下に「サマリーを編集」という入力欄が表示されるが、この内容は本文に保存されるのではなく、RSS や差分につける要約となる。 | * 編集ウィンドウの下に「サマリーを編集」という入力欄が表示されるが、この内容は本文に保存されるのではなく、RSS や差分につける要約となる。 | ||
行 21: | 行 23: | ||
* パスワード送付の差出人メールアドレスは、あらかじめ「サイト設定」で指定しておいたほうがよい。(そうでないと、サーバーにログインしたユーザーに付随するメールアドレスが使用される。) | * パスワード送付の差出人メールアドレスは、あらかじめ「サイト設定」で指定しておいたほうがよい。(そうでないと、サーバーにログインしたユーザーに付随するメールアドレスが使用される。) | ||
* パスワードはログイン後、「ユーザー情報の更新」から変更できる。 | * パスワードはログイン後、「ユーザー情報の更新」から変更できる。 | ||
- | * 画像などのメディアファイルをアップロードしたとき、各ページのソースファイルとは別のフォルダに、カテゴリごとに分けて格納される。 | + | * 画像などのメディアファイルをアップロードしたとき、各ページのソースファイルとは別のフォルダに、カテゴリごとに分けて格納される。画像に IPTC 情報などがあれば、detail.php で画像の詳細表示をする際に、指定されている項目が表示される。また、アップロード後にメディアマネージャから画像にタイトルや説明を付加した場合は、画像ファイルの IPTC 情報としてファイル内に保存される。 |
+ | * メッセージなどの日本語対応ファイルは inc/ | ||
+ | * 初期設定では、ページが編集された後、一定時間が経過しないとサーチエンジンの検索対象にならないよう、編集直後は「< | ||
* [[syntax_summary]] | * [[syntax_summary]] | ||
* [[japanese_handling|日本語の扱い]] | * [[japanese_handling|日本語の扱い]] | ||
- | ====== インストール | + | ===== インストール ===== |
* [[http:// | * [[http:// | ||
- | * まず上記ページから [[http://dev.splitbrain.org/download/darcs/dokuwiki-downloader/dokuwiki-downloader.php|dokuwiki-downloader.php]] をダウンロードしてローカルに保存する。 | + | * まず上記ページから [[http://www.dokuwiki.org/lib/exe/fetch.php? |
- | * このスクリプトを DokuWiki を設置したい場所にアップロードして、スクリプトを走らせると、DokuWiki の配布ファイル(tarball)をサーバーにダウンロードし、ファイルを解凍し、インストーラの起動までが自動で行われる。現在このスクリプトが取ってくるのは 2009-02-14 のバージョンだが、バージョンが上がればダウンロードスクリプトも対応されるだろうし、そうでなくてもスクリプトの最初の $VERSION のところを変更すればよい。 | + | * このスクリプトを DokuWiki を設置したい場所にアップロードして、スクリプトを走らせると、DokuWiki の配布ファイル(tarball)をサーバーにダウンロードし、ファイルを解凍し、インストーラの起動までが自動で行われる。現在このスクリプトが取ってくるのは 2009-02-14 のバージョンだが、バージョンが上がればダウンロードスクリプトも対応されるだろうし、そうでなくてもスクリプトの最初の $VERSION のところを変更すればよい。 |
* 実際に別の場所でやってみましたが、すべてが非常に迅速に完了しました。 | * 実際に別の場所でやってみましたが、すべてが非常に迅速に完了しました。 | ||
* PHP が CGI モードで動いている場合はパーミッションの問題がないが、Apache Handler で処理される mod_php だと手作業でディレクトリのパーミッションを変更する必要が出てくる(「書き込み処理ができませんでした」という内容のエラーになる)ことがある。 | * PHP が CGI モードで動いている場合はパーミッションの問題がないが、Apache Handler で処理される mod_php だと手作業でディレクトリのパーミッションを変更する必要が出てくる(「書き込み処理ができませんでした」という内容のエラーになる)ことがある。 | ||
- | |||
* **URL をカスタマイズしてリンクから doku.php を消すのは、.htaccess で mod_rewrite が使える環境であれば、附属の .htaccess.dist のいちばん下にある一群の RewriteRule をそのまま使うと簡単にできる。** (だいぶ上にある RewriteEngine on も必要。) | * **URL をカスタマイズしてリンクから doku.php を消すのは、.htaccess で mod_rewrite が使える環境であれば、附属の .htaccess.dist のいちばん下にある一群の RewriteRule をそのまま使うと簡単にできる。** (だいぶ上にある RewriteEngine on も必要。) | ||
* 有志の尽力による [[doku> | * 有志の尽力による [[doku> | ||
行 42: | 行 45: | ||
<code php> | <code php> | ||
<?php | <?php | ||
- | //date_default_timezone_set(" | + | //putenv("TZ=Asia/Tokyo"); // for PHP4 |
date_default_timezone_set(" | date_default_timezone_set(" | ||
?> | ?> | ||
</ | </ | ||
- | * [[templates]] | + | * [[doku> |
* [[doku> | * [[doku> | ||
行 56: | 行 60: | ||
* main.php -- すべてのページで読み込む基本的な要素についての設定。 | * main.php -- すべてのページで読み込む基本的な要素についての設定。 | ||
* mediamanager.php -- 「イメージやファイルの追加」ボタンをクリックしたときに表示されるページの内容。 | * mediamanager.php -- 「イメージやファイルの追加」ボタンをクリックしたときに表示されるページの内容。 | ||
- | |||
* footer.html -- すべてのページに共通のフッタの内容の設定。 | * footer.html -- すべてのページに共通のフッタの内容の設定。 | ||
* スタイルについては lib/tpl ディレクトリの下の使用中のスタイルの CSS ファイルを直接編集する。(最初からあるのは default スタイルなので、これを別名で保存して初期状態のコピーを確保してから編集するか、別名で保存したコピーを編集する。) | * スタイルについては lib/tpl ディレクトリの下の使用中のスタイルの CSS ファイルを直接編集する。(最初からあるのは default スタイルなので、これを別名で保存して初期状態のコピーを確保してから編集するか、別名で保存したコピーを編集する。) | ||
* lib/tpl の style.ini では、どのスタイルシートファイルをどの場合に使用するか、という設定と、さまざまな部分に共通に使うベース色が設定されている。(基本の色設定はここで行うほうが CSS ファイルが簡潔になる。) | * lib/tpl の style.ini では、どのスタイルシートファイルをどの場合に使用するか、という設定と、さまざまな部分に共通に使うベース色が設定されている。(基本の色設定はここで行うほうが CSS ファイルが簡潔になる。) | ||
- | |||
- | |||
==== doku.php を index.php にしたい場合 ==== | ==== doku.php を index.php にしたい場合 ==== | ||
行 69: | 行 70: | ||
RewriteRule (.*) index.php? | RewriteRule (.*) index.php? | ||
- | # | + | # |
* ファイル内で doku.php に言及している部分を index.php に変更する。 | * ファイル内で doku.php に言及している部分を index.php に変更する。 | ||
- | | + | |
==== トップページを start から index に変更したい場合 ==== | ==== トップページを start から index に変更したい場合 ==== | ||
+ | |||
* 「管理」-「サイト設定」で「スタートページ名」を「index」にする。 | * 「管理」-「サイト設定」で「スタートページ名」を「index」にする。 | ||
* これに該当するデータファイルは data/pages/ の index.txt になる。(ダウンロードしてローカルで編集できる。) | * これに該当するデータファイルは data/pages/ の index.txt になる。(ダウンロードしてローカルで編集できる。) | ||
* この変更で各ディレクトリ内でファイル名指定がない場合に表示されるファイルが index.txt になる。 | * この変更で各ディレクトリ内でファイル名指定がない場合に表示されるファイルが index.txt になる。 | ||
+ | |||
+ | ==== favicon.ico のカスタマイズ ==== | ||
+ | |||
+ | * / | ||
+ | |||
+ | ==== 表示される用語のカスタマイズ ==== | ||
+ | |||
+ | * DokuWiki 本体に付属の各国語インタフェースの用語は inc/lang/ にある。日本語のインタフェースをカスタマイズするには、この中の ja フォルダにあるファイルを編集する。実際に動かして表示される文字列で Grep をかけると変更すべき箇所が探しやすい。 | ||
+ | * プラグインの日本語インタフェースは lib/ | ||
+ | |||
+ | ==== ツールチップに表示される略語ヘルプのカスタマイズ ==== | ||
+ | |||
+ | |||
+ | |||
+ | * [[doku> | ||
+ | |||
===== 動作状況 ===== | ===== 動作状況 ===== | ||
+ | |||
このセクションは運用状況に応じて更新します。 | このセクションは運用状況に応じて更新します。 | ||
行 92: | 行 111: | ||
* ページの雛形を使う機能もある。ページ作成時に同じカテゴリにある「_templtate.txt」というファイルが雛形として使用される。 | * ページの雛形を使う機能もある。ページ作成時に同じカテゴリにある「_templtate.txt」というファイルが雛形として使用される。 | ||
* Wiki 全体の表示スタイルを変更するには、 [[doku> | * Wiki 全体の表示スタイルを変更するには、 [[doku> | ||
- | | ||
===== よさそうな特徴 ===== | ===== よさそうな特徴 ===== | ||
- | * データベース不要で、そのわりに処理速度は速いらしい。データは記事ごとのテキストファイル。 | ||
- | * データのバックアップには、/ | ||
+ | * データベース不要で、そのわりに処理速度は速いらしい。**データは記事ごとのテキストファイル。** | ||
+ | * データの **バックアップ** には、/ | ||
* 編集用の「見出し」や「リスト」タグ自動入力ボタンが期待以上に便利。 | * 編集用の「見出し」や「リスト」タグ自動入力ボタンが期待以上に便利。 | ||
- | * あらかじめ記法にそったテキストファイルを作成して、それをアップロードすることでも、記事が追加できる。 | + | * あらかじめ記法にそった |
- | * DokuWiki 記法は、テキストファイル(ソースファイル)の状態で見出しやリストのレベルが判別しやすく、テキストエディタでの読み書きがしやすい。 | + | * DokuWiki 記法は、テキストファイル(ソースファイル)の状態で |
* ファイル名を英数半角にしつつ、記事タイトルを日本語にし、かつ、記事一覧でもこの日本語を表示させることが、useheader 設定により可能。 | * ファイル名を英数半角にしつつ、記事タイトルを日本語にし、かつ、記事一覧でもこの日本語を表示させることが、useheader 設定により可能。 | ||
+ | * 編集途中で公開したくないが、保存はしておきたいファイルや、一時的に非公開にしたいファイルは、ファイル名の先頭に「_」(アンダースコア)をつけておくと、**記事一覧(索引)での表示や閲覧を回避** できる。(管理画面からアクセス制限をかけるより便利。) | ||
* ページ内のセクションごとの編集ができる。 | * ページ内のセクションごとの編集ができる。 | ||
* ページの右上に表示される「目次」(TOC) はなかなか便利。 | * ページの右上に表示される「目次」(TOC) はなかなか便利。 | ||
行 110: | 行 128: | ||
* ページの左上に「現在位置」を表示できるのが好み。(「サイト設定」で表示を選択) | * ページの左上に「現在位置」を表示できるのが好み。(「サイト設定」で表示を選択) | ||
* デフォルトでは左上に「トレース」が表示されている。これは移動履歴の表示。これも便利かも。 | * デフォルトでは左上に「トレース」が表示されている。これは移動履歴の表示。これも便利かも。 | ||
+ | |||
+ | ===== 作業手順メモ ===== | ||
+ | |||
+ | * リンク切れを起こさずにファイル名(記事ファイルの実体名)を変更するには。 | ||
+ | * ファイル名を変更する前にブラウザから記事を開いて、記事タイトル部分をクリックし、**バックリンク** を表示する。 | ||
+ | * このファイルにリンクしている文書の一覧が表示されるので、これをメモ。 | ||
+ | * ファイル名を変更するとともに、リンク元一覧にあるリンクを修正。 | ||
+ | |||
+ |