Walrus,Digit. | 一覧 | 検索 | 更新履歴(RSS) | 新規作成
はてなブックマークに追加 はてなブックマークを表示 編集 | 編集(管理者用) | 差分

WalWiki

編集

about WalWiki

はてなブックマークを表示 はてなブックマークに追加 リンク 編集

WalWikiは、WikiWiki CloneのYukiWiki (結城ウィキィ）に、いくつかの機能追加をしたものです。

WikiWikiは次のような特徴のシステムです。

最初のWikiWikiなCGIは「WikiWikiWeb」ですが、この仕組みには多くの人が夢中になり、同様の特徴をもつWikiWikiCloneと呼ばれるシステムはどんどん種類が増えていきました

そのWikiWikiCloneの中で、日本産、国内でポピュラーなものに、結城浩?氏が発表されたYukiWikiがあります。 この使いやすく、カスタマイズも容易なCGIをベースに、いくつかの機能を追加してWalWiki（Walrus YukiWiki）としました。

WalWikiは、WikiWikiやYukiWikiと同様、フリーウェアです。 GPLの元、自由に使い、改造し、再配布できます。

WalWikiの入手と設置

編集

現在の正式版は、YukiWiki 2.1.2aをベースにした、2.1.0版です。設置方法などの詳細は「WalWiki/入手と設置」をご確認ください。

YukiWiki 1.xベースのWalWikiの最終版は1.6.7.wal.2版です。 YukiWiki 2.0.xベースのWalWikiの最終版は2.0.5.wal.5.2版です。 2.0.4.wal.2までのWalWikiと、2.0.4までのYukiWiki2にはXSS脆弱性があります。 また、上記のYukiWiki1系ベースのWalWikiはXSS脆弱性などセキュリティについては検証されていません。 特別な事情が無い限り、YukiWiki2.1をベースとした最新版をお使いください。

ベースバージョンlzhファイルtar+gzファイル
YukiWiki 1.x1.6.7.wal.2WalWiki.lzh-
YukiWiki 2.x2.0.5.wal.5.2WalWiki2.lzhWalWiki2.tar.gz

ページ・データの移行

編集

WalWiki 2.1のデータは、YukiWiki 2.xやWalWiki 2.0とほぼ同じです。そのまま、wiki、diff、infoといったデータをコピーすることで、WalWiki 2.1でページ・データを使用することができます。

なお、次のようなケースでは、ページ・データを変換してやる必要があります。

  • YukiWiki 1.xのページデータを使用する
  • データベースを変更する（例：dbmopenからYukiWikiDBに変更）
  • 文字コードを変更する（例：eucからUTF8に変更）

この時は、WalWiki2.1/移行ツールを使用して、データを移行してください。

ページ・データの共用

編集

YukiWiki2.xとWalWiki 2.1では、データ構成はほとんど変わりません。

  • YukiWiki2.xのデータをWalWiki 2.1のデータに上書きした場合、それは問題なく表示されます。
  • WalWiki2.1のデータをYukiWiki2.xのデータに上書きした場合、WalWikiで拡張された別名、ISBN用のInterWikiなどが動作しないだけで、それ以外は問題なく表示されます。
  • YukiWiki2.xとWalWiki2.1で、同じ$modifier_dir_dataを指定して、並行運用することすら可能です。

追加機能

編集

WalWiki/YukiWikiからの変更点をご覧下さい。

これらの機能が不要な時は、YukiWikiをお使いいただけばよいと思います。 これらの機能が必要な時だけ、WalWikiをお使いください。 上述のとおりYukiWikiからWalWikiへはそのままデータを持ち越せますので、念のために最初からWalWiki、とする必要はないと思います。

スクリプトの相違

編集

WalWikiは、できるだけYukiWikiのスクリプトを崩さないように作成されています。

また、先頭のコメント部には追加した機能が番号つきでリストされています。 これは、変更部分のコメント行に入れられている番号と対応しています。 変更部分に興味があれば、一度diffを取ってみてください。 もし、自分用にYukiWikiを改造する際、これらの一部の機能が必要であれば、お好きなようにその部分だけをご利用ください。

まずは書いてみる

編集
1. 編集モードにする
「編集」をクリックします。すると中央にテキストエリアが作成され、編集前のページの内容が表示されます。
2. 書き込む
テキストエリアをスクロールさせて、一番下まで持っていきます。次に、空行を1行ほど入れて「(あなたの名前)が書き込んでいます。ホームページは(あなたのホームページのURL)です。」と入力します。
3. プレビュー
多くのWikiでは、実際に書き込む前に、編集結果を「プレビュー」で確かめることになっています。テキストエリアの下の「プレビュー」ボタンを押します。
4. 更新する
編集結果が、実際にWikiでどう表示されるかというプレビューが表示されます。表示に問題がなければ「ページの更新」をクリックします。ここでさらに修正を加えてから、「再度プレビュー」や「ページの更新」をしても構いません。

これで、ページ内にあなたの名前と、ホームページのアドレスが追記されたはずです。 ホームページへのアドレスは、ちゃんとリンクになっています。

練習ページを開く

編集

Wikiでは普通、「SandBox」というページを練習用にします。 YukiWikiなど日本語でページを作れる場合は、「練習用ページ」という名前にしていることもあります。 このページを開きましょう。

1. 練習用ページを探す
「一覧」をクリックします。すると、現在のページの一覧が表示されます。
2. 練習用ページを開く
練習用の「SandBox」か「練習用ページ」というページを探します。もし見つかれば、その練習用のページのタイトルをクリックします。すると、練習用のページが開かれます。
3. 練習用ページを作る
練習用のページがないときは、作ることにします。まず「トップ」をクリックして、トップページに移ります。次に、「編集」をクリックして、編集状態にします。編集用のテキストエリアに次の2行を書き込みます。「Sand」と「Box」の間はくっつけてください。書き込んだら、プレビューし、更新します。
   ----
   練習は「SandBox」でどうぞ。
4. 練習用ページを開く
SandBoxの文字の脇に、「?」がついているはずです。この「?」をクリックすると、練習用のページ「SandBox」が編集状態で開きます。

Wikiを設置した人も、練習用ページを作ってそちらで練習をしてもらえることは、歓迎してくれるはずです。 練習用ページでは、自由に書き込み、削除をしてみましょう。

WalWikiの変換ルール

編集

Wikiの特徴は、書き込んだテキストがいくつかのルールで変換されることです。 例えば、リンクになるもの、リストになるもの、表になるもの、強調表示されるものや斜体表示されるものなどがあります。

WalWikiの変換ルールは、次のようにYukiWikiに拡張を加えたものになります。 言葉だけだと分かりにくい部分があります。 実際に、練習用のページで試してください。

テキスト

編集

改行、段落

  • 改行は無視されます。
  • 空行があると、そこで段落の切れ目だと判断されます。

整形済みテキスト

  • 行の先頭に半角空白かTABを入れると、その行は整形済みテキストとして扱われます。
    • この部分では、空白や改行がそのまま表示されるので、書き込んだとおりのレイアウトになります。
    • ソースコードやアスキーアート（文字や罫線で作った地図、絵）などを載せる時に使います。

水平線

  • 行頭から、ハイフンを4つ連続でおく（"----"）と、水平線が引かれます。

強調

  • シングルクォート2つで挟まれた部分は太字、3つで挟まれた部分は斜体、5つで挟まれた部分は太字の斜体で表示されます。
    • 例えば、' '～' 'とすると太字、' ' '～' ' 'とすると斜体、' ' ' ' '～' ' ' ' 'とすると太字で斜体といった具合です。

リンク

編集

直接リンクを書き込むことができます。

  • http:～、https:～、ftp:～、mailto:～などは、直接リンクが貼られます。
  • リンク先が画像（http、https、ftpで始まってgif、jpg、jpeg、pngで終る）場合は、その画像がインライン表示されます。

Wiki NameでこのWiki内の別ページへのリンクを作れます。

  • 大文字ではじまる英単語を2語以上つなげて書いたものが、Wiki Nameです。Wiki Nameは、このWiki上の別ページへのリンクになります。
    • Wiki Nameには「WikiWiki」「PerlBook」のような単語が含まれます。
    • また、WalWikiでは「PerlCE」のように、大文字で始まる英単語 + 大文字を含む英文字列という形式もWiki Nameに含まれるようになっています。
  • そのページがもう作られていれば、クリックするとそのページに飛びます。
  • まだ作られていないときはそのページが編集用で開きます。

Bracket NameでもこのWiki内の別ページへのリンクを作れます。

  • [[ と ]]で挟まれた、空白を含まない文字列がBracket Nameです。
    • 数字や記号（コロン、ピリオド、カンマ、アンダーバー、ハイフンなど）、日本語などを含められることです。
    • 例えば「塚本牧生」のようなものがBracket Nameに含まれます。
  • Bracket NameはWiki Nameと同じように、このWiki上のページへのリンクになります。

Alias Nameで、リンクに別名をつけることができます。

  • [[ 別名 リンク ]]のように、別名、空白、リンクを[[ と ]]で挟んだものがAlias Nameです。
    • 別名とリンクはどちらも空白を含んではいけません。
    • これまでのリンクは、文字列とリンク先が一緒でしたが、Alias Nameでは表示されるのは別名、リンク先はリンクの方になります。
  • リンクにはURL、Wikiのページ名、Amazon Nameのどれを入れても構いません。
  • また、通常はBracket Nameにするようなページ名も、そのままリンクに書いて構いません。

特殊なブロック

編集

特殊なブロックの作り方は、実際にやってみるとよく分かります。 それぞれに例をつけますので、先頭の空白を取り除き、練習ページに貼り付けてみてください。

リストを作成することができます。

行頭に1つから3つのハイフン（"-"、"--"、"---"）をおき、その後にテキストを続けると、リストに変換されます。 ハイフンの数が多いほど、深くインデントされます。 例えば、以下はWikiの機能一覧です。 

- Wikiの機能
-- 編集
--- 強調表示が可能
--- URLは自動でリンク
--- 水平線やリスト、表の作成が可能
-- 一覧の表示
-- 最終更新の表示
-- 差分の表示
-- 本文の検索

用語リストを作成することができます。

先頭にコロン、単語を書き込んでコロン、その後に説明、という書き方で用語リストを作れます。 

:WikiWiki Web:最初のWiki
:YukiWiki:結城浩氏によるWiki。日本語名のページが作れる。
:Walrus YukiWiki:YukiWikiを元にした塚本のWiki。表を作れたりとかいろいろ。

表を作ることができます。

先頭にカンマを入れ、CSVデータを書き込むと表に変換されます。 例えば、以下はWikiの表です。 

,Wikiシステム名  ,  特徴    
,WikiWiki Web    ,最初のWiki
,YukiWiki        ,結城浩氏によるWiki。日本語名のページが作れる。
,Walrus YukiWiki ,YukiWikiを元にした塚本のWiki。表を作れたりとかいろいろ。

カンマの後、データの前に空白を入れると右寄せになります。 データの前後に空白を入れると、センタリングされます。 この辺りは、ほぼ見た目どおりのはずです。

データに「==」のようにイコール2つだけ書き込むと、左のセルに連結されます。 

, Wikiシステム    ,==
,WikiWiki Web    ,最初のWiki

データを、ダブルクォーテーションで挟んでやるとカンマを含めることができます。 データの中にダブルクォーテーションを使いたいときは、ダブルクォーテーションを2重に書きます。 

, カンマを含むセル , ダブルクォーテーションを含むセル    
,"       1,234,567"," ""WalWiki"" is ""YukiWiki"" Clone. "

引用部も特殊なブロックになります。

行頭を'>'にすると、引用文の扱いになり、インデント（字下げ）されます。　 '>'の数が増えるほどインデントは深くなります。 

> 質問です。
> WalWikiってなんですか？
WikiWiki Cloneの一種です。
結城浩氏のYukiWikiを元に、いくつかの改造をしました。

mtYukiWiki/YukiWikiからの移行

編集

WalWikiやYukiWiki2では、YukiWikiおよび旧mtYukiWikiとブラケットネームに対応するデータ名が違います。 このため、これらで作成したデータを使う時には、簡単な移行作業が必要です。

実行後は、旧データキー（データサイズ）と新データキー（データサイズ）の対照表が表示されます。 ここでは、次の2点の変化があるはずです。

これで、データの移行は完了です。

このページへのご意見、ご質問

編集

ちょっとコメントが増えてきましたので、新着順にしました。

コメントスパムがひどいためこのページのコメント欄を削除しました。コメントしたい方は暫定的に「掲示板」のページへお願いいたします。 

0273 ##############################
0274 #
0275 # You MAY modify following variables added by Walrus.
0276 #
0277 my @ignore_html_page = ('', $FrontPage, $AdminSpecialPage); # Walrus add [HTML mode]
0278 my @ignore_html_tags = ('a', 'br', 'blockquote', 'img');    # Walrus add [HTML mode]

0278 my @ignore_html_tags = ('a', 'br', 'blockquote', 'img','h2');    # Walrus add [HTML mode]

<html>
<img src="画像のURL" align="right">
</html>
このWebサイトは、………についてのサイトです、hogehoge が作っています。
<html>
<br clear="all">
<h2>最新更新情報（５件）</h2>
</html>
[[#recent(5)]] 
<html>
<h2>メニュー</h2>
</html>

┌───────────────────┐
│FrontPage 　　　　　　　　　　　　　　│
└───────────────────┘
　　　　　　　　　　　　　　┌─────┐
　このWebサイトは、………に │　　　　　│
　ついてのサイトです。hogeh │　　　　　│
　oge が作っています。　　　│　画　像　│
　　　　　　　　　　　　　　│　　　　　│
　　　　　　　　　　　　　　│　　　　　│
　　　　　　　　　　　　　　└─────┘
┌───────────────────┐
│最新更新情報（５件）　　　　　　　　　│
└───────────────────┘
　・2004-07-23 (Fri) 23:02:14 ……………
　・2004-07-23 (Fri) 20:45:23 ……………
　　　　　　　　　　：
　・2004-07-22 (Thu) 19:55:07 ……………
┌───────────────────┐
│メニュー　　　　　　　　　　　　　　　│
└───────────────────┘

	$_[0] =~ s/&((:?apos|quot|gt|lt|amp|copy|#x?[0-9a-f]+);)?/$1 ? '&'.$1 : '&amp;'/gie;
Poweredby WalWiki 2.1.0.2 based on YukiWiki 2.1.2a.
Modified by TSUKAMOTO Makio.

WalWiki based on YukiWiki