「MacPortsでインストールしたMoinMoinWikiのセットアップ」の編集履歴（バックアップ）一覧はこちら
MacPortsでインストールしたMoinMoinWikiのセットアップ - (2008/10/29 (水) 17:37:16) の１つ前との変更点
追加された行は緑色になります。
削除された行は赤色になります。
#image(right,title=MoinMoinロゴ,moinmoin.png)
#right(){（&counter()）}
*MacPortsでインストールしたMoinMoinWikiのセットアップ
このページでは、MacPortsでインストールしたMoinMoinWikiを実際に使用できるようにした、そのときの作業手順を記しています。
最終更新日：&update(j);
----
*そもそもMoinMoinWikiって何？
多くのWikiクローンの1つで、Pythonで書かれている特徴を持つ。[[日本語Wikiの解説>http://ja.wikipedia.org/wiki/MoinMoin]]によると、
#blockquote(){MoinMoin（モインモイン）はPythonで書かれたウィキクローンの一つ。ユルゲン・ヘルマン、トーマス・ヴァルドマンらによって開発された。ライセンスはGPLである。 Moinとは北部ドイツ等で話されるフリジア語の挨拶の言葉であり、直訳すると「よき一日を！」という意味である。
}
とのこと。同じページから特徴を引用すると、
#blockquote(){-Pythonで書かれている
-強力なページのリビジョン管理（変更履歴はすべて保存される）
-UTF-8出力や国際化に標準で対応
-MySQLなどのRDBMSを使わない（ページの保存にはテキストファイルを使用）
-様々なテーマやプラグイン、マクロが利用できる
-ウィキ文法を意識せずに編集が行えるWYSIWYGエディタ
-スペルチェック機能
などの特徴がある。また、欧米では非常にポピュラーなウィキであり、ApacheやXen、Fedora、Debianなど、著名なオープンソースプロジェクトのWikiに採用されている。
}
だそうです。
MoinMoinを選んだ理由は、比較的メジャーそうなのと、使用言語がPythonだっただけなのですが、世の中には[[色々なWikiクローン>http://en.wikipedia.org/wiki/Comparison_of_wiki_software]]があるものです。
*目次
#contents(fromhere=true)
*前提
以下の前提があります。人によっては(ていうか大部分の人が)手順の一部が違っていたり、内容が違っているので注意してください。
- pythonはMacオリジナルのものを使用している
-- MacオリジナルのPythonはシステムが利用するためにカスタマイズが入っていて、単純に変更してしまうと問題が出てくる、という本当かどうか分からない噂につられてます。
- MoinMoinWikiのバージョンは1.7.0を使用
-- 2008/10/27時点、[[本家のサイト>http://moinmo.in/MoinMoinWiki]]だと1.7.2が最新ですが、まあいいや。
- MacOSXはLeopard(10.5.5)。
- MacPortsは1.600。
- 公開先は$(HOME)/moinと設定。自分専用と仮定しています。
-- 個人使用なら[[DesktopEdition>http://moinmo.in/DesktopEdition]]使えよ、というコメントもあるでしょうが、Wikiサーバーを作成する練習も兼ねているので良しとします。
*作業手順（インストール編）
**MacPortsからMoinMoinWikiをインストール
MacPortsを使用してインストールします。
#highlight(sh){
% 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には含まれないので、パスを追加しておくことが必要です。
パスを追加するには[[いくつかの方法>http://www.python.jp/doc/2.5/inst/search-path.html]]がありますが、ここではお手軽かつ安全な方法として、.pthファイルを作成してopt/local下のディレクトリを含めることにしました。
まず、以下の内容のファイルを/Library/Python/2.5/site-packages下に作成します。
#highlight(sh){
% 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としました。
#highlight(sh){
$ mkdir ~/Sites/moin }
**必要なファイルをコピー
まず、MacPortsでインストールしたMoinMoinの設定ファイルなどが置かれた場所に移動しておきます。
#highlight(sh){
% cd /opt/local/share/moin
% ls
config data htdocs server underlay
% }
ここの一部のファイルを公開するフォルダにコピーします。
#highlight(sh){
% 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のサイトによると
#blockquote(){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セクションに以下の設定を追加します。
#highlight(sh){
Alias /moin_static170/ "/Users/XXXXXXXX/Sites/moin/htdocs/"
ScriptAlias /mywiki "/Users/XXXXXXXX/Sites/moin/moin.cgi" }
ここの"XXXXXXXX"は各自のホームディレクトリに読み替えてください。そして以下のDirectoryセクションも追加します。
#highlight(sh){
<Directory "/moinwiki">
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
Allow from all
</Directory> }
以上でWebサーバー側の設定はオーケーです。保存するのを忘れないよう注意してくださいな。
**MoinMoinの個人設定
さて、今度は個人用の設定です。まず、~/Sites/moin/moin.cgiを変更します。冒頭の"import sys, os"の直後にパス設定を追加してください。
#highlight(python){
"""
....
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結果で載せておきます。
#highlight(python){{
% 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"への書き換えが重要ですので、これも注意。
そして、フォルダとフォルダ以下の所有権、アクセス権を変更します。
#highlight(sh){{
$ chown -R www:www moin
$ chmod -R 744 moin }}
ここで普通はwwwっていうユーザーはデフォルトでは存在していないので、'ls -l'してみると「_www」という表示になってしまう。でも大丈夫っぽいのでそのままにした。
** 起動確認
ここまで来たら、とりあえずは動かせるようになっているはず。システム環境設定から「共有」→「Web共有」チェックボックスにチェックを入れて、http:localhost/moinへアクセス。
↓こんなページが表示されるはずです。
#image(firstpage.png,width=550,center)
インストール編はココまで。
** 最初の設定
前節の画像を見てもらうと分かるように、「トップページを変えろ」という情報が記されています。そこでオリジナルの説明を一通り読んだら、wikiconfig.pyを再び編集してトップページを設定します。
#highlight(python){{
# 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のインストール）
書きかけ。
*補足
書きかけ。
*参考サイト
-[[MoinMoinWikiのサイト>http://moinmo.in]]。本家。[[MacOSX用のインストール手順>http://moinmo.in/HelpOnInstalling/ApacheOnMacOsx]]も書かれています。
-[[MoinMoinの文法>http://moinmo.in/HelpOnEditing]]。本家のサイトです。
-[[MoinMoin_のインストールと設定、カスタマイズ>http://www.codereading.com/notebook/moin.cgi/MoinMoin_のインストールと設定、カスタマイズ]]。すでにあるWebサーバに対してMoinMoinをインストールする方法が書かれている。Macの手順と少し違うところがあるけれども、分かりやすくまとめられているので大いに参考にしました。
-[[Wikipediaの記事>http://en.wikipedia.org/wiki/Make_%28software%29]]。簡単な説明、程度の記事。でも分かりやすい文章でした。
-[[MoinMoin インストールと設定>http://ssk.jugem.jp/trackback/15]]。gentooにインストールしたときの手順。それなりにみやすくまとまっていました。
-[[色々なWikiの比較サイト>http://www.wikimatrix.org/]]。探していたらこんなサイトもありました。文法まで比較対象として確認できて、なかなか便利。
#image(right,title=MoinMoinロゴ,moinmoin.png)
#right(){（&counter()）}
*MacPortsでインストールしたMoinMoinWikiのセットアップ
このページでは、MacPortsでインストールしたMoinMoinWikiを実際に使用できるようにした、そのときの作業手順を記しています。
最終更新日：&update(j);
----
*そもそもMoinMoinWikiって何？
多くのWikiクローンの1つで、Pythonで書かれている特徴を持つ。[[日本語Wikiの解説>http://ja.wikipedia.org/wiki/MoinMoin]]によると、
#blockquote(){MoinMoin（モインモイン）はPythonで書かれたウィキクローンの一つ。ユルゲン・ヘルマン、トーマス・ヴァルドマンらによって開発された。ライセンスはGPLである。 Moinとは北部ドイツ等で話されるフリジア語の挨拶の言葉であり、直訳すると「よき一日を！」という意味である。
}
とのこと。同じページから特徴を引用すると、
#blockquote(){-Pythonで書かれている
-強力なページのリビジョン管理（変更履歴はすべて保存される）
-UTF-8出力や国際化に標準で対応
-MySQLなどのRDBMSを使わない（ページの保存にはテキストファイルを使用）
-様々なテーマやプラグイン、マクロが利用できる
-ウィキ文法を意識せずに編集が行えるWYSIWYGエディタ
-スペルチェック機能
などの特徴がある。また、欧米では非常にポピュラーなウィキであり、ApacheやXen、Fedora、Debianなど、著名なオープンソースプロジェクトのWikiに採用されている。
}
だそうです。
MoinMoinを選んだ理由は、比較的メジャーそうなのと、使用言語がPythonだっただけなのですが、世の中には[[色々なWikiクローン>http://en.wikipedia.org/wiki/Comparison_of_wiki_software]]があるものです。
*目次
#contents(fromhere=true)
*前提
以下の前提があります。人によっては(ていうか大部分の人が)手順の一部が違っていたり、内容が違っているので注意してください。
- pythonはMacオリジナルのものを使用している
-- MacオリジナルのPythonはシステムが利用するためにカスタマイズが入っていて、単純に変更してしまうと問題が出てくる、という本当かどうか分からない噂につられてます。
- MoinMoinWikiのバージョンは1.7.0を使用
-- 2008/10/27時点、[[本家のサイト>http://moinmo.in/MoinMoinWiki]]だと1.7.2が最新ですが、まあいいや。
- MacOSXはLeopard(10.5.5)。
- MacPortsは1.600。
- 公開先は$(HOME)/moinと設定。自分専用と仮定しています。
-- 個人使用なら[[DesktopEdition>http://moinmo.in/DesktopEdition]]使えよ、というコメントもあるでしょうが、Wikiサーバーを作成する練習も兼ねているので良しとします。
*作業手順（インストール編）
**MacPortsからMoinMoinWikiをインストール
MacPortsを使用してインストールします。
#highlight(sh){
% 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には含まれないので、パスを追加しておくことが必要です。
パスを追加するには[[いくつかの方法>http://www.python.jp/doc/2.5/inst/search-path.html]]がありますが、ここではお手軽かつ安全な方法として、.pthファイルを作成してopt/local下のディレクトリを含めることにしました。
まず、以下の内容のファイルを/Library/Python/2.5/site-packages下に作成します。
#highlight(sh){
% 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としました。
#highlight(sh){
$ mkdir ~/Sites/moin }
**必要なファイルをコピー
まず、MacPortsでインストールしたMoinMoinの設定ファイルなどが置かれた場所に移動しておきます。
#highlight(sh){
% cd /opt/local/share/moin
% ls
config data htdocs server underlay
% }
ここの一部のファイルを公開するフォルダにコピーします。
#highlight(sh){
% 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のサイトによると
#blockquote(){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セクションに以下の設定を追加します。
#highlight(sh){
Alias /moin_static170/ "/Users/XXXXXXXX/Sites/moin/htdocs/"
ScriptAlias /mywiki "/Users/XXXXXXXX/Sites/moin/moin.cgi" }
ここの"XXXXXXXX"は各自のホームディレクトリに読み替えてください。そして以下のDirectoryセクションも追加します。
#highlight(sh){
<Directory "/moinwiki">
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
Allow from all
</Directory> }
以上でWebサーバー側の設定はオーケーです。保存するのを忘れないよう注意してくださいな。
**MoinMoinの個人設定
さて、今度は個人用の設定です。まず、~/Sites/moin/moin.cgiを変更します。冒頭の"import sys, os"の直後にパス設定を追加してください。
#highlight(python){
"""
....
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結果で載せておきます。
#highlight(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"への書き換えが重要ですので、これも注意。
そして、フォルダとフォルダ以下の所有権、アクセス権を変更します。
#highlight(sh){{
$ chown -R www:www moin
$ chmod -R 744 moin }}
ここで普通はwwwっていうユーザーはデフォルトでは存在していないので、'ls -l'してみると「_www」という表示になってしまう。でも大丈夫っぽいのでそのままにした。
** 起動確認
ここまで来たら、とりあえずは動かせるようになっているはず。システム環境設定から「共有」→「Web共有」チェックボックスにチェックを入れて、http:localhost/moinへアクセス。
↓こんなページが表示されるはずです。
#image(firstpage.png,width=550,center)
インストール編はココまで。
** 最初の設定
前節の画像を見てもらうと分かるように、「トップページを変えろ」という情報が記されています。そこでオリジナルの説明を一通り読んだら、wikiconfig.pyを再び編集してトップページを設定します。
#highlight(python){{
# 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のインストール）
書きかけ。
*補足
書きかけ。
*参考サイト
-[[MoinMoinWikiのサイト>http://moinmo.in]]。本家。[[MacOSX用のインストール手順>http://moinmo.in/HelpOnInstalling/ApacheOnMacOsx]]も書かれています。
-[[MoinMoinの文法>http://moinmo.in/HelpOnEditing]]。本家のサイトです。
-[[MoinMoin_のインストールと設定、カスタマイズ>http://www.codereading.com/notebook/moin.cgi/MoinMoin_のインストールと設定、カスタマイズ]]。すでにあるWebサーバに対してMoinMoinをインストールする方法が書かれている。Macの手順と少し違うところがあるけれども、分かりやすくまとめられているので大いに参考にしました。
-[[Wikipediaの記事>http://en.wikipedia.org/wiki/Make_%28software%29]]。簡単な説明、程度の記事。でも分かりやすい文章でした。
-[[MoinMoin インストールと設定>http://ssk.jugem.jp/trackback/15]]。gentooにインストールしたときの手順。それなりにみやすくまとまっていました。
-[[色々なWikiの比較サイト>http://www.wikimatrix.org/]]。探していたらこんなサイトもありました。文法まで比較対象として確認できて、なかなか便利。
表示オプション
横に並べて表示：
変化行の前後のみ表示：
