| 両方とも前のリビジョン前のリビジョン次のリビジョン | 前のリビジョン最新のリビジョン両方とも次のリビジョン |
| wiki:install [2005/11/29 20:48] – 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一般 ===== |
| Ports treeが新しい物に更新されている必要があります。そうでないと、何も起こりません。 | 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]] |
| |
| |
| |
| ====== 動いた ― 次はどうすればいい？ ====== | ====== 動いた ― 次はどうすればいい？ ====== |
| 無事すべての設定が終わって動き始めたら、次にやるべきことは次のとおりです。 | 無事すべての設定が終わって動き始めたら、次にやるべきことは次のとおりです。 |
| |
| * 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. |
