########################################################################### # # This is the JSPWiki configuration file. You'll need to edit this # a bit. The first few lines are the most important ones. # # Wherever it is said that an option can be "true" or "false", you can # also use "yes"/"no", or "on/off". Just for some convenience. # # # You can use this to override the default application name. It affects # the HTML titles and logging, for example. It can be different from # the actual web name (http://my.com/mywiki) of the application, but usually # it is the same. # jspwiki.applicationName = @appname@ # # Describe where your wiki lives (the real URL through which it is available # through the internet/intranet). This is a mandatory attribute. # # Be careful if you use a localhost address (http://localhost/ or http://127.0.0.1/), # as this will cause some unwanted side effects if your wiki is accessed from # any other computer than where the wiki is running. # # Example: # jspwiki.baseURL = http://www.jspwiki.org/ # jspwiki.baseURL= # # Which page provider class to use. Possibilities are: # # RCSFileProvider - for simple RCS-based file storage # FileSystemProvider - for simple pure file storage with no version information # VersioningFileProvider - for simple, non-RCS based versioning storage. # # Note that if you're upgrading from JSPWiki 1.x, then you need to remove the # "com.ecyrd.jspwiki." part from the beginning of the path. # jspwiki.pageProvider = FileSystemProvider # # Set to true, if you want to cache page data into memory. This is # in general a good idea. # # Default is false (no cache). # # NB: This replaces the JSPWiki 1.x "CachingProvider" setting, since it # probably was too confusing. # jspwiki.usePageCache = true # # Determines where wiki files are kept for FileSystemProvider # and RCSFileProvider # # If you're using Windows, then you must duplicate the backslashes. # For example, use: # # jspwiki.fileSystemProvider.pageDir = C:\\Data\\jspwiki # jspwiki.fileSystemProvider.pageDir = @pagedir@ # # The JSPWiki working directory. If not set, a temporary path will # be used. You can see the location of the workdir in the logs. # It is HIGHLY recommended that you set this. # # The working directory is used to cache things like Lucene search # results. # #jspwiki.workDir = # # ATTACHMENTS: # # Use the following property to define which attachment provider # you want to use. You have basically two choices: # * Set the value to BasicAttachmentProvider # a simple, flat file versioning provider # * Leave the value empty (or just comment the line out) # the attachment functionality is disabled # jspwiki.attachmentProvider = BasicAttachmentProvider # # The BasicAttachmentProvider needs to know where to store the files # the user has uploaded. It's okay to put these in the same directory # as you put your text files (i.e. the pageDir setting above). # # If you're using Windows, then you must duplicate the backslashes. # For example, use: # # jspwiki.basicAttachmentProvider.storageDir = C:\\Data\\jspwiki # jspwiki.basicAttachmentProvider.storageDir = @pagedir@ # # You can tell the BasicAttachmentProvider to add a flag # so that browsers do not cache certain (or all) attachment # types. This is useful in intranet environments. You should activate # this if your users complain that their excel files are not uploaded # correctly and they still do have an old version: Usually the # file was uploaded correctly, but they get the locally cached version # # You can use regular expressions to disable the cache, e.g the # following example will disable browser cache for all excel and word files # # If you don't define this property, cache is enabled by default for # all attachments # # jspwiki.basicAttachmentProvider.disableCache = .*\.xls|.*\.doc # # You can limit the maximum size of an attachment by setting this # value. The value is in bytes, and by default all attachments # are accepted. # # The following line would limit the attachment size to 100,000 bytes #jspwiki.attachment.maxsize=100000 # # By default JSPWiki accepts all types of attachments. However, you # can allow some types only, or forbid some other types. By default, # all file types are allowed (if you do not specify the "allow" list # at all or it is empty). # # These both are space-separated lists of file suffixes # # Example: Allow only PNG, JPG, ZIP and JAR file attachments #jspwiki.attachment.allow=.png .jpg .zip .jar # Example: Forbid HTML, PHP, ASP and EXE #jspwiki.attachment.forbid=.html .htm .php .asp .exe # # page Diff Representation # # To show differences between page versions, you can define a # difference provider. # The following choices are available: # * TraditionalDiffProvider - Uses internal (java) diff # to create a list of changes and shows it line by # line colored. This is the default # * ContextualDiffProvider - Uses internal (java) diff # to create changes inline and shows it on a word by # word basis using CSS. This is much superior to the # traditional diff provider, however, it is still quite # new and not much tested. YMMV. # * ExternalDiffProvider - uses a system diff program (which # can be configured using "jspwiki.diffCommand") to # create an unified (!) diff. # # Example for a diff command: # jspwiki.diffCommand = /usr/bin/diff -u %s1 %s2 # jspwiki.diffProvider = TraditionalDiffProvider # Determines if you need to have relative urls or not. If the baseURL # is not set, then this has no effect, but if you set the baseURL (which # is highly recommended), you can use this to set relative urls. # # Possible values are "absolute" and "relative". # #jspwiki.referenceStyle=relative # # Determines which character encoding JSPWiki should use. If you want # to support all languages in your Wiki, you probably want to enable # this. From JSPWiki 2.2, it is strongly suggested that you use UTF-8. # # Note that you can't switch these in the mean time, since the way the # files are encoded on disk is incompatible between ISO-Latin1 and UTF-8. # Don't try. You'll get all sorts of interesting problems, if you do. # # Possible values are 'ISO-8859-1' (default, if none has been specified) # and 'UTF-8'. jspwiki.encoding = UTF-8 # # Determines whether raw HTML is allowed as Wiki input. # # THIS IS A DANGEROUS OPTION! # # If you decide to allow raw HTML, understand that ANY person who has # access to your Wiki site can embed ANY sort of malicious JavaScript, # or plugin, or ActiveX, or whatever on your site. They can even mess it # up so royally it is impossible for you to replace the situation without # the need of direct access to the repository. So think twice before # allowing raw HTML on your own site. # # Most probably you want to use this on Intranets, or personal servers, # where only a handful of people can access the wiki. # # Text between {{{ and }}} -options is not affected by this setting, so # it's always safe to quote HTML code with those. # # The default for this option is "false". # jspwiki.translatorReader.allowHTML = false ############################################################################ # # Usability niceties. # # # If this property is set to "true", then page titles are rendered # using an extra space between every capital letter. It may make # page titles readable on some occasions, but it does have the # drawback of making the titles look a bit funny at times. # jspwiki.breakTitleWithSpaces = false # # If set to true, this property means that "WikiName" and "WikiNames" # are considered equal when linking between them. Setting this to # true does not prevent you from having both kinds of pages - we just # fall back to the other one if the primary name does not exist. # # For any other language, you'll probably want to turn this off. # jspwiki.translatorReader.matchEnglishPlurals = true # # If you set this to true, the Wiki translator will then also consider # "traditional" WikiNames (that is, names of pages JustSmashedTogether # without square brackets) as hyperlinks. This technique is also # known as "CamelCase", or "BumpyCase", or "InterCapping". I personally # like CamelCase as a word, which is why this property is named as it is :-). # # By default this is false, since traditional WikiLinks may confuse newbies. # # This option can be overridden on a per-page basis using the SET directive. # jspwiki.translatorReader.camelCaseLinks = false # # This sets the default template used by the Wiki engine. The templates # live in templates/