How To Wiki

From MEDS Wiki

Revision as of 20:22, 19 October 2019 by Dimitri (talk | contribs) (Edit an existing page)

MEDS wiki is open and visible for anyone. You don't need a user account to look up content.

Everybody is able to create an account, add and edit content however.

All heads of departments are invited to sign up and contribute to the wiki. Additional helpers and editors are very welcome too.

MEDS wiki is based on MediaWiki, the same platform behind Wikipedia and many other similar pages.


Create a user account

Open the user menu on the top right. Click on create account, fill in your real name as the user name, password, email address and complete the captcha. As soon you send the form, your user account is generated.

In order to be able to edit and add content, you have to confirm your email address. While logged in, go to your [profile settings] and click on "confirm email address". Check your email inbox (or spam folder) and finish your signing up by clicking the confirmation link in the mail.


Join #wiki on Slack

It's mandatory to be member of the #Wiki Slack channel, in order to get updates and discuss about wiki technical related topics.


How to use MEDS wiki

The easiest way to look up information is by using the search bar. If you can't find what you are looking for, you are welcome to create a page about your desired topic.

A extensive guide how to create pages, editing and organizing pages can be found here. This the following paragraphs only show you the basic topics. Remember, these actions only work if you're logged in and have your email confirmed.


During the beta phase wiki pages may be created and be unfinished. However in the future we should follow this rule:

Only add content that has beed agreed in consensus with your team/department. This wiki is not a debating platform. Discussions should be held on Slack.


Create a new page

Creating a new Page.png


Simply use the search bar on the top left and enter your desired page title. You can see if the page (or a similar one) already exists in the search results. If your desired page does not exist, simply click Create the page "****" on this wiki.. You will be greeted by the text editor, where you can add your content. Don't forget to save and publish your changes after you're done.


Another method is to directly type the name of your desired page in to the URL bar of your browser. (eg. http://wiki.medsworkshop.com/index.php?title=Forum_2019_Basel )


Go to Special:NewPages to see the newly created pages.

Edit an existing page

Simply click edit in your Actions menu (the one with the cogwheel) on the top right of the page. If this menu does not appear on your screen, you might not be logged in, or/and have not yet confirmed your email adress.


Go to Special:RecentChanges to see all recent changes made on the wiki.

Hyperlinks and wanted pages

You can link wiki pages by simply typing the name of the page in double square [[example]] brackets, or simply use the link symbol above the text editor.

External links can be hyperlinked with single square brackets with the URL followed by the shown text. (e.g. [https://medsworkshop.com/ text] )


It is possible to link non existing wiki pages as well, e.g. if you think there should be a page about a topic in your text. If you a link a non existing page, this will be categorised as a wanted page. By clicking on such a link, the wiki asks if you want to create this page. Go to Special:WantedPages to see a list of all uncreated pages.

Categories

It is convenient to categorise all pages to keep order on the wiki. It also helps to find related pages.

Categories work similarly as a tree. You have your main category (tree trunk) where multiple sub categories (branches) can evolve from. This principle works with endless sub and sub-sub categories.

To assign your page to a category, simply add [[Category:Forum_2019_Basel]] at the end of your page. If the category won't exist already, it will be automatically created. By clicking on a certain category on the bottom on your page, a list with all page of this category will appear. This list is also a wiki page itself and can be edited accordingly. By editing the category page, you can simply add a parent category in the same fashion.


New categories can also be created in the same manner as a regular wiki page with the URL method. (e.g. http://wiki.medsworkshop.com/index.php?title=Category:Forum_2019_Basel )


Usually you would only use an end branch(es) to categorise your page.


All existing categories can be viewed under Special:Categories.


A category tree helps to organise the wiki. However, in the beta stage of the wiki, a tree structure first has to be planned. This has been done before, but was not applicable 1/1 on the actual wiki.

Embedding Videos

We have the MediaWiki Youtube extension running on the Wiki, which allows embedding Videos not only from Youtube, but also from other Video hosting sites. Simply add <youtube>video URL</youtube> where you want to place the video. (e.g. <youtube>https://www.youtube.com/watch?v=ebtWsHr3Xug&t</youtube> )

For the full instructions, see the extensions documentation.


Foreground Skin

This wiki uses the Foreground Skin to make it visually appealing. This skin has some useful features such as image sliders and grid systems. If you're planning the make use of it, refer to their documentation.


Sensitive Data

Keep in mind, this wiki is open for anyone, there is no restricted area here. Please do not post personal information (eg. participants lists) on the wiki. If you refer to documents containing personal information, please make a private link to Mega, where we have password restriction.


Sandbox

Use the Sandbox page to play around with all the layout options and media wiki syntax and mechanics.


How to manage MEDS wiki

Many useful tools to manage content and users can be accessed through the Special:SpecialPages. Deeper changes can be done in pages located in the MediaWiki namespace, such as editing the navigation bar and the CSS. These changes can all be done by simply modifying the associated page. Certain actions, such as adding themes and extensions require server access.


Edit the Navigation Bar

Navigate to the Sidebar page and click edit from the Actions menu.