3 * This is DokuWiki's Main Configuration file
5 * All the default values are kept here, you should not modify it but use
6 * a local.php file instead to override the settings from here.
8 * This is a piece of PHP code so PHP syntax applies!
10 * For help with the configuration see http://www.splitbrain.org/dokuwiki/wiki:config
14 /* Datastorage and Permissions */
16 $conf['fmode'] = 0644; //set file creation mode
17 $conf['dmode'] = 0755; //set directory creation mode
18 $conf['lang'] = 'en'; //your language
19 $conf['basedir'] = ''; //absolute dir from serveroot - blank for autodetection
20 $conf['baseurl'] = ''; //URL to server including protocol - blank for autodetect
21 $conf['savedir'] = './data'; //where to store all the files
22 $conf['allowdebug'] = 0; //allow debug output, enable if needed 0|1
26 $conf['start'] = 'start'; //name of start page
27 $conf['title'] = 'DokuWiki'; //what to show in the title
28 $conf['template'] = 'default'; //see lib/tpl directory
29 $conf['license'] = 'cc-by-nc-sa'; //see conf/license.php
30 $conf['fullpath'] = 0; //show full path of the document or relative to datadir only? 0|1
31 $conf['recent'] = 20; //how many entries to show in recent
32 $conf['breadcrumbs'] = 10; //how many recent visited pages to show
33 $conf['youarehere'] = 0; //show "You are here" navigation? 0|1
34 $conf['typography'] = 1; //smartquote conversion 0=off, 1=doublequotes, 2=all quotes
35 $conf['htmlok'] = 0; //may raw HTML be embedded? This may break layout and XHTML validity 0|1
36 $conf['phpok'] = 0; //may PHP code be embedded? Never do this on the internet! 0|1
37 $conf['dformat'] = '%Y/%m/%d %H:%M'; //dateformat accepted by PHPs strftime() function
38 $conf['signature'] = ' --- //[[@MAIL@|@NAME@]] @DATE@//'; //signature see wiki:config for details
39 $conf['toptoclevel'] = 1; //Level starting with and below to include in AutoTOC (max. 5)
40 $conf['tocminheads'] = 3; //Minimum amount of headlines that determines if a TOC is built
41 $conf['maxtoclevel'] = 3; //Up to which level include into AutoTOC (max. 5)
42 $conf['maxseclevel'] = 3; //Up to which level create editable sections (max. 5)
43 $conf['camelcase'] = 0; //Use CamelCase for linking? (I don't like it) 0|1
44 $conf['deaccent'] = 1; //deaccented chars in pagenames (1) or romanize (2) or keep (0)?
45 $conf['useheading'] = 0; //use the first heading in a page as its name
46 $conf['refcheck'] = 1; //check for references before deleting media files
47 $conf['refshow'] = 0; //how many references should be shown, 5 is a good value
48 $conf['showuseras'] = 'loginname'; // 'loginname' users login name
49 // 'username' users full name
50 // 'email' e-mail address (will be obfuscated as per mailguard)
51 // 'email_link' e-mail address as a mailto: link (obfuscated)
53 /* Antispam Features */
55 $conf['usewordblock']= 1; //block spam based on words? 0|1
56 $conf['indexdelay'] = 60*60*24*5; //allow indexing after this time (seconds) default is 5 days
57 $conf['relnofollow'] = 1; //use rel="nofollow" for external links?
58 $conf['mailguard'] = 'hex'; //obfuscate email addresses against spam harvesters?
60 // 'visible' - replace @ with [at], . with [dot] and - with [dash]
61 // 'hex' - use hex entities to encode the mail address
62 // 'none' - do not obfuscate addresses
63 $conf['iexssprotect']= 1; // check for JavaScript and HTML in uploaded files 0|1
65 /* Authentication Options - read http://www.splitbrain.org/dokuwiki/wiki:acl */
67 $conf['useacl'] = 0; //Use Access Control Lists to restrict access?
68 $conf['autopasswd'] = 1; //autogenerate passwords and email them to user
69 $conf['authtype'] = 'plain'; //which authentication backend should be used
70 $conf['passcrypt'] = 'smd5'; //Used crypt method (smd5,md5,sha1,ssha,crypt,mysql,my411)
71 $conf['defaultgroup']= 'user'; //Default groups new Users are added to
72 $conf['superuser'] = '!!not set!!'; //The admin can be user or @group or comma separated list user1,@group1,user2
73 $conf['manager'] = '!!not set!!'; //The manager can be user or @group or comma separated list user1,@group1,user2
74 $conf['profileconfirm'] = 1; //Require current password to confirm changes to user profile
75 $conf['disableactions'] = ''; //comma separated list of actions to disable
76 $conf['sneaky_index'] = 0; //check for namespace read permission in index view (0|1) (1 might cause unexpected behavior)
77 $conf['auth_security_timeout'] = 900; //time (seconds) auth data is considered valid, set to 0 to recheck on every page view
78 $conf['securecookie'] = 1; //never send HTTPS cookies via HTTP
80 $conf['xmlrpc'] = 0; //Enable/disable XML-RPC interface
81 $conf['xmlrpcuser'] = '!!not set!!'; //Restrict XML-RPC access to this groups/users
83 /* Advanced Options */
85 $conf['updatecheck'] = 1; //automatically check for new releases?
86 $conf['userewrite'] = 0; //this makes nice URLs: 0: off 1: .htaccess 2: internal
87 $conf['useslash'] = 0; //use slash instead of colon? only when rewrite is on
88 $conf['usedraft'] = 1; //automatically save a draft while editing (0|1)
89 $conf['sepchar'] = '_'; //word separator character in page names; may be a
90 // letter, a digit, '_', '-', or '.'.
91 $conf['canonical'] = 0; //Should all URLs use full canonical http://... style?
92 $conf['autoplural'] = 0; //try (non)plural form of nonexisting files?
93 $conf['compression'] = 'gz'; //compress old revisions: (0: off) ('gz': gnuzip) ('bz2': bzip)
94 // bz2 generates smaller files, but needs more cpu-power
95 $conf['cachetime'] = 60*60*24; //maximum age for cachefile in seconds (defaults to a day)
96 $conf['locktime'] = 15*60; //maximum age for lockfiles (defaults to 15 minutes)
97 $conf['fetchsize'] = 0; //maximum size (bytes) fetch.php may download from extern, disabled by default
98 $conf['notify'] = ''; //send change info to this email (leave blank for nobody)
99 $conf['registernotify'] = ''; //send info about newly registered users to this email (leave blank for nobody)
100 $conf['mailfrom'] = ''; //use this email when sending mails
101 $conf['gzip_output'] = 0; //use gzip content encodeing for the output xhtml (if allowed by browser)
102 $conf['gdlib'] = 2; //the GDlib version (0, 1 or 2) 2 tries to autodetect
103 $conf['im_convert'] = ''; //path to ImageMagicks convert (will be used instead of GD)
104 $conf['jpg_quality'] = '70'; //quality of compression when scaling jpg images (0-100)
105 $conf['subscribers'] = 0; //enable change notice subscription support
106 $conf['compress'] = 1; //Strip whitespaces and comments from Styles and JavaScript? 1|0
107 $conf['hidepages'] = ''; //Regexp for pages to be skipped from RSS, Search and Recent Changes
108 $conf['send404'] = 0; //Send a HTTP 404 status for non existing pages?
109 $conf['sitemap'] = 0; //Create a google sitemap? How often? In days.
110 $conf['rss_type'] = 'rss1'; //type of RSS feed to provide, by default:
115 // 'atom1' - Atom 1.0
116 $conf['rss_linkto'] = 'diff'; //what page RSS entries link to:
117 // 'diff' - page showing revision differences
118 // 'page' - the revised page itself
119 // 'rev' - page showing all revisions
120 // 'current' - most recent revision of page
121 $conf['rss_content'] = 'abstract'; // what to put in the items by deafult?
122 // 'abstract' - plain text, first paragraph or so
123 // 'diff' - plain text unified diff wrapped in <pre> tags
124 // 'htmldiff' - diff as HTML table
125 // 'html' - the full page rendered in XHTML
126 $conf['rss_update'] = 5*60; //Update the RSS feed every n seconds (defaults to 5 minutes)
127 $conf['recent_days'] = 7; //How many days of recent changes to keep. (days)
128 $conf['rss_show_summary'] = 1; //Add revision summary to title? 0|1
129 $conf['broken_iua'] = 0; //Platform with broken ignore_user_abort (IIS+CGI) 0|1
130 $conf['xsendfile'] = 0; //Use X-Sendfile (1 = lighttpd, 2 = standard)
131 $conf['renderer_xhtml'] = 'xhtml'; //renderer to use for main page generation
132 $conf['rememberme'] = 1; //Enable/disable remember me on login
134 //Set target to use when creating links - leave empty for same window
135 $conf['target']['wiki'] = '';
136 $conf['target']['interwiki'] = '';
137 $conf['target']['extern'] = '';
138 $conf['target']['media'] = '';
139 $conf['target']['windows'] = '';
141 //Proxy setup - if your Server needs a proxy to access the web set these
142 $conf['proxy']['host'] = '';
143 $conf['proxy']['port'] = '';
144 $conf['proxy']['user'] = '';
145 $conf['proxy']['pass'] = '';
146 $conf['proxy']['ssl'] = 0;
150 $conf['safemodehack'] = 0; //read http://www.dokuwiki.org/config:safemodehack !
151 $conf['ftp']['host'] = 'localhost';
152 $conf['ftp']['port'] = '21';
153 $conf['ftp']['user'] = 'user';
154 $conf['ftp']['pass'] = 'password';
155 $conf['ftp']['root'] = '/home/user/htdocs';
