[go: up one dir, main page]
More Web Proxy on the site http://driver.im/

selflearn @ ウィキ

MacPortsでインストールしたMoinMoinWikiのセットアップ

最終更新:

kato

- view
メンバー限定 登録/ログイン
-

MacPortsでインストールしたMoinMoinWikiのセットアップ

このページでは、MacPortsでインストールしたMoinMoinWikiを実際に使用できるようにした、そのときの作業手順を記しています。

最終更新日:2008年10月29日 (水) 17時37分16秒;


そもそもMoinMoinWikiって何?

多くのWikiクローンの1つで、Pythonで書かれている特徴を持つ。日本語Wikiの解説によると、
MoinMoin(モインモイン)はPythonで書かれたウィキクローンの一つ。ユルゲン・ヘルマン、トーマス・ヴァルドマンらによって開発された。ライセンスはGPLである。 Moinとは北部ドイツ等で話されるフリジア語の挨拶の言葉であり、直訳すると「よき一日を!」という意味である。
とのこと。同じページから特徴を引用すると、
  • Pythonで書かれている
  • 強力なページのリビジョン管理(変更履歴はすべて保存される)
  • UTF-8出力や国際化に標準で対応
  • MySQLなどのRDBMSを使わない(ページの保存にはテキストファイルを使用)
  • 様々なテーマやプラグイン、マクロが利用できる
  • ウィキ文法を意識せずに編集が行えるWYSIWYGエディタ
  • スペルチェック機能
などの特徴がある。また、欧米では非常にポピュラーなウィキであり、ApacheやXen、Fedora、Debianなど、著名なオープンソースプロジェクトのWikiに採用されている。
だそうです。
MoinMoinを選んだ理由は、比較的メジャーそうなのと、使用言語がPythonだっただけなのですが、世の中には色々なWikiクローンがあるものです。

目次


前提

以下の前提があります。人によっては(ていうか大部分の人が)手順の一部が違っていたり、内容が違っているので注意してください。
  • pythonはMacオリジナルのものを使用している
    • MacオリジナルのPythonはシステムが利用するためにカスタマイズが入っていて、単純に変更してしまうと問題が出てくる、という本当かどうか分からない噂につられてます。
  • MoinMoinWikiのバージョンは1.7.0を使用
  • MacOSXはLeopard(10.5.5)。
  • MacPortsは1.600。
  • 公開先は$(HOME)/moinと設定。自分専用と仮定しています。
    • 個人使用ならDesktopEdition使えよ、というコメントもあるでしょうが、Wikiサーバーを作成する練習も兼ねているので良しとします。

作業手順(インストール編)

MacPortsからMoinMoinWikiをインストール

MacPortsを使用してインストールします。
% sudo port install moin
Password:
--->  Fetching moin
--->  Verifying checksum(s) for moin
--->  Extracting moin
--->  Configuring moin
--->  Building moin with target build
--->  Staging moin into destroot
--->  Installing moin 1.7.0_0
--->  Activating moin 1.7.0_0
--->  Cleaning moin
% 
ここは簡単、簡単。

パスの設定

インストールしたMoinMoinのフォルダ(/opt/local/Library/Frameworks/Python.framework/Versions/2.5/lib/python2.5/site-packages/MoinMoin)はMacPortsからインストールしたPythonのsys.pathには含まれるけど、オリジナルのPythonには含まれないので、パスを追加しておくことが必要です。
パスを追加するにはいくつかの方法がありますが、ここではお手軽かつ安全な方法として、.pthファイルを作成してopt/local下のディレクトリを含めることにしました。

まず、以下の内容のファイルを/Library/Python/2.5/site-packages下に作成します。
% pwd
/Library/Python/2.5/site-packages
% ls
20081027_moinmoin.pth README
% more 20081027_moinmoin.pth
/opt/local/Library/Frameworks/Python.framework/Versions/2.5/lib/python2.5/site-packages
% python
Python 2.5.1 (r251:54863, Apr 15 2008, 22:57:26) 
[GCC 4.0.1 (Apple Inc. build 5465)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import MoinMoin  # エラーが出なければOK
>>>
 
これでオリジナルのPythonも、MacPortsがインストールしたPythonスクリプトが利用できるようになりました。ちなみに今の設定はパスの最後に設定されるので、MacPorts側の同名のモジュールが使用されることはないはず、です(これが安全だと書いた理由)。

サイト公開場所を作成

ディレクトリを作成し、MonMoinのうち自分が手を加える一部のファイルをコピーします。ここでは素直にmoinとしました。
$ mkdir ~/Sites/moin 

必要なファイルをコピー

まず、MacPortsでインストールしたMoinMoinの設定ファイルなどが置かれた場所に移動しておきます。
% cd /opt/local/share/moin
% ls
config   data     htdocs   server   underlay
% 
ここの一部のファイルを公開するフォルダにコピーします。
% cd /opt/local/share/moin
% ls
config   data     htdocs   server   underlay
% cp -r data ~/Sites/moin
% cp -r underlay ~/Sites/moin
% cp -r htdocs ~/Sites/moin
% cp server/moin.cgi ~/Sites/moin
% cp config/wikiconfig.py ~/Sites/moin 
ちなみに別のWikiサイトを作成したい場合は、Sites下にmoin2フォルダなどを作って同じようにコピーすればよいとのこと。お手軽だ。

Apacheサーバーの設定(httpd.conf)

LeopardのWebサーバ(Apache2.2)は、MoinMoinのサイトによると
Apple upgraded Apache to 2.2 in Leopard, which (among other things) brings tighter security controls than previous versions.
とのことなので、httpd.confも設定しないといけないです。/etc/apache2/httpd.confをルート権限で開き(sudo vi httpd.conf等)、Aliasesセクションに以下の設定を追加します。
Alias /moin_static170/   "/Users/XXXXXXXX/Sites/moin/htdocs/"
ScriptAlias /mywiki      "/Users/XXXXXXXX/Sites/moin/moin.cgi" 
ここの"XXXXXXXX"は各自のホームディレクトリに読み替えてください。そして以下のDirectoryセクションも追加します。
<Directory "/moinwiki">
    Options Indexes FollowSymLinks MultiViews
    AllowOverride None
    Order allow,deny
    Allow from all
</Directory> 
以上でWebサーバー側の設定はオーケーです。保存するのを忘れないよう注意してくださいな。

MoinMoinの個人設定

さて、今度は個人用の設定です。まず、~/Sites/moin/moin.cgiを変更します。冒頭の"import sys, os"の直後にパス設定を追加してください。
"""
    ....
                2008 by MoinMoin:ThomasWaldmann
    @license: GNU GPL, see COPYING for details.
"""
 
import sys, os
sys.path.insert(0, '/Users/XXXXXXXX/Sites/moin/wikiconfig.py') # ココ!
 
# a) Configuration of Python's code search path 
そして、wikiconfig.pyも変更します。細々とあるので、diff結果で載せておきます。
% diff -u /opt/local/share/moin/config/wikiconfig.py ./wikiconfig.py
--- /opt/local/share/moin/config/wikiconfig.py	2008-05-15 07:37:45.000000000 +0900
+++ ./wikiconfig.py	2008-10-27 14:49:11.000000000 +0900
@@ -1,4 +1,4 @@
-# -*- coding: iso-8859-1 -*-
+# -*- coding: utf-8 -*-
 # IMPORTANT! This encoding (charset) setting MUST be correct! If you live in a
 # western country and you don't know that you use utf-8, you probably want to
 # use iso-8859-1 (or some other iso charset). If you use utf-8 (a Unicode
@@ -33,7 +33,7 @@
     # Wiki identity ----------------------------------------------------
 
     # Site name, used by default for wiki name-logo [Unicode]
-    sitename = u'Untitled Wiki'
+    sitename = u'My MoinMoinWiki'
 
     # Wiki logo. You can use an image, text or both. [Unicode]
     # For no logo or text, use '' - the default is to show the sitename.
@@ -65,14 +65,14 @@
 
     # Where your mutable wiki pages are. You want to make regular
     # backups of this directory.
-    data_dir = './data/'
+    data_dir = '/Users/XXXXXXXX/Sites/moin/data/'
 
     # Where read-only system and help page are. You might want to share
     # this directory between several wikis. When you update MoinMoin,
     # you can safely replace the underlay directory with a new one. This
     # directory is part of MoinMoin distribution, you don't have to
     # backup it.
-    data_underlay_dir = './underlay/'
+    data_underlay_dir = '/Users/XXXXXXXX/Sites/moin/underlay/'
 
     # The URL prefix we use to access the static stuff (img, css, js).
     # NOT touching this is maybe the best way to handle this setting as moin
@@ -81,7 +81,7 @@
     # For Twisted and standalone server, the default will automatically work.
     # For others, you should make a matching server config (e.g. an Apache
     # Alias definition pointing to the directory with the static stuff).
-    #url_prefix_static = '/moin_static170'
+    url_prefix_static = '/moin_static170'
 
 
     # Security ----------------------------------------------------------
 
日本語のタイトルにするにはファイル先頭の"utf-8"への書き換えが重要ですので、これも注意。
そして、フォルダとフォルダ以下の所有権、アクセス権を変更します。
$ chown -R www:www moin
$ chmod -R 744 moin 
ここで普通はwwwっていうユーザーはデフォルトでは存在していないので、'ls -l'してみると「_www」という表示になってしまう。でも大丈夫っぽいのでそのままにした。

起動確認

ここまで来たら、とりあえずは動かせるようになっているはず。システム環境設定から「共有」→「Web共有」チェックボックスにチェックを入れて、http:localhost/moinへアクセス。
↓こんなページが表示されるはずです。
インストール編はココまで。

最初の設定

前節の画像を見てもらうと分かるように、「トップページを変えろ」という情報が記されています。そこでオリジナルの説明を一通り読んだら、wikiconfig.pyを再び編集してトップページを設定します。
# a) if most wiki content is in a single language
    #page_front_page = u"MyStartingPage"
 
    # b) if wiki content is maintained in many languages
    page_front_page = u"FrontPage"
 
上記どちらかのコメントアウトされている箇所を外します。複数の言語に対応させたい場合(フロントページを各国語で表示したい場合)は後者のコメントアウト文字を外してください。ここでは(=私は)後者を有効化しています。

以上でインストールから初期設定までの作業は終わりです。
おつかれさまでした。

あとはWelcomeページに書かれているような設定を行ってアカウントを作ったり、アクセス制限したり、よしなにどうぞ。

作業手順(環境設定:Parserのインストール)

書きかけ。

補足

書きかけ。

参考サイト

添付ファイル
人気記事ランキング