【しばらく編集不可モードで運営します】 編集(管理者用) | 差分 | 新規作成 | 一覧 | RSS | FrontPage | 検索 | 更新履歴

MacでYukiWiki - セットアップ手順の概略

目次

セットアップ手順の概略

はじめに

結城さんの日記で話題が出ていたので少し書いてみました。 「知りたい肝心なところが書いてないじゃないか!」というツッコミが聞こえてきそうですが。

ここでの記述は、MacOSX 10.2.8の環境を前提としています。 MacOSX 10.1以前、あるいは10.3以降では異なる部分があるかもしれません。

ここに記述されている内容を試す場合は自己責任でお願いします。 また、補足情報などは適宜追加してください。

MacOSXにYukiWikiをインストール

(0) YukiWikiを入手する

結城さんのサイトから最新版をダウンロードしましょう。

http://www.hyuki.com/yukiwiki/index.html

(1) YukiWikiを設置するフォルダを決める

Finderで「ホーム」を見ると、「サイト」あるいは「Sites」というフォルダがあるはずです。 これはMacOSXの「パーソナルWeb共有」機能によってユーザごとのWebコンテンツを格納するためのフォルダです。 中を見ると、index.htmlというファイルがあるはずです。

ここに、YukiWikiを格納するフォルダを作って、インストールするのがいいのではないか、と思います。 私はそうしています。

このサイト(Sites)フォルダに「ターミナル」からアクセスする場合の絶対パスは、例えば以下のようになります。

ユーザ名がhogehogeの場合 : /Users/hogehoge/Sites

「サイト」にyukiwikiフォルダを作ってインストールする場合: /Users/hogehoge/Sites/yukiwiki

(2) CGIを実行可能なようにWWWサーバの設定を変更する

これについては、説明されているWebページや書籍がたくさんありますのでそちらを参照してください。 後述の参考文献では、8章に一連の説明があります。

→後述の「Apache Webサーバの設定変更方法」を参照してください。

(3) YukiWikiをインストールする

ダウンロードしたアーカイブに含まれているreadme.txtに従ってインストールしてください。

readme.txtにある設置手順の(1)は変更不要のはずです。

readme.txtにある設置手順の(2)はGUIで可能です。 ただし、wiki.cgiの編集には、改行コードをLFで保存可能なエディタを使いましょう。 私はmiというフリーのテキストエディタを使っています。

問題はreadme.txtにある設置手順の(3)です。 ファイルの配置はGUIでできますが、 パーミッションの変更は「ターミナル」を使って作業をする必要があります。

ここ、間違いでした。設置したファイルのパーミッション変更だけならsudoは不要です。 →(この作業には管理者権限が必要です。また、sudoコマンドを使う必要があります。)

(ここを分かりやすく説明するのは難しいです。 よく分からない、という方は、周りの詳しい方に聞くか、 MacOSXのUNIX的な使い方を解説している本を読むことをおすすめします。)

(わかりやすく説明するのではなくてよいですから、コマンドの概略だけでも教えていただけると助かる人は多いかも。)

chmod ほげほげ
sudo ほげほげ

のようにして、基本的なところだけ書いてもらえると助かります。

パーミッションの変更は、以下のようにおこないます。

(a)「ターミナル」アプリケーションを起動します。 すると、以下のような画面が出るはずです。

Last login: Sun Mar  7 06:59:59 on ttyp1
Welcome to Darwin!
[Macintosh:~] hogehoge% 

(b)cdコマンドを使ってyukiwikiを設置したフォルダに移動します。

[Macintosh:~] hogehoge% cd Sites/yukiwiki
[Macintosh:~/Sites/yukiwiki] hogehoge%

(c)chmodコマンドを使ってパーミッションを変更します。 例えば、wiki.cgiのパーミッションを変更する場合、

[Macintosh:~/Sites/yukiwiki] hogehoge% chmod 755 wiki.cgi

(4)「パーソナルWeb共有」を「開始」する

「システム環境設定」の「共有」を開きます。 そして、「サービス」タブを選択すると、その中に「パーソナルWeb共有」がありますので、それを「開始」します。 「パーソナルWeb共有しています」という表示になれば、WWWサーバが起動しています。

もし最初から「パーソナルWeb共有しています」という表示になっている場合は、一度「停止」して再度「開始」します。

(5) WebブラウザでYukiWikiにアクセスしてみる

ユーザ名がhogehogeで、yukiwikiにインストールした場合、

http://127.0.0.1/~hogehoge/yukiwiki/wiki.cgi

YukiWikiにアクセスできるはずです。

Enjoy YukiWiki!

セキュリティを考慮しましょう

MacOSXでWWWサーバ(Apache)を動作させるためには、パーソナルWeb共有という機能を有効にします。 しかし、単にパーソナルWeb共有を有効にするだけだと、ネットワークでつながっている他のMac/PCからもアクセス可能になってしまいます。

YukiWikiを公開目的でなく個人で使うのであれば、YukiWikiをインストールしたMac以外からはアクセスできないようにApacheの設定を変更することをお勧めします。

具体的な内容については、参考文献のHack #89をご参照ください。 (時間があれば書くんですけど...)

Apache Webサーバの設定変更方法

MacOSXの場合、ユーザ別に設定ファイルが用意されているので、それを使用します。

ユーザ別の設定ファイルは、/etc/httpd/usersにあります。 ユーザhogehogeの場合、hogehoge.confというファイルがあるはずです。

hogehoge.confは、デフォルトでは以下のような設定になっています。

<Directory "/Users/hogehoge/Sites/">
    Options Indexes MultiViews?
    AllowOverride? None
    Order allow,deny
    Allow from all
</Directory>

CGIを実行可能にする

wikiが動作するためには、CGIが実行可能になっている必要があります。 そのためには、以下のように変更します。

<Directory "/Users/hogehoge/Sites/">
    Options Indexes MultiViews? ExecCGI
    AddHandler cgi-script .cgi
    AllowOverride? None
    Order allow,deny
    Allow from all
</Directory>

インストールしたMacからのみアクセスできるようにする

デフォルト設定では、誰でもアクセスできるようになっています。

wikiをインストールしたMacからしかアクセスできないようにするには、以下のように変更します。

<Directory "/Users/hogehoge/Sites/">
    Options Indexes MultiViews? ExecCGI
    AddHandler cgi-script .cgi
    AllowOverride? None
    Order deny,allow
    Deny from all
    Allow from localhost
</Directory>
Orderは、Deny(アクセス禁止)とAllow(アクセス許可)の適用順序を規定しています。 Denyで、全てのホストからのアクセスを禁止し、Allowで、localhostからのアクセスのみ許可しています。

YukiWikiに使用するWebブラウザ

MacOSXでやっかいなのは、実はWebブラウザだったりします。

私のMacOSX 10.2.8の環境では3つのブラウザをインストールしていますが、Wikiや掲示板へのアクセスにはInternet Explorerしか使えません。

ブラウザ状況
Internet Explorer問題なく使用できる
Safari半角の¥や\といった文字を入力すると、文字化けする(? になってしまう)
iCabフォームで日本語入力ができない(!)ためWikiでは使えない

Safariは、MacOSX 10.3以降では改善されているのでしょうか?

参考文献

MAC OS X HACKS - プロが使うテクニック&ツール100選

オライリージャパン/オーム社

ISBN4-87311-146-3

コメント・情報をどうぞ

(Too many spams ... embedded comments are not allowed now, sorry.)