Add Special:Version; remove Special:Debug; remove dupe language lists; fix line endin...
[lhc/web/wiklou.git] / LocalSettings.sample
index b3cffb6..6bda7fd 100644 (file)
@@ -5,14 +5,24 @@
 # configuration preferences. The install script will copy it to
 # the installation path, but a copy should also remain in the
 # source tree so that maintenance scripts can refer to it (you
-# may want to make it a symbolic link after installation).  Do
-# not check LocalSettings.php into CVS!  It is different for
-# every installation, and must not be overridden.
+# may want to make it a symbolic link after installation). 
+
+# Developers: Do not check LocalSettings.php into CVS! Make
+# changes to LocalSettings.sample instead.
+
+# Note that you will find many more settings in 
+# includes/DefaultSettings.php - if you want to change any of
+# them, copy the variables into LocalSettings.php, and change them
+# here, otherwise your settings will be overwritten with your
+# next update.
 
 # The most important setting is here: $IP is the installation
-# path for the software.
+# path for the software. In the example below, the htdocs
+# dir should be set as the DocumentRoot in the httpd.conf 
+# configuration file of Apache. To put it more simply:
+# The directory below needs to be accessible in some way
+# through your web browser.
 #
-
 $IP = "/usr/local/apache/htdocs/wiki";
 
 if ( ! isset( $DP ) ) { $DP = $IP; }
@@ -30,17 +40,44 @@ $wgEmergencyContact = "wikiadmin@myhost.com";
 
 # MySQL settings
 #
+# The user you specify here DOES NOT NEED TO EXIST.
+# It is created by the installation script.
+#
+# $wgDBsqluser is used for queries through the 
+# web interface. It is also created by the script.
+# Unlike the regular user, it has no write 
+# permissions and can not access passwords.
+#
 $wgDBserver         = "localhost";
-$wgDBuser           = "wikiuser";
 $wgDBname           = "wikidb";
+$wgDBuser           = "wikiuser";
 $wgDBpassword       = "userpass";
+$wgDBsqluser        = "sqluser";
 $wgDBsqlpassword       = "sqlpass";
+
+# Advanced DB settings
+#
 $wgDBminWordLen                = 3;     # Match this to your MySQL fulltext
 $wgDBtransactions   = false; # Set to true if using InnoDB tables
 
-# This code is still slightly experimental. Turn it off if "What links here"
-# and similar stuff does not work.
-$wgUseBetterLinksUpdate=true;
+#
+# Set $wgUseImageResize to true if you want to enable dynamic
+# server side image resizing ("Thumbnails")
+# 
+$wgUseImageResize              = false;
+
+# Resizing can be done using PHP's internal image libraries
+# or using ImageMagick. The later supports more file formats
+# than PHP, which only supports PNG, GIF, JPG, XBM and WBMP.
+#
+# Set $wgUseImageMagick to true to use Image Magick instead
+# of the builtin functions
+#
+$wgUseImageMagick              = false;
+$wgImageMagickConvertCommand    = "/usr/bin/convert";
+
+# If you want a non-English wiki, add a line like this
+# $wgLanguageCode = "de";
 
 # Turn this on during database maintenance
 # $wgReadOnly = true;
@@ -48,9 +85,6 @@ $wgUseBetterLinksUpdate=true;
 # Turn this on to get HTML debug comments
 # $wgDebugComments     = true;
 
-# If you want a non-English wiki, add a line like this
-# $wgLanguageCode = "de";
-
 $wgUseTeX                      = false;
 $wgUseCategoryMagic = true ;
 
@@ -93,4 +127,17 @@ $wgOutputEncoding   = "ISO-8859-1";
 # $wgWhitelistEdit = true;
 # $wgWhitelistRead = false;
 # $wgWhitelistAccount = array ( "user" => 0, "sysop" => 1, "developer" => 1 );
+
+
+# Squid-related settings
+#
+# Enable/disable Squid
+# $wgUseSquid = true;
+# If you run Squid3 with ESI support, enable this (default:false):
+# $wgUseESI = true;
+# Internal server name as known to Squid, if different
+# $wgInternalServer = 'http://yourinternal.tld:8000';
+# A list of proxy servers (ips if possible) to purge on changes
+# don't specify ports here (80 is default)
+# $wgSquidServers = array('127.0.0.1');
 ?>