aboutsummaryrefslogtreecommitdiff
path: root/doc/ikiwiki.setup
blob: 10cb3da1d5e26f1c6392ecfa51aaa3cf52f8ea43 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
#!/usr/bin/perl
# Configuration file for ikiwiki.
# Passing this to ikiwiki --setup will make ikiwiki generate wrappers and
# build the wiki.
#
# Remember to re-run ikiwiki --setup any time you edit this file.

use IkiWiki::Setup::Standard {
	wikiname => "MyWiki",
	#adminuser => ["yourname", ],
	adminemail => 'me@example.org',

	# Be sure to customise these..
	srcdir => "/path/to/source",
	destdir => "/var/www/wiki",

	url => "http://example.org/wiki",
	cgiurl => "http://example.org/wiki/ikiwiki.cgi",
	#templatedir => "/usr/share/ikiwiki/templates",
	#underlaydir => "/usr/share/ikiwiki/basewiki",

	# Subversion stuff.
	#rcs => "svn",
	#historyurl => "http://svn.example.org/trunk/[[file]]",
	#diffurl => "http://svn.example.org/trunk/[[file]]?root=wiki&r1=[[r1]]&r2=[[r2]]",
	#svnrepo => "/svn/wiki",
	#svnpath => "trunk",

	# Git stuff.
	#rcs => "git",
	#historyurl => "http://git.example.org/gitweb.cgi?p=wiki.git;a=history;f=[[file]]",
	#diffurl => "http://git.example.org/gitweb.cgi?p=wiki.git;a=blobdiff;h=[[sha1_to]];hp=[[sha1_from]];hb=[[sha1_parent]];f=[[file]]",
	#gitorigin_branch => "origin",
	#gitmaster_branch => "master",

	# Tla stuff.
	#rcs => "tla"
	#historyurl => ??,
	#diffurl => ??,

	# Mercurial stuff.
	#rcs => "mercurial",
	#historyurl => "http://localhost:8000/log/tip/[[file]]", # hg serve'd local repository
	#diffurl => "http://localhost:8000/?fd=[[r2]];file=[[file]]",

	# Bazaar stuff.
	#rcs => "bzr",
	#historyurl => "", 
	#diffurl => "http://example.com/revision?start_revid=[[r2]]#[[file]]-s", # using loggerhead

	# Monotone stuff
	#rcs => "monotone",
	#mtnkey => "web\@machine.company.com",
	#historyurl => "http://viewmtn.example.com/branch/head/filechanges/com.example.branch/[[file]]",
	#diffurl => "http://viewmtn.example.com/revision/diff/[[r1]]/with/[[r2]]/[[file]]",
	# Set if you want the wiki to sync on update and commit.
	#mtnsync => 0,
	# The path to your workspace (defaults to the srcdir itself)
	# e.g. use if your srcdir is a subdirectory of the workspace.
	#mtnrootdir => "path/to/root/of/workspace",

	wrappers => [
		#{
		#	# The cgi wrapper.
		#	cgi => 1,
		#	wrapper => "/var/www/wiki/ikiwiki.cgi",
		#	wrappermode => "06755",
		#},
		#{
		#	# The svn post-commit wrapper.
		#	# Note that this will overwrite any existing
		#	# post-commit hook script, which may not be
		#	# what you want.
		#	wrapper => "/svn/wikirepo/hooks/post-commit",
		#	wrappermode => "04755",
		#	# Log to syslog since svn post-commit hooks
		#	# hide output and errors.
		#	syslog => 1,
		#},
		#{
		#	# The git post-update wrapper.
		#	# Note that this will overwrite any existing
		#	# post-update hook script, which may not be
		#	# what you want.
		#	wrapper => "/git/wiki.git/hooks/post-update",
		#	wrappermode => "06755",
		#},
		#{
		#	# The monotone netsync hook.
		#	wrapper => "path/to/root/of/workspace/_MTN/ikiwiki-netsync-hook",
		#	wrappermode => "06755",
		#},
	],

	# Default to generating rss feeds for pages with feeds?
	#rss => 1,
	# Default to generating atom feeds for pages with feeds?
	#atom => 1,
	# Allow generating feeds even if not generated by default?
	#allowrss => 1,
	#allowatom => 1,
	# Urls to ping with XML-RPC when feeds are updated
	#pingurl => [qw{http://rpc.technorati.com/rpc/ping}],
	# Include discussion links on all pages?
	discussion => 1,
	# To exclude files matching a regexp from processing. This adds to
	# the default exclude list.
	#exclude => qr/\.wav$/,
	# To change the extension used for generated html files.
	#htmlext => 'htm',
	# Time format (for strftime)
	#timeformat => '%c',
	# Locale to use. Must be a UTF-8 locale.
	#locale => 'en_US.UTF-8',
	# Only send cookies over SSL connections.
	#sslcookie => 1,
	# Logging settings:
	#verbose => 1,
	syslog => 0,
	# To link to user pages in a subdirectory of the wiki.
	#userdir => "users",
	# To create output files named page.html rather than page/index.html.
	#usedirs => 0,
	# Simple spam prevention: require an account-creation password.
	#account_creation_password => "example",
	# Cost of generating a password using Authen::Passphrase::BlowfishCrypt
	#password_cost => 8,
	# Uncomment to force ikiwiki to run with a particular umask.
	#umask => 022,
	# Default settings for the recentchanges page.
	#recentchangespage => "recentchanges",
	#recentchangesnum => 100,
	# Use new '!'-prefixed preprocessor directive syntax
	#prefix_directives => 0,
	# Attempt to make hardlinks to source files instead of copying them.
	# Useful if the wiki contains large media files.
	#hardlink => 1,
	# Enable use of multimarkdown features in .mdwn files.
	#multimarkdown => 1,

	# To add plugins, list them here.
	#add_plugins => [qw{goodstuff search wikitext camelcase
	#                   htmltidy fortune sidebar map rst anonok}],
	# If you want to disable any of the default plugins, list them here.
	#disable_plugins => [qw{inline htmlscrubber passwordauth openid}],
	# To add a directory to the perl search path, use this.
	#libdir => "/home/me/.ikiwiki/",
	
	# To override environment variable settings, you can list values here.
	#ENV => {
	#	TZ => "America/New_York",
	#	PATH => "/home/me/bin:/usr/local/bin:/usr/bin:/bin",
	#},

	# For use with the tag plugin, make all tags be located under a
	# base page.
	#tagbase => "tag",

	# For use with the search plugin if the omega cgi is located
	# somewhere else.
	#omega_cgi => "/usr/lib/cgi-bin/omega/omega",

	# For use with the openid plugin, to give an url to a page users
	# can use to signup for an OpenID.
	#openidsignup => "http://myopenid.com/",

	# For use with the mirrorlist plugin, a list of mirrors.
	#mirrorlist => {
	#	mirror1 => "http://hostname1",
	#	mirror2 => "http://hostname2/mirror",
	#},
	
	# For use with the anonok plugin, a PageSpec specifying what
	# pages anonymous users can edit
	#anonok_pagespec => "*",
	
	# For use with the aggregate plugin.
	# Enable aggregation to internal pages. New wikis should set this to 1,
	# but if you use aggregate already, read the aggregate plugin docs
	# before enabling it.
	#aggregateinternal => 1,
	# Allow aggregation to be triggered via the web.
	#aggregate_webtrigger => 1,
	
	# For use with the pinger plugin, how many seconds to wait before
	# timing out.
	#pinger_timeout => 15.
	
	# For use with the amazon S3 plugin, your public access key id.
	#amazon_s3_key_id => 'XXXXXXXXXXXXXXXXXXXX',
	# And a file holding your secret key. This file *must* not be
	# readable by others!
	#amazon_s3_key_file => "/home/me/.hide/.s3_key
	# The globally unique name of the bucket to use to store the wiki.
	#amazon_s3_bucket => "mywiki",
	# A prefix to prepend to each page name.
	#amazon_s3_prefix => "wiki/",
	# Uncomment to use the S3 European datacenter.
	#amazon_s3_location => "EU",
	# Uncomment if you need to store each index file twice.
	#amazon_s3_dupindex => 1,
	
	# For use with the attachment plugin, a program that returns
	# nonzero if its standard input contains an virus.
	#virus_checker => "clamdscan -",
}