====== DokuWiki 安裝指引 =====

**如果要升級既有的 DokuWiki 站點，可以參考另外一份[[install:upgrade|升級指引]].**

您可以嘗試下述的簡要指引，如果遇到了問題或是指引不夠詳細，請點擊進一步的連結：

  * **第 0 步**：確認您的伺服器符合[[requirements|系統需求]]
  * **第 1 步**：從[[https://download.dokuwiki.org/|下載頁面]]獲取下載最新版本
  * **第 2 步**：在開始安裝__之前__，詳閱[[security|安全頁面]]中的內容，並審慎對待；如果有任何疑問，請透過[[mailinglist|郵件列表]]提問
  * **第 3 步**：解壓縮下載的檔案，並上傳或複製到您的網路空間
  * **第 4 步**：在瀏覽器中開啟 ''install.php'' 檔案，並依照說明步驟進行操作（進一步的資訊，請參閱[[installer|安裝程式]]頁面）
  * **第 5 步**：開始使用您的 DokuWiki 並閱讀[[manual|使用手冊]]來發掘可以使用的功能

這裡有支[[install:screencast|安裝影片]]展示了如何將 DokuWiki 安裝到共享虛擬主機（Shared Web Hosting），但依然可以作為其他安裝方式的參考；如果您尚未具備自己的網頁託管主機，可以查看我們的[[hosting|主機合作夥伴]]使用預裝好 DokuWiki 的主機服務。

如果您希望創建多個維基站點，可以創建一座 DokuWiki 農場，相關的創建資訊與指引可以參考[[farms|維基農場]]頁面上的說明。

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

如果您在執行上述步驟時遇到問題，或者需要更詳細的資訊，請查看以下頁面：

  * [[install:unpacking|解壓縮 ''.tgz'' 檔案]]
  * [[install:permissions|如何設置權限]]
  * [[install:hosted|在網頁空間上安裝 DokuWiki]]
  * [[installer|''install.php'' 指引]]
  * [[install:upgrade|從之前的版本升級]]
  * [[FAQ|常見問題]]

==== 作業系統／分支相關 ====

  * [[http://wiki.archlinux.org/index.php/Dokuwiki|Arch Linux]]
  * [[::install:CentOS]]
  * [[::install:Debian]]
  * [[::install:Fedora]]
  * [[::install:FreeBSD]]
  * [[::install:Gentoo]]
  * [[::install:MacOSX]] or [[::install:mac_alt]]
  * [[::install:OpenSolaris]]
  * [[::install:openSUSE]]
  * [[http://wiki.qnap.com/wiki/Dokuwiki|QNAP NAS]]
  * [[::install:Solaris]]
  * [[::install:Ubuntu|Ubuntu]]
  * [[::install:Windows]]

==== Webserver 相關 ====

  * [[::install:Apache]]
  * [[::install:darklight]]
  * [[::install:Hiawatha]]
  * [[::install:IIS]]
  * [[::install:Lighttpd]]
  * [[::install:Mongoose]]
  * [[::install:Nanoweb]]
  * [[::install:nginx]]

==== Web Host 相關 ====

  * [[::hosting|虛擬主機合作夥伴]] 提供預先載入之 DokuWiki 安裝
  * DokuWiki 在 ...
    * [[::install:hosted|在網頁空間上安裝 DokuWiki]]
    * [[::install:dreamhost|Dreamhost]]
    * [[::install:free.fr|free.fr]]
    * [[::install:godaddy.com|GoDaddy]]
    * [[::install:ovh.com|ovh.com]]
    * [[::install:sourceforge|SourceForge]]
    * [[::install:strato|Strato and 1&1]]
    * [[::install:azurewebsites|Windows Azure Web Sites]]

==== 替代安裝方案 ====
  * [[::install:downloader|DokuWiki Downloader]] -- 一個簡單的腳本，包含下載及安裝 DokuWiki
  * [[http://www.turnkeylinux.org/dokuwiki|TurnKey DokuWiki Appliance]] -- 免費且開源的虛擬環境，可執行於 Ubuntu ，易於設定同時非常的精簡。每日自動更新安全性修補。幾分鐘內就可以完成部屬成為虛擬機器、Bare-Metal(裸機)或放置於雲端。屬於[[http://www.turnkeylinux.org/|TurnKey Linux Virtual Appliance Library]]。
  * [[http://www.splitbrain.org/blog/2007-12/01-dokuwiki_on_a_stick|在隨身碟上使用 DokuWiki]] -- 直接在隨身碟上執行 DokuWiki (此版本已非常舊，不建議使用，本頁英文版已移除此連結。)
  * [[http://bitnami.org/stack/dokuwiki|DokuWiki Bitnami Module]] -- 一個 DokuWiki 懶人包，包含所有 DokuWiki 需要的執行環境。如果你使用 Linux 則可使用 LAMPStack；如果你使用 Mac、Windows 或 Solaris 則可考慮 MAMPStack、WAMPStack 或 SAMPstack，允許與其他應用程式模組一同共用資料庫、網頁伺服器及語言執行環境。
  * [[https://sourceforge.net/projects/desktopwiki/|Desktop Wiki]] -- 其他行動版 DokuWiki
  * [[devel:git#maintaining_a_stable_version_with_git|使用 git 維護程式碼]]
  * [[https://sourceforge.net/projects/dokuwikispatial/files/DokuWiki%20portable/|行動版 DokuWiki 使用 Uniform Server PHP MicroServer]]

===== suhosin php extension 的陷阱 =====
（從 2015-08-10 "Detritus" 起的版本）

如果你的 php 有開啟 [[https://suhosin.org/stories/index.html|suhosin php extension]] 功能，記得設定於 ''php.ini'' 中將下列二個參數 ''suhosin.post.disallow_nul'' 及 ''suhosin.request.disallow_nul'' 設定為 0，不然頁面編輯及外掛頁將無法運作。（在編輯頁面存檔時將會無窮迴圈的回到編輯頁面中，以及外掛管理頁面中的安裝及升級將會無法正常運作。）

您可以將下列內容儲存成 ''test.php'' 後放置到主機上以確認您的 php 設定：

''<?php phpinfo(); ?>''

使用瀏覽器查看此頁面。

如果您的 dokuwiki 安裝於代管之 web hosting 中且您無法修改主機設定時，請詢問您的主機商並要求修改相關的設定。

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

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

  * 再次閱讀[[::security|安全(英)]]這一頁。 ;-)
  * 考慮啟動[[::rewrite|URL Rewrite]]。
  * 替你的內容選擇一個授權方式 -- 若您的樣板無法使用 ''tpl_licence()''（此功能始於 DokuWiki 2009-02-14），則可編輯設定檔[[config:license]] 或 dokuwiki/lib/tpl/... 中的 ''footer.html'' 來顯示合適的授權。
  * 在[[::dokuinstall|使用者頁面]]中輸入你在什麼地方使用和怎麼使用 [[DokuWiki]] 。
  * 訂閱[[::newsletter|新聞群組]]，以獲得更新和安全性問題資訊。
  * 閱讀
    * [[::faq|常見問題]]
    * [[::tips:maintenance|必要的每日維護]]
    * [[::tips|小技巧]]，尤其是在安裝後做[[::tips:tailorwikirules|最好的練習]]。

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

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

  * 再次[[http://download.dokuwiki.org/|下載檔案]]確保你已經完整的下載了檔案。
  * 再次上傳檔案 - FTP 傳檔失敗通常是問題發生的原因。上傳 .zip 檔後在伺服器上解開會比上傳每個檔案來得可靠。
  * 再三確認 [[::install:permissions|檔案及資料夾的權限]] - 這**常常**是問題發生的原因。
  * 在張貼你的問題到[[http://forum.dokuwiki.org/forum/2/|安裝討論區]]之前請先[[http://forum.dokuwiki.org/search|搜尋討論區]]，看看是不是有類似的問題及解答。