Mediawiki: Difference between revisions

From 太極
Jump to navigation Jump to search
Line 419: Line 419:
Another way to get the SVG instead of PNG format for mathematical formulae is to use the [https://www.mediawiki.org/wiki/Extension:SimpleMathJax SimpleMathJax] extension (see a [https://stackoverflow.com/questions/29387372/how-to-embed-maths-in-mediawiki discussion]). The instruction needs to be modified.  
Another way to get the SVG instead of PNG format for mathematical formulae is to use the [https://www.mediawiki.org/wiki/Extension:SimpleMathJax SimpleMathJax] extension (see a [https://stackoverflow.com/questions/29387372/how-to-embed-maths-in-mediawiki discussion]). The instruction needs to be modified.  
* After unzip the zip file to the extensions folder it is necessary to change the folder name from 'SimpleMathJax-master' to 'SimpleMathJax' (if we did not do that, the maintenance/update.php will issue errors)
* After unzip the zip file to the extensions folder it is necessary to change the folder name from 'SimpleMathJax-master' to 'SimpleMathJax' (if we did not do that, the maintenance/update.php will issue errors)
* The renaming step is not necessary if we use the 'git' command to download the files
* The renaming step is not necessary if we use the 'git' command to download the files; i.e. git clone https://github.com/jmnote/SimpleMathJax.git


It works when I tested on Ubuntu 18 + Mediawiki 1.31 + SimpleMathJax 0.7.3.
It works when I tested on Ubuntu 18 + Mediawiki 1.31 + SimpleMathJax 0.7.3.

Revision as of 11:34, 10 October 2018

Help resources

Announcements of releases and security updates

https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce

Cheatsheet

Wikipedia.org

Keyboard shortcut

https://www.mediawiki.org/wiki/VisualEditor/Portal/Keyboard_shortcuts

  • Save: Alt+s (non-mac), Ctr+Option+s (Mac)
  • Preview: Alt+p (non-mac), Ctrl+Option+p (Mac)

Install mediawiki on ubuntu

http://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Debian_GNU/Linux

Check requirement

php -v
mysql -V  # capital V

http://localhost/mediawiki setup

  • Language
  • Welcome to MediaWiki!
    • Environmental checks
    • Copyright and Terms
  • Connect to database - MySQL settings
    • Database host: localhost
    • Database name: (default is my_wiki)
    • Database table prefix: (Leave it empty)
    • Database username: root (saved in LocalSettings.php - $wgDBuser, no need to change)
    • Database password: (saved in LocalSettings.php - $wgDBpassword)
  • Database settings
    • Storage engine: InnoDB
    • Database character set: Binary
  • Name
    • Name of wiki: (saved in LocalSettings.php - $wgSitename)
    • Administrator account
      • Your username: (will be saved in the database)
      • Password: (will be saved in the database)
      • Email address: (leave it empty)
      • Uncheck 'Share data about this installation with MediaWiki developers.'
      • Check 'I'm bored already, just install the wiki.'

If we choose 'Ask me more questions', we will get more questions to answer

  • Options
    • User rights profile: Open wiki/Account creation required/Authorized editors only/Private wiki
    • Copyright and license: Creative Commons Attribution/.../No license footer/Select a custom Creative Commons license
    • Email settings
    • Skins
    • Extensions: Gadgets, ImageMap, InputBox, Interwiki, LocalisationUpdate, Nuke, ParserFunctions, PdfHandler, Renameuser, SpamBlacklist, SyntaxHighlight_GeSHi, TitleBlacklist, WikiEditor
    • Images and file uploads: Enable file uploads, Logo URL
    • Advanced configuration: PHP object caching (APC, APCu, XCache or WinCache)

At the end, we will be notified to download LocalSettings.php file. The new database will be created now. 

$ mysql -u root -p -e 'SHOW DATABASES'

$ mysql -u root -p -e 'SHOW TABLES' DB_NAME

Enable tex for formula

1. The following line is coming from an earlier bookmarked tutorial (not sure if it is needed anymore) 

apt-get install mediawiki-math

2. Download Math extension from this link

3. Then you should extract the archive in the "extensions" folder within your MediaWiki installation directory.

4. Next, you need to add the following line to your LocalSettings.php file: 

wfLoadExtension( 'Math' );

5. Install texvc and ocaml 

sudo apt-get install ocaml
cd extensions/Math/math
make

6. The next step is to execute the "maintenance/update.php" script via shell: 

php maintenance/update.php

Done. Go to test it. [Tested on mediawiki 1.22 on Ubuntu 12.04]. Navigate to "Special:Version" on your wiki to verify that the extension is successfully installed.

Skins

The default skin is vector.

MobileFrontEnd

cd Downloads
wget https://extdist.wmflabs.org/dist/extensions/MobileFrontend-REL1_30-5ecc673.tar.gz
wget https://extdist.wmflabs.org/dist/skins/MinervaNeue-REL1_30-7ee8663.tar.gz
tar xzvf MobileFrontend-REL1_30-5ecc673.tar.gz -C ../mediawiki-1.30.0/extensions/
tar xzvf MinervaNeue-REL1_30-7ee8663.tar.gz -C ../mediawiki-1.30.0/skins
  • Use a table or phone to test the effect. It works. The changes I made to <LocalSettings.php>
wfLoadSkin( 'MinervaNeue' ); # put it in the same section of wfLoadSkin

wfLoadExtension( 'MobileFrontend' );
$wgMFAutodetectMobileView = true;
$wgMFDefaultSkinClass = 'SkinMinerva';

$wgShowExceptionDetails = true; # debugging use only

Install on Ubuntu 16.04, 18.04

I follow this guide to install LAMP.

However the SSH setting will be affected since ufw will assume the default port. So I follow this guide to fix the port problem on OpenSSH.

How to install MediaWiki on Ubuntu 18.04 LTS

Install mediawiki on debian

Link here [1]

Install mediawiki through Vagrant + VirtualBox

https://www.mediawiki.org/wiki/MediaWiki-Vagrant

Several extensions have an instruction for vagrant engine. 

vagrant roles enable mobilefrontend --provision

vagrant enable-role multimediaviewer 
vagrant provision

Run mediawiki with Docker

Install mediawiki on XAMPP

LocalSettings.php

  • $wgSitename = "BRB-ArrayTools";

The protocol and server name to use in fully-qualified URLs

  • $wgServer = "https://YOURDOMAIN.COM";
  • $wgSecureLogin = true;
  • $wgLogo = "$wgScriptPath/YOURLOGO.png";
  • $wgEnableEmail = false;

Database settings

  • $wgDBtype = "mysql";
  • $wgDBserver = "localhost";
  • $wgDBname = "MYWIKIDB";
  • $wgDBuser = "root"; # not the wiki user
  • $wgDBpassword = "MYPASSWORD"; # not the password used to log in the mediawiki

Shared memory settings

  • $wgMainCacheType = CACHE_ACCEL;

To enable image uploads, make sure the 'images' directory is writable, then set this to true:

  • $wgEnableUploads = true;

If you use ImageMagick (or any other shell command) on a Linux server, this will need to be set to the name of an available UTF-8 locale

  • $wgShellLocale = "en_US.utf8";

Extensions

  • wfLoadExtension( 'SyntaxHighlight_GeSHi' );
  • $wgFileExtensions = array('txt','svg','png','gif','jpg','jpeg','doc','xls','mpp','pdf','ppt','tiff','bmp','docx', 'xlsx', 'pptx','ps','odt','ods','odp','odg');
  • $wgSVGConverter = 'ImageMagick';
  • $wgTrustedMediaFormats = array('text/plain');
  • $wgDisableCounters = true;
  • $wgLocaltimezone = "America/New_York";
  • $wgLocalTZoffset = date("Z") / 60;
  • date_default_timezone_set( $wgLocaltimezone );
  • require_once("$IP/extensions/Math/Math.php");
  • $wgFavicon = "$wgScriptPath/favicon32.ico";

Customize

Customize MediaWiki into Your Ultimate Collaborative Web Site

Uninstall mediawiki

  1. delete the directory containing the wiki's files
  2. remove the MySQL database holding your wiki
mysql> DROP DATABASE wikidb;

Mediawiki database

MySQL

See the internal MySQL link.

  • It seems not necessary to create a new user for storing the mediawiki database; root is OK
  • The mediawiki database administrator information will not be saved to the database
  • The mediawiki user account will be written to the database.

Users

The administrator and users information is saved in the 'user' table of the wiki database. The can be seen by looking at the phpMyAdmin page. LocalSettings.php only saved the database name and username/password in order to get an access.

Format

Preformatted text with text wrap

Search 'Customized preformatted' on the Formatting page.

<pre style="white-space: pre-wrap; /* CSS 3 */ white-space: -moz-pre-wrap; /* Mozilla, since 1999 */ white-space: -pre-wrap; /* Opera 4-6 */ white-space: -o-pre-wrap; /* Opera 7 */ word-wrap: break-word; /* IE 5.5+ */ " > YOUR TEXT </pre>

Color format: CSS

Text is red. 

<span style="color: red">
Text is red.
</span>

Another example: Template::Mvar.

Preformatted text: nowiki

If we want to escape from wikipedia's interpretation & avoiding using pre which will create a block, we can use nowiki. One example is {{mvar}} instead of {{{1}}}.

Formatting: Superscript and subscript

Use 

<sup>1</sup>

or sub keyword.

Syntax highlight

Use the "syntaxhighlight" (for newer versions of mediawiki) or source (for older versions) tag for inline/non-inline syntax highlight. For example, 

library(d3Network)

Source <- c("A", "A", "A", "A", "B", "B", "C", "C", "D") 
Target <- c("B", "C", "D", "J", "E", "F", "G", "H", "I") 
NetworkData <- data.frame(Source, Target) 

d3SimpleNetwork(NetworkData, height = 800, width = 1024, file="tmp.html")

can be created by 

<source lang="rsplus">
library(d3Network)

Source <- c("A", "A", "A", "A", "B", "B", "C", "C", "D") 
Target <- c("B", "C", "D", "J", "E", "F", "G", "H", "I") 
NetworkData <- data.frame(Source, Target) 

d3SimpleNetwork(NetworkData, height = 800, width = 1024, file="tmp.html")
</source>

Note for some reason, when I use the syntaxhighlight tag (use syntaxhighlight instead of source tag), 'r' is not recognized on my mediawiki 1.22 although 'bash' works.

This syntax highlight extension package https://github.com/artemklevtsov/MediaWiki-SyntaxHighlight seems more complete. It supports markdown, cpp, r, bash, cxx, ... (no Fortran?) languages. But highlight.js library supports even more.

If we need to use code syntaxhighlight with a list, we shall put the beginning "syntaxhighlight" tag immediately after the paragraph instead of a new line. Putting the tag immediately after the paragraph allows an indentation of the code.

Create tables

Introduction Introduction Installation Installation Packages and Repositories Packages and
Repositories		 File Managers File Managers
Desktop Add-ons Desktop Add-ons Virtual Machines Virtual Machines Games and Entertainment Games and
Entertainment		 Internet Internet

Mediawiki/Apache has no response

sudo /etc/init.d/apache2 restart

Auto timeout

php.ini

See

On ubuntu, change /etc/php5/apache2/php.ini. 

session.cache_expire=180

session.gc_maxlifetime = 1440

session.cookie_lifetime = 1440

After modifying php.ini, you need to restart apache. sudo /etc/init.d/apache2 restart

'keep me logged in' option

Make sure to check this option on the login screen.

Errors and symptoms

https://www.mediawiki.org/wiki/Manual:Errors_and_symptoms

Sorry! We could not process your edit due to a loss of session data. You might have been logged out. Please verify that you're still logged in and try May be related to Cookies. See also Discussion.

favicon

Move favicon.ico to the mediawiki folder and include the following line in the <LocalSettings.php> 

$wgFavicon = "$wgScriptPath/favicon.ico";

Note that the attribute of the ico file has to be at least 644. If not, just run the following line 

chmod 644 favicon.ico

To download a favicon, use the approach here. For example, to download the favicon icon from https://wiki.ubuntu.com/ website, we just open the url https://wiki.ubuntu.com/favicon.ico.

The approach works is based on the assumption that the favicon.ico file name is not changed and usually located under the website root directory.

Change skin

Change user's password

https://www.mediawiki.org/wiki/Manual:Resetting_passwords

tackle slowness when saving pages

In summary:

1. Install php-apc. sudo apt-get install php-apc

2. nano LocalSettings.php. Change $wgMainCacheType from CACHE_NONE to CACHE_ACCEL. 

$wgMainCacheType = CACHE_ACCEL;

3. (optional) sudo /etc/init.d/apache2 reload

Alternatives to mediawiki

3 Alternatives To MediaWiki When Hosting Your Own Wiki

15 best alternative to MediaWiki?

Article size and its limit

By default the size is 2048 KB. You can modify it in LocalSettings.php. 

$wgMaxArticleSize = 100;  # 100 KB

To view what the size of the current (and other revisions) of the page is, open the page on the frontend and view its history.

Change/move main page title

How to change MediaWiki “Main Page” title?

Registration time, password

Preferences > User Profile. From here we can see when the user has registered and there is an opportunity to change the password.

Extensions

Top 15 downloaded extensions

Google Analytics

http://www.mediawiki.org/wiki/Extension:Google_Analytics_Integration#Installation

ImageMap

https://www.mediawiki.org/wiki/Extension:ImageMap

Math

http://www.mediawiki.org/wiki/Extension:Math

However, Ubuntu does not have a support on Mathoid which can convert math to SVG instead of PNG.

I can only get PNG rendering for Math formula on Ubuntu. However if I use Mediawiki Docker image which based on PHP and PHP is based on Debian, I can get SVG images for Math formula.

If I go to Preferences > Appearance, the Math mode is "MathML with SVG or PNG fallback" in Docker but "PNG images" in Ubuntu. If I try to change to "MathML with SVG or PNG fallback" in Ubuntu, it will break.

Installing the MediaWiki Math extension is easier now March 2018

Another way to get the SVG instead of PNG format for mathematical formulae is to use the SimpleMathJax extension (see a discussion). The instruction needs to be modified.

  • After unzip the zip file to the extensions folder it is necessary to change the folder name from 'SimpleMathJax-master' to 'SimpleMathJax' (if we did not do that, the maintenance/update.php will issue errors)
  • The renaming step is not necessary if we use the 'git' command to download the files; i.e. git clone https://github.com/jmnote/SimpleMathJax.git

It works when I tested on Ubuntu 18 + Mediawiki 1.31 + SimpleMathJax 0.7.3. 

root@ubuntu1804:/var/www/html/mediawiki/extensions# ls -lh SimpleMathJax/
total 20K
-rw-r--r-- 1 root root  829 May 12 11:47 extension.json
drwxr-xr-x 3 root root 4.0K May 12 11:47 modules
-rw-r--r-- 1 root root 1.7K May 12 11:47 README.md
-rw-r--r-- 1 root root 1.3K May 12 11:47 SimpleMathJax_body.php
-rw-r--r-- 1 root root  391 May 12 11:47 SimpleMathJax.php

how to display index under the sigma sign? limits

MobileFrontEnd

https://www.mediawiki.org/wiki/Extension:MobileFrontend

WikiEditor

https://www.mediawiki.org/wiki/Extension:WikiEditor

The 2nd line is required from my experience 

wfLoadExtension( 'WikiEditor' );
$wgDefaultUserOptions['usebetatoolbar'] = 1;

YouTube

https://www.mediawiki.org/wiki/Extension:YouTube

Template

https://www.mediawiki.org/wiki/Help:Templates

Template:Mvar

<span class="texhtml mvar" style="font-style:italic;">{{{1}}}</span>

Trouble shooting

Import images

$ php maintenance/dumpUploads.php | grep Boxplot
images/2/25/Boxplot.svg
$ find images -iname *Boxplot*
images/thumb/2/25/Boxplot.svg
images/thumb/2/25/Boxplot.svg/120px-Boxplot.svg.png
images/thumb/2/25/Boxplot.svg/180px-Boxplot.svg.png
images/thumb/2/25/Boxplot.svg/450px-Boxplot.svg.png
images/thumb/2/25/Boxplot.svg/600px-Boxplot.svg.png
images/thumb/2/25/Boxplot.svg/1200px-Boxplot.svg.png
images/thumb/2/25/Boxplot.svg/400px-Boxplot.svg.png
images/thumb/2/25/Boxplot.svg/240px-Boxplot.svg.png
images/thumb/2/25/Boxplot.svg/900px-Boxplot.svg.png
images/thumb/2/25/Boxplot.svg/300px-Boxplot.svg.png
images/thumb/2/25/Boxplot.svg/200px-Boxplot.svg.png
# Get a list of uploaded images, save them to a new folder
php maintenance/dumpUploads.php | grep images | xargs tar czvf ~/Downloads/backup_files.tar.gz
mkdir ~/Downloads/imagesdir
tar xzvf backup_files.tar.gz -C ~/Downloads/imagesdir
cd ~/Downloads/imagesdir
find images -type f -exec cp {} . \;
rm *.txt
rm *.pdf
rm -rf images

# scp imagesdir to my local computer. Then run
php maintenance/importImages.php --overwrite /mnt
# where imagesdir has been mounted to /mnt
# For some reason, some images are not imported?
chown -R www-data:www-data images

Fatal exception of type "Wikimedia\Rdbms\DBQueryError"

Run php update.php.

Backup for offline

https://webmasters.stackexchange.com/questions/28702/how-to-dump-a-mediawiki-for-offline-use 

wget -k -p -r -R '*Special*' -R '*Help*' -E http://example.com/wiki

Mediawiki to Markdown

https://github.com/philipashlock/mediawiki-to-markdown

How to Create Your Own Offline Wiki

https://www.wikihow.com/Create-Your-Own-Offline-Wiki

Comparison of wiki hosting services

https://en.wikipedia.org/wiki/Comparison_of_wiki_hosting_services

Retrieved from "https://wiki.taichimd.us/index.php?title=Mediawiki&oldid=17796"