summaryrefslogtreecommitdiff
path: root/ikiwiki_admin.setup
blob: 707b894bc4e89c56c2ea5d3d39feda66550a5bb4 (plain)
  1. #!/usr/bin/perl
  2. # Setup file for ikiwiki.
  3. #
  4. # Passing this to ikiwiki --setup will make ikiwiki generate
  5. # wrappers and build the wiki.
  6. #
  7. # Remember to re-run ikiwiki --setup any time you edit this file.
  8. our ($basedir, $builddir, $domain, $gitrepo);
  9. BEGIN {
  10. # git hook requires full path as basedir: $ENV{'HOME'} . '/mywiki'
  11. $basedir = $ENV{'SRCDIR'} || $ENV{'PWD'};
  12. $builddir = $ENV{'BUILDDIR'} || $basedir . '/build';
  13. $domain = 'example.org';
  14. $gitrepo = 'wiki';
  15. }
  16. use IkiWiki::Setup::Standard {
  17. # name of the wiki
  18. wikiname => 'MyWiki',
  19. # contact email for wiki
  20. #adminemail => 'me@' . $domain,
  21. # users who are wiki admins
  22. adminuser => [],
  23. # users who are banned from the wiki
  24. banned_users => [],
  25. # where the source of the wiki is located
  26. srcdir => $basedir . '/content',
  27. # where to build the wiki
  28. destdir => $builddir . '/html-admin',
  29. # base url to the wiki
  30. url => 'http://admin.' . $domain . '/',
  31. # url to the ikiwiki.cgi
  32. cgiurl => 'http://admin.' . $domain . '/ikiwiki.cgi',
  33. # cgi wrapper to generate
  34. cgi_wrapper => $builddir . '/cgi-admin/ikiwiki.cgi',
  35. # mode for cgi_wrapper (can safely be made suid)
  36. cgi_wrappermode => '00755',
  37. # rcs backend to use
  38. rcs => 'git',
  39. # plugins to add to the default configuration
  40. add_plugins => [qw{
  41. h1title
  42. }],
  43. # plugins to disable
  44. disable_plugins => [qw{
  45. }],
  46. # location of template files
  47. templatedir => $basedir . '/templates',
  48. # base wiki source location
  49. underlaydir => $basedir . '/basewiki',
  50. # display verbose messages when building?
  51. #verbose => 1,
  52. # log to syslog?
  53. #syslog => 1,
  54. # create output files named page/index.html?
  55. usedirs => 1,
  56. # use '!'-prefixed preprocessor directives?
  57. prefix_directives => 1,
  58. # use page/index.mdwn source files
  59. indexpages => 0,
  60. # enable Discussion pages?
  61. discussion => 1,
  62. # only send cookies over SSL connections?
  63. sslcookie => 0,
  64. # extension to use for new pages
  65. default_pageext => 'mdwn',
  66. # extension to use for html files
  67. htmlext => 'html',
  68. # strftime format string to display date
  69. timeformat => '%c',
  70. # UTF-8 locale to use
  71. locale => 'en_US.UTF-8',
  72. # put user pages below specified page
  73. userdir => '',
  74. # how many backlinks to show before hiding excess (0 to show all)
  75. numbacklinks => 10,
  76. # attempt to hardlink source files? (optimisation for large files)
  77. hardlink => 0,
  78. # force ikiwiki to use a particular umask
  79. #umask => 022,
  80. # extra library and plugin directory
  81. libdir => $basedir . '/perl',
  82. # environment variables
  83. ENV => {},
  84. # regexp of source files to ignore
  85. #exclude => '\\.wav$',
  86. # specifies the characters that are allowed in source filenames
  87. wiki_file_chars => '-[:alnum:]+/.:_',
  88. # allow symlinks in the path leading to the srcdir (potentially insecure)
  89. allow_symlinks_before_srcdir => 0,
  90. # aggregate plugin
  91. # enable aggregation to internal pages?
  92. #aggregateinternal => 0,
  93. # allow aggregation to be triggered via the web?
  94. #aggregate_webtrigger => 0,
  95. # amazon_s3 plugin
  96. # public access key id
  97. #amazon_s3_key_id => 'XXXXXXXXXXXXXXXXXXXX',
  98. # file holding secret key (must not be readable by others!)
  99. #amazon_s3_key_id => 's3_key',
  100. # globally unique name of bucket to store wiki in
  101. #amazon_s3_bucket => 'mywiki',
  102. # a prefix to prepend to each page name
  103. #amazon_s3_prefix => 'wiki/',
  104. # which S3 datacenter to use (leave blank for default)
  105. #amazon_s3_location => 'EU',
  106. # store each index file twice? (allows urls ending in "/index.html" and "/")
  107. #amazon_s3_dupindex => 0,
  108. # anonok plugin
  109. # PageSpec to limit which pages anonymous users can edit
  110. #anonok_pagespec => '*/discussion',
  111. # attachment plugin
  112. # enhanced PageSpec specifying what attachments are allowed
  113. #allowed_attachments => 'virusfree() and mimetype(image/*) and maxsize(50kb)',
  114. # virus checker program (reads STDIN, returns nonzero if virus found)
  115. #virus_checker => 'clamdscan -',
  116. # calendar plugin
  117. # base of the archives hierarchy
  118. #archivebase => 'archives',
  119. # git plugin
  120. # git hook to generate
  121. git_wrapper => $builddir . '/git/post-update-ikiwiki-admin',
  122. # mode for git_wrapper (can safely be made suid)
  123. git_wrappermode => '06755',
  124. # gitweb url to show file history ([[file]] substituted)
  125. historyurl => 'http://source.' . $domain . '/gitweb.cgi?p=' . $gitrepo . '.git;a=history;f=[[file]]', # ;hb=master
  126. # gitweb url to show a diff ([[sha1_to]], [[sha1_from]], [[sha1_parent]], and [[file]] substituted)
  127. diffurl => 'http://source.' . $domain . '/gitweb.cgi?p=' . $gitrepo . '.git;a=blobdiff;h=[[sha1_to]];hp=[[sha1_from]];hb=[[sha1_parent]];f=[[file]]',
  128. # where to pull and push changes (set to empty string to disable)
  129. #gitorigin_branch => 'samplewiki',
  130. # branch that the wiki is stored in
  131. #gitmaster_branch => 'master',
  132. # htmlscrubber plugin
  133. # PageSpec specifying pages not to scrub
  134. #htmlscrubber_skip => '!*/Discussion',
  135. # inline plugin
  136. # enable rss feeds by default?
  137. #rss => 0,
  138. # enable atom feeds by default?
  139. #atom => 0,
  140. # allow rss feeds to be used?
  141. #allowrss => 0,
  142. # allow atom feeds to be used?
  143. #allowatom => 0,
  144. # urls to ping (using XML-RPC) on feed update
  145. #pingurl => 'http://rpc.technorati.com/rpc/ping',
  146. # listdirectives plugin
  147. # directory in srcdir that contains directive descriptions
  148. #directive_description_dir => 'ikiwiki/directive',
  149. # lockedit plugin
  150. # PageSpec controlling which pages are locked
  151. #locked_pages => '!*/Discussion',
  152. # mdwn plugin
  153. # enable multimarkdown features?
  154. #multimarkdown => 0,
  155. # mirrorlist plugin
  156. # list of mirrors
  157. #mirrorlist => {},
  158. # openid plugin
  159. # an url where users can signup for an OpenID
  160. #openidsignup => 'http://myopenid.com/',
  161. # passwordauth plugin
  162. # a password that must be entered when signing up for an account
  163. #account_creation_password => 's3cr1t',
  164. # cost of generating a password using Authen::Passphrase::BlowfishCrypt
  165. #password_cost => 8,
  166. # pinger plugin
  167. # how many seconds to try pinging before timing out
  168. #pinger_timeout => 15,
  169. # prettydate plugin
  170. # format to use to display date
  171. #prettydateformat => '%X, %B %o, %Y',
  172. # recentchanges plugin
  173. # name of the recentchanges page
  174. #recentchangespage => 'recentchanges',
  175. # number of changes to track
  176. #recentchangesnum => 100,
  177. # search plugin
  178. # path to the omega cgi program
  179. #omega_cgi => '/usr/lib/cgi-bin/omega/omega',
  180. # tag plugin
  181. # parent page tags are located under
  182. #tagbase => 'tag',
  183. # teximg plugin
  184. # Should teximg use dvipng to render, or dvips and convert?
  185. #teximg_dvipng => '',
  186. # LaTeX prefix for teximg plugin
  187. #teximg_prefix => '\\documentclass{article}
  188. #\\usepackage{amsmath}
  189. #\\usepackage{amsfonts}
  190. #\\usepackage{amssymb}
  191. #\\pagestyle{empty}
  192. #\\begin{document}
  193. #',
  194. # LaTeX postfix for teximg plugin
  195. #teximg_postfix => '\\end{document}',
  196. # typography plugin
  197. # Text::Typography attributes value
  198. #typographyattributes => '3',
  199. # websetup plugin
  200. # list of plugins that cannot be enabled/disabled via the web interface
  201. #websetup_force_plugins => [],
  202. # show unsafe settings, read-only, in web interface?
  203. #websetup_show_unsafe => 1,
  204. # varioki plugin (strings are eval'ed: double-quote actual strings!)
  205. #varioki => {
  206. # 'branding_logo_text' => '"Example Website"',
  207. # 'branding_logo' => '"logo.png"',
  208. # 'branding_logo_tagline' => '"Yet another ikiwiki site!"',
  209. #},
  210. }