Development:Index: Difference between revisions
From COMP15212 Wiki
Yuron [PHRhYmxlIGNsYXNzPSJ0d3BvcHVwIj48dHI+PHRkIGNsYXNzPSJ0d3BvcHVwLWVudHJ5dGl0bGUiPkdyb3Vwczo8L3RkPjx0ZD51c2VyPGJyIC8+YnVyZWF1Y3JhdDxiciAvPmludGVyZmFjZS1hZG1pbjxiciAvPnN5c29wPGJyIC8+PC90ZD48L3RyPjwvdGFibGU+] (talk | contribs) m (1 revision imported) |
W81054ch [PHRhYmxlIGNsYXNzPSJ0d3BvcHVwIj48dHI+PHRkIGNsYXNzPSJ0d3BvcHVwLWVudHJ5dGl0bGUiPkdyb3Vwczo8L3RkPjx0ZD51c2VyPGJyIC8+YnVyZWF1Y3JhdDxiciAvPmludGVyZmFjZS1hZG1pbjxiciAvPnN5c29wPGJyIC8+PC90ZD48L3RyPjwvdGFibGU+] (talk | contribs) Tag: Rollback |
||
Line 1: | Line 1: | ||
This page details information related to the development of this Mediawiki-driven website. | This page details information related to the development of this Mediawiki-driven website, serving as documentation for the code written for the wiki. For information regarding how to make use of this wiki's features once it's been set up, refer to [[Help:Index]]. | ||
== Extensions == | == Extensions == | ||
*Semantic Mediawiki is used to provide: | *Semantic Mediawiki is used to provide: | ||
Line 5: | Line 5: | ||
**Priority levels | **Priority levels | ||
**Paths | **Paths | ||
**Dependencies | |||
*Scribunto (Lua scripting) is used to provide: | *Scribunto (Lua scripting) is used to provide: | ||
**Article dependencies (Lua is needed to support an arbitrary | **Article dependencies (Lua is needed to support adding an arbitrary number of dependencies to a single box) | ||
*Widgets is used to provide: | *Widgets is used to provide: | ||
**Page demonstrations ([[ | **Page demonstrations ([{{canonicalurl:Special:AllPages|namespace=274}} List of widgets]) | ||
*[[Development:UserDash|UserDash]] is the extension that drives most other features specific to this site, including: | |||
**[[Special:Dashboard]], which currently holds the contents of the account profile page from MESH, rather than the Dashboard. | |||
**The rating and page tagging system | |||
**Page graphs | |||
**[[Special:Contents|Contents]] page | |||
*The skin Chameleon is used to provide Bootstrap to the wiki. | |||
**'''The Bootstrap extension the Chameleon skin comes with does not include tooltip.js from Bootstrap. Replace line 68 in extensions/Bootstrap/src/Definition/V4ModuleDefinition with ''' <code> 'tooltip' => [ 'styles' => 'tooltip', 'scripts' => 'tooltip.js', 'dependencies' => [ 'popper', 'js-util' ] ],> </code> ''' to fix this. This needs to be done every time Composer is used to update components, as this change would be overwritten.''' | |||
== Migration == | == Migration == | ||
#First, copy over the wiki installation, including the extensions, skin, and custom configurations in LocalSettings.php, or start from a fresh installation and append the needed extensions/configurations to LocalSettings.php afterwards. | |||
#Second, migrate all pages in the wiki: | |||
* | ##Run <code> php maintenance/dumpBackup.php --current > backup.xml </code> to dump all pages into backup.xml | ||
##Restore backup.xml with the special page Special:Import on the target server | |||
##*Special:Import also requires an "interwiki prefix", which doesn't matter for a migration | |||
#Third, migrate all images: | |||
##Run the bespoke <code>exportImage.sh</code> on the source server to obtain MediaFiles.zip | |||
##Copy MediaFiles.zip to ~/ (user directory) on the destination | |||
##Run the bespoke importImage.sh on the destination to restore images | |||
#Lastly, refresh the extension databases with <code>php maintenance/update.php</code>, and refresh the Semantic Mediawiki database with <code> php extensions/SemanticMediaWiki/maintenance/rebuildData.php </code> | |||
=== Further setup === | |||
For the rating chart in Special:Profile to work properly, the values UDStartYear, UDStartMonth, UDStartDay, UDStartHour, UDEndWeek and UDVacationWeeks in extensions/UserDash/extension.json must be set to sensible values. |
Revision as of 11:08, 27 July 2019
This page details information related to the development of this Mediawiki-driven website, serving as documentation for the code written for the wiki. For information regarding how to make use of this wiki's features once it's been set up, refer to Help:Index.
Extensions
- Semantic Mediawiki is used to provide:
- Page summaries
- Priority levels
- Paths
- Dependencies
- Scribunto (Lua scripting) is used to provide:
- Article dependencies (Lua is needed to support adding an arbitrary number of dependencies to a single box)
- Widgets is used to provide:
- Page demonstrations (List of widgets)
- UserDash is the extension that drives most other features specific to this site, including:
- Special:Dashboard, which currently holds the contents of the account profile page from MESH, rather than the Dashboard.
- The rating and page tagging system
- Page graphs
- Contents page
- The skin Chameleon is used to provide Bootstrap to the wiki.
- The Bootstrap extension the Chameleon skin comes with does not include tooltip.js from Bootstrap. Replace line 68 in extensions/Bootstrap/src/Definition/V4ModuleDefinition with
'tooltip' => [ 'styles' => 'tooltip', 'scripts' => 'tooltip.js', 'dependencies' => [ 'popper', 'js-util' ] ],>
to fix this. This needs to be done every time Composer is used to update components, as this change would be overwritten.
- The Bootstrap extension the Chameleon skin comes with does not include tooltip.js from Bootstrap. Replace line 68 in extensions/Bootstrap/src/Definition/V4ModuleDefinition with
Migration
- First, copy over the wiki installation, including the extensions, skin, and custom configurations in LocalSettings.php, or start from a fresh installation and append the needed extensions/configurations to LocalSettings.php afterwards.
- Second, migrate all pages in the wiki:
- Run
php maintenance/dumpBackup.php --current > backup.xml
to dump all pages into backup.xml - Restore backup.xml with the special page Special:Import on the target server
- Special:Import also requires an "interwiki prefix", which doesn't matter for a migration
- Run
- Third, migrate all images:
- Run the bespoke
exportImage.sh
on the source server to obtain MediaFiles.zip - Copy MediaFiles.zip to ~/ (user directory) on the destination
- Run the bespoke importImage.sh on the destination to restore images
- Run the bespoke
- Lastly, refresh the extension databases with
php maintenance/update.php
, and refresh the Semantic Mediawiki database withphp extensions/SemanticMediaWiki/maintenance/rebuildData.php
Further setup
For the rating chart in Special:Profile to work properly, the values UDStartYear, UDStartMonth, UDStartDay, UDStartHour, UDEndWeek and UDVacationWeeks in extensions/UserDash/extension.json must be set to sensible values.