Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
becki:linux:dokuwiki_tips [2015-05-07 11:16] becki |
becki:linux:dokuwiki_tips [2016-04-04 12:33] (aktuell) becki |
||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
====== Dokuwiki Tips == | ====== Dokuwiki Tips == | ||
===== Updating Dokuwiki == | ===== Updating Dokuwiki == | ||
+ | |||
+ | <note important>Consider the [[https://www.dokuwiki.org/install:upgrade|recommended]] approach which overwrites the old installation instead of the manual here!</note> | ||
This manual presumes that you saved a copy of the //original// config files with the extension ''.sborg'' //before// you made any changes! | This manual presumes that you saved a copy of the //original// config files with the extension ''.sborg'' //before// you made any changes! | ||
- Download and extract newest Dokuwiki version on the server. Use Stable (direct link, not customized) from http://download.dokuwiki.org | - Download and extract newest Dokuwiki version on the server. Use Stable (direct link, not customized) from http://download.dokuwiki.org | ||
- | - 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 | + | - 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.\\ Note that it might be necessary to treat ''.htaccess'' manually! |
- Copy additional Interwiki Shortcut images to ''lib/images/interwiki'' | - Copy additional Interwiki Shortcut images to ''lib/images/interwiki'' | ||
- Copy additional smiley images to ''lib/images/smileys'' | - Copy additional smiley images to ''lib/images/smileys'' | ||
Zeile 11: | Zeile 13: | ||
- Set owner and group of ''newDokuwiki/'' recursively to ''root:root'' | - 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''. [[doku>install:permissions|Optionally finetune permissinons]] | - Set owner and group of ''newDokuwiki/conf'', ''newDokuwiki/data'' and ''newDokuwiki/lib'' recursively to the ID of your webserver eg. ''apache:apache''. [[doku>install:permissions|Optionally finetune permissinons]] | ||
- | - delete unnecessary language translations with ''bin/striplangs.php'' FIXME did not work with 2014-09-29d "Hrun" (deleted every lang except en) | + | - delete unnecessary language translations with ''bin/striplangs.php'' |
- Download and install fresh revisions of previously installed additional plugins from the web | - Download and install fresh revisions of previously installed additional plugins from the web | ||
+ | - 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'') | ||
+ | - In the //new// dokuwiki installation [[diffupgrade|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. | ||
- copy data: <code bash> | - copy data: <code bash> | ||
cp -a oldDokuwiki/data/attic/* newDokuwiki/data/attic | cp -a oldDokuwiki/data/attic/* newDokuwiki/data/attic | ||
Zeile 19: | Zeile 23: | ||
cp -a oldDokuwiki/data/meta/* newDokuwiki/data/meta | cp -a oldDokuwiki/data/meta/* newDokuwiki/data/meta | ||
</code> | </code> | ||
- | - 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'') | + | - Restore the content of the namespaces ''wiki'' and ''playground'' from the newDokuwiki |
- | - In the //new// dokuwiki installation [[diffupgrade|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. | + | |
- Update index with ''bin/indexer.php''. See [[doku>cli#indexerphp]] | - Update index with ''bin/indexer.php''. See [[doku>cli#indexerphp]] | ||
+ | |||
+ | Note: After update to 2014-09-29d "Hrun" the toolbar icons were missing in the edit page. Try: | ||
+ | - [[doku>faq:toolbar]] | ||
+ | - Admin -> Configuration Settings -> cssdatauri from 0 to 500. | ||
See also [[diffupgrade]] & http://www.dokuwiki.org/install:diffupgrade | See also [[diffupgrade]] & http://www.dokuwiki.org/install:diffupgrade | ||
- | |||
- | FIXME Move content from [[becki:my:linux:beckisownwiki]] to here! | ||
===== Add an Interwiki Shortcut == | ===== Add an Interwiki Shortcut == | ||
Zeile 36: | Zeile 41: | ||
See also http://www.dokuwiki.org/interwiki | See also http://www.dokuwiki.org/interwiki | ||
- | ===== Linebreak Plugin == | + | ===== Enable Linebreaks == |
- | FIXME Still necessary? | + | Install [[doku>plugin:xbr]] plugin and set ''renderer_xhtml'' to ''xbr'' in Configuration Settings |
- | + | ||
- | Just install the [[doku>plugin:linebreak|linebreak plugin]]. No additional config is necessary. | + | |
===== URL Rewriting == | ===== URL Rewriting == | ||
Zeile 67: | Zeile 70: | ||
See also: [[doku>wiki:rewrite]] | See also: [[doku>wiki:rewrite]] | ||
- | |||
- | ===== monospaced in blue == | ||
- | |||
- | lib/tpl/default/design.css --- 2007-01-06 17:16 | ||
- | |||
- | diff design.css.org design.css | ||
- | <code> | ||
- | 465a466 | ||
- | > color: darkblue; | ||
- | </code> | ||
===== How the Search Index works == | ===== How the Search Index works == | ||
Zeile 127: | Zeile 120: | ||
You could also directly work on branch ''stable'' instead of creating ''mysettings''. But this seems not to be idiomatic git usage. | You could also directly work on branch ''stable'' instead of creating ''mysettings''. But this seems not to be idiomatic git usage. | ||
+ | |||
+ | ==== monospaced in blue == | ||
+ | |||
+ | lib/tpl/default/design.css --- 2007-01-06 17:16 | ||
+ | |||
+ | diff design.css.org design.css | ||
+ | <code> | ||
+ | 465a466 | ||
+ | > color: darkblue; | ||
+ | </code> | ||
==== Update Manual == | ==== Update Manual == |