X-Git-Url: https://git.cyclocoop.org/%27.WWW_URL.%27admin/?a=blobdiff_plain;f=LocalSettings.sample;h=8be4c13de3fa29e478833fccd00675a189f29342;hb=629e3c2c7380a0b982b5fef2595e51ff59430536;hp=6bda7fd259de0ebe0f21c33594d23d2a74358b90;hpb=84679b35fba8ad8d39f1f3e7701b35d1367fba33;p=lhc%2Fweb%2Fwiklou.git

diff --git a/LocalSettings.sample b/LocalSettings.sample
index 6bda7fd259..8be4c13de3 100644
--- a/LocalSettings.sample
+++ b/LocalSettings.sample
@@ -1,112 +1,194 @@
-<?
+<?php
 # Local settings work like this: the file LocalSettings.sample
 # should be copied to LocalSettings.php in the source directory
 # and edited for your local file system settings and software
 # 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). 
+# 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 
+# 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.
 
+# You can get some useful informations online at:
+# http://meta.wikipedia.org/wiki/LocalSettings.php
+
 # The most important setting is here: $IP is the installation
 # path for the software. In the example below, the htdocs
-# dir should be set as the DocumentRoot in the httpd.conf 
+# 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";
 
+## Don't change this bit; install.php needs it.
+#
 if ( ! isset( $DP ) ) { $DP = $IP; }
 include_once( "$DP/DefaultSettings.php" );
 
+# If you wish to enable third-party extensions, you do that
+# using an include_once statement here. Make sure, however,
+# that DefaultSettings.php (above) is included first.
+
+## Please customize!
+#
+$wgSitename         = "MediaWiki";
+
 # You can customize a lot of URLs and paths, but you will
 # almost certainly want to customize the following.  The
+
+# Normally the server will be auto-detected, but you can
+# force the base URL. Don't forget http:// (or https://)!
+# If you are running php as CGI, the $_SERVER variable might
+# not be set, you will then need to manually set $wgServer
+#
+#$wgServer           = "http://www.myhost.com";
+
+## The location of the main script, you need this to be correct!
+#
+$wgScriptPath	    = "/wiki";
+$wgScript           = "{$wgScriptPath}/index.php";
+$wgRedirectScript   = "{$wgScriptPath}/redirect.php";
+
 # ArticlePath one is especially useful if you want to use
 # mod_redirect to make page-viewing URLs look static.
 #
-$wgServer           = "http://www.myhost.com";
-$wgScriptPath	    = "/wiki";
-$wgArticlePath      = "{$wgScript}?title=$1";
-$wgEmergencyContact = "wikiadmin@myhost.com";
+$wgArticlePath      = "{$wgScript}/$1";
+# $wgArticlePath     = "/wiki/$1"; # Prettier if you're setup for it
+
+## Normally you don't need to change these once the above are set...
+#
+$wgStylePath   = "{$wgScriptPath}/skins";
+$wgStyleSheetDirectory = "{$IP}/skins";
+
+$wgUploadPath       = "{$wgScriptPath}/upload";
+$wgUploadDirectory	= "{$IP}/upload";
+$wgLogo				= "{$wgStylePath}/images/wiki.png";
+
+## Preferably these addresses should be able to receive mail asking for help
+#
+$wgEmergencyContact = "wikiadmin@" . $_SERVER['SERVER_NAME'];
+$wgPasswordSender	= "Wikipedia Mail <apache@" . $_SERVER['SERVER_NAME'] . ">";
 
 # MySQL settings
 #
 # The user you specify here DOES NOT NEED TO EXIST.
-# It is created by the installation script.
+# It is created by the installation script, if
+# you have root privileges on your database.
 #
-# $wgDBsqluser is used for queries through the 
+# IF on the other hand you have only limited privs
+# on your DB and have to do a manual install, use
+# your existing username and password. Be sure this
+# file doesn't get left around on the web legible...
+#
+# $wgDBsqluser is used for queries through the
 # web interface. It is also created by the script.
-# Unlike the regular user, it has no write 
+# Unlike the regular user, it has no write
 # permissions and can not access passwords.
 #
 $wgDBserver         = "localhost";
 $wgDBname           = "wikidb";
 $wgDBuser           = "wikiuser";
-$wgDBpassword       = "userpass";
+$wgDBpassword       = "userpass"; # Use a better password! ;)
 $wgDBsqluser        = "sqluser";
 $wgDBsqlpassword	= "sqlpass";
 
-# Advanced DB settings
+## Minimum word length for the full-text search.
+## NOTICE: Changing this value does not suffice. You must
+## also change the corresponding setting in MySQL itself.
+## See the MySQL manual for information on how to do so.
 #
-$wgDBminWordLen		= 3;	 # Match this to your MySQL fulltext
-$wgDBtransactions   = false; # Set to true if using InnoDB tables
+$wgDBminWordLen		= 3;
 
+## Set these to true to turn on some optimizations when using
+## MySQL 4.x:
 #
-# Set $wgUseImageResize to true if you want to enable dynamic
-# server side image resizing ("Thumbnails")
-# 
-$wgUseImageResize		= false;
+# $wgDBmysql4			= true;
+# $wgEnablePersistentLC	= true;
 
-# 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.
+## You can customize the interface messages through the wiki;
+## see [[MediaWiki:All pages]]. (This requires a sysop account.)
+## This causes a performance hit, though; if you don't need it,
+## feel free to turn it off:
 #
-# Set $wgUseImageMagick to true to use Image Magick instead
-# of the builtin functions
+# $wgUseDatabaseMessages = false;
+
+## The links in the navigation sidebar can be configured.
+## To add a link to the sidebar, add a line like the following
 #
-$wgUseImageMagick		= false;
-$wgImageMagickConvertCommand    = "/usr/bin/convert";
+# $wgNavigationLinks[] = array( 'text' => 'helpdesk', 'href' => 'helpdesk-url' );
+#
+## and create two MediaWiki:-pages with the corresponding names, e.g.
+## MediaWiki:helpdesk="User help desk"
+## MediaWiki:helpdesk-url="YourProject:Help_desk"
 
-# If you want a non-English wiki, add a line like this
-# $wgLanguageCode = "de";
+## Set $wgUseImageResize to true if you want to enable dynamic
+## server side image resizing ("Thumbnails")
+#
+# $wgUseImageResize		= true;
 
-# Turn this on during database maintenance
-# $wgReadOnly = true;
+## 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		= true;
+# $wgImageMagickConvertCommand    = "/usr/bin/convert";
 
-# Turn this on to get HTML debug comments
-# $wgDebugComments	= true;
+## If you have the appropriate support software installed
+## you can enable inline LaTeX equations:
+# $wgUseTeX			= true;
+# $wgMathPath         = "{$wgUploadPath}/math";
+# $wgMathDirectory    = "{$wgUploadDirectory}/math";
+# $wgTmpDirectory     = "{$wgUploadDirectory}/tmp";
 
-$wgUseTeX			= false;
-$wgUseCategoryMagic = true ;
+$wgLocalInterwiki   = $wgSitename;
 
-$wgLocalInterwiki   = "w";
+## If you want a non-English wiki, add a line like this
+# $wgLanguageCode = "de";
 
-$wgInputEncoding	= "ISO-8859-1";
-$wgOutputEncoding	= "ISO-8859-1";
+## If you want a different default time zone than UTC, add a line like this
+# $wgLocalTZoffset = -5;	# (EST, for example)
 
-# Extremely high-traffic wikis may want to disable
-# some database-intensive features here:
+## Character encoding: normally auto-selected by the language.
+## English, German, Danish, Dutch, French, Spanish, and Swedish
+## will be in ISO-8859-1 by default, all other languages in
+## UTF-8 encoding. UTF-8 is more flexible, but some older browsers
+## have trouble with it. You can force an English-language wiki
+## to UTF-8 by uncommenting the lines below. The other languages
+## mentioned above might not work properly this way without
+## additional tweaking.
+#
+# $wgInputEncoding	= "UTF-8";
+# $wgOutputEncoding	= "UTF-8";
+
+## Default skin: you can change the default skin. Use the internal symbolic
+## names, ie 'standard', 'nostalgia', 'cologneblue', 'monobook':
+# $wgDefaultSkin = 'monobook';
+
+## Extremely high-traffic wikis may want to disable
+## some database-intensive features here:
 #
 # $wgDisableTextSearch = true;
 # $wgDisableCounters = true;
 # $wgMiserMode		= true;
 
-# The following three config variables are used to define
-# the rights of users in your system. 
+## The following three config variables are used to define
+## the rights of users in your system.
 #
 # If wgWhitelistEdit is set to true, only logged in users
 # are allowed to edit articles.
-# If wgWhitelistRead is set to true, only logged in users
-# are allowed to read articles.
+# If wgWhitelistRead is set to an array of page names, only logged in users
+# are allowed to read pages *not in the list*.
 #
 # wgWhitelistAccount lists user types that can add user accounts:
 # "key" => 1 defines permission if user has right "key".
@@ -120,7 +202,8 @@ $wgOutputEncoding	= "ISO-8859-1";
 #
 # Invitation-only closed shop type of system
 # $wgWhitelistEdit = true;
-# $wgWhitelistRead = true;
+# Pages anonymous user may see:
+# $wgWhitelistRead = array ( ":Main_Page", "Special:Userlogin", "Wikipedia:Help");
 # $wgWhitelistAccount = array ( "user" => 0, "sysop" => 1, "developer" => 1 );
 #
 # Public website, closed editorial team
@@ -137,7 +220,15 @@ $wgOutputEncoding	= "ISO-8859-1";
 # $wgUseESI = true;
 # Internal server name as known to Squid, if different
 # $wgInternalServer = 'http://yourinternal.tld:8000';
+# Cache timeout for the squid, will be sent as s-maxage (without ESI) or
+# Surrogate-Control (with ESI). Without ESI, you should strip out s-maxage in the Squid config.
+# 18000 seconds = 5 hours, more cache hits with 2678400 = 31 days
+# $wgSquidMaxage = 18000;
 # 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');
+
+# Browser-related setting
+$wgBrowserBlackList = array();
+
 ?>