ikiwiki.setup

   1 # IkiWiki::Setup::Yaml - YAML formatted setup file
   2 #
   3 # Setup file for ikiwiki.
   4 #
   5 # Passing this to ikiwiki --setup will make ikiwiki generate
   6 # wrappers and build the wiki.
   7 #
   8 # Remember to re-run ikiwiki --setup any time you edit this file.
   9 #
  10 # name of the wiki
  11 wikiname: ikiwiki
  12 # contact email for wiki
  13 adminemail: joey@ikiwiki.info
  14 # users who are wiki admins
  15 adminuser:
  16 - http://joey.kitenet.net/
  17 - http://joeyh.name/
  18 # users who are banned from the wiki
  19 banned_users:
  20 - http://tonyguards.myopenid.com/
  21 - http://butoijoh.myopenid.com/
  22 - ip(62.219.8.238)
  23 - ip(184.105.146.11)
  24 - ip(184.105.146.6)
  25 - ip(149.135.147.88)
  26 - https://www.google.com/accounts/o8/id?id=AItOawnAq_X98v6qKJFwl-MyLb440vC8laTdiMg
  27 - https://www.google.com/accounts/o8/id?id=AItOawm_nWF_tPw8mLI7rMxfykA_d3FehQNvWpI
  28 - https://www.google.com/accounts/o8/id?id=AItOawkTn3HixU2KJIvvLXLqwYUzlDGDtYf43GE
  29 - https://www.google.com/accounts/o8/id?id=AItOawkDOCT-KTCLpieip-2W0N51gZwF7nGLaS0
  30 - https://www.google.com/accounts/o8/id?id=AItOawl8-V-Yp0F5ZWRmDb7j4ul1gsbMXjghDIU
  31 - https://www.google.com/accounts/o8/id?id=AItOawkaL6e6GtpyD7gJyqHphon_5ES1ACDLJgg
  32 - https://www.google.com/accounts/o8/id?id=AItOawnv-w7GplWln2P55lnzc6Ds-ltzk6sNxDY
  33 - https://me.yahoo.com/a/3hUnH9Qi24uk3RwCwHATJBWKVyqc#7d8b8
  34 - ip(95.65.50.150)
  35 - https://me.yahoo.com/a/2.Pjpm0G0Z6F9LiGW4cYO84pIrb.Lg--#137de
  36 - https://www.google.com/accounts/o8/id?id=AItOawkuR0eo_HO1s1hs49h0Y_4Bzm08l9evMEc
  37 - https://www.google.com/accounts/o8/id?id=AItOawlYXeKSEBoSCzES7o5VYiSratG5RfNucL0
  38 - https://www.google.com/accounts/o8/id?id=AItOawl_wuvPHDhkuMVnEOP5jLrZyd3nnBs8YRw
  39 - ip(115.43.30.149)
  40 - ikiwikiweb
  41 - webkatalog
  42 - ip(117.201.35.183)
  43 - adrianna
  44 - ip(94.179.251.118)
  45 - capitaine
  46 - ip(74.63.117.196)
  47 - ip(74.63.117.195)
  48 - testerer
  49 - ip(86.103.200.90)
  50 - AlbertF
  51 - ip(71.132.208.155)
  52 - MariaJackson
  53 - ip(208.75.10.42)
  54 - HelenOliver
  55 - ip(222.127.197.140)
  56 - GraceTemplman46
  57 - diannetyron
  58 - ip(119.111.124.194)
  59 - http://cmelbye.myopenid.com/
  60 - autobahnned
  61 - icerain321
  62 - shoesorder
  63 - AdamMeyars
  64 - essaywriter
  65 - blahgrad
  66 - alicia.warner
  67 - WikiJeanHawkins
  68 - nicole.adams
  69 - Smith
  70 - quentin
  71 - quentinfudge
  72 - https://www.google.com/accounts/o8/id?id=AItOawkJHb27RVmw93kqyzfoxZWNKjqR8MEVt3A
  73 - ip(123.26.115.218)
  74 - https://www.google.com/accounts/o8/id?id=AItOawkljravtnjpauReS81ng5zVurZx_thpse8
  75 - ip(123.26.124.157)
  76 - KataMutiara
  77 - tekschen
  78 - webschen1
  79 - ip(79.228.*.*)
  80 - soman81
  81 - ip(31.17.11.19)
  82 - spain1001
  83 - ip(80.187.*.*)
  84 - Toni
  85 - ip(124.105.173.121)
  86 - domtheo9110
  87 - https://www.google.com/accounts/o8/id?id=AItOawnO6NxsiqDMNHCMugqNKPwCWmTAQ7v_2Fs
  88 - ip(58.186.127.104)
  89 - https://pypi.python.org/id/tlevine
  90 - ip(82.153.13.48)
  91 # where the source of the wiki is located
  92 srcdir: /home/b-ikiwiki/source/doc
  93 # where to build the wiki
  94 destdir: /home/b-ikiwiki/public_html
  95 # base url to the wiki
  96 url: http://ikiwiki.info
  97 # url to the ikiwiki.cgi
  98 cgiurl: http://ikiwiki.info/ikiwiki.cgi
  99 # filename of cgi wrapper to generate
 100 cgi_wrapper: /var/www/b-ikiwiki/ikiwiki.cgi
 101 # mode for cgi_wrapper (can safely be made suid)
 102 cgi_wrappermode: 0755
 103 # number of seconds to delay CGI requests when overloaded
 104 cgi_overload_delay: ''
 105 # message to display when overloaded (may contain html)
 106 cgi_overload_message: ''
 107 # enable optimization of only refreshing committed changes?
 108 only_committed_changes: 0
 109 # rcs backend to use
 110 rcs: git
 111 # plugins to add to the default configuration
 112 add_plugins:
 113 - sidebar
 114 - goodstuff
 115 - websetup
 116 - table
 117 - haiku
 118 - html
 119 - polygen
 120 - fortune
 121 - linkmap
 122 - favicon
 123 - poll
 124 - postsparkline
 125 - sparkline
 126 - version
 127 - testpagespec
 128 - edittemplate
 129 - recentchangesdiff
 130 - 404
 131 - ikiwikihosting
 132 - branchable
 133 - recentchangesdiff
 134 - attachment
 135 - remove
 136 - rename
 137 - edittemplate
 138 - favicon
 139 - format
 140 - fortune
 141 - highlight
 142 - listdirectives
 143 - poll
 144 - progress
 145 - relativedate
 146 - search
 147 - testpagespec
 148 - version
 149 - theme
 150 - repolist
 151 - highlight
 152 - comments
 153 - gitpush
 154 - blogspam
 155 # plugins to disable
 156 disable_plugins: []
 157 # additional directory to search for template files
 158 templatedir: /usr/share/ikiwiki/templates
 159 # base wiki source location
 160 underlaydir: /usr/share/ikiwiki/basewiki
 161 # display verbose messages?
 162 #verbose: 1
 163 # log to syslog?
 164 syslog: 1
 165 # create output files named page/index.html?
 166 usedirs: 1
 167 # use '!'-prefixed preprocessor directives?
 168 prefix_directives: 1
 169 # use page/index.mdwn source files
 170 indexpages: 0
 171 # enable Discussion pages?
 172 discussion: 1
 173 # name of Discussion pages
 174 discussionpage: Discussion
 175 # generate HTML5?
 176 html5: 0
 177 # only send cookies over SSL connections?
 178 sslcookie: 0
 179 # extension to use for new pages
 180 default_pageext: mdwn
 181 # extension to use for html files
 182 htmlext: html
 183 # strftime format string to display date
 184 timeformat: '%c'
 185 # UTF-8 locale to use
 186 #locale: en_US.UTF-8
 187 # put user pages below specified page
 188 userdir: users
 189 # how many backlinks to show before hiding excess (0 to show all)
 190 numbacklinks: 10
 191 # attempt to hardlink source files? (optimisation for large files)
 192 hardlink: 1
 193 # force ikiwiki to use a particular umask (keywords public, group or private, or a number)
 194 #umask: public
 195 # group for wrappers to run in
 196 #wrappergroup: ikiwiki
 197 # extra library and plugin directory
 198 libdir: /home/b-ikiwiki/.ikiwiki
 199 # environment variables
 200 ENV:
 201   TMPDIR: /home/b-ikiwiki/tmp
 202 # time zone name
 203 timezone: JEST+4
 204 # regexp of normally excluded files to include
 205 #include: ^\.htaccess$
 206 # regexp of files that should be skipped
 207 #exclude: ^(*\.private|Makefile)$
 208 # specifies the characters that are allowed in source filenames
 209 wiki_file_chars: -[:alnum:]+/.:_
 210 # allow symlinks in the path leading to the srcdir (potentially insecure)
 211 allow_symlinks_before_srcdir: 0
 212 # cookie control
 213 cookiejar:
 214   file: /home/b-ikiwiki/.ikiwiki/cookies
 215
 216 ######################################################################
 217 # core plugins
 218 #   (branchable, editpage, git, gitpush, htmlscrubber, ikiwikihosting,
 219 #    inline, link, meta, parentlinks)
 220 ######################################################################
 221
 222 # branchable plugin
 223 # Allow anyone to branch, check out, and copy this site?
 224 branchable: 1
 225 # Allow anyone to git push verified changes to this site?
 226 anonpush: 1
 227 # Display "Branchable" link on action bar?
 228 branchable_action: 1
 229
 230 # git plugin
 231 # git hook to generate
 232 git_wrapper: /home/b-ikiwiki/source.git/hooks/post-update
 233 # shell command for git_wrapper to run, in the background
 234 #git_wrapper_background_command: git push github
 235 # mode for git_wrapper (can safely be made suid)
 236 git_wrappermode: 6755
 237 # git pre-receive hook to generate
 238 git_test_receive_wrapper: /home/b-ikiwiki/source.git/hooks/pre-receive
 239 # unix users whose commits should be checked by the pre-receive hook
 240 untrusted_committers:
 241 - ikiwiki-anon
 242 # gitweb url to show file history ([[file]] substituted)
 243 historyurl: http://source.ikiwiki.branchable.com/?p=source.git;a=history;f=doc/[[file]];hb=HEAD
 244 # gitweb url to show a diff ([[file]], [[sha1_to]], [[sha1_from]], [[sha1_commit]], and [[sha1_parent]] substituted)
 245 diffurl: http://source.ikiwiki.branchable.com/?p=source.git;a=blobdiff;f=doc/[[file]];h=[[sha1_to]];hp=[[sha1_from]];hb=[[sha1_commit]];hpb=[[sha1_parent]]
 246 # where to pull and push changes (set to empty string to disable)
 247 gitorigin_branch: origin
 248 # branch that the wiki is stored in
 249 gitmaster_branch: master
 250
 251 # gitpush plugin
 252 # git repository urls that changes are pushed to
 253 git_push_to:
 254 - git@github.com:joeyh/ikiwiki.git
 255 - joey@git.kitenet.net:/srv/git/ikiwiki.git
 256
 257 # htmlscrubber plugin
 258 # PageSpec specifying pages not to scrub
 259 htmlscrubber_skip: tipjar
 260
 261 # ikiwikihosting plugin
 262 # list of urls that alias to the main url
 263 urlalias:
 264 - http://ikiwiki.branchable.com/
 265 - http://ikiwiki.branchable.com/
 266 - http://git.ikiwiki.info/
 267 - http://www.ikiwiki.info/
 268 # openid of primary site owner
 269 owner: http://joey.kitenet.net/
 270 # optional hostname of site this one was branched from
 271 #parent: ''
 272 # internal hostname of this site
 273 hostname: ikiwiki.branchable.com
 274 # site creation datestamp
 275 created: 1305836524
 276 # how many days to retain logs
 277 #log_period: 7
 278 # disable IPv6?
 279 ipv6_disabled: 0
 280
 281 # inline plugin
 282 # enable rss feeds by default?
 283 rss: 1
 284 # enable atom feeds by default?
 285 atom: 0
 286 # allow rss feeds to be used?
 287 #allowrss: 0
 288 # allow atom feeds to be used?
 289 allowatom: 1
 290 # urls to ping (using XML-RPC) on feed update
 291 pingurl: []
 292
 293 ######################################################################
 294 # auth plugins
 295 #   (anonok, blogspam, httpauth, lockedit, moderatedcomments,
 296 #    opendiscussion, openid, passwordauth, signinedit)
 297 ######################################################################
 298
 299 # anonok plugin
 300 # PageSpec to limit which pages anonymous users can edit
 301 #anonok_pagespec: '*/discussion'
 302
 303 # blogspam plugin
 304 # PageSpec of pages to check for spam
 305 blogspam_pagespec: '*'
 306 # options to send to blogspam server
 307 #blogspam_options: blacklist=1.2.3.4,blacklist=8.7.6.5,max-links=10
 308 # blogspam server XML-RPC url
 309 #blogspam_server: ''
 310
 311 # httpauth plugin
 312 # url to redirect to when authentication is needed
 313 #cgiauthurl: http://example.com/wiki/auth/ikiwiki.cgi
 314 # PageSpec of pages where only httpauth will be used for authentication
 315 #httpauth_pagespec: '!*/Discussion'
 316
 317 # lockedit plugin
 318 # PageSpec controlling which pages are locked
 319 locked_pages: tipjar or tips/DreamHost
 320
 321 # moderatedcomments plugin
 322 # PageSpec matching users or comment locations to moderate
 323 #moderate_pagespec: '*'
 324
 325 # openid plugin
 326 # url pattern of openid realm (default is cgiurl)
 327 #openid_realm: ''
 328 # url to ikiwiki cgi to use for openid authentication (default is cgiurl)
 329 #openid_cgiurl: ''
 330
 331 # passwordauth plugin
 332 # a password that must be entered when signing up for an account
 333 #account_creation_password: s3cr1t
 334 # cost of generating a password using Authen::Passphrase::BlowfishCrypt
 335 #password_cost: 8
 336
 337 ######################################################################
 338 # format plugins
 339 #   (creole, highlight, hnb, html, mdwn, otl, po, rawhtml, rst, textile,
 340 #    txt)
 341 ######################################################################
 342
 343 # highlight plugin
 344 # types of source files to syntax highlight
 345 tohighlight: .c .h .cpp .pl .py Makefile:make
 346 # location of highlight's filetypes.conf
 347 filetypes_conf: /etc/highlight/filetypes.conf
 348 # location of highlight's langDefs directory
 349 langdefdir: /usr/share/highlight/langDefs
 350
 351 # mdwn plugin
 352 # enable multimarkdown features?
 353 #multimarkdown: 0
 354 # disable use of markdown discount?
 355 #nodiscount: 0
 356
 357 # po plugin
 358 # master language (non-PO files)
 359 #po_master_language: en|English
 360 # slave languages (translated via PO files) format: ll|Langname
 361 #po_slave_languages:
 362 #- fr|Français
 363 #- es|Español
 364 #- de|Deutsch
 365 # PageSpec controlling which pages are translatable
 366 po_translatable_pages: ''
 367 # internal linking behavior (default/current/negotiated)
 368 po_link_to: default
 369
 370 ######################################################################
 371 # special-purpose plugins
 372 #   (osm, underlay)
 373 ######################################################################
 374
 375 # osm plugin
 376 # the default zoom when you click on the map link
 377 #osm_default_zoom: 15
 378 # the icon shown on links and on the main map
 379 #osm_default_icon: ikiwiki/images/osm.png
 380 # the alt tag of links, defaults to empty
 381 #osm_alt: ''
 382 # the output format for waypoints, can be KML, GeoJSON or CSV (one or many, comma-separated)
 383 #osm_format: KML
 384 # the icon attached to a tag, displayed on the map for tagged pages
 385 #osm_tag_default_icon: icon.png
 386 # Url for the OpenLayers.js file
 387 #osm_openlayers_url: http://www.openlayers.org/api/OpenLayers.js
 388 # Layers to use in the map. Can be either the 'OSM' string or a type option for Google maps (GoogleNormal, GoogleSatellite, GoogleHybrid or GooglePhysical). It can also be an arbitrary URL in a syntax acceptable for OpenLayers.Layer.OSM.url parameter.
 389 #osm_layers:
 390 #  OSM: GoogleSatellite
 391 # Google maps API key, Google layer not used if missing, see https://code.google.com/apis/console/ to get an API key
 392 #osm_google_apikey: ''
 393
 394 # underlay plugin
 395 # extra underlay directories to add
 396 #add_underlays:
 397 #- /home/b-ikiwiki/wiki.underlay
 398
 399 ######################################################################
 400 # web plugins
 401 #   (404, attachment, comments, editdiff, edittemplate, getsource, google,
 402 #    goto, mirrorlist, remove, rename, repolist, search, theme, userlist,
 403 #    websetup, wmd)
 404 ######################################################################
 405
 406 # attachment plugin
 407 # enhanced PageSpec specifying what attachments are allowed
 408 allowed_attachments: admin() and virusfree()
 409 # virus checker program (reads STDIN, returns nonzero if virus found)
 410 virus_checker: clamdscan -
 411
 412 # comments plugin
 413 # PageSpec of pages where comments are allowed
 414 comments_pagespec: forum/* and !*/Discussion
 415 # PageSpec of pages where posting new comments is not allowed
 416 comments_closed_pagespec: ''
 417 # Base name for comments, e.g. "comment_" for pages like "sandbox/comment_12"
 418 comments_pagename: comment_
 419 # Interpret directives in comments?
 420 #comments_allowdirectives: 0
 421 # Allow anonymous commenters to set an author name?
 422 comments_allowauthor: 0
 423 # commit comments to the VCS
 424 comments_commit: 1
 425 # Restrict formats for comments to (no restriction if empty)
 426 comments_allowformats: ''
 427
 428 # getsource plugin
 429 # Mime type for returned source.
 430 #getsource_mimetype: text/plain; charset=utf-8
 431
 432 # mirrorlist plugin
 433 # list of mirrors
 434 #mirrorlist: {}
 435 # generate links that point to the mirrors' ikiwiki CGI
 436 #mirrorlist_use_cgi: 1
 437
 438 # repolist plugin
 439 # URIs of repositories containing the wiki's source
 440 repositories:
 441 - ssh://b-ikiwiki@ikiwiki.branchable.com/
 442 - git://ikiwiki.branchable.com/
 443
 444 # search plugin
 445 # path to the omega cgi program
 446 omega_cgi: /usr/lib/cgi-bin/omega/omega
 447 # use google site search rather than internal xapian index?
 448 google_search: 1
 449
 450 # theme plugin
 451 # name of theme to enable
 452 #theme: actiontabs
 453
 454 # websetup plugin
 455 # list of plugins that cannot be enabled/disabled via the web interface
 456 websetup_force_plugins:
 457 - httpauth
 458 - openid
 459 - mdwn
 460 - wmd
 461 # list of additional setup field keys to treat as unsafe
 462 websetup_unsafe:
 463 - url
 464 - cgiurl
 465 - verbose
 466 - syslog
 467 - usedirs
 468 - prefix_directives
 469 - indexpages
 470 - repositories
 471 - sslcookie
 472 # show unsafe settings, read-only, in web interface?
 473 websetup_show_unsafe: 0
 474
 475 ######################################################################
 476 # widget plugins
 477 #   (calendar, color, conditional, cutpaste, date, format, fortune,
 478 #    graphviz, haiku, headinganchors, img, linkmap, listdirectives, map,
 479 #    more, orphans, pagecount, pagestats, poll, polygen, postsparkline,
 480 #    progress, shortcut, sparkline, table, template, teximg, toc, toggle,
 481 #    version)
 482 ######################################################################
 483
 484 # calendar plugin
 485 # base of the archives hierarchy
 486 #archivebase: archives
 487 # PageSpec of pages to include in the archives; used by ikiwiki-calendar command
 488 #archive_pagespec: page(posts/*) and !*/Discussion
 489
 490 # listdirectives plugin
 491 # directory in srcdir that contains directive descriptions
 492 directive_description_dir: ikiwiki/directive
 493
 494 # teximg plugin
 495 # Should teximg use dvipng to render, or dvips and convert?
 496 #teximg_dvipng: ''
 497 # LaTeX prefix for teximg plugin
 498 #teximg_prefix: '\documentclass{article}
 499 #
 500 #  \usepackage[utf8]{inputenc}
 501 #
 502 #  \usepackage{amsmath}
 503 #
 504 #  \usepackage{amsfonts}
 505 #
 506 #  \usepackage{amssymb}
 507 #
 508 #  \pagestyle{empty}
 509 #
 510 #  \begin{document}
 511 #
 512 #'
 513 # LaTeX postfix for teximg plugin
 514 #teximg_postfix: \end{document}
 515
 516 ######################################################################
 517 # other plugins
 518 #   (aggregate, autoindex, brokenlinks, camelcase, ddate, embed, favicon,
 519 #    filecheck, flattr, goodstuff, htmlbalance, localstyle, missingsite,
 520 #    notifyemail, pagetemplate, parked, pingee, pinger, prettydate,
 521 #    recentchanges, recentchangesdiff, relativedate, rsync, sidebar,
 522 #    smiley, sortnaturally, tag, testpagespec, trail, transient, typography)
 523 ######################################################################
 524
 525 # aggregate plugin
 526 # enable aggregation to internal pages?
 527 aggregateinternal: 1
 528 # allow aggregation to be triggered via the web?
 529 #aggregate_webtrigger: 0
 530
 531 # autoindex plugin
 532 # commit autocreated index pages
 533 autoindex_commit: 1
 534
 535 # camelcase plugin
 536 # list of words to not turn into links
 537 #camelcase_ignore: []
 538
 539 # flattr plugin
 540 # userid or user name to use by default for Flattr buttons
 541 #flattr_userid: joeyh
 542
 543 # parked plugin
 544 # An optional message explaining why this site is parked.
 545 #parked_message: ''
 546
 547 # pinger plugin
 548 # how many seconds to try pinging before timing out
 549 #pinger_timeout: 15
 550
 551 # prettydate plugin
 552 # format to use to display date
 553 prettydateformat: '%X, %B %o, %Y'
 554
 555 # recentchanges plugin
 556 # name of the recentchanges page
 557 recentchangespage: recentchanges
 558 # number of changes to track
 559 recentchangesnum: 100
 560
 561 # rsync plugin
 562 # command to run to sync updated pages
 563 #rsync_command: rsync -qa --delete . user@host:/path/to/docroot/
 564
 565 # sidebar plugin
 566 # show sidebar page on all pages?
 567 global_sidebars: 0
 568
 569 # tag plugin
 570 # parent page tags are located under
 571 #tagbase: tag
 572 # autocreate new tag pages?
 573 #tag_autocreate: 1
 574 # commit autocreated tag pages
 575 tag_autocreate_commit: 1
 576
 577 # typography plugin
 578 # Text::Typography attributes value
 579 #typographyattributes: 3