====== DokuWiki 安裝方式 ======
如果你已經安裝了 DokuWiki ，有另外一份[[install:upgrade|升級指引]]。

安裝 [[DokuWiki]] 可以說是非常的簡單 - 一般來說只是解壓縮和設定權限而已。你應該先試著按照這裡所提供的簡易指引進行安裝，如果遇到了問題或是指引不夠詳細，則進一步的閱讀連結。

  * **第一步**：從 [[sb>dokuwiki]] 下載最新的版本。

  * **第二步**：在安裝**之前**閱讀[[security|安全]]這一頁。請認真對待這個議題。如果還有疑問，請在[[mailinglist|信件群組]]中發問。

  * **第三步**：解壓縮下載的檔案並上傳/複製到你的網路空間。

  * **第四步**：在瀏覽器中打開 install.php 並照步驟做。（更多的資訊請參看[[installer]]）

  * **第五步**：開始使用你的 DokuWiki 並閱讀[[..:manual|說明書（英）]]來發掘你可以使用的功能。

[[:install:screencast|這裡]]有一個安裝 DokuWiki 的螢幕截取影片。雖然上頭所展示的是安裝到分享式的網站提供者，但對於其他的情況仍然是很有幫助的。

===== 詳細指引 =====

如果你在上述的步驟中遇到了問題或是需要更詳細的資訊，請參看下列頁面（英）：

  * [[..install:unpacking|解壓縮 .tgz 檔]]
  * [[..install:permissions|如何設定權限]]
  * [[..install:hosted|在網頁空間上安裝 DokuWiki]]
  * [[installer|install.php 指引]]
  * [[..install:upgrade|從之前的版本升級]]
  * 作業系統相關：
    * [[..install:Debian]]
    * [[..install:Gentoo]]
    * [[..install:FreeBSD]]
    * [[..install:MacOSX]]
    * [[..install:fsg-3]] (NAS with linux kernel)
    * [[..install:Solaris]]
  * Webserver 相關：
    * [[..:install:Apache]]
    * [[..install:Lighttpd]]
    * [[..install:Nanoweb]]
    * [[..install:IIS]]
  * Web Host 相關：
    * [[..install:hosted|在網頁空間上安裝 DokuWiki]]
    * [[install:sourceforge|DokuWiki on Sourceforge]]
    * [[install:free.fr|DokuWiki on free.fr]]
  * 替代安裝方案：
    * [[http://www.splitbrain.org/blog/2007-12/01-dokuwiki_on_a_stick|在隨身碟上使用 DokuWiki]] -- 直接在隨身碟上執行 DokuWiki
    * [[http://bitnami.org/stack/dokuwiki|DokuWiki Bitnami Stack]] -- 一個 DokuWiki 懶人包，包含所有 DokuWiki 需要的執行環境(Apache, PHP)及發佈
    * [[darcs#maintaining_a_stable_version_with_darcs|使用 Darcs 管理安裝]]
  * [[..FAQ|常見問題]]

===== 成功了！接下來呢？ =====

在一切都成功之後，這裡有些事是你可能會想做的：

  * 再次閱讀[[security|安全]]這一頁。 ;-)
  * 考慮啟動 [[rewrite|URL 重寫]]。
  * 替你的內容選擇一個授權方式 -- 編輯在 dokuwiki/lib/tpl/default 中的 ''footer.html'' 來顯示合適的授權。
  * 在[[users|使用者頁面]]中輸入你在什麼地方使用和怎麼使用 [[DokuWiki]] 。
  * 在 [[http://www.freshmeat.net|freshmeat.net]] 中 [[http://freshmeat.net/subscribe/48181/|訂閱]] DokuWiki ，以獲得更新和安全性問題資訊。
  * 閱讀
    * [[faq|常見問題]]
    * [[tips:maintenance|必要的每日維護]]
    * [[tips|小技巧]]，尤其是在安裝後做[[tips:tailorwikirules|最好的練習]]。

===== 它動不了！問題排除 =====

如果你在安裝 DokuWiki 的時候遇到了問題，而且你也仔細地檢查了上面的每個步驟的話：

  * 再次[[sb>dokuwiki|下載檔案]]確保你已經完整的下載了檔案。
  * 再次上傳檔案 - FTP 傳檔失敗通常是問題發生的原因。上傳 .zip 檔後在伺服器上解開會比上傳每個檔案來得可靠。
  * 再三確認 [[install:permissions|檔案及資料夾的權限]] - 這**常常**是問題發生的原因。
  * 在張貼你的問題到[[http://forum.dokuwiki.org/forum/2/|安裝討論區]]之前請先[[http://forum.dokuwiki.org/search|搜尋討論區]]，看看是不是有類似的問題及解答。
 
=== 開發中版本 ===
FIXME
If you're attempting to run a [[http://dev.splitbrain.org/browse/snapshots/|development version]] (which will likely fix some bugs whilst adding new ones) and receive message "//unrecognised or modified dokuwiki.php//", perform the following:
    - copy the reported hash key, e.g. '''1e5c42eac3219d9e21927c39e3240aad'''
    - open //install.php// and find <code>$dokuwiki_hash array</code>
    - duplicate the final line within the array, e.g. <code>'2007-06-26'   => 'b3ca19c7a654823144119980be73cd77',</code>
    - edit your duplicated line for date and new hash key, e.g. <code>'2008-03-17'   => '1e5c42eac3219d9e21927c39e3240aad',</code>
    - save, upload to server and rerun ''install.php''