This pages replaces beckisownwiki

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

1. Download and extract newest Dokuwiki version on the server. Use Stable (direct link, not customized) from http://download.dokuwiki.org
2. 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
3. Copy additional Interwiki Shortcut images to lib/images/interwiki
4. Copy additional smiley images to lib/images/smileys
5. chmod a-rwx install.php to run it?
6. Set owner and group of newDokuwiki/ recursively to root:root
7. Set owner and group of newDokuwiki/conf, newDokuwiki/data and newDokuwiki/lib recursively to the ID of your webserver eg. apache:apache. Optionally finetune permissinons
8. delete unnecessary language translations with bin/striplangs.php did not work with 2014-09-29d „Hrun“ (deleted every lang except en)
9. Download and install fresh revisions of previously installed additional plugins from the web
10. 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

11. 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>.sborg (eg. cp new/conf/acronyms.conf new/conf/acronyms.conf.sborg)
12. In the new dokuwiki installation patch <file> with the modifications: merge <file> old/<file>.sborg old/<file>. Do this for all files on the list where the old changes are still really necessary for the new wiki version.
    Note that it might be necessary to treat .htaccess manually.
13. 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!

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.

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

Look for the stable branch in the remote repo which you will use as base:

git branch -r

And copy it into a local branch:

git checkout -b stable origin/stable

Create a private branch for your modifications:

git checkout -b mysettings stable
(make your changes)
git commit -a -m '...'

Now you can pull all needed updates whenever a new release comes out:

git checkout stable
git pull
git checkout mysettings
git merge stable

See also branches

You could also directly work on branch stable instead of creating mysettings. But this seems not to be idiomatic git usage.