User:Wynter/Tech:Guide

This tech guide shows how to change the configuration of an Orain wiki. It's especially useful when responding to Request features.

Ansible-playbook
All the Orain wiki settings can be found on Orain's ansible-playbook on GitHub. If you don't already have a GitHub account, you'll need to sign up.

Most wiki configuration settings are located in two files: /roles/mediawiki/files/localsettings/LocalSettings.php.j2 and /roles/mediawiki/files/localsettings/LocalExtensions.php. Rarely do you ever need to change any other files.

Wiki ID
Every Orain wiki has a wiki ID, which is the wiki's subdomain + "wiki". For example, since Orain Meta's subdomain is "meta" (from meta.orain.org), its wiki ID is "metawiki". It's important to know a wiki's ID since it's used throughout the configuration.

Code style
Make sure to use the correct indention. Try to keep all the lists (e.g. arrays) in the code in alphabetical order.

Logo

 * 1) Make sure the logo is uploaded locally to the target wiki. If uploads are disabled on the target wiki, you may upload it on Meta or Wikimedia Commons (you may want to leave a note indicating it's used as a logo on an Orain wiki). Otherwise, do not use files on Meta. DO NOT use files from any other sites!
 * 2) Get the file's actual url path by clicking on the image on its description page. For example, File:Orain.png is the Orain logo's file name, and https://static.orain.org/meta.orain.org/images/c/c6/Orain.png is the full url path.
 * 3) Find the   array in LocalSettings.php.j2.
 * 4) Add the following line:   (make sure to use quotation marks "" for the url) If the logo is uploaded on any Orain wiki, replace   with  . If there is already an entry with the wiki's ID, just change the url parameter.