File README.DISTRIBUTION of Package mediawiki

README.DISTRIBUTION for Mediawiki
=================================

Mediawiki requires a web-server with PHP support and one of the supported
database-systems. This RPM-package provides a pre-configured Apache -
configuration and suggests usage of MySQL, but any other supported database
can be used, too.

Before first run it's necessary to configure Mediawiki following way:

1. Use the 'default' Mediawiki location at /srv/www/mediawiki installed
   by the RPM-package OR add a new location using
   "mediawiki-admin install /srv/www/mywiki" which will
   create a structure to be used to store a Mediawiki system. In this case
   the installation can be added to the apache's configuration as suggested
   by the script.


2. Enable the mw-config alias in Apache's configuration and reload apache

   service apache2 reload


3. Access the Mediawiki configuration page, configure everything and upload the
   resulting LocalSettings.php to installation's webroot directory,
   e.g. /srv/www/mediawiki/webroot/LocalSettings.php

   https://www.test.com/mywiki/mw-config/index.php


4. To use short URLs, read mediawiki's documentation.
   The recommended setting can be defined in LocalSettings.php:
   $wgScriptPath  = "/w";
   $wgArticlePath = "/wiki/$1";

5. Remove the mw-config alias from Apache's configuration and reload Apache

   service apache2 reload


6. Access the new Mediawiki instance

   https://www.test.com/mywiki/


Included Scripts:
==================================

mediawiki-admin

This script updates can be used to 

* upgrade the default Mediawiki installation (/srv/www/mediawiki/webroot)
  as well as all installations listed in /etc/mediawiki-installations.
  Update-Logs are reported to /var/log/mediawiki-update.log

* create new symlinked Mediawiki instances and prints a recommended
  Apache-Configuration to the console.
  
* Run Asyncron scripts


Additional information:
==================================

*) Edit LocalSettings.php to match your needs. e.g.

   For enable picture uploads:
   $wgEnableUploads = true;

*) To enable file-upload it is suggested to set some variables
   correctly in LocalSettings.php:

   $wgTmpDirectory= dirname($IP).'/tmp';


*) To enable cache use a proper directory. The following is suggested:

   $wgCacheDirectory = dirname($IP).'/cache';

*) Mediawiki's Apache-Configuration can be found in
   /etc/apache2/conf.d/mediawiki.conf. 
   Mediawiki is included through the /wiki/ and /w/ aliases.

*) After activating or Updating extensions, run a database upgrade (maintainance/upgrade.php)
   or execute the packaged mediawiki-update.sh tool.

Breaking changes in version 1.33
================================

Locations and symlink-methods have been changes. You have to review all your instances!

* The shared code bas has been moved from /usr/shared/mediawiki to /usr/shared/php/mediawiki

* The basic installation has been moved from /var/lib/mediawiki to /srv/www/mediawiki

* Skins (example with the new timeless-skin) must now be included using the 
  following lines in LocalSettings.php:

wfLoadSkin( 'Timeless' );
$wgDefaultSkin = 'timeless';
# $wgAllowUserSkin = false;

* All extensionsare have to be installed in /usr/shared/php/mediawiki/extensions. Move (and update)
  extensions you are using from the old to the new locations.

* Extensions are now included using "wfLoadExtension( 'EXTENSION_NAME' )"

* If you had a installation in the former default location which you want to move to the new location
  move the webroot directory to the new location and remove the old installation.
  PLEASE BE CAREFULL AND DO A BACKUP BEFORE DELETING FILES

rm -rf /srv/www/mediawiki/webroot
mv /var/lib/mediawiki/webroot /srv/www/mediawiki
rm -rf /var/lib/mediawiki

For more information read user guide on:
========================================
http://www.mediawiki.org/wiki/Localisation
http://www.mediawiki.org/wiki/Manual:Contents
http://www.mediawiki.org/wiki/Manual:Short_URL/Apache
Places

File README.DISTRIBUTION of Package mediawiki

Places
