Difference between revisions of "Wiki"

From CSLabsWiki
Jump to: navigation, search
 
(25 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
{{services
 
{{services
|contact_person = [[User:beadleha|'''Alan Beadle''']]
+
|ip_addr = 128.153.145.148
|last_update = ''unknown''
+
|contact_person = [[User:lannonbr|Benjamin Lannon]] and [[User:jared|Jared Dunbar]]
|host_vm =  
+
|last_update = ''January 2017''
|vm_host =  
+
|host_vm = [[docs]]
|services =  
+
|vm_host = [[hydra]]
 +
|services = Documentation Wiki
 
|category = Service
 
|category = Service
|handoff =  
+
|handoff = no
 
}}
 
}}
 +
 +
The COSI Wiki, informally known as docs, is the service that hosts this article that describes the COSI Wiki, and many other pages.
  
 
==Upgrade==
 
==Upgrade==
The wiki has been updated! The old one is still running, but if you are reading this, it's on the new one. There are a few remaining problems to fix, but it's mostly ready.
+
The wiki has been updated! Please contact the maintainer if you discover any issues.
  
==Problems==
+
It is currently hosted on a VM called [[docs]]
Special pages do not work, file uploads do not work, and the COSI logo is slightly too big.
 
  
===Extensions===
+
==Setup==
* [http://meta.wikimedia.org/wiki/Help:ParserFunctions ParserFunctions]
+
 
* [http://www.mediawiki.org/wiki/Extension:Renameuser RenameUser]
+
'''Make sure to follow the upgrade instructions for that release instead of blindly upgrading it, and make sure to have thorough backups before that (see below). Seriously, back this up. This wiki has a lot of history and it would be a shame to lose it.'''
* [http://www.mediawiki.org/wiki/Extension:ASHighlight ASHighlight]
+
 
* [http://www.mediawiki.org/wiki/Extension:EmailAddressImage EmailAddressImage]
+
Our wiki is mostly a pretty stock configuration of MediaWiki as found in Debian 8.2 jessie-backports
* [http://www.mediawiki.org/wiki/Extension:Password_Reset PasswordReset]
+
 
 +
When copying, loosely do the following:
 +
 
 +
* '''Make a backup of the VM image''' on at least 2 different machines, and preform checksum on the image to make sure that you got it completely in one piece.
 +
* Export the mysql database 'wikidb' to a .sql file
 +
* Copy all files in the /images folder of the MediaWiki to a secure place.
 +
* Set up a basic MediaWiki install with a different database name (or delete the database '''before''' you insert the new one).
 +
* Compare the LocalSettings.php file and (with some common sense) move lines from the old one to the new one, especially the plugin includes and the permissions, email links, etc. Some flags are deprecated between versions, pay attention to that.
 +
* Copy the images folder into the new install at the exact same path
 +
* Import the old database into mysql with the same name
 +
* Install the 3rd party extensions.
 +
 
 +
Voila!
 +
 
 +
In general, set up short URL support as explained on the mediawiki wiki in addition to having the plugins below.
  
===Configuration===
+
<pre>
'''User settings:'''
+
$wgUseTeX = true; # LaTeX support apparently
# Force people to check their edit summaries
+
$wgStrictFileExtensions = false; # allow file extensions that are "not safe" (ex, svg)
$wgDefaultUserOptions['forceeditsummary'] = 1;
+
$wgArticlePath = "/wiki/$1"; # part of the url shortening
+
$wgDefaultUserOptions['forceeditsummary'] = 1; # force showing an edits summary
# Registration disabled for all users EXCEPT sysops
+
$wgGroupPermissions['admin']['protect'] = true; # protected pages
$wgGroupPermissions['*']['createaccount'] = false;
+
$wgGroupPermissions['admin']['createaccount'] = true; # only allow admins to create users
+
# loads the two extensions
# Must be logged in to edit
+
wfLoadExtension( 'ParserFunctions' );
$wgGroupPermissions['*']['edit'] = false;
+
require_once("$IP/extensions/DynamicPageList/DynamicPageList2.php");
 +
</pre>
  
===Templates===
+
===Extensions===
Various [http://docs.cosi/w/index.php?title=Special%3AAllpages&from=&namespace=10 templates] have been added to better the user experience.
+
* [http://www.mediawiki.org/wiki/Help:Extension:ParserFunctions ParserFunctions]
 +
* [http://www.mediawiki.org/wiki/Extension:DynamicPageList_%28third-party%29 DynamicPageList2 (3rd party)]
  
 
__NOTOC__
 
__NOTOC__
Line 40: Line 58:
  
 
[[Category:Projects]]
 
[[Category:Projects]]
 +
[[Category:Web Service]]

Latest revision as of 20:04, 4 January 2017

Wiki
IP Address(es): 128.153.145.148
Contact Person: Benjamin Lannon and Jared Dunbar
Last Update: January 2017
VM Host (Physical): hydra
Host VM: docs
Services: Documentation Wiki


The COSI Wiki, informally known as docs, is the service that hosts this article that describes the COSI Wiki, and many other pages.

Upgrade

The wiki has been updated! Please contact the maintainer if you discover any issues.

It is currently hosted on a VM called docs

Setup

Make sure to follow the upgrade instructions for that release instead of blindly upgrading it, and make sure to have thorough backups before that (see below). Seriously, back this up. This wiki has a lot of history and it would be a shame to lose it.

Our wiki is mostly a pretty stock configuration of MediaWiki as found in Debian 8.2 jessie-backports

When copying, loosely do the following:

  • Make a backup of the VM image on at least 2 different machines, and preform checksum on the image to make sure that you got it completely in one piece.
  • Export the mysql database 'wikidb' to a .sql file
  • Copy all files in the /images folder of the MediaWiki to a secure place.
  • Set up a basic MediaWiki install with a different database name (or delete the database before you insert the new one).
  • Compare the LocalSettings.php file and (with some common sense) move lines from the old one to the new one, especially the plugin includes and the permissions, email links, etc. Some flags are deprecated between versions, pay attention to that.
  • Copy the images folder into the new install at the exact same path
  • Import the old database into mysql with the same name
  • Install the 3rd party extensions.

Voila!

In general, set up short URL support as explained on the mediawiki wiki in addition to having the plugins below.

$wgUseTeX = true; # LaTeX support apparently
$wgStrictFileExtensions = false; # allow file extensions that are "not safe" (ex, svg)
$wgArticlePath = "/wiki/$1"; # part of the url shortening
$wgDefaultUserOptions['forceeditsummary'] = 1; # force showing an edits summary
$wgGroupPermissions['admin']['protect'] = true; # protected pages
$wgGroupPermissions['admin']['createaccount'] = true; # only allow admins to create users
# loads the two extensions
wfLoadExtension( 'ParserFunctions' );
require_once("$IP/extensions/DynamicPageList/DynamicPageList2.php");

Extensions