fix a problem by not inserting __MWTEMPLATESECTION for section titles that don't...
[lhc/web/wiklou.git] / includes / DefaultSettings.php
index 7ce4518..0319147 100644 (file)
@@ -1,23 +1,47 @@
 <?php
-
-# $Id$
-# DO NOT EDIT THIS FILE!
-# To customize your installation, edit "LocalSettings.php".
-# 
-# Note that since all these string interpolations are expanded
-# before LocalSettings is included, if you localize something
-# like $wgScriptPath, you must also localize everything that
-# depends on it.
+/**
+ * DO NOT EDIT THIS FILE!
+ *
+ * To customize your installation, edit "LocalSettings.php".
+ *
+ * Note that since all these string interpolations are expanded
+ * before LocalSettings is included, if you localize something
+ * like $wgScriptPath, you must also localize everything that
+ * depends on it.
+ *
+ * @version $Id$
+ * @package MediaWiki
+ */
 
 # This is not a valid entry point, perform no further processing unless MEDIAWIKI is defined
 if( defined( 'MEDIAWIKI' ) ) {
 
+/**
+ * MediaWiki version number
+ * @global string $wgVersion
+ */
 $wgVersion                     = '1.4-prealpha';
 
-$wgSitename         = 'MediaWiki'; # Please customize!
-$wgMetaNamespace    = FALSE; # will be same as you set $wgSitename
-
-
+/** 
+ * Name of the site.
+ * It must be changed in LocalSettings.php
+ * @global string $wgSitename
+ */
+$wgSitename         = 'MediaWiki';
+
+/**
+ * Will be same as you set @see $wgSitename
+ * @global mixed $wgMetaNamespace
+ */
+$wgMetaNamespace    = FALSE;
+
+
+/** 
+ * URL of the server
+ * It will be automaticly build including https mode
+ * @global string $wgServer
+ */
+$wgServer = '';
 # check if server use https:
 $wgProto = (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] == 'on') ? 'https' : 'http';
 
@@ -29,21 +53,51 @@ if ( @$wgCommandLineMode ) {
 }
 unset($wgProto);
 
+
+/**
+ * The path we should point to.
+ * It might be a virtual path in case with use apache mod_rewrite for example
+ * @global string $wgScriptPath
+ */
 $wgScriptPath      = '/wiki';
 
-# Whether to support URLs like index.php/Page_title
+/**
+ * Whether to support URLs like index.php/Page_title
+ * @global bool $wgUsePathInfo
+ */
 $wgUsePathInfo         = ( strpos( php_sapi_name(), 'cgi' ) === false );
 
-# ATTN: Old installations used wiki.phtml and redirect.phtml -
-# make sure that LocalSettings.php is correctly set!
+
+/**#@+
+ * Script users will request to get articles
+ * ATTN: Old installations used wiki.phtml and redirect.phtml -
+ * make sure that LocalSettings.php is correctly set!
+ * @deprecated
+ */
+/** 
+ *     @global string $wgScript
+ */
 $wgScript           = "{$wgScriptPath}/index.php";
+/**
+ *     @global string $wgRedirectScript
+ */
 $wgRedirectScript   = "{$wgScriptPath}/redirect.php";
-
-
-# Paths Settings
-# 
-$wgStylePath   = "{$wgScriptPath}/style";
-$wgStyleDirectory = "{$IP}/style";
+/**#@-*/
+
+
+/**#@+
+ * @global string
+ */
+/**
+ * style path as seen by users
+ * @global string $wgStylePath
+ */
+$wgStylePath   = "{$wgScriptPath}/skins";
+/**
+ * filesystem stylesheets directory
+ * @global string $wgStyleDirectory
+ */
+$wgStyleDirectory = "{$IP}/skins";
 $wgStyleSheetPath = &$wgStylePath;
 $wgStyleSheetDirectory = &$wgStyleDirectory;
 $wgArticlePath      = "{$wgScript}?title=$1";
@@ -53,26 +107,77 @@ $wgLogo                            = "{$wgUploadPath}/wiki.png";
 $wgMathPath         = "{$wgUploadPath}/math";
 $wgMathDirectory    = "{$wgUploadDirectory}/math";
 $wgTmpDirectory     = "{$wgUploadDirectory}/tmp";
+/**#@-*/
 
 
 # Email settings
 #
-$wgEmergencyContact = 'wikiadmin@' . getenv( 'SERVER_NAME' );
-$wgPasswordSender      = 'Wikipedia Mail <apache@' . getenv( 'SERVER_NAME' ) . '>';
-
-# For using a direct (authenticated) SMTP server connection.
-# "host" => 'SMTP domain', "IDHost" => 'domain for MessageID', "port" => "25", "auth" => true/false, "username" => user, "password" => password
+/**
+ * Site admin email address
+ * Default to wikiadmin@SERVER_NAME
+ * @global string $wgEmergencyContact
+ */
+$wgEmergencyContact = 'wikiadmin@' . $_SERVER['SERVER_NAME'];
+
+/**
+ * Password reminder email address
+ * The address we should use as sender when a user is requesting his password
+ * Default to apache@SERVER_NAME
+ * @global string $wgPasswordSender
+ */
+$wgPasswordSender      = 'Wikipedia Mail <apache@' . $_SERVER['SERVER_NAME'] . '>';
+
+
+/**
+ * SMTP Mode
+ * For using a direct (authenticated) SMTP server connection. 
+ * Default to false or fill an array :
+ * <code>
+ * "host" => 'SMTP domain',
+ * "IDHost" => 'domain for MessageID',
+ * "port" => "25",
+ * "auth" => true/false,
+ * "username" => user,
+ * "password" => password
+ * </code>
+ *
+ * @global mixed $wgSMTP
+ */
 $wgSMTP                                = false;
 
 
-# Database settings
-#
+/**#@+
+ * Database settings
+ */
+/** database host name or ip address */
 $wgDBserver         = 'localhost';
+/** name of the database */
 $wgDBname           = 'wikidb';
+/** */
 $wgDBconnection     = '';
+/** Database username */
 $wgDBuser           = 'wikiuser';
-$wgDBtype           = "mysql"; # "mysql" for working code and "PostgreSQL" for development/broken code
-$wgDBprefix         = ''; # Table name prefix
+/** Database type
+ * "mysql" for working code and "PostgreSQL" for development/broken code
+ */
+$wgDBtype           = "mysql";
+/** Table name prefix */
+$wgDBprefix         = ''; 
+/** Database schema
+ * on some databases this allows separate 
+ * logical namespace for application data
+ */
+$wgDBschema        = 'mediawiki';
+/**#@-*/
+
+
+
+# Shared database for multiple wikis.
+# Presently used for storing a user table for single sign-on
+# The server for this database must be the same as for the main
+# database.
+# EXPERIMENTAL
+# $wgSharedDB='';
 
 # Database load balancer
 # This is a two-dimensional array, an array of server info structures
@@ -131,17 +236,45 @@ $wgMemCachedDebug   = false;
 $wgSessionsInMemcached = false;
 $wgLinkCacheMemcached = false; # Not fully tested
 
-# Turck MMCache shared memory
-# You can use this for persistent caching where your wiki runs on a small number of 
-# servers. Mutually exclusive with memcached. MMCache must be installed.
+/**
+ * Turck MMCache shared memory
+ * You can use this for persistent caching where your wiki runs on a small
+ * number of servers. Mutually exclusive with memcached. MMCache must be
+ * installed.
+ *
+ * @global bool $wgUseTurckShm Enable or disabled Turck MMCache
+ */
 $wgUseTurckShm      = false;
 
 
 # Language settings
 #
+/**
+ * Site language code
+ * Default to 'en'. Should be one of ./language/Language(.*).php
+ * @global string $wgLanguageCode
+ */
 $wgLanguageCode     = 'en';
-$wgLanguageFile     = false; # Filename of a language file generated by dumpMessages.php
-$wgInterwikiMagic      = true; # Treat language links as magic connectors, not inline links
+
+/**
+ * Languages which the user may select to display the user interface
+ * in instead of the default language. This option is currently
+ * experimental and WILL FAIL FOR MANY COMMON TASKS AND PERHAPS
+ * CORRUPT YOUR DATABASE WITH BOGUS DATA.
+ * Set to eg array( 'en', 'fr', 'zh' ) etc
+ */
+$wgUserLanguages = array();
+
+/**
+ * Filename of a language file generated by dumpMessages.php
+ * @global string|false $wgLanguageFile (default:false)
+ */
+$wgLanguageFile     = false;
+/**
+ * Treat language links as magic connectors, not inline links
+ * @global bool $wgInterwikiMagic (default:true)
+ */
+$wgInterwikiMagic      = true;
 $wgInputEncoding       = 'ISO-8859-1'; # LanguageUtf8.php normally overrides this
 $wgOutputEncoding      = 'ISO-8859-1'; # unless you set the next option to true:
 $wgUseLatin1           = false; # Enable ISO-8859-1 compatibility mode
@@ -181,6 +314,10 @@ $wgReadOnlyFile         = "{$wgUploadDirectory}/lock_yBgMBwiR";
 # The debug log file should be not be publicly accessible if it is
 # used, as it may contain private data.
 $wgDebugLogFile         = '';
+
+/**#@+
+ * @global bool
+ */
 $wgDebugRedirects              = false;
 $wgDebugRawPage         = false; # Avoid overlapping debug entries by leaving out CSS
 
@@ -209,6 +346,7 @@ $wgCompressedPersistentLC = true; # use gzcompressed blobs
 $wgUseOldExistenceCheck = false;  # use old prefill link method, for debugging only
 
 $wgEnableParserCache = false; # requires that php was compiled --with-zlib
+/**#@-*/
 
 # wgHitcounterUpdateFreq sets how often page counters should be
 # updated, higher values are easier on the database. A value of 1
@@ -397,10 +535,6 @@ $wgSiteNotice = "";
 # 
 $wgUseImageResize              = false;
 
-## Set maximum width of images on image description pages.
-## Images bigger than this will be rendered down.
-$wgMaxImageWidth = 800;
-
 ## 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.
@@ -487,9 +621,9 @@ $wgGoToEdit = false;
 $wgUserHtml = true;
 
 # Allow raw, unchecked HTML in <html>...</html> sections.
-# THIS IS VERY DANGEROUS on a publically editable site.
-# Don't enable it unless you've restricted editing to trusted
-# users only.
+# THIS IS VERY DANGEROUS on a publically editable site, so
+# you can't enable it unless you've restricted editing to
+# trusted users only with $wgWhitelistEdit.
 $wgRawHtml = false;
 
 # $wgUseTidy: use tidy to make sure HTML output is sane.
@@ -542,9 +676,38 @@ $wgUseExternalDiffEngine = false;
 # Use RC Patrolling to check for vandalism
 $wgUseRCPatrol = true;
 
-# set wgUserTablePrefix to the name of the DB where your users
-# table is for single login. Disabled by default.
-#$wgUserTablePrefix='';
+# Additional namespaces. If the namespaces defined in Language.php and Namespace.php are insufficient,
+# you can create new ones here, for example, to import Help files in other languages.
+# PLEASE NOTE: Once you delete a namespace, the pages in that namespace will no longer be accessible.
+# If you rename it, then you can access them through the new namespace name.
+#
+# Custom namespaces should start at 100.
+#$wgExtraNamespaces =
+#      array(100 => "Hilfe",
+#            101 => "Hilfe_Diskussion",
+#            102 => "Aide",
+#            103 => "Discussion_Aide"
+#            );
+$wgExtraNamespaces = NULL;
+
+# Enable SOAP interface. Off by default
+# SOAP is a protocoll for remote procedure calls (RPC) using http as middleware.
+# This interface can be used by bots or special clients to receive articles from
+# a wiki.
+# Most bots use the normal HTTP interface and don't use SOAP.
+# If unsure, set to false.
+$wgEnableSOAP = false;
+
+# Limit images on image description pages to a user-selectable limit. In order to
+# reduce disk usage, limits can only be selected from a list. This is the list of
+# settings the user can choose from:
+$wgImageLimits = array (
+       array(320,240),
+       array(640,480),
+       array(800,600),
+       array(1024,768),
+       array(1280,1024),
+       array(10000,10000) );
 
 } else {
        die();