This pages replaces beckisownwiki

This manual presumes that you saved a copy of the original config files with the extension .org before you made any changes!

• Download and extract newest Dokuwiki version on the server
• Locate all files with the extension .dist (eg conf/local.php.dist) in the new dokuwiki installation and copy their counterparts without the .dist extension (eg conf/local.php) to the new dokuwiki installation
• Copy additional Interwiki Shortcut images to lib/images/interwiki
• Copy additional smiley images to lib/images/smileys
• chmod a-rwx install.php
• Set owner and group of newDokuwiki/ recursively to root:root
• Set owner and group of newDokuwiki/conf, newDokuwiki/data and newDokuwiki/lib recursively to the ID of your webserver eg. apache:apache
• delete unnecessary language translations with bin/striplangs.php
• Download and install fresh revisions of previously installed additional plugins from the web
• copy data:

  cp -a oldDokuwiki/data/attic/* newDokuwiki/data/attic
  cp -a oldDokuwiki/data/pages/* newDokuwiki/data/pages
  cp -a oldDokuwiki/data/media/* newDokuwiki/data/media
  cp -a oldDokuwiki/data/meta/*  newDokuwiki/data/meta

• Make a list of all files with the extension .sborg (eg. old/conf/acronyms.conf.sborg) in the old dokuwiki installation. Then go to the new dokuwiki installation and copy the corresponding original files to <file>.org (eg. cp new/conf/acronyms.conf new/conf/acronyms.conf.org)
• In the new dokuwiki installation patch <file> with the modifications: merge <file> old/<file>.org old/<file>. Do this for all files on the list where the old changes are still really necessary for the new wiki version.
• Update index with bin/indexer.php. See cli#indexerphp

See also Upgrading Configuration Files with a three-way File Merge & http://www.dokuwiki.org/install:diffupgrade

Move content from beckisownwiki to here!

Info source

Download repository with:

git clone git://github.com/splitbrain/dokuwiki.git # or behind a firewall:
git clone http://github.com/splitbrain/dokuwiki.git

git branch shows existing local branches, while git branch -r causes the „remote-tracking“ branches to be listed, and option -a shows both. See git-branch

With Git it is not possible to directly swich to a different path on a cloned repository like in Mercurial. Instead first you have to create a new (local) branch wich „tracks“ the specified remote brach (origin/stable) and then checkout (=update) this branch to your working directory. The following command does both steps at once:

git checkout -b stable origin/stable

Now you can pull all needed updates whenever a new release is made:

git pull

1. Add URL in dokuwiki/conf/interwiki.conf
2. Add the interwiki icon at dokuwiki/lib/images/interwiki. Possible formats: .gif and .png, but not .ico (Tested with version 2007-06-26b)
3. Delete the cache: rm -rf dokuwiki/data/cache/*
4. Reload the page in browser

See also http://www.dokuwiki.org/interwiki

Still necessary?

Just install the linebreak plugin. No additional config is necessary.

Uncomment

LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so

in /etc/apache/httpd.conf

Make sure that .htaccess file is respected with

<Directory /path/to/dokuwiki>
  AllowOverride All
</Directory>

or

<Directory /var/www/htdocs>
  AllowOverride All
</Directory>

in /etc/apache/httpd.conf

Uncomment everything beginning with #Rewrite… in /var/www/htdocs/dokuwiki/.htaccess, but not the line #RewriteBase /dokuwiki.

Enable rewriting in admin config menu by setting it to type 1

See also: wiki:rewrite

lib/tpl/default/design.css — 2007-01-06 17:16

diff design.css.org design.css

465a466
>   color: darkblue;

This section is just informative for interested people. Indexing works automatically, no configuration has to be done.

The search index is saved in dokuwiki/data/index/.

• The file page.idx lists the filenames of all indexed files. One file per line.
• w<len>.idx lists all occurring words with a length of <len>. One word per line. Eg. w14.idx lists all words with a length of 14 caracters.
• i<len>.idx lists how often all words of <len> characters occur in which pages. Pages are addressed by their line number in page.idx, counting starts with 0. One word per line. The line number of the entrys in i<len>.idx corresponds to the line number in w<len>.idx, i.e. the entry in line 9 in i<len>.idx refers to the word in line 9 in w<len>.idx.
• pageword.idx lists where to find all occurring words of the wiki in the w<len>.idx files for every page. One page per line. The line number corresponds to the line number in page.idx. What is this file used for?

Example:

• w14.idx contains the word developerworks in line 9
• i14.idx contains the line 2*1:5*2:9*1 in line 9. This means the page #2 has 1 occurrence of the word developerworks, page #5 has 2 and page #9 hast 1.
• page.idx contains the word pending in line 5, this is the filename of page #5. Hence the page with the filename pending has 2 occurrences of the word developerworks.