Difference between revisions of "MediaWiki"

From HackerNet
Jump to: navigation, search
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
[[Category:Guider]] [[Category:Sparco]]
 
MediaWiki är en open-source wiki application som driver två av dom största och bästa wiki hemsidorna på nätet [http://hackernet.se Hackernet] och [https://www.wikipedia.org/ Wikipedia].
 
MediaWiki är en open-source wiki application som driver två av dom största och bästa wiki hemsidorna på nätet [http://hackernet.se Hackernet] och [https://www.wikipedia.org/ Wikipedia].
−
 
  
 
== Förberedelser ==
 
== Förberedelser ==
Line 35: Line 35:
  
 
==Konfiguration==
 
==Konfiguration==
 +
All konfiguration av mediawiki och plugins görs i <code>LocalSettings.php</code> filen.
 +
 +
===Plugins===
 +
[https://www.mediawiki.org/wiki/Category:Extensions Plugins] finns på mediawikis hemsida.
 +
 +
Några bra plugins som denna sidan använder är.
 +
{| class="wikitable"
 +
|-
 +
|[https://www.mediawiki.org/wiki/Extension:VisualEditor Visual Editor]||Bra editor om man är nybörjare och inte förstår mediawikis syntax.
 +
|-
 +
|[https://www.mediawiki.org/wiki/Extension:Google_Analytics_Integration Google Analytics]||Enkelt att få Google analytics att fungera.
 +
|-
 +
|[https://www.mediawiki.org/wiki/Extension:LDAP_Authentication LDAP Authentication]||För att kunna koppla sin wiki mot en LDAP server som OpenLDAP eller Active Directory.
 +
|-
 +
|[https://www.mediawiki.org/wiki/Extension:WikiEditor Wiki Editor]||För att få en lite bättre source editor.
 +
|-
 +
|[https://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight]||För att kunna få tex php,html,python kod på en sida mer lättläst.
 +
|-
 +
|[https://www.mediawiki.org/wiki/Extension:MsUpload MsUpload]||Enkelt kunna ladda upp filer när man editerar.
 +
|-
 +
|[https://www.mediawiki.org/wiki/Extension:Intersection Dynamic Page List]||För att kunna skapa dynamiska listor från tex kategorier eller namespaces. Tools på [[Linux#Tools|Linux sidan]] använder detta plugin.
 +
|-
 +
|[https://www.mediawiki.org/wiki/Extension:Contribution_Scores Contribution Scores]||För att få fram en tabel om vem som bidragit med mest på wikin.
 +
|}
 +
 +
==Backup==
 +
Vi använder ett script som gör en dump på databasen och packar ihop dumpen med alla filer i mediawiki mappen. Backup filen sparas i samma mapp som scriptet körs i.
 +
 +
<div class="panel-group" id="accordion">
 +
<accordion parent="accordion" heading="Ändra under configuration så det passar dig.">
 +
<syntaxhighlight lang=bash>#!/bin/bash
 +
#
 +
# fullsitebackup.sh V1.2
 +
#
 +
# Full backup of website files and database content.
 +
#
 +
# A number of variables defining file location and database connection
 +
# information must be set before this script will run.
 +
# Files are tar'ed from the root directory of the website. All files are
 +
# saved. The MySQL database tables are dumped without a database name and
 +
# and with the option to drop and recreate the tables.
 +
#
 +
# ----------------------
 +
# 05-Jul-2007 - Quick adaptation for MediaWiki (currently testing)
 +
# ----------------------
 +
# March 2007 Updates - Version for Drupal
 +
# - Updated script to resolve minor path bug
 +
# - Added mysql password variable (caution - this script file is now a security risk - protect it)
 +
# - Generates temp log file
 +
# - Updated backup and restore scripts have been tested on Ubunutu Edgy server w/Drupal 5.1
 +
#
 +
# - Enjoy! BristolGuy
 +
#-----------------------
 +
#
 +
## Parameters:
 +
# tar_file_name (optional)
 +
#
 +
#
 +
# Configuration
 +
#
 +
 +
# Database connection information
 +
dbname="wiki" # (e.g.: dbname=wikidb)
 +
dbhost="localhost"
 +
dbuser="wikidb" # (e.g.: dbuser=wikiuser)
 +
dbpw="secretpassword" # (e.g.: dbuser password)
 +
 +
# Website Files
 +
webrootdir="/var/www/wiki" # (e.g.: webrootdir=/home/user/public_html)
 +
 +
#
 +
# Variables
 +
#
 +
 +
# Default TAR Output File Base Name
 +
tarnamebase=wiki_sitebackup-
 +
datestamp=`date +'%m-%d-%Y'`
 +
 +
# Execution directory (script start point)
 +
startdir=`pwd`
 +
logfile=$startdir"/fullsite.log" # file path and name of log file to use
 +
 +
# Temporary Directory
 +
tempdir=$datestamp
 +
 +
#
 +
# Input Parameter Check
 +
#
 +
 +
if test "$1" = ""
 +
then
 +
tarname=$tarnamebase$datestamp.tgz
 +
else
 +
tarname=$1
 +
fi
 +
 +
#
 +
# Begin logging
 +
#
 +
echo "Beginning mediawiki site backup using fullsitebackup.sh ..." > $logfile
 +
#
 +
# Create temporary working directory
 +
#
 +
echo " Creating temp working dir ..." >> $logfile
 +
mkdir $tempdir
 +
 +
#
 +
# TAR website files
 +
#
 +
echo " TARing website files into $webrootdir ..." >> $logfile
 +
cd $webrootdir
 +
tar cf $startdir/$tempdir/filecontent.tar .
 +
 +
#
 +
# sqldump database information
 +
#
 +
echo " Dumping mediawiki database, using ..." >> $logfile
 +
echo " user:$dbuser; database:$dbname host:$dbhost " >> $logfile
 +
cd $startdir/$tempdir
 +
mysqldump --user=$dbuser --password=$dbpw --add-drop-table $dbname > dbcontent.sql
 +
 +
#
 +
# Create final backup file
 +
#
 +
echo " Creating final compressed (tgz) TAR file: $tarname ..." >> $logfile
 +
tar czf $startdir/$tarname filecontent.tar dbcontent.sql
 +
 +
#
 +
# Cleanup
 +
#
 +
echo " Removing temp dir $tempdir ..." >> $logfile
 +
cd $startdir
 +
rm -r $tempdir
 +
 +
#
 +
# Exit banner
 +
#
 +
endtime=`date`
 +
echo "Backup completed $endtime, TAR file at $tarname. " >> $logfile
 +
</syntaxhighlight>
 +
</accordion>
 +
 +
===Cronjob===
 +
Scriptet funkar att köra som ett cronjob. Raden gör att det körs en backup kl 05:00 varje dag.
 +
 +
0 05 * * * cd /path/to/script && sh Backup_script.sh
 +
 +
== Sitemap ==
 +
Mediawiki har ett inbyggt script för att skapa sitemaps. Sitemaps används av sökmotorer så att deras botar vet vilka URLs det finns att indexera.
 +
 +
Scriptet finns under <code>maintenance</code> och heter <code>generateSitemap.php</code>.
 +
 +
Skapa en mapp att spara sitemapen i.
 +
mkdir /var/www/mediawiki/sitemap
 +
 +
Kör kommandot,
 +
php generateSitemap.php --fspath /var/www/mediawiki/sitemap --server "http://URLtillStartsidan" --urlpath "http://URLtill/sitemap"
 +
 +
Nu ska du säga till sökmotorn vart din sitemap finns så är det klart.
 +
 +
=== Cronjob ===
 +
Kör generateSitemap.php som ett cronjob var 45e minut.
 +
*/45 * * * * /usr/bin/php /var/www/wiki/maintenance/generateSitemap.php --fspath /var/www/mediawiki/sitemap --server "http://URLtillStartsidan" --urlpath "http://URLtill/sitemap"
 +
 +
== Upgrade ==
 +
Mediawiki använder semantic versioning där man namnger releases X.Y.Z (Major.Minor.Patch). I skrivande stund så är Mediawiki uppe i major 1, minor 26, patch 0.
 +
 +
Alla versioner av Mediawiki finns att ladda hem [https://releases.wikimedia.org/mediawiki/ här!]
 +
===Minor===
 +
Oftast är '''LocalSettings.php''' kompatibel mellan minor versioner, läs release notes för att få reda på mer.
 +
 +
Ersätt dom gammla filerna med dom nya filerna. Via skalet kör sedan maintenance script för att uppdatera databas tabeller och bygg om filstrukturen för bla filer:
 +
php /var/www/mediawiki/maintenance/update.php
 +
php /var/www/mediawiki/maintenance/rebuildall.php
  
−
==Plugins==
+
Gå in på din wiki sida och kolla ''Special:Version'' för att verifiera att uppgraderingen.
 +
===Patch===
 +
#Gå till din mediawiki mapp (den med localsettings.php i).
 +
#Ladda ner och packa om patch filen.
 +
#Kör '''patch -p1 --dry-run -i ''mediawiki stable release number.patch'''''
 +
#Gick allt igenom utan problem kör samma kommando igen fast utan '''--dry-run'''.
 +
#Surfa sedan in på din wiki sida och kolla ''Special:Version'' för att verifiera att patchen gått igenom.

Latest revision as of 11:48, 3 August 2017

MediaWiki är en open-source wiki application som driver två av dom största och bästa wiki hemsidorna på nätet Hackernet och Wikipedia.

Förberedelser

För att kunna köra mediawiki krävs det att du har LAMP.

Valfria program

Man kan installera dom i efterhand också om man kommer på att man behöver dom.

php-apc Alternative PHP Cache.
php5-intl Unicode normalization.
ImageMagick Image thumbnailing.
GD Library Alternative to ImageMagick. Install libgd2-xpm libgd2-xpm-dev php5-gd.
phpmyadmin MySQL administration tool.
php5-cli Ability to run PHP commands from the command line, which is useful for debugging and running maintenance scripts.

Exempel: 

 sudo apt-get install php-apc php5-intl imagemagick phpmyadmin vsftpd php5-cli

Installation

Tanka hem senaste eller LTS versionen från deras hemsida, packa upp filen och byt namn på foldern. 

wget https://releases.wikimedia.org/mediawiki/1.25/mediawiki-1.25.1.tar.gz | tar -xvf mediawiki-1.25.1.tar.gz -C /var/www/ | mv /var/www/mediawiki-1.25.1/ /var/www/mediawiki

Se till att användaren som kör din webbserver äger mappen mediawiki så att du kan tex ladda upp filer.

Skapa sedan en databas som mediawiki kan ansluta till, surfa sedan in på http://<ip>/mediawiki och följ wizarden.

När wizarden är klar ladda upp LocalSettings.php till mediawiki mappen.

Konfiguration

All konfiguration av mediawiki och plugins görs i LocalSettings.php filen.

Plugins

Plugins finns på mediawikis hemsida.

Några bra plugins som denna sidan använder är.

Visual Editor Bra editor om man är nybörjare och inte förstår mediawikis syntax.
Google Analytics Enkelt att få Google analytics att fungera.
LDAP Authentication För att kunna koppla sin wiki mot en LDAP server som OpenLDAP eller Active Directory.
Wiki Editor För att få en lite bättre source editor.
SyntaxHighlight För att kunna få tex php,html,python kod på en sida mer lättläst.
MsUpload Enkelt kunna ladda upp filer när man editerar.
Dynamic Page List För att kunna skapa dynamiska listor från tex kategorier eller namespaces. Tools på Linux sidan använder detta plugin.
Contribution Scores För att få fram en tabel om vem som bidragit med mest på wikin.

Backup

Vi använder ett script som gör en dump på databasen och packar ihop dumpen med alla filer i mediawiki mappen. Backup filen sparas i samma mapp som scriptet körs i.

Ändra under configuration så det passar dig. 

#!/bin/bash
#
# fullsitebackup.sh V1.2
#
# Full backup of website files and database content.
#
# A number of variables defining file location and database connection
# information must be set before this script will run.
# Files are tar'ed from the root directory of the website. All files are
# saved. The MySQL database tables are dumped without a database name and
# and with the option to drop and recreate the tables.
#
# ----------------------
# 05-Jul-2007 - Quick adaptation for MediaWiki (currently testing)
# ----------------------
# March 2007 Updates - Version for Drupal
# - Updated script to resolve minor path bug
# - Added mysql password variable (caution - this script file is now a security risk - protect it)
# - Generates temp log file
# - Updated backup and restore scripts have been tested on Ubunutu Edgy server w/Drupal 5.1
#
# - Enjoy! BristolGuy
#-----------------------
#
## Parameters:
# tar_file_name (optional)
#
#
# Configuration
#

# Database connection information
dbname="wiki" # (e.g.: dbname=wikidb)
dbhost="localhost"
dbuser="wikidb" # (e.g.: dbuser=wikiuser)
dbpw="secretpassword" # (e.g.: dbuser password)

# Website Files
webrootdir="/var/www/wiki" # (e.g.: webrootdir=/home/user/public_html)

#
# Variables
#

# Default TAR Output File Base Name
tarnamebase=wiki_sitebackup-
datestamp=`date +'%m-%d-%Y'`

# Execution directory (script start point)
startdir=`pwd`
logfile=$startdir"/fullsite.log" # file path and name of log file to use

# Temporary Directory
tempdir=$datestamp

#
# Input Parameter Check
#

if test "$1" = ""
then
tarname=$tarnamebase$datestamp.tgz
else
tarname=$1
fi

#
# Begin logging
#
echo "Beginning mediawiki site backup using fullsitebackup.sh ..." > $logfile
#
# Create temporary working directory
#
echo " Creating temp working dir ..." >> $logfile
mkdir $tempdir

#
# TAR website files
#
echo " TARing website files into $webrootdir ..." >> $logfile
cd $webrootdir
tar cf $startdir/$tempdir/filecontent.tar .

#
# sqldump database information
#
echo " Dumping mediawiki database, using ..." >> $logfile
echo " user:$dbuser; database:$dbname host:$dbhost " >> $logfile
cd $startdir/$tempdir
mysqldump --user=$dbuser --password=$dbpw --add-drop-table $dbname > dbcontent.sql

#
# Create final backup file
#
echo " Creating final compressed (tgz) TAR file: $tarname ..." >> $logfile
tar czf $startdir/$tarname filecontent.tar dbcontent.sql

#
# Cleanup
#
echo " Removing temp dir $tempdir ..." >> $logfile
cd $startdir
rm -r $tempdir

#
# Exit banner
#
endtime=`date`
echo "Backup completed $endtime, TAR file at $tarname. " >> $logfile

Cronjob

Scriptet funkar att köra som ett cronjob. Raden gör att det körs en backup kl 05:00 varje dag. 

0 05 * * * cd /path/to/script && sh Backup_script.sh

Sitemap

Mediawiki har ett inbyggt script för att skapa sitemaps. Sitemaps används av sökmotorer så att deras botar vet vilka URLs det finns att indexera.

Scriptet finns under maintenance och heter generateSitemap.php.

Skapa en mapp att spara sitemapen i. 

mkdir /var/www/mediawiki/sitemap

Kör kommandot, 

php generateSitemap.php --fspath /var/www/mediawiki/sitemap --server "http://URLtillStartsidan" --urlpath "http://URLtill/sitemap"

Nu ska du säga till sökmotorn vart din sitemap finns så är det klart.

Cronjob

Kör generateSitemap.php som ett cronjob var 45e minut. 

*/45 * * * * /usr/bin/php /var/www/wiki/maintenance/generateSitemap.php --fspath /var/www/mediawiki/sitemap --server "http://URLtillStartsidan" --urlpath "http://URLtill/sitemap"

Upgrade

Mediawiki använder semantic versioning där man namnger releases X.Y.Z (Major.Minor.Patch). I skrivande stund så är Mediawiki uppe i major 1, minor 26, patch 0.

Alla versioner av Mediawiki finns att ladda hem här!

Minor

Oftast är LocalSettings.php kompatibel mellan minor versioner, läs release notes för att få reda på mer.

Ersätt dom gammla filerna med dom nya filerna. Via skalet kör sedan maintenance script för att uppdatera databas tabeller och bygg om filstrukturen för bla filer: 

php /var/www/mediawiki/maintenance/update.php
php /var/www/mediawiki/maintenance/rebuildall.php

Gå in på din wiki sida och kolla Special:Version för att verifiera att uppgraderingen.

Patch

  1. Gå till din mediawiki mapp (den med localsettings.php i).
  2. Ladda ner och packa om patch filen.
  3. Kör patch -p1 --dry-run -i mediawiki stable release number.patch
  4. Gick allt igenom utan problem kör samma kommando igen fast utan --dry-run.
  5. Surfa sedan in på din wiki sida och kolla Special:Version för att verifiera att patchen gått igenom.
Retrieved from "https://hackernet.se/index.php?title=MediaWiki&oldid=2606"