Meza/Adding wikis

This manual explains how to add wikis to your Meza install. There are two methods for adding wikis:


 * 1) Creating a new wiki from scratch
 * 2) Importing one or more wikis

Creating a new wiki
To create a new wiki, perform the following where  is your environment name (probably , unless you're using Vagrant in which case it's probably  ):

This script will then ask for two inputs:


 * 1) Wiki ID: This is an alphanumeric identifier for your wiki. It will be used in the URL (like  ), and throughout the server configuration. It should be something short and simple. For example, if you're creating a wiki for your Human Resources department, a good wiki ID would be "hr". All lowercase is preferred.
 * 2) Wiki Name: This should be a more descriptive title for your wiki. It still should not be too long, though. For the same example you may choose "Human Resources Wiki" or "HR Wiki"

Adding custom logo and favicon
See Issue 410 on GitHub.

Creating a wiki user
With a new wiki, you'll probably want to create a new user. In the following example, you would be creating the user "Jdoe" on the wiki with the ID "mywiki" and the password "mypassword". Once your user account is set up, this user's password can be modified using Mediawiki's user profile page in the user settings. See Manual:CreateAndPromote.php for more info.

Importing existing wikis
Importing wikis is done by either defining servers as sources for import files, or by positioning files on your server in the correct location, then simply running.

Importing wikis directly from another server
This documentation requires more info here, but some info can be found in Pull Request #547 and Issue #548.

Creating the import directory
If you would like to manually put files on your server to be used in an import, you'll need to put those files in the correct location in. *This documentation requires more info here*. To get an idea of how the directory should look, try backing up your Demo Wiki by running  and then looking at the directory structure.

Transferring your files to your wiki
To transfer files to your server you can use SCP (or PSCP on Windows):

Making a wiki the "primary" wiki
A wiki can be setup as the "primary" wiki. This means that all other wikis will use its user and interwiki tables. If all wikis are related, and are going to have similar users, you should do this. To make one wiki the primary wiki edit your configuration:

In this example the wiki with ID "big", and thus database name "wiki_big", is being defined as the primary wiki. This statement can be added to any configuration YAML file, but the recommended is.

Deleting wikis
If you want to get rid of a wiki, just do:

Unify user tables
WARNING: Test user-unification extensively before performing in production

If you run  on a set of wikis that do not share user and interwiki tables, the script will automatically setup the   file for you (FIXME #763: this probably is not true anymore). To run  perform the following:

In this case above you need to specify any existing wiki at the beginning. This is simply so LocalSettings.php will load properly. Any of your existing wikis will do. After the  add the wiki ID of the wiki you want to be prime.