Lusix Person's Notes

• 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 (不安全)
  1. chmod 777 wiki/conf/acl.auth.php
  2. chmod 777 wiki/conf/users.auth.php
  3. chmod -R 777 wiki/data
• rm install.php
• 在資料夾權限部份亦可進行下列的處理（將資料夾的所屬使用者及群組，設定為Apache伺服器的www-data。）

• 更改Template
  1. 上傳新template的子目錄至/lib/tpl
  2. 進入「管理選單」→「系統配置設定」，更改樣版(Template)
• 將外部連結改為開新頁面
  1. 修改/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 語法, 格式會錯亂 — 蔡宗融 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:

• updatecheck – if update notifications persist
• toolbar – Quickbuttons and JavaScript problems
• searchindex – if search box gives you no result

Here are a few different upgrade descriptions, provided by users. They might be slightly out of date.

• Use Upgrade Plugin
• Upgrading by creating diffs
• Upgrading by APS - has anybody tested this yet?
• Upgrading using the DokuWiki Downloader
  • Upload the 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!

• 蔡宗融個人網站
• Lainme's Blog

*Setting up file permissions