Help:Admin: Difference between revisions

Help page
(Paste important links)
 
(Added SSH help, Sidebar and footer modification access)
Line 1: Line 1:
This page should help you, as an admin user, to maintain the wiki.
== Getting started ==
== Getting started ==
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
Line 5: Line 7:
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]
==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 [https://www.mediawiki.org/wiki/Skin:Citizen Citizen], not on other default skins.
===Sidebar===
Modify it like any page at [[MediaWiki:Sidebar]]. For editing help, see [https://www.mediawiki.org/wiki/Manual:Interface/Sidebar 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 [https://rezel.net/ 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 <code>yourkey.pub</code> content needs to be added on the server by someone from Rezel (maybe and admin with server access too?).
===Generate a SSH key===
Follow [https://assistance.groupemagiconline.com/knowledge-base/generer-une-cle-ssh/ 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 <code>ssh-keygen -p</code> 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 <code>ssh root@wikimdr-lxc.rezel.net -i .ssh/id_rsa</code>, adjust depending on your key location and name.
Otherwise you can do it in [https://code.visualstudio.com/ VS Code] with the [https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh remote SSH extension]. In VS Code click <tt> View > Command palette...</tt> or <kbd>Crtl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>, then type and choose <tt>Remote-SSH: Connect to host</tt>. You will need to configure a new SSH host. The operating system is <tt>Linux</tt> and host adress is <tt>root@wikimdr-lxc.rezel.net</tt>. This will probably create a config file in your .ssh folder. Access it with <tt>Remote-SSH: Open SSH Configuration File</tt> and configure it that way:
<pre>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</pre>
See more info about it [https://unix.stackexchange.com/questions/494483/specifying-an-identityfile-with-ssh 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 <tt>connected</tt>. Now when doing <tt>File > Open folder</tt> you can choose which folder you want to access.
LocalSettings.php is located in <tt>/var/lib/mediawiki/</tt>

Revision as of 11:59, 5 June 2023

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

Getting started

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/