Anonymous

OER in Education:Documentation: Difference between revisions

From OER in Education
no edit summary
No edit summary
No edit summary
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{draft}}
= Introduction =


= General =
This page documents the setup of this wiki, with particular attention to non-standard features. Some of these changes were made with the help of funding from the Wikimedia Foundation UK, see [[EWTE]], which also provides a narrative and rationale for some of the changes made.


Extensionsː
= General setup =
* Reviewed topcontent ← needs adding to github somewhere (e.g. mine)
 
* Reviewed magicnumeredheadins ← needs adding to github
The current wiki version and installed extensions are available on the usual page [[Special:Version]].
* Reconfigure the search feature ← needs documenting
 
* Optimize the page delivering (more caching) ← needs documenting
Speed optimisation:
* Search engine crawling restrictions ← needs documenting
* Optimise the page delivering (more caching)
* Setup social extentions working with togetherJS ← need to refer to some installation docs elsewhere (“We followed these instructions …”)̈
* Search engine crawling restrictions  
* Setup new OCG toolchain with Collection extension (still buggy) (for pdf generation) ← need to refer to some installation docs elsewhere; Also, what’s the ETA for improvements?             
 
* Setup auto. ZIM generation toolchain ← need to refer to some installation docs elsewhere
Usability:
* Configure solution for article section prefixing ← needs documenting
* Reconfigure the search feature
* Setup social extensions working with togetherJS  
* Setup new OCG toolchain with Collection extension (still buggy) (for pdf generation)
* Configure solution for article section prefixing
 
Offline:
* Setup automatic ZIM generation toolchain


= Optimisation and upgrading =
= Optimisation and upgrading =
Line 36: Line 44:


== Custom extensions ==
== Custom extensions ==
OER has a few extensions which are ''non-standards'' or/and lightly customized. They are available in /var/www/custom/extensions/
OER has a few extensions which are ''non-standard'' or/and lightly customized. They are available on our server in /var/www/custom/extensions/, and can also be obtained from github, see [[OER:Documentation/customextensions]].
 


= Usabilty and accessː Offline =
= Usabilty and accessː Offline =
== PDF ==
== PDF ==
Assessment of pdf generation. We currently generate our own multi-chapter pdf (using a set of scripts), as we have not found the pediapress pdf generation suitable for our type of content. We would like to explore what other pdf production tool are being worked on, and would like to feed Higher Education requirements into that process.
== ZIM generation ==
== ZIM generation ==
One time a month a new ZIM file of OER is generated automatically using mwoffliner (and crontab, zimwriterfs, ...)
One time a month a new ZIM file of OER is generated automatically using mwoffliner (and crontab, zimwriterfs, ...)
Line 50: Line 54:


== Search ==
== Search ==
We did some user testing, and the wiki search came up as something that users found confusing, and not really useful for finding the content they were looking for. We currently use a Google custom search, but the integration into the wiki is not ideal. We would like to explore options for searching that allows our audience to find relevant content more easily.


How did we do this? → See LocalSettings.custom.php and “../custom/extensions” directory.
How did we do this? → See LocalSettings.custom.php and “../custom/extensions” directory.


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.
== Social tools ==


== Social tools ==
We have installed TogetherJS on OER using the [https://www.mediawiki.org/wiki/Extension:TogetherJS TogetherJS Mediawiki extension].
We have installed TogetherJS on OER using the [https://www.mediawiki.org/wiki/Extension:TogetherJS TogetherJS Mediawiki extension].
== Visual editor ==


= Usabilityː Navigation =
= Usabilityː Navigation =
Line 108: Line 106:


Also we are running an event for Faculty, focussing on content production with these new tools (such as visual editor, navigation, etc).
Also we are running an event for Faculty, focussing on content production with these new tools (such as visual editor, navigation, etc).
= Also see =
[[EWTE]]