両方とも前のリビジョン前のリビジョン次のリビジョン | 前のリビジョン最新のリビジョン両方とも次のリビジョン |
wiki:install [2005/11/29 20:39] – osamu | wiki:install [2007/07/23 16:50] – 外部編集 127.0.0.1 |
---|
* 誰でもページを読め、編集でき、作成できる状態になっています([[acl#Permissionlevels]]参照) | * 誰でもページを読め、編集でき、作成できる状態になっています([[acl#Permissionlevels]]参照) |
* FIXME (上記の『ディレクトリやファイルがない』という問題は将来の新しいバージョンでは修正したいと思っています。提案:必要な空のファイルとディレクトリをあらかじめアーカイブファイルの中に入れておく。可能か?あるいは、スペース1つだけが入ったファイルを入れる? | * FIXME (上記の『ディレクトリやファイルがない』という問題は将来の新しいバージョンでは修正したいと思っています。提案:必要な空のファイルとディレクトリをあらかじめアーカイブファイルの中に入れておく。可能か?あるいは、スペース1つだけが入ったファイルを入れる? |
| |
| |
| |
===== Linux/UnixとApache一般 ===== | ===== Linux/UnixとApache一般 ===== |
| |
パッケージのバグを見つけたときはDebianのバグトラッキングシステム[[http://www.debian.org/Bugs/]]にレポートしてください。 | パッケージのバグを見つけたときはDebianのバグトラッキングシステム[[http://www.debian.org/Bugs/]]にレポートしてください。 |
| |
| |
| |
===== FreeBSD ===== | ===== FreeBSD ===== |
| |
To install dokuwiki using the FreeBSD ports tree, do the following: | FreeBSDのportsからDokuWikiをインストールするには次のようにします: |
| |
#> cd /usr/ports/www/dokuwiki | #> cd /usr/ports/www/dokuwiki |
#> make install clean | #> make install clean |
| |
The default DokuWiki directory is ''/usr/local/www/data/dokuwiki'' \\ -- Of course the directory can be changed or symbolic linked to anywhere :-) | DokuWikiをインストールするディレクトリはデフォルトでは''/usr/local/www/data/dokuwiki''となっています。 |
| もちろん、インストール先を別のディレクトリにしたり、別の場所へシンボリックリンクを張ることもできます。 :-) |
| |
To upgrade using the ports tree, do: | Portsでのアップグレードは: |
| |
#> portupgrade dokuwiki | #> portupgrade dokuwiki |
| |
Make sure that the ports tree has been updated, or this will have no effect. | Ports treeが新しい物に更新されている必要があります。そうでないと、何も起こりません。 |
| |
===== Mac OS X and Apache ===== | |
| |
See the detailed [[http://the.taoofmac.com/space/HOWTO/Install%20DokuWiki%20on%20Tiger|HOWTO for DokuWiki on Tiger]]. | |
| |
The HOWTO does not appear to be up-to-date (though it was helpful). | |
| |
Below is what I did for Tiger (no previous DokuWiki installed): | ===== Mac OS X と Apache ===== |
| |
- [[http://the.taoofmac.com/space/HOWTO/Enable%20PHP%20on%20Mac%20OS%20X|Enable PHP on Mac OS X]] (includes starting Personal Web Sharing) | くわしくは[[http://the.taoofmac.com/space/HOWTO/Install%20DokuWiki%20on%20Tiger|HOWTO for DokuWiki on Tiger]]を参照してください。 |
- [[http://www.splitbrain.org/Programming/PHP/DokuWiki/index.php|Downloaded dokuwiki-2005-07-13.tgz]] (assuming to ~/Desktop) | |
- From the command line:<code bash> | このHOWTOは大変役に立ちますが、少し内容が古いようです。 |
| |
| 私がTiger(古いDokuWikiはインストールされていない環境)にインストールしたときは次のような手順でした: |
| |
| - [[http://the.taoofmac.com/space/HOWTO/Enable%20PHP%20on%20Mac%20OS%20X|Mac OS XでPHPを有効にする]] (Personal Web Sharingの起動も) |
| - [[http://www.splitbrain.org/Programming/PHP/DokuWiki/index.php|dokuwiki-2005-07-13.tgzをダウンロード]] (ダウンロード先は~/Desktop) |
| - コマンドラインから:<code bash> |
$ cd ~/Desktop && tar -zxvf dokuwiki-2005-07-13.tgz | $ cd ~/Desktop && tar -zxvf dokuwiki-2005-07-13.tgz |
$ mv dokuwiki-2005-07-13 ~/Sites/dokuwiki | $ mv dokuwiki-2005-07-13 ~/Sites/dokuwiki |
$ touch data/changes.log | $ touch data/changes.log |
$ sudo chown -R www data</code> | $ sudo chown -R www data</code> |
- If you want autorization (change useacl in conf/local.php), also from the command line:<code bash> | - アクセスコントロールを使いたい場合は(conf/local.phpでuseaclの設定を変えて)、コマンドラインから:<code bash> |
$ cp conf/users.auth.php.dist conf/users.auth.php | $ cp conf/users.auth.php.dist conf/users.auth.php |
$ sudo chown www conf/users.auth.php | $ sudo chown www conf/users.auth.php |
$ cp conf/acl.auth.php.dist conf/acl.auth.php | $ cp conf/acl.auth.php.dist conf/acl.auth.php |
$ sudo chown www conf/acl.auth.php</code> | $ sudo chown www conf/acl.auth.php</code> |
- Important: set <code php>$conf['basedir'] = '/~user/dokuwiki/';</code> in conf/local.php; autodetection does not work! | - 重要:conf/local.phpで<code php>$conf['basedir'] = '/~user/dokuwiki/';</code>と設定すること。ディレクトリの自動検出はうまく動きません。 |
| |
## in 10.4.3 client running the built in apache, but with site at /Library/Webserver/Documents (to mimic server) adding 'basedir' actually breaks it. | ## 10.4.3 クライアントで、標準装備のApacheを走らせて、サイトを/Library/Webserver/Documentsに設定(サーバーのふりをさせるため)した場合、'basedir'を指定すると壊れてしまった(訳注:ここ意味不明) |
| |
===== Windows ===== | ===== Windows ===== |
| |
==== With Apache ==== | |
| |
This is for people who want to use DokuWiki on their Desktop-Machine | ==== Windows版Apache ==== |
| |
* Make sure you have Apache and PHP installed ((The easiest way to do this is using an installer package like [[http://www.uniformserver.com/index.php|Uniserver]], [[http://www.apachefriends.org/en/xampp-windows.html|XAMPP]], [[http://www.appservnetwork.com/|AppServ]], [[http://www.easyphp.org|EasyPHP]] or [[http://www.hotscripts.com/PHP/Software_and_Servers/Installation_Kits/|any other available]])) | デスクトップ機でDokuWikiを動作させたい方向け |
* Unpack the tarball using a tool like [[http://www.winzip.com|WinZIP]] or the opensource file archiver [[http://www.7-zip.org|7-Zip]]. See File extraction details [[install#File Extraction|below]]. | |
* move the ''dokuwiki-YYYY-MM-DD'' directory to somewhere below your new webserver documentroot eg. ''c:\xampp\htdocs\'' and rename it to ''dokuwiki'' | |
* in the ''dokuwiki/data/'' directory create a new empty file named ''changes.log'' (rightclick and select new -> Textfile, then rename the file) | |
* edit the ''dokuwiki.php'' file in the ''conf'' directory to configure your Wiki (see [[config]]) or (better) create a new ''conf/local.php'' file containing those lines from ''dokuwiki.php'', which you want to change. This way your changes are preserved when overwriting the ''dokuwiki.php'' with a new release. | |
* Your new Wiki should be available at %%http://127.0.0.1/dokuwiki/doku.php%% | |
| |
Sometimes, you might require to create a attic/ directory under data dir. Thanks to oak to help me out with this. | * ApacheとPHPをインストールしてください ((インストーラーのパッケージが各種配布されていますので、それを使うのが簡単です。[[http://www.uniformserver.com/index.php|Uniserver]], [[http://www.apachefriends.org/en/xampp-windows.html|XAMPP]], [[http://www.appservnetwork.com/|AppServ]], [[http://www.easyphp.org|EasyPHP]] or [[http://www.hotscripts.com/PHP/Software_and_Servers/Installation_Kits/|any other available]])) |
| * DokuWikiのtarボールのファイルを[[http://www.winzip.com|WinZIP]]やオープンソースの展開ソフト[[http://www.7-zip.org|7-Zip]]などのツールで展開します。ファイルの展開方法についての詳しい説明は[[install#File Extraction|後述]]。 |
| * ''dokuwiki-YYYY-MM-DD''ディレクトリを、インストールしたWebサーバーのドキュメントルート(例:''c:\xampp\htdocs\'')の下のどこかに移動し、名前を''dokuwiki''に変更します |
| * ''dokuwiki/data/''ディレクトリの中に''changes.log''という名前の空のファイルを作ります(右クリックしてから、新規作成 -> テキスト ドキュメント。その後できたファイルの名前を変更)。 |
| * ''conf''ディレクトリの中の''dokuwiki.php''ファイルを編集してDokuWikiの設定を変更する([[config]]参照)か、''conf/local.php''という新しいファイルを作り、''dokuwiki.php''の中の変更したい行だけを抜き出したものをその中に記入します。後者の方法は新しいバージョンのDokuWikiを上書きインストールしたときに''dokuwiki.php''が書き換わっても、あなたが変更した設定はそのまま残りますので、お薦めです。 |
| * %%http://127.0.0.1/dokuwiki/doku.php%%であなたのWikiが見えるはずです。 |
| |
> In the last version (2005-07-01) you have to create those directories too : data/cache, data/meta, data/locks. | ''data''ディレクトリの中に''attic''というディレクトリを作らないといけない場合もあるようです。同様に、場合によっては''data/cache''、''data/meta''、''data/locks''というディレクトリも手動で作る必要があります。 |
| |
==== With IIS ==== | ==== IIS ==== |
| |
This is for people who want to use DokuWiki on a Windows machine with IIS webserver (Windows 2000, Windows XP or Windows Server 2003) | IISが使えるWindows機(Windows 2000、Windows XP、Windows Server 2003)でDokuWikiを使いたい方向けz |
| |
* Make sure you have PHP installed. See the [[http://www.php.net|PHP site]] for installers or complete packages. PHP can run either as CGI-application or as an ISAPI extension. | * PHPをインストールしてください。[[http://www.php.net|PHPのサイト]]にインストールプログラムやパッケージについての説明があります。 PHPはCGIプログラムとして動かすことも、ISAPI拡張プログラムとして動かすこともできます。 |
* Unzip the DokuWiki archive using a tool like [[http://www.winzip.com|WinZIP]] or the opensource file archiver [[http://www.7-zip.org|7-Zip]]. See File extraction details [[install#File Extraction|below]]. | * DokuWikiのtarボールのファイルを[[http://www.winzip.com|WinZIP]]やオープンソースの展開ソフト[[http://www.7-zip.org|7-Zip]]などのツールで展開します。ファイルの展開方法についての詳しい説明は[[install#File Extraction|後述]]。 |
* Rename the ''dokuwiki-YYYY-MM-DD'' directory to ''dokuwiki'' and move it to | * ''dokuwiki-YYYY-MM-DD''ディレクトリの名前を''dokuwiki''に変更して、次のどこかに移動します |
* somewhere below your new webserver documentroot, e.g. ''c:\inetpub\dokuwiki'' | * Webサーバーのドキュメントルート(例:''c:\inetpub\dokuwiki'')の下のどこかに移動します |
* any other location on your machine, and make sure to setup a Virtual Directory mapping to that location | * その他、どこか任意の場所に移動して、そのディレクトリにバーチャルディレクトリをマッピングします |
* In the ''dokuwiki/data/'' directory create a new empty file named ''changes.log'', and create the folders attic/, meta/, locks/ and cache/ | * In the ''dokuwiki/data/'' directory create a new empty file named ''changes.log'', and create the folders attic/, meta/, locks/ and cache/ |
* Edit the ''dokuwiki.php'' file in the ''conf'' directory to configure your Wiki (see [[config]]) or (better) create a new ''conf/local.php'' file containing those lines from ''dokuwiki.php'', which you want to change. This way your changes are preserved when overwriting the ''dokuwiki.php'' with a new release. | * Edit the ''dokuwiki.php'' file in the ''conf'' directory to configure your Wiki (see [[config]]) or (better) create a new ''conf/local.php'' file containing those lines from ''dokuwiki.php'', which you want to change. This way your changes are preserved when overwriting the ''dokuwiki.php'' with a new release. |
$conf['basedir'] = '/dokuwiki/'; //relative dir to serveroot - blank for autodetection | $conf['basedir'] = '/dokuwiki/'; //relative dir to serveroot - blank for autodetection |
Note that, for whatever reason, //a trailing slash is **required**!!// | Note that, for whatever reason, //a trailing slash is **required**!!// |
| |
| |
| |
* FTPプログラムでファイルのパーミッションを変更するオプションはたいてい''chmod''という名前がついていて、メニューのどこかに隠れていたり、ファイルを右クリックすると使えたりします。 | * FTPプログラムでファイルのパーミッションを変更するオプションはたいてい''chmod''という名前がついていて、メニューのどこかに隠れていたり、ファイルを右クリックすると使えたりします。 |
* いちばん単純な設定は、''dokuwiki/data/''ディレクトリとその中の全部のファイルとディレクトリのパーミッションを''rwxrwxrwx''あるいは''777''に変更することです。 | * いちばん単純な設定は、''dokuwiki/data/''ディレクトリとその中の全部のファイルとディレクトリのパーミッションを''rwxrwxrwx''あるいは''777''に変更することです。 |
* :!: その前に、まず''rwxrwx---''あるいは''770''というパーミッション設定を試してみるのがよいでしょう。―このほうがセキュリティ上より安心な設定ですが、ホスティング会社のサーバーの設定によってはこのパーミッションではDokuWikiがうまく動作しないこともあります。 | * :!: その前に、まず''%%rwxrwx---%%''あるいは''770''というパーミッション設定を試してみるのがよいでしょう。―このほうがセキュリティ上より安心な設定ですが、ホスティング会社のサーバーの設定によってはこのパーミッションではDokuWikiがうまく動作しないこともあります。 |
| |
===== Development Versions ===== | ===== Development Versions ===== |
[[alternativeupgradedetail | Example of everything needed for this]] | [[alternativeupgradedetail | Example of everything needed for this]] |
| |
====== It Works - What Now ? ====== | ====== 動いた ― 次はどうすればいい? ====== |
| |
Here is **what** you may want to do when everything is up and working. | 無事すべての設定が終わって動き始めたら、次にやるべきことは次のとおりです。 |
| |
* Check the [[security]] page for hotfixes | * セキュリティ対策のパッチが出ていないか、[[doku>security]]のページを確認します |
* Consider enabling [[http://wiki.splitbrain.org/wiki:tips:modrewrite|modrewrite]] | * [[http://wiki.splitbrain.org/wiki:tips:modrewrite|modrewrite]]を使うかどうかを決めます |
* Choose a license for your content -- edit the ''footer.html'' inside the dokuwiki/lib/tpl/default folder to represent the appropriate license: | * 自分が作るコンテンツのライセンスポリシーを決めます -- 選んだライセンスポリシーに合わせて/dokuwiki/lib/tpl/defaultディレクトリの''footer.html''を変更します |
* [[http://creativecommons.org/licenses/by-nc-sa/2.0/|Creative Commons Attribution-NonCommercial-ShareAlike License]] (included by default) | * [[http://creativecommons.org/licenses/by-nc-sa/2.0/|Creative Commons Attribution-NonCommercial-ShareAlike License]](既定の設定はこれ) |
* [[http://www.gnu.org/copyleft/fdl.html|GNU Free Documentation License]] | * [[http://www.gnu.org/copyleft/fdl.html|GNU Free Documentation License]] |
* If using [[http://www.apache.org/httpd|Apache]], enable URL rewriting in ''.htaccess'' and set the appropriate config file option. | * [[http://www.apache.org/httpd|Apache]]を使っている場合は、''.htaccess''のURL書き換え(URL rewrite)オプションを有効にして、設定ファイル(''/conf/dokuwiki.php''または''/conf/local.php'')もURL書き換えを利用するように修正します |
* Change the ''style.css'' to your own ideas | * お好みに合わせて''/lib/tpl/default''ディレクトリの中の''design.css''と''layout.css''を修正します |
* Enter a few words how and where you use [[DokuWiki]] in the [[users|userpage]] | * Enter a few words how and where you use [[DokuWiki]] in the [[users|userpage]] |
* [[http://freshmeat.net/subscribe/48181/|subscribe]] to DokuWiki at [[http://www.freshmeat.net|freshmeat.net]] to stay informed of updates and get a mail whenever a security problem is encountered. | * [[http://freshmeat.net/subscribe/48181/|subscribe]] to DokuWiki at [[http://www.freshmeat.net|freshmeat.net]] to stay informed of updates and get a mail whenever a security problem is encountered. |