One of the early steps in configuring your system is to create (or edit) your web.config file. This is the standard ASP.NET application configuration file that contains settings specific to your web application (in this case: FlexWiki).

The web.config file contains a variety of important configuration options for your site.

Here's a simple (valid) one:

 <?xml version="1.0" encoding="utf-8" ?>
 <configuration>
  <appSettings>
   <add key="FederationNamespaceMapFile" value="/files/NamespaceMap.xml" />
   <add key="SMTPServer" value="mail.flexwiki.com" />
   <add key="SMTPUser" value="davidorn@flexwiki.com" />
   <add key="SMTPPassword" value="yourpassword" />
   <add key="NewslettersFrom" value="wiki@yourserver.com" />
   <add key="OverrideStylesheet" value="/override.css" />
   <add key="DoubleClickToEdit" value="True" />
  </appSettings>
  <system.web> 
   <authentication mode="None" />
   <pages validateRequest = "false" />
  </system.web>
 </configuration>

The settings are as follows:

FederationNamespaceMapFile

This mandatory setting points to a FederationConfiguration file using a web-server virtual path (not a file system path). See FederationConfiguration for more details.

Mail Server Options

If you want your system to deliver email WikiNewsletters, you need to do two things:

• ConfigureFlexWikiToSendMail
• set the NewslettersFrom app setting in the web.config file to the email address that WikiNewsletters should have in their From: line

Disable Rename Fixup

By default, FlexWiki's rename function will offer users the ability to automatically fixup all pages that point to the one being renamed. In some situations this can create a lot of work for site maintainers to do to deal with accidental or malicious renames. The ability to do this automatic "fixup" can be disabled by setting the DisableRenameFixup key in <appSettings> to true (or false to enable it, the default).

OverrideStylesheet

This optional setting allows you to override the visual appearance of your site. See StylesheetOverride for more details.

DoubleClickToEdit

This optional setting, available as of build 1674, allows you to disable double-click-to-edit on topic pages. A value of FALSE will disable double-click-to-edit.

<authentication>

You should configure your site for some form of authentication. See AuthenticationOptions for more details.

<pages validateRequest = "false" />

You must set this setting or users will be unable to edit pages on your site.