xref: /dokuwiki/conf/dokuwiki.php (revision 44881d272282937c9bb745f462c947319d404dd0)
1<?php
2/**
3 * This is DokuWiki's Main Configuration file
4 * This is a piece of PHP code so PHP syntax applies!
5 *
6 * For help with the configuration see http://www.splitbrain.org/dokuwiki/wiki:config
7 */
8
9
10/* Datastorage and Permissions */
11#$conf['umask']       = 0002;              //set the global umask
12#$conf['fmode']       = 0666;              //set file creation mode
13#$conf['dmode']       = 0777;              //set direction creation mode
14
15$conf['lang']        = 'en';              //your language
16$conf['basedir']     = '';                //absolute dir from serveroot - blank for autodetection
17$conf['baseurl']     = '';                //URL to server including protocol - blank for autodetect
18$conf['savedir']     = './data';          //where to store all the files
19$conf['allowdebug']  = 1;                 //make debug possible, disable after install! 0|1
20
21/* Display Options */
22
23$conf['start']       = 'start';           //name of start page
24$conf['title']       = 'DokuWiki';        //what to show in the title
25$conf['template']    = 'default';         //see tpl directory
26$conf['fullpath']    = 0;                 //show full path of the document or relative to datadir only? 0|1
27$conf['recent']      = 20;                //how many entries to show in recent
28$conf['breadcrumbs'] = 10;                //how many recent visited pages to show
29$conf['youarehere']  = 0;                 //show "You are here" navigation? 0|1
30$conf['typography']  = 1;                 //convert quotes, dashes and stuff to typographic equivalents? 0|1
31$conf['htmlok']      = 0;                 //may raw HTML be embedded? This may break layout and XHTML validity 0|1
32$conf['phpok']       = 0;                 //may PHP code be embedded? Never do this on the internet! 0|1
33$conf['dformat']     = 'Y/m/d H:i';       //dateformat accepted by PHPs date() function
34$conf['signature']   = ' --- //[[@MAIL@|@NAME@]] @DATE@//'; //signature see wiki:config for details
35$conf['toptoclevel'] = 1;                 //Level starting with and below to include in AutoTOC (max. 5)
36$conf['maxtoclevel'] = 3;                 //Up to which level include into AutoTOC (max. 5)
37$conf['maxseclevel'] = 3;                 //Up to which level create editable sections (max. 5)
38$conf['camelcase']   = 0;                 //Use CamelCase for linking? (I don't like it) 0|1
39$conf['deaccent']    = 1;                 //deaccented chars in pagenames (1) or romanize (2) or keep (0)?
40$conf['useheading']  = 0;                 //use the first heading in a page as its name
41$conf['refcheck']    = 1;                 //check for references before deleting media files
42$conf['refshow']     = 0;                 //how many references should be shown, 5 is a good value
43
44/* Antispam Features */
45
46$conf['usewordblock']= 1;                 //block spam based on words? 0|1
47$conf['indexdelay']  = 60*60*24*5;        //allow indexing after this time (seconds) default is 5 days
48$conf['relnofollow'] = 1;                 //use rel="nofollow" for external links?
49$conf['mailguard']   = 'hex';             //obfuscate email addresses against spam harvesters?
50                                          //valid entries are:
51                                          //  'visible' - replace @ with [at], . with [dot] and - with [dash]
52                                          //  'hex'     - use hex entities to encode the mail address
53                                          //  'none'    - do not obfuscate addresses
54
55/* Authentication Options - read http://www.splitbrain.org/dokuwiki/wiki:acl */
56$conf['useacl']      = 0;                //Use Access Control Lists to restrict access?
57$conf['openregister']= 1;                //Should users to be allowed to register?
58$conf['autopasswd']  = 1;                //autogenerate passwords and email them to user
59$conf['resendpasswd']= 0;                //allow resend password function?
60$conf['authtype']    = 'plain';          //which authentication backend should be used
61$conf['passcrypt']   = 'smd5';           //Used crypt method (smd5,md5,sha1,ssha,crypt,mysql,my411)
62$conf['defaultgroup']= 'user';           //Default groups new Users are added to
63$conf['superuser']   = '!!not set!!';    //The admin can be user or @group
64$conf['profileconfirm'] = '1';           //Require current password to confirm changes to user profile
65
66/* Advanced Options */
67$conf['userewrite']  = 0;                //this makes nice URLs: 0: off 1: .htaccess 2: internal
68$conf['useslash']    = 0;                //use slash instead of colon? only when rewrite is on
69$conf['sepchar']     = '_';              //word separator character in page names; may be a
70                                         //  letter, a digit, '_', '-', or '.'.
71$conf['canonical']   = 0;                //Should all URLs use full canonical http://... style?
72$conf['autoplural']  = 0;                //try (non)plural form of nonexisting files?
73$conf['usegzip']     = 1;                //gzip old revisions?
74$conf['cachetime']   = 60*60*24;         //maximum age for cachefile in seconds (defaults to a day)
75$conf['purgeonadd']  = 1;                //purge cache when a new file is added (needed for up to date links)
76$conf['locktime']    = 15*60;            //maximum age for lockfiles (defaults to 15 minutes)
77$conf['notify']      = '';               //send change info to this email (leave blank for nobody)
78$conf['mailfrom']    = '';               //use this email when sending mails
79$conf['gdlib']       = 2;                //the GDlib version (0, 1 or 2) 2 tries to autodetect
80$conf['im_convert']  = '';               //path to ImageMagicks convert (will be used instead of GD)
81$conf['spellchecker']= 0;                //enable Spellchecker (needs PHP >= 4.3.0 and aspell installed)
82$conf['subscribers'] = 0;                //enable change notice subscription support
83$conf['compress']    = 1;                //Strip whitespaces and comments from Styles and JavaScript? 1|0
84$conf['hidepages']   = '';               //Regexp for pages to be skipped from RSS, Search and Recent Changes
85$conf['send404']     = 0;                //Send a HTTP 404 status for non existing pages?
86$conf['sitemap']     = 0;                //Create a google sitemap? How often? In days.
87$conf['rss_type']    = 'rss1';           //type of RSS feed to provide, by default:
88                                         //  'rss'  - RSS 0.91
89                                         //  'rss1' - RSS 1.0
90                                         //  'rss2' - RSS 2.0
91                                         //  'atom' - Atom 0.3
92$conf['rss_linkto'] = 'diff';            //what page RSS entries link to:
93                                         //  'diff'    - page showing revision differences
94                                         //  'page'    - the revised page itself
95                                         //  'rev'     - page showing all revisions
96                                         //  'current' - most recent revision of page
97
98//Set target to use when creating links - leave empty for same window
99$conf['target']['wiki']      = '';
100$conf['target']['interwiki'] = '_blank';
101$conf['target']['extern']    = '_blank';
102$conf['target']['media']     = '';
103$conf['target']['windows']   = '';
104
105//Proxy setup - if your Server needs a proxy to access the web set these
106$conf['proxy']['host'] = '';
107$conf['proxy']['port'] = '';
108$conf['proxy']['user'] = '';
109$conf['proxy']['pass'] = '';
110$conf['proxy']['ssl']  = 0;
111
112/* Safemode Hack */
113$conf['safemodehack'] = 0;               //read http://wiki.splitbrain.org/wiki:safemodehack !
114$conf['ftp']['host'] = 'localhost';
115$conf['ftp']['port'] = '21';
116$conf['ftp']['user'] = 'user';
117$conf['ftp']['pass'] = 'password';
118$conf['ftp']['root'] = '/home/user/htdocs';
119
120