這裏顯示兩個版本的差異處。
Both sides previous revision 前次修改 下次修改 | 前次修改 | ||
dokuwiki_establishment_learning_notes [2012/01/01 21:26] lucien |
— (目前版本) | ||
---|---|---|---|
行 1: | 行 1: | ||
- | ==== 基本安裝 ==== | ||
- | |||
- | *cd /path/to/wiki/ | ||
- | *wget http://.../dokuwiki-xxxx-xx-xx.tgz | ||
- | *tar -xzvf dokuwiki-xxxx-xx-xx.tgz --strip-components=1 | ||
- | *rm dokuwiki-xxxx-xx-xx.tgz | ||
- | *資料夾權限部份可進行下列處理(1) | ||
- | *chmod 777 -R /var/www/dokuwiki/data/ 或是 chmod 700 -R /var/www/dokuwiki/data/ chown nobody:nobody -R /var/www/dokuwiki/data/ | ||
- | *chmod 777 -R /var/www/dokuwiki/conf/ | ||
- | */dokuwiki/install.php | ||
- | *chmod 755 -R /var/www/dokuwiki/conf/ | ||
- | *或是逕將權限指定給Apache的www-data(2) | ||
- | *sudo chown -R www-data:www-data | ||
- | *或是較不在意權限問題的話(3)-將資料夾的權限設定為777 (不安全) | ||
- | -chmod 777 wiki/conf/acl.auth.php | ||
- | -chmod 777 wiki/conf/users.auth.php | ||
- | -chmod -R 777 wiki/data | ||
- | *rm install.php | ||
- | *在資料夾權限部份亦可進行下列的處理(將資料夾的所屬使用者及群組,設定為Apache伺服器的www-data。) | ||
- | |||
- | |||
- | ==== 架構調整 ==== | ||
- | |||
- | *更改Template | ||
- | -上傳新template的子目錄至/lib/tpl | ||
- | -進入「管理選單」→「系統配置設定」,更改樣版(Template) | ||
- | *將外部連結改為開新頁面 | ||
- | -修改/conf下的「dokuwiki.php」,將$conf['target']['extern'] = '';改為$conf['target']['extern'] = '_blank'; | ||
- | -亦可從「管理選單」→「系統配置設定」→「target»extern」,直接加註「_blank」 | ||
- | |||
- | ==== 外掛安裝 ==== | ||
- | |||
- | === Folded === | ||
- | * http://wiki.splitbrain.org/plugin:folded | ||
- | * 下載網址:http://www.cdsmith.plus.com/dokuwiki/plugin-folded.tar.gz | ||
- | * 蔡宗融老師2007年11月測試發現 any content 的部份不可以出現 code3 plugin 語法, 格式會錯亂 --- //[[tryweb@ichiayi.com|蔡宗融]] 2007/11/01 12:09// | ||
- | * 基本語法: | ||
- | * Inline: <file> ++title| formatted text ++ </file> | ||
- | * Block : <file> ++++title| any content ++++ </file> | ||
- | |||
- | ++++ 點這看使用說明(也用 block 方式展示)| | ||
- | * 範例 : | ||
- | 這是測試範例, 可以++點這裡看詳細狀況|這裡是針對 **inline** 所列出的詳細內容++ | ||
- | |||
- | * 區塊展示可以內涵其他表格, include 頁面... | ||
- | |||
- | | 可以包含表格 wiki 格式 | 樣式都可以透過 block 方式呈現 | **很像不錯的樣子** | | ||
- | |||
- | <note> | ||
- | 還可以加入 note 的 TAG 內容 | ||
- | </note> | ||
- | |||
- | ++++ | ||
- | |||
- | === SwiftMailer === | ||
- | * http://www.dokuwiki.org/plugin:swiftmail | ||
- | * 下載網址: http://github.com/splitbrain/dokuwiki-plugin-swiftmail/zipball/master | ||
- | * Swiftmail的Gmail配置 | ||
- | -plugin»swiftmail»smtp_host:smtp.gmail.com | ||
- | -plugin»swiftmail»smtp_port:465 | ||
- | -plugin»swiftmail»smtp_ssl:SSL | ||
- | -plugin»swiftmail»auth_user:gmail郵件信箱 | ||
- | -plugin»swiftmail»auth_pass:密碼 | ||
- | -「管理選單」→「系統配置設定」→「mailfrom」,填註管理者所欲使用的「gmail郵件信箱」 | ||
- | |||
- | ==== 備份昇級 ==== | ||
- | |||
- | -cp -a /path/to/wiki/ /path/to/wikibackup | ||
- | -參考網址:http://www.dokuwiki.org/install:upgrade | ||
- | |||
- | ===== Files to remove ===== | ||
- | |||
- | Here is a list of files that were removed in recent releases. You should check if they still exist in your install. If they do, delete them. | ||
- | |||
- | <file - removeold.txt> | ||
- | # removed in 2011-05-25 | ||
- | conf/words.aspell.dist | ||
- | lib/styles/style.css | ||
- | |||
- | # removed in 2010-11-07 | ||
- | inc/lang/ar/subscribermail.txt | ||
- | inc/lang/az/subscribermail.txt | ||
- | inc/lang/bg/subscribermail.txt | ||
- | inc/lang/ca/subscribermail.txt | ||
- | inc/lang/ca-valencia/subscribermail.txt | ||
- | inc/lang/cs/subscribermail.txt | ||
- | inc/lang/da/subscribermail.txt | ||
- | inc/lang/de-informal/subscribermail.txt | ||
- | inc/lang/el/subscribermail.txt | ||
- | inc/lang/eo/subscribermail.txt | ||
- | inc/lang/es/subscribermail.txt | ||
- | inc/lang/et/subscribermail.txt | ||
- | inc/lang/eu/subscribermail.txt | ||
- | inc/lang/fa/subscribermail.txt | ||
- | inc/lang/fi/subscribermail.txt | ||
- | inc/lang/fo/subscribermail.txt | ||
- | inc/lang/fr/subscribermail.txt | ||
- | inc/lang/gl/subscribermail.txt | ||
- | inc/lang/he/subscribermail.txt | ||
- | inc/lang/hr/subscribermail.txt | ||
- | inc/lang/hu/subscribermail.txt | ||
- | inc/lang/id/subscribermail.txt | ||
- | inc/lang/is/subscribermail.txt | ||
- | inc/lang/it/subscribermail.txt | ||
- | inc/lang/ja/subscribermail.txt | ||
- | inc/lang/ko/subscribermail.txt | ||
- | inc/lang/ku/subscribermail.txt | ||
- | inc/lang/lt/subscribermail.txt | ||
- | inc/lang/lv/subscribermail.txt | ||
- | inc/lang/mr/subscribermail.txt | ||
- | inc/lang/ne/subscribermail.txt | ||
- | inc/lang/nl/subscribermail.txt | ||
- | inc/lang/no/subscribermail.txt | ||
- | inc/lang/pl/subscribermail.txt | ||
- | inc/lang/pt-br/subscribermail.txt | ||
- | inc/lang/pt/subscribermail.txt | ||
- | inc/lang/ro/subscribermail.txt | ||
- | inc/lang/ru/subscribermail.txt | ||
- | inc/lang/sk/subscribermail.txt | ||
- | inc/lang/sr/subscribermail.txt | ||
- | inc/lang/sv/subscribermail.txt | ||
- | inc/lang/th/subscribermail.txt | ||
- | inc/lang/tr/subscribermail.txt | ||
- | inc/lang/uk/subscribermail.txt | ||
- | inc/lang/zh/subscribermail.txt | ||
- | inc/lang/zh-tw/subscribermail.txt | ||
- | |||
- | # removed in rc2010-10-07 | ||
- | conf/msg | ||
- | inc/lang/bg/wordblock.txt | ||
- | inc/lang/ca-valencia/wordblock.txt | ||
- | inc/lang/ca/wordblock.txt | ||
- | inc/lang/cs/wordblock.txt | ||
- | inc/lang/da/wordblock.txt | ||
- | inc/lang/de-informal/wordblock.txt | ||
- | inc/lang/de/subscribermail.txt | ||
- | inc/lang/de/wordblock.txt | ||
- | inc/lang/el/wordblock.txt | ||
- | inc/lang/en/subscribermail.txt | ||
- | inc/lang/en/wordblock.txt | ||
- | inc/lang/eo/wordblock.txt | ||
- | inc/lang/es/wordblock.txt | ||
- | inc/lang/et/wordblock.txt | ||
- | inc/lang/eu/wordblock.txt | ||
- | inc/lang/fa/wordblock.txt | ||
- | inc/lang/fi/wordblock.txt | ||
- | inc/lang/fo/wordblock.txt | ||
- | inc/lang/fr/wordblock.txt | ||
- | inc/lang/he/wordblock.txt | ||
- | inc/lang/hr/wordblock.txt | ||
- | inc/lang/hu/wordblock.txt | ||
- | inc/lang/id/wordblock.txt | ||
- | inc/lang/it/wordblock.txt | ||
- | inc/lang/ja/wordblock.txt | ||
- | inc/lang/ko/wordblock.txt | ||
- | inc/lang/ku/wordblock.txt | ||
- | inc/lang/lt/wordblock.txt | ||
- | inc/lang/lv/wordblock.txt | ||
- | inc/lang/mg/wordblock.txt | ||
- | inc/lang/mr/wordblock.txt | ||
- | inc/lang/nl/wordblock.txt | ||
- | inc/lang/no/wordblock.txt | ||
- | inc/lang/pl/wordblock.txt | ||
- | inc/lang/pt-br/wordblock.txt | ||
- | inc/lang/pt/wordblock.txt | ||
- | inc/lang/ro/wordblock.txt | ||
- | inc/lang/sk/wordblock.txt | ||
- | inc/lang/sl/wordblock.txt | ||
- | inc/lang/sr/wordblock.txt | ||
- | inc/lang/sv/wordblock.txt | ||
- | inc/lang/th/wordblock.txt | ||
- | inc/lang/tr/wordblock.txt | ||
- | inc/lang/uk/wordblock.txt | ||
- | inc/lang/vi/wordblock.txt | ||
- | inc/lang/zh-tw/wordblock.txt | ||
- | inc/lang/zh/wordblock.txt | ||
- | lib/scripts/pngbehavior.htc | ||
- | |||
- | # removed in rc2009-12-02 | ||
- | inc/lang/ar/wordblock.txt | ||
- | inc/lang/ca-va/ | ||
- | lib/plugins/acl/lang/ca-va/ | ||
- | lib/plugins/config/lang/ca-va/ | ||
- | lib/plugins/plugin/lang/ca-va/ | ||
- | lib/plugins/popularity/lang/ca-va/ | ||
- | lib/plugins/revert/lang/ca-va/ | ||
- | lib/plugins/usermanager/lang/ca-va/ | ||
- | |||
- | # removed in rc2009-01-30 | ||
- | lib/plugins/upgradeplugindirectory | ||
- | lib/plugins/upgradeplugindirectory/action.php | ||
- | |||
- | # removed in rc2009-01-26 | ||
- | inc/auth/punbb.class.php | ||
- | inc/lang/ko/edit.txt_bak | ||
- | inc/lang/ko/lang.php_bak | ||
- | inc/lang/ku/admin_acl.txt | ||
- | inc/lang/mg/admin_acl.txt | ||
- | lib/plugins/importoldchangelog | ||
- | lib/plugins/importoldchangelog/action.php | ||
- | lib/plugins/importoldindex | ||
- | lib/plugins/importoldindex/action.php | ||
- | lib/plugins/usermanager/images/no_user_edit.png | ||
- | lib/plugins/usermanager/images/user_edit.png | ||
- | lib/tpl/default/UWEB.css | ||
- | |||
- | # removed in rc2008-03-31 | ||
- | inc/aspell.php | ||
- | inc/geshi/css-gen.cfg | ||
- | inc/lang/fr/admin_acl.txt | ||
- | lib/exe/spellcheck.php | ||
- | lib/images/toolbar/spellcheck.png | ||
- | lib/images/toolbar/spellnoerr.png | ||
- | lib/images/toolbar/spellstop.png | ||
- | lib/images/toolbar/spellwait.gif | ||
- | lib/plugins/acl/lang/ar/intro.txt | ||
- | lib/plugins/acl/lang/bg/intro.txt | ||
- | lib/plugins/acl/lang/ca/intro.txt | ||
- | lib/plugins/acl/lang/cs/intro.txt | ||
- | lib/plugins/acl/lang/da/intro.txt | ||
- | lib/plugins/acl/lang/de/intro.txt | ||
- | lib/plugins/acl/lang/el/intro.txt | ||
- | lib/plugins/acl/lang/en/intro.txt | ||
- | lib/plugins/acl/lang/es/intro.txt | ||
- | lib/plugins/acl/lang/et/intro.txt | ||
- | lib/plugins/acl/lang/eu/intro.txt | ||
- | lib/plugins/acl/lang/fi/intro.txt | ||
- | lib/plugins/acl/lang/fr/intro.txt | ||
- | lib/plugins/acl/lang/gl/intro.txt | ||
- | lib/plugins/acl/lang/he/intro.txt | ||
- | lib/plugins/acl/lang/id/intro.txt | ||
- | lib/plugins/acl/lang/it/intro.txt | ||
- | lib/plugins/acl/lang/ja/intro.txt | ||
- | lib/plugins/acl/lang/ko/intro.txt | ||
- | lib/plugins/acl/lang/lt/intro.txt | ||
- | lib/plugins/acl/lang/lv/intro.txt | ||
- | lib/plugins/acl/lang/nl/intro.txt | ||
- | lib/plugins/acl/lang/no/intro.txt | ||
- | lib/plugins/acl/lang/pl/intro.txt | ||
- | lib/plugins/acl/lang/pt/intro.txt | ||
- | lib/plugins/acl/lang/ru/intro.txt | ||
- | lib/plugins/acl/lang/sk/intro.txt | ||
- | lib/plugins/acl/lang/sr/intro.txt | ||
- | lib/plugins/acl/lang/sv/intro.txt | ||
- | lib/plugins/acl/lang/tr/intro.txt | ||
- | lib/plugins/acl/lang/uk/intro.txt | ||
- | lib/plugins/acl/lang/vi/intro.txt | ||
- | lib/plugins/acl/lang/zh/intro.txt | ||
- | lib/plugins/acl/lang/zh-tw/intro.txt | ||
- | lib/scripts/spellcheck.js | ||
- | lib/styles/spellcheck.css | ||
- | |||
- | # removed in 2007-06-26 | ||
- | inc/parser/wiki.php | ||
- | lib/images/interwiki/bug.gif | ||
- | lib/plugins/base.php | ||
- | lib/plugins/plugin/inc | ||
- | lib/plugins/plugin/inc/tarlib.class.php | ||
- | lib/plugins/plugin/inc/zip.lib.php | ||
- | lib/scripts/domLib.js | ||
- | lib/scripts/domTT.js | ||
- | |||
- | # removed in 2006-11-06 | ||
- | inc/admin_acl.php | ||
- | inc/lang/lt/stopwords.txt | ||
- | inc/magpie | ||
- | inc/magpie/rss_cache.inc | ||
- | inc/magpie/rss_fetch.inc | ||
- | inc/magpie/rss_parse.inc | ||
- | inc/magpie/rss_utils.inc | ||
- | lib/exe/media.php | ||
- | lib/tpl/default/mediaedit.php | ||
- | lib/tpl/default/media.php | ||
- | lib/tpl/default/mediaref.php | ||
- | |||
- | # removed in 2006-03-09 | ||
- | data/pages/wiki/playground.txt | ||
- | inc/auth/ldap.php | ||
- | inc/auth/mysql.php | ||
- | inc/auth/pgsql.php | ||
- | inc/auth/plain.php | ||
- | inc/lang/ca/admin_acl.txt | ||
- | inc/lang/cs/admin_acl.txt | ||
- | inc/lang/da/admin_acl.txt | ||
- | inc/lang/de/admin_acl.txt | ||
- | inc/lang/en/admin_acl.txt | ||
- | inc/lang/et/admin_acl.txt | ||
- | inc/lang/eu/admin_acl.txt | ||
- | inc/lang/fr/admin_acl.txt | ||
- | inc/lang/it/admin_acl.txt | ||
- | inc/lang/ja/admin_acl.txt | ||
- | inc/lang/lt/admin_acl.txt | ||
- | inc/lang/lv/admin_acl.txt | ||
- | inc/lang/nl/admin_acl.txt | ||
- | inc/lang/no/admin_acl.txt | ||
- | inc/lang/pl/admin_acl.txt | ||
- | inc/lang/pt/admin_acl.txt | ||
- | inc/lang/vi/admin_acl.txt | ||
- | inc/lang/zh-tw/admin_acl.txt | ||
- | inc/parser/spamcheck.php | ||
- | lib/images/favicon.ico | ||
- | lib/images/thumbup.gif | ||
- | lib/images/toolbar/code.png | ||
- | lib/images/toolbar/empty.png | ||
- | lib/images/toolbar/extlink.png | ||
- | lib/images/toolbar/fonth1.png | ||
- | lib/images/toolbar/fonth2.png | ||
- | lib/images/toolbar/fonth3.png | ||
- | lib/images/toolbar/fonth4.png | ||
- | lib/images/toolbar/fonth5.png | ||
- | lib/images/toolbar/list.png | ||
- | lib/images/toolbar/list_ul.png | ||
- | lib/images/toolbar/rule.png | ||
- | lib/tpl/default/images/interwiki.png | ||
- | </file> | ||
- | |||
- | People with shell access to their server can copy the text above and paste it into a file on the system, then run the following commands to check for and remove all those files. Only those that exist are removed. I used the filename of ''/tmp/removeold.txt'' to store the list of files copied from here. | ||
- | |||
- | <code> | ||
- | grep -Ev "^($|#)" /tmp/removeold.txt | xargs -n 1 rm -f | ||
- | </code> | ||
- | |||
- | If you are paranoid, replace the "rm -f" with "ls -la" to see what files will be deleted. | ||
- | |||
- | To remove directories as well as files you have to use: | ||
- | <code> | ||
- | grep -Ev "^($|#)" /tmp/removeold.txt | xargs -n 1 rm -fd | ||
- | </code> | ||
- | |||
- | However, some systems may not support the "rm -d" option for directory removal. In that case, you have to use recursive removal (just be sure to double-check that the file list does not include any paths that will delete too much): | ||
- | <code> | ||
- | grep -Ev "^($|#)" /tmp/removeold.txt | xargs -n 1 rm -fr | ||
- | </code> | ||
- | |||
- | Some systems may give an 'Illegal Variable Name' error when using the above grep commands. In these cases, substitute single quotes for the double quotes. | ||
- | |||
- | I have created a python script that will print the files deleted, it can be improved | ||
- | <code python> | ||
- | import os | ||
- | file = open("/tmp/removeold.txt") | ||
- | for line in file: | ||
- | #os.remove(line) | ||
- | if not line.isspace() : | ||
- | if not line[0:1] =='#' : | ||
- | line = line.rstrip(os.linesep) | ||
- | try: | ||
- | print(line) | ||
- | os.remove(line) | ||
- | except OSError, err: | ||
- | pass | ||
- | </code> | ||
- | ===== Troubleshooting ===== | ||
- | |||
- | If you encounter some inconsistencies in [[..:DokuWiki's]] behaviour after upgrading, you should delete the cache files in ''data/cache/''. You should make sure your browser hasn't cached old stylesheets or JavaScript by forcing a reload (Shift-F5 or Ctrl-Shift-R in most browsers). | ||
- | |||
- | Related pages that might apply: | ||
- | |||
- | * [[config:updatecheck]] -- if update notifications persist | ||
- | * [[faq:toolbar]] -- Quickbuttons and JavaScript problems | ||
- | * [[faq:searchindex]] -- if search box gives you no result | ||
- | |||
- | ===== Alternative Ways ===== | ||
- | |||
- | Here are a few different upgrade descriptions, provided by users. They might be slightly out of date. | ||
- | |||
- | * Use [[plugin:upgrade|Upgrade Plugin]] | ||
- | * [[.:diffupgrade|Upgrading by creating diffs]] | ||
- | * [[http://apscatalog.com/1/splitbrain.org/dokuwiki/|Upgrading by APS]] - has anybody tested this yet? | ||
- | * Upgrading using the [[install:downloader|DokuWiki Downloader]] | ||
- | * Upload the {{http://github.com/splitbrain/dokuwiki-downloader/raw/master/dokuwiki-downloader.php|Downloader script}} to your wiki's root directory | ||
- | * Remove your doku.php | ||
- | * Make sure all files that might be overwritten are writable by the webserver | ||
- | * Execute the downloader as usual | ||
- | * Skip the installation step and remove install.php (if you continue to the installer you will be warned anyway, that an existing installation was detected) | ||
- | * Done! | ||
- | |||
- | ==== 學習資源 ==== | ||
- | |||
- | *[[http://www.ichiayi.com/wiki/tech/dokuwiki_gallery|蔡宗融個人網站]] | ||
- | *[[http://www.lainme.com/doku.php/|Lainme's Blog]] | ||
- | |||
- | ==== 教學專文 ==== | ||
- | |||
- | *[[install:permissions|Setting up file permissions]] |