README.txt

   1 名前
   2     PukiWiki - 自由にページを追加・削除・編集できるWebページ構築スクリプト
   3
   4     Version 1.5.0
   5     Copyright (C)
   6       2001-2016 PukiWiki Development Team
   7       2001-2002 yu-ji (Based on PukiWiki 1.3 by yu-ji)
   8     License: GPL version 2 or (at your option) any later version
   9
  10     URL:
  11       http://pukiwiki.sourceforge.jp/
  12       http://pukiwiki.sourceforge.jp/dev/
  13       http://sourceforge.jp/projects/pukiwiki/
  14
  15     $Id: README.txt,v 1.28 2006/05/29 15:16:24 henoheno Exp $
  16
  17 書式
  18     index.php
  19     index.php?PAGE_NAME_ENCODED
  20     index.php?plugin=PLUGIN_NAME
  21
  22 概要
  23     PukiWiki(ぷきうぃき)は、ハイパーテキストを素早く自由に追加・削除・編集で
  24     きるWebアプリケーション(Wiki, WikiWikiWeb)の一つです。テキストデータから
  25     XHTML 1.1 を生成することができ、そのテキストはWebブラウザから何度でも修
  26     正することができます。それぞれのページは自然にハイパーリンクで結びつける
  27     ことができます。
  28
  29     PukiWikiはグループ間の知識の共有に用いることができますが、個人が自分のた
  30     めのアイデア帖や日記ツールとして活用することも可能です。また、管理者に
  31     だけ「簡単に編集できる」利点を残したまま、閲覧者に対して「編集のできない
  32     Webサイト」として情報を提供する構成も可能です。(この場合、Wiki風のデザイ
  33     ンである必要すらありません)
  34
  35     PukiWikiはPHP言語で書かれたプログラムなので、PHP(PHP4.1.2～PHP5)が動作す
  36     るWebサーバーであれば容易に設置でき、軽快に動作します。
  37
  38     PukiWikiは、yu-jiさんを含む PukiWiki Develpers Team やその貢献者が、各自の
  39     著作物にGPLバージョン2(または _あなたの選択で_ それ以降のGPL)を適用してい
  40     る「フリーソフトウェア(自由なソフトウェア)」です。最新版はPukiWiki公式サイ
  41     トから入手できます。
  42
  43 ページの作成、編集、削除、復旧
  44     1. 「新規」のリンクからページ名(まだそのWikiに存在していないもの)を入力し
  45       たり、既存のページを表示した状態で「編集」のリンクをたどったり、そのペー
  46       ジが置かれるはずのURLに直接アクセスすると、テキストの入力ができる状態に
  47       なります。
  48
  49       ※「凍結」されていたり、「編集が禁止」されている場合は、リンクが存在し
  50         なかったり、そのようなメッセージが表示されるでしょう
  51
  52     2. テキストを入力(ないし修正)し「保存」すると、そのテキストはサーバーに保
  53       存され、すぐに「そのテキストを元にしたWebページ」が表示されます。
  54       「編集」は何度でも繰り返す事ができます。
  55
  56     3. テキストの中に、「大文字始まりの英単語が二つ以上連結された単語」(例え
  57       ば"NewPage")や、二重のブラケットで囲まれた語句(例えば[[新しいページ]])
  58       があった場合、その語句は背景が変化し、末尾に '?' という小さなリンクが挿
  59       入されます(未解決のリンク)。 この装飾は「(表示した時点では)その名前のペ
  60       ージが存在していなかった」ことを示しています。もしもその名前のページが
  61       存在しているならば、その語句の部分は「その名前のページ」を指し示すハイ
  62       パーリンクになります。
  63
  64     4. テキストを全て削除してから「保存」することで、そのページを削除すること
  65        ができます。いたずらを検知するため、削除された事実は専用のページ
  66        [[RecentDeleted]] に記録されます。
  67
  68        ※削除した理由が明確でない場合、他の参加者はそのページを復旧させること
  69          ができます。
  70
  71     5. テキストの編集履歴は自動的に記録(バックアップ)されます。設定によります
  72        が、バックアップは既定の時間が経過するか、毎回編集するたびに行われま
  73        す。バックアップされたデータがあるならば、それを使いコンテンツを当時の
  74        状態に復旧することができます。バックアップデータを完全に削除することは
  75        管理者にしかできません。
  76
  77 テキストの整形ルール
  78     テキストをWebページ(HTML/XHTML)としてうまく出力させるため、「どのようなテ
  79     キストを書くと、どのようなHTML/XHTMLになるのか」、という部分に一定のルール
  80     (書式)が決められています。こちらについては [[help]] [[FormattingRules]] の
  81     ページを参照してください。
  82
  83     テキストに書き込んだ「HTMLエンティティ(HTMLにおいて、特殊な文字を表示させ
  84     るためのエスケープ文字列のようなもの)」はほぼそのまま表示されます。一部の
  85     文字は、HTMLエンティティで記述する必要があるかもしれません。
  86     (例: "&" => "&amp;")
  87
  88     テキストデータでの改行を、XHTMLの出力でもそのまま改行(<br />)として反映さ
  89     せたい場合、あるいは行間を空けたい場合:
  90       1. 設定 $line_break の内容を切り替えることで全体の動作が変わります
  91       2. #setlinebreak プラグインで行単位に操作する事が可能です
  92       3. 行末に "~" を追加すると、その行の改行が無視されなくなります
  93       4. brプラグイン(&br;) を文中に追加すると、そこで改行します
  94       5. brプラグイン(#br) で、一行分の空間を空けることができます
  95
  96     WikiName (大文字始まりの英単語が二つ以上続いた単語) に対する自動リンク機
  97     能を無効にするには、設定 $nowikiname の内容を切り替えて下さい。
  98
  99     AutoLink (既存のページに対するリンクを自動的に作成する機能)を無効にした
 100     り、有効とみなすページ名のバイト数を修正する場合、設定 $autolink の値を
 101     修正して下さい。
 102
 103 ページの編集を禁止するには
 104     以下のような方法があります。
 105
 106     1. 定数 PKWK_READONLY により、PukiWiki全体を書き込み禁止にする
 107       これは閲覧専用のPukiWikiを用意するためのオプションです。
 108       既存のPukiWikiのミラーサイトを構築したり、情報提供用のサイトを構築するた
 109       めに活用することができます。有効/無効にするためには管理者による設定変更
 110       が必要です。 (詳しくは: BugTrack/744)
 111
 112     2. 編集認証($edit_auth)により、指定したパターンに合致するページの編集を禁
 113      じる
 114       指定したパターン(例えば "Aで始まるページ名")に合致するページに対し、特定
 115       のアカウントにだけ編集を許可するためのオプションです。
 116       ユーザーの設定などは管理者による設定変更が必要です。
 117       編集認証は「ページの中身」「ページ名」いずれかに対してかける事ができま
 118       す。パターンの指定は正規表現で行います。
 119
 120     3. 「凍結」機能により、ページ単位に編集を禁じる/許可する
 121       凍結/凍結解除には管理者パスワードが必要です。
 122       ページを書き換えるプラグイン(例: #comment プラグイン)は凍結されたページ
 123       の中でも動作しますので、それらをページに含めた場合、管理者が定期的にそ
 124       のページをクリンナップする必要があるかもしれません。
 125
 126     4. 指定したページの編集を禁じる($cantedit)
 127       ページ名を事前に指定しておく事により、通常の操作によるそのページの編集
 128       を禁じる事ができます。RecentChangesなどはこの機能を利用しています。
 129       設定を追加/削除するためには管理者による設定変更が必要です。
 130
 131 ページを秘密にする、パスワードを秘密にする
 132     PukiWiki全体を秘密の場所に置くことは簡単です。認証や暗号化をかける場合、
 133     そのWebサーバーに関する知識が必要です。
 134
 135     1. Webサーバーの機能によって、PukiWikiを設置しているフォルダにベーシック
 136        認証や、ダイジェスト認証などをかけることができるでしょう。
 137
 138     2. Webサーバーの機能によって、SSL(TLS)で通信経路を暗号化することができる
 139       でしょう。これによってベーシック認証のパスワードやコンテンツを盗聴され
 140       たり、何らかのきっかけでそれらが漏洩する可能性を低下させることができま
 141       す。
 142
 143     PukiWikiのコンテンツを「部分的に」秘密にするためには、PukiWikiの複数の設
 144     定やプラグインに関する知識が必要です。以下にいくつかの注意点をまとめます。
 145
 146     1. 公開用の入り口(index.php)とは別に編集用の入り口(例えばsecret.php)を用
 147       意し、それぞれの設定を調整/改造することができます。
 148
 149      例:
 150       * 公開するPukiWikiの編集を PKWK_READONLY で禁止する
 151       * 編集用の入り口では、編集認証と閲覧認証を全てのページ名に適用する
 152         (正規表現では '')
 153
 154     2. 編集認証($edit_auth) と 閲覧認証($read_auth) を利用する場合、それぞれ
 155        の対象が一致するように設定する必要があります。例えば閲覧認証だけをかけ
 156        ている場合、編集行為によってコンテンツが漏洩する可能性があります。
 157
 158     3. MenuBarやヘッダ/フッタは、編集認証/閲覧認証の影響を受けません。
 159        (詳しくは:続・質問箱/11)
 160
 161     4. 他のページを雛型としてロードする機能($load_template_func)は、閲覧認証
 162        の影響を受けません。現状の回避策は、この機能を無効にすることです。
 163        (詳しくは:BugTrack/598)
 164
 165     5. あまり利用されていない一部のプラグインは、編集認証/閲覧認証に対応して
 166        いません。そのためにページのコンテンツやページ名が漏洩する可能性があり
 167        ます。編集認証/閲覧認証に頼る場合はこれらを事前に削除する必要がありま
 168        す。(例:BugTrack/511)
 169
 170 プラグインについて
 171     プラグインを組み込むことで、PukiWikiに様々な機能を追加/拡張することができ
 172     ます。PukiWikiには70を越える標準添付のプラグインの他に、多数の自作プラグ
 173     インが存在しています。
 174
 175     プラグインのスタイルは大きく分けて三種類あります。多くはWebコンテンツ(静
 176     的なもの/動的なもの)を出力しますが、それ以外の動作をするものも存在します。
 177
 178     ブロック型プラグイン(block/convert)
 179        行単位に特殊なWebコンテンツを挿入するものです。
 180        ※コメント欄(#comment)、目次(#contents)、配下のページを一覧(#ls2)、最
 181          新のN件(#recent)、ページのインクルード(#include)、投票ボックス
 182          (#vote)など
 183
 184     インライン型プラグイン(inline)
 185        HTMLエンティティを拡張した文字列をテキストの途中に挿入することで、
 186        文章の途中にWebコンテンツを挿入するものです。
 187        ※文章の色と背景色の操作(&color(red,yellow){文字列};)など
 188
 189     アクション型プラグイン(action)
 190        プラグインごとに独自の効果を発揮するものです。
 191        ※Wikiページの表示(read)、RSSの出力(rss)、ページ名の変更(rename)など
 192
 193 文字列置換ルール
 194     いくつかの機能は、プラグインではなく文字列の置換か、それとの組み合わせに
 195     よって実現されています。
 196
 197     テキストを表示する際にWebコンテンツと置き換えるタイプ
 198        ※ハートマーク(&heart;)の描画、顔文字を画像に置き換える機構など
 199
 200     テキストを保存する瞬間に置き換え、結果を保存するタイプ
 201        ※&now; を、「その時の現在時刻」に置き換える機構など
 202
 203 InterWikiについて
 204     InterWiki とは、WikiとWikiをつなげる機能です。例えば
 205     [[Wikiサイト名:ページ名]]
 206     このように記述することで、そのWikiの特定のページに対するリンクを簡単に出力
 207     させる事ができます。
 208     ※Wiki以外のサイト、例えば検索エンジンへのURIを生成することも可能です
 209
 210     InterWikiを活用したテキストフォームは #lookup プラグインによって作成するこ
 211     とができます。
 212
 213     この機能は Tiki からほぼ完全に移植されています。
 214     詳細は [[InterWiki]] のページを参照してください。
 215
 216 Wikiの様子を見る
 217     Wikiの更新状況(更新された順に並べた一覧)は RecentChanges という特殊なペー
 218     ジからチェックすることができます。
 219
 220     #recentプラグインはこの内容をコンパクトなリストとして表示します。
 221       ※デフォルトでMenuBarに追加されています
 222
 223     rssプラグインはこの内容をRSSのフォーマットで提供することができます。
 224       出力方法の例:
 225         RSS 0.91 index.php?plugin=rss
 226         RSS 1.0  index.php?plugin=rss&ver=1.0
 227         RSS 2.0  index.php?plugin=rss&ver=2.0
 228
 229 関連項目
 230     INSTALL.txt (インストールとアップグレード)
 231
 232     標準添付されているプラグインの簡潔な説明は、[[PukiWiki/1.4/Manual/Plugin]]
 233     のページを参照して下さい。
 234
 235     その他、リリース版の基本的な使い方に関する情報はPukiWiki公式サイト
 236     をご覧下さい。以下のようなコンテンツが特に有用です。
 237
 238     FAQ        http://pukiwiki.sourceforge.jp/?FAQ
 239     質問箱     http://pukiwiki.sourceforge.jp/?%E8%B3%AA%E5%95%8F%E7%AE%B1
 240     続・質問箱 http://pukiwiki.sourceforge.jp/?%E7%B6%9A%E3%83%BB%E8%B3%AA%E5%95%8F%E7%AE%B1
 241
 242 バグ
 243     PukiWikiのセキュリティに関する情報は以下でまとめられています。
 244     http://pukiwiki.sourceforge.jp/?PukiWiki/Errata
 245
 246     バグ報告は devサイトまでお願いします。
 247     (我々はPukiWikiでPukiWikiのバグトラッキングを行っています)
 248     http://pukiwiki.sourceforge.jp/dev/?BugTrack2
 249
 250 歴史
 251     PukiWikiは、結城浩さんが作られたYukiWikiの仕様を参考に独自に開発されまし
 252     た。PukiWiki バージョン1.3まではyu-jiさんが個人で製作していました。
 253
 254     バージョン1.2.1 から、RecentChangesのRDF/RSSを出力できるようになりました。
 255
 256     バージョン1.3.1b 以降はPukiWiki Development Team によって開発が続けられて
 257     います。
 258
 259  　 バージョン1.4.5 から、RSS 2.0 を出力できるようになりました。
 260
 261 謝辞
 262     PukiWiki Develpers Teamの皆さん、PukiWikiユーザの皆さんに感謝します。
 263     PukiWiki を開発した、yu-ji(旧sng)さんに感謝します。
 264     YukiWiki のクローン化を許可していただいた結城浩さんに感謝します。
 265     本家のWikiWikiを作ったCunningham & Cunningham, Inc.に 感謝します。
 266
 267     * yu-jiさんのホームページ   http://factage.com/yu-ji/
 268     * 結城浩さんのホームページ  http://www.hyuki.com/
 269     * YukiWikiホームページ      http://www.hyuki.com/yukiwiki/
 270     * Tiki          http://todo.org/cgi-bin/tiki/tiki.cgi
 271     * 本家WikiWikiWeb       http://c2.com/cgi/wiki?WikiWikiWeb
 272     * WikiWikiWebの作者(Cunningham & Cunningham, Inc.) http://c2.com/