#--------------------------------------------------------------------------- # # Configuration file for SubWiki # # Information on SubWiki is located at the following web site: # http://subwiki.tigris.org/ # #--------------------------------------------------------------------------- # # See http://www.webdav.org/wiki/projects/SubWikiConfig for more information. # # # BASIC CONFIGURATION # # For correct operation, you will need to change the following configuration # variables: # # repos # ??? # # It is usually desirable to change the following variables: # # ... # # Also, review the .ezt templates in the templates/ directory to adjust them # for your particular site. # # # FORMAT INFORMATION # # This file is delineated by sections, specified in [brackets]. Within each # section, are a number of configuration settings. These settings take the # form of: name = value. Values may be continued on the following line by # indenting the continued line. # # WARNING: indentation *always* means continuation. name=value lines should # always start in column zero. # # Comments should always start in column zero, and are identified with "#". # # Certain configuration settings may have multiple values. These should be # separated by a comma. The settings where this is allowed are noted below. # # Any other setting that requires special syntax is noted at that setting. # #--------------------------------------------------------------------------- [general] # # There are cases where additional configuration information may be stored # in a separate file. The most typical case for this is storing the # additional configuration in the repository, where it can be subject to # version controlled maintenance. # global_config = # # Once an application (a vwiki) has been determined and instantiated, then # additional application-specific configuration may be loaded. This option # specifies the location of that config. Typically, this value will be # overridden by the appropriate vwiki section. # app_config = # # The location of the Subversion repository containing the Wiki pages, # hook scripts, and index files. This must be an absolute path. # repos = /home/gstein/repos/wiki # # This specifies the path to the Wiki page content, within the Subversion # repository. # page_path = /pages # # This options specifies the location of content for the [docroot] # template variable. The directory is specified relative to this # configuration file. # # Note: this default value works well for a system-wide set of content # files. Per-instance content is easily specified using the config- # relative directory. # docroot = {install}/docroot # # Define the default duration for the docroot content to remain within # browser and proxy caches. This value is specified in seconds. If you # expect your content to change frequently, then use a short duration. # If you do not want your content cached, then set this value to zero. # # For performance reasons, it is best to keep this value high. This # will prevent the browser/proxy from continuing to ask SubWiki for # the content. # cache_duration = 86400 # # This setting specifies where the indexes will be kept. It can be specified # as an absolute path, or relative to this configuration file. # index_dir = indexes # # If authentication/authorization is enabled (see the [acl] section), then # SubWiki can respond to an unauthorized operation in one of two ways: # # 1) if use_subwiki_authn is enabled, then SubWiki will use an internal # cookie-based authentication system; a web form will be presented to # allow the user to log in. # # 2) if use_subwiki_authn is not enabled, then SubWiki will just raise # an exception (a CGI cannot participate in the HTTP authentication # process) # # ### if we're running as a mod_python script (or somesuch), then a 401 # ### response is possible. but we'll figure that out when we get there. # # Note: if the web server performs any authentication with the user, then # SubWiki will always use/prefer that author name (from the REMOTE_USER # CGI environment variable). # # Legal values are: yes, no # use_subwiki_authn = yes # # If SubWiki's internal authentication system is used, then this option # should be uncommented, and an arbitrary string should be filled in. This # secret will be used when building cookies to hold the authenticated # user information. # # This secret is used to provide a minimal level of security around # issuance of cookies. While it is not cryptographically secure, it # will prevent basic "manufacture a cookie" attacks. As with any cookie- # based authentication, sniffing the wire can be used to steal credentials. # # Examples: # authn_secret = little red riding hood # authn_secret = three little pigs # # This setting specifies where the user metadata be kept. It can be specified # as an absolute path, or relative to this configuration file. # users_dir = users # # The list of plugins to load (comma-separated). These are specified # as absolute paths, or relative to the installed plugins directory. # plugins = std/view.py, std/change.py, std/patterns.py, std/macros.py, std/users.py, ext/history.py #--------------------------------------------------------------------------- [templates] # # The template directory is specified relative to the directory holding # this configuration file. An absolute path may be used, if you want to # keep these elsewhere. # # The templates may be stored within the repository by using the {repos} # path prefix. For example: # # template_dir = {repos}/templates # # For per-instance templates, use: # # template_dir = templates # # and place your templates in that subdirectory, relative to this file. # template_dir = {install}/templates # # The individual templates are normally located in the template directory, # and are specified relative to there. However, absolute paths may be # used, if desired. # view = view.ezt history = history.ezt edit = edit.ezt add = add.ezt login = login.ezt # # Micro templates are used for rendering portions of a page, rather than # an entire page. These allow the wiki admins to fine-tune the actual # structure of a page (rather than simply the style). # # for the [RecentChanges] mcaro micro_changes = micro_changes.ezt #--------------------------------------------------------------------------- #[vwikis] # # # ### need to document this section # ### random test/dev bits here: # # host = (?P[^.]*)\. # script = /wiki/(?P[a-z]*)/ # use_path = true # # SUBWIKI_VWIKI = (?P.*) # #--------------------------------------------------------------------------- # # Uncomment this to apply some access control. # #[acl] ### refine docco: ### specify access control lists here. option names are commands, and ### values are lists of users/groups ### example: ### moderate = gstein @admins ### view = ### add = ### important to have something like below, or CSS cannot be fetched. ### docroot = ### and to log in ### login = #---------------------------------------------------------------------------