Help:Admin

Help page
Revision as of 14:13, 12 June 2023 by Côme (talk | contribs) (Added info on the wiki and help as an admin)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This page should help you, as an admin user, to maintain the wiki.

Wikimdr info

The wiki is powered by Mediawiki. It is customized with Visual Editor and OATHAuth extensions and Citizen skin. It is running on a Debian GNU/Linux Virtual Machine (VM) hosted by Rezel. More info at Special:Version.

What to do as an admin?

Useful links

Changing the interface

Sidebar menu can be edited by users with editinterface permission, footer can be modified by everyone. The footer is an element interface present on Citizen, not on other default skins.

Sidebar

Modify it like any page at MediaWiki:Sidebar. For editing help, see Mediawiki manual.

Footer description

The footer description can be modified at MediaWiki:Citizen-footer-desc. Keep it short and descriptive.

Footer tagline

The footer tagline can be modified at MediaWiki:Citizen-footer-tagline and will appear under the description.

Server side modifications

Some modifications require access to the Virtual Machine (VM) on which the wiki is installed and running. The student association Rezel is in charge of the maintenance and they set up the wiki. To access the VM you will need to connect to it via SSH. With this technique you have access to the files on the server and can work on it in an Integrated development environment like VS Code. A key is generated on your machine and your public key yourkey.pub content needs to be added on the server by someone from Rezel (maybe and admin with server access too?).

Generate a SSH key

Follow these instructions. Setting up a passphrase is not necessary and caused some problem with VS Code. Just hit enter to avoid that step. If you want to remove the passphrase without having to recreate a new key, type ssh-keygen -p in your Command-line interface. This will prompt you to enter the keyfile location (C:\Users\Your-user-name\.ssh on Windows) and set a new password.

Adding authorized keys on server

Contact User:Admin.

Connect to the server

Once your public key has been setup by someone with server access, you can connect to the server. You can do it via your Command-line interface if you know how to navigate within folders with a text based interface. Type ssh root@wikimdr-lxc.rezel.net -i .ssh/id_rsa, adjust depending on your key location and name.

Otherwise you can do it in VS Code with the remote SSH extension. In VS Code click View > Command palette... or Crtl + Shift + P, then type and choose Remote-SSH: Connect to host. You will need to configure a new SSH host. The operating system is Linux and host adress is root@wikimdr-lxc.rezel.net. This will probably create a config file in your .ssh folder. Access it with Remote-SSH: Open SSH Configuration File and configure it that way:

Host wikimdr-lxc.rezel.net
  HostName wikimdr-lxc.rezel.net
  User root
  IdentityFile ~/.ssh/id_rsa #change it according to you key location and name
  IdentitiesOnly yes

See more info about it here.

Once you started the connection, find the Remote Explorer tab on the left. You'll see that you are connected to the VM (an icon is green and it is written connected. Now when doing File > Open folder you can choose which folder you want to access.

LocalSettings.php is located in /var/lib/mediawiki/