(Paste important links) |
(Added info on the wiki and help as an admin) |
||
(One intermediate revision by one other user not shown) | |||
Line 1: | Line 1: | ||
== | This page should help you, as an admin user, to maintain the wiki. | ||
== Wikimdr info == | |||
The wiki is powered by [https://www.mediawiki.org/wiki/MediaWiki Mediawiki]. It is customized with Visual Editor and OATHAuth extensions and [https://www.mediawiki.org/wiki/Skin:Citizen Citizen skin]. It is running on a Debian GNU/Linux Virtual Machine (VM) hosted by [https://rezel.net/ Rezel]. More info at [[Special:Version]]. | |||
== What to do as an admin? == | |||
* Subscribe to the [https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/ MediaWiki release mailing list] in order to stay up to date with the software. | |||
* Create your classmates' accounts [[Special:CreateAccount]]. | |||
* Keep an eye on [[Special:RecentChanges | recent changes]] and [[Special:NewPages | new pages]] and help new editors. | |||
== Useful links == | |||
* [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] | ||
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ] | * [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ] | ||
Line 5: | Line 15: | ||
* [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> |
Latest revision as of 14:13, 12 June 2023
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?
- Subscribe to the MediaWiki release mailing list in order to stay up to date with the software.
- Create your classmates' accounts Special:CreateAccount.
- Keep an eye on recent changes and new pages and help new editors.
Useful links
- Configuration settings list
- MediaWiki FAQ
- MediaWiki release mailing list
- Localise MediaWiki for your language
- 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 Citizen, not on other default skins.
Sidebar
Modify it like any page at MediaWiki:Sidebar. For editing help, see Mediawiki manual.
The footer description can be modified at MediaWiki:Citizen-footer-desc. Keep it short and descriptive.
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/