差異處

這裏顯示兩個版本的差異處。

--- zh-tw:install [2008-08-11 23:37] – andi
+++ zh-tw:install [2022-11-14 06:16] (目前版本) – Hsins
@@ 行 1: / 行 1: @@
-====== DokuWiki 安裝方式 ======
+====== DokuWiki 安裝指引 =====
-如果你已經安裝了 DokuWiki ，有另外一份[[install:upgrade|升級指引]]。
-安裝 [[DokuWiki]] 可以說是非常的簡單 - 一般來說只是解壓縮和設定權限而已。你應該先試著按照這裡所提供的簡易指引進行安裝，如果遇到了問題或是指引不夠詳細，則進一步的閱讀連結。
+**如果要升級既有的 DokuWiki 站點，可以參考另外一份[[install:upgrade|升級指引]].**
-  * **第一步**：從 [[sb>dokuwiki]] 下載最新的版本。
+您可以嘗試下述的簡要指引，如果遇到了問題或是指引不夠詳細，請點擊進一步的連結：
-  * **第二步**：在安裝**之前**閱讀[[security|安全]]這一頁。請認真對待這個議題。如果還有疑問，請在[[mailinglist|信件群組]]中發問。
+  * **第 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 的主機服務。
-  * **第四步**：在瀏覽器中打開 install.php 並照步驟做。（更多的資訊請參看[[installer]]）
+如果您希望創建多個維基站點，可以創建一座 DokuWiki 農場，相關的創建資訊與指引可以參考[[farms|維基農場]]頁面上的說明。
-  * **第五步**：開始使用你的 DokuWiki 並閱讀[[..:manual|說明書（英）]]來發掘你可以使用的功能。
+===== 詳細指引 =====
-[[:install:screencast|這裡]]有一個安裝 DokuWiki 的螢幕截取影片。雖然上頭所展示的是安裝到分享式的網站提供者，但對於其他的情況仍然是很有幫助的。
+如果您在執行上述步驟時遇到問題，或者需要更詳細的資訊，請查看以下頁面：
-===== 詳細指引 =====
+  * [[install:unpacking|解壓縮 ''.tgz'' 檔案]]
+  * [[install:permissions|如何設置權限]]
+  * [[install:hosted|在網頁空間上安裝 DokuWiki]]
+  * [[installer|''install.php'' 指引]]
+  * [[install:upgrade|從之前的版本升級]]
+  * [[FAQ|常見問題]]
-如果你在上述的步驟中遇到了問題或是需要更詳細的資訊，請參看下列頁面（英）：
+==== 作業系統／分支相關 ====
-  * [[..install:unpacking|解壓縮 .tgz 檔]]
+  * [[http://wiki.archlinux.org/index.php/Dokuwiki|Arch Linux]]
-  * [[..install:permissions|如何設定權限]]
+  * [[::install:CentOS]]
-  * [[..install:hosted|在網頁空間上安裝 DokuWiki]]
+  * [[::install:Debian]]
-  * [[installer|install.php 指引]]
+  * [[::install:Fedora]]
-  * [[..install:upgrade|從之前的版本升級]]
+  * [[::install:FreeBSD]]
-  * 作業系統相關：
+  * [[::install:Gentoo]]
-    * [[..install:Debian]]
+  * [[::install:MacOSX]] or [[::install:mac_alt]]
-    * [[..install:Gentoo]]
+  * [[::install:OpenSolaris]]
-    * [[..install:FreeBSD]]
+  * [[::install:openSUSE]]
-    * [[..install:MacOSX]]
+  * [[http://wiki.qnap.com/wiki/Dokuwiki|QNAP NAS]]
-    * [[..install:fsg-3]] (NAS with linux kernel)
+  * [[::install:Solaris]]
-    * [[..install:Solaris]]
+  * [[::install:Ubuntu|Ubuntu]]
-  * Webserver 相關：
+  * [[::install:Windows]]
-    * [[..:install:Apache]]
-    * [[..install:Lighttpd]]
+==== Webserver 相關 ====
-    * [[..install:Nanoweb]]
-    * [[..install:IIS]]
+  * [[::install:Apache]]
-  * Web Host 相關：
+  * [[::install:darklight]]
-    * [[..install:hosted|在網頁空間上安裝 DokuWiki]]
+  * [[::install:Hiawatha]]
-    * [[install:sourceforge|DokuWiki on Sourceforge]]
+  * [[::install:IIS]]
-    * [[install:free.fr|DokuWiki on free.fr]]
+  * [[::install:Lighttpd]]
-  * 替代安裝方案：
+  * [[::install:Mongoose]]
-    * [[http://www.splitbrain.org/blog/2007-12/01-dokuwiki_on_a_stick|在隨身碟上使用 DokuWiki]] -- 直接在隨身碟上執行 DokuWiki
+  * [[::install:Nanoweb]]
-    * [[http://bitnami.org/stack/dokuwiki|DokuWiki Bitnami Stack]] -- 一個 DokuWiki 懶人包，包含所有 DokuWiki 需要的執行環境(Apache, PHP)及發佈
+  * [[::install:nginx]]
-    * [[darcs#maintaining_a_stable_version_with_darcs|使用 Darcs 管理安裝]]
-  * [[..FAQ|常見問題]]
+==== 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 中且您無法修改主機設定時，請詢問您的主機商並要求修改相關的設定。
 ===== 成功了！接下來呢？ =====
@@ 行 51: / 行 93: @@
 在一切都成功之後，這裡有些事是你可能會想做的：
-  * 再次閱讀[[security|安全]]這一頁。 ;-)
+  * 再次閱讀[[::security|安全(英)]]這一頁。 ;-)
-  * 考慮啟動 [[rewrite|URL 重寫]]。
+  * 考慮啟動[[::rewrite|URL Rewrite]]。
-  * 替你的內容選擇一個授權方式 -- 編輯在 dokuwiki/lib/tpl/default 中的 ''footer.html'' 來顯示合適的授權。
+  * 替你的內容選擇一個授權方式 -- 若您的樣板無法使用 ''tpl_licence()''（此功能始於 DokuWiki 2009-02-14），則可編輯設定檔[[config:license]] 或 dokuwiki/lib/tpl/... 中的 ''footer.html'' 來顯示合適的授權。
-  * 在[[users|使用者頁面]]中輸入你在什麼地方使用和怎麼使用 [[DokuWiki]] 。
+  * 在[[::dokuinstall|使用者頁面]]中輸入你在什麼地方使用和怎麼使用 [[DokuWiki]] 。
-  * 在 [[http://www.freshmeat.net|freshmeat.net]] 中 [[http://freshmeat.net/subscribe/48181/|訂閱]] DokuWiki ，以獲得更新和安全性問題資訊。
+  * 訂閱[[::newsletter|新聞群組]]，以獲得更新和安全性問題資訊。
   * 閱讀
-    * [[faq|常見問題]]
+    * [[::faq|常見問題]]
-    * [[tips:maintenance|必要的每日維護]]
+    * [[::tips:maintenance|必要的每日維護]]
-    * [[tips|小技巧]]，尤其是在安裝後做[[tips:tailorwikirules|最好的練習]]。
+    * [[::tips|小技巧]]，尤其是在安裝後做[[::tips:tailorwikirules|最好的練習]]。
 ===== 它動不了！問題排除 =====
@@ 行 65: / 行 107: @@
 如果你在安裝 DokuWiki 的時候遇到了問題，而且你也仔細地檢查了上面的每個步驟的話：
-  * 再次[[sb>dokuwiki|下載檔案]]確保你已經完整的下載了檔案。
+  * 再次[[http://download.dokuwiki.org/|下載檔案]]確保你已經完整的下載了檔案。
   * 再次上傳檔案 - FTP 傳檔失敗通常是問題發生的原因。上傳 .zip 檔後在伺服器上解開會比上傳每個檔案來得可靠。
-  * 再三確認 [[install:permissions|檔案及資料夾的權限]] - 這**常常**是問題發生的原因。
+  * 再三確認 [[::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''