OER in Education:Documentation

From OER in Education
Revision as of 19:50, 2 December 2014 by Kelson (talk | contribs)

Mediawiki backup & upgrade

OER server has an all-in-one solution to backup the MW instance and replace the MW code by an other (newer one). To achieve to do this, the script only needs a master directory with the newer Mediawiki (with a configured LocalSettings.php and all necessaries extensions. The script is localised current at /home/kelson/updateMediawikiInstance.pl (call it without argument to learn how to use it). The code repository of this script is here.

To update OCG, Parsoid, mwoffliner and Semantic Mediawiki you should refer to the original documentation.

Search

The Mediawiki search future is customized. It display the results of the standard search engine conbined with the results of Google. This is done using the "GoogleSiteSearch" extension. See the file LocalSettings.custom.php to see how it's configured.

Custom extensions

OER has a few extensions which are non-standards or/and lightly customized. They are available in /var/www/custom/extensions/

Caching

OER use a few technics to improve responsiveness of the web site:

  • Memcached to cache the rendered HTML (see /var/www/w/LocalSettings.php)
  • Nginx customized virtual host configuration (see /etc/nginx/site-availables/oer)

Robots

Have a look to the robots.txt file.

Social tools

We have installed TogetherJS on OER using the TogetherJS Mediawiki extension.

Incremental backup

The incremental backup is done every day using rsnapshot (and a cron entry).

ZIM generation

One time a month a new ZIM file of OER is generated automatically using mwoffliner (and crontab, zimwriterfs, ...)

Article Prefixing

The OER Mediawiki is configured in a way to allow to specify a prefix before section titles. This prefix can be set using the Template:SectionPrefix and use the extension:CSS.