Help:Manual

From Beyond Social

This is an overview page that helps you getting familiar to work with a wiki. For a short history and introduction about the choice for a wiki for Beyond Social, read the Wiki Introduction.

Account creation

In order to start contributing to BS wiki, like in most wikis, you need to create a user account. Do so by clicking on Create Account, in the top right corner or the wiki,

You'll be taken to a page where you will be asked your account details, a question to see if you are not a robot — as you guessed the answer is Design.

Tip: if you don't want to publish under your real name, use a pseudonym. Do not use your student number, that's confidential information you should protecc.

User page

Your user page is a personal page in the wiki where you can leave information about yourself, leave notes or do some tests with the wiki syntax. An easy way to add a user profile to your page is by using the following form: Form:Profile.

Preferences

You can make changes to your wiki experience in the preferences menu. You can find it at the top-right of the screen.

Confirmed email-address

One of the features that you can activate are email updates. With this setting enabled, you receive a short update mail whenever one of the pages in your watchlist is edited by someone else. To enable this feature, you need to have a confirmed email-address connected to your account. To do this, go to the preference menu and scroll down until you see the email options.

page creation

How to create an article? If you want to say something about something for which there isn't a page, you create that page and start writing its content.

To create a new article:

  1. go to the Main Page
  2. scroll down to "Contribute"
  3. use the input field to write the title of your new article
  4. click on "create article"

editing

How to write on the wiki? Writing on a wiki is not not very different from writing a blog. You have a Read and Edit mode. Edit lets you enter content and make changes to existing content. While you are editing, you can preview your changes in the Preview window. Once done editing save the page, otherwise your contribution will be lost.

However, one big difference with normal blogs is the wiki's history tracking function. Every edit that is been done in the wiki is tracked, and visible for reader and writers. Under the button "View history" you can see how the wiki page has been changed over time. Also, the special page Recent Changes lists the recent actitivy on the wiki. Read more about the characteristics of a wiki in the page about Mediawiki software.

We suggest that you experiment with writing and formating your own User page. You can get to this page by clicking in your username, next to the little person drawing. The user page, is normally used to say something about you, but can also be a nice testing ground.

Licenses

All work on Beyond Social is by default published under the Creative Commons Attribution NonCommercial ShareAlike 4.0 license. This means that anyone is free to:

Share — copy and redistribute the material in any medium or format
Adapt — remix, transform, and build upon the material for any purpose, even commercially.

Other options

If you want to publish under another license, or under copyright: more information is collected on the page Topic:Licenses.

wikimarkup / Syntax

Although there is a specific markup syntax to format the text, you can use the menu to do much of the formating you need. In case you are interested to get to know the syntax here is cheat-sheet with the most important syntax.

Basics

Bold (word):

'''word'''

Italic (word):

''word''

Underline (word):

<u>word</u> or <ins>word</ins>

Strikethrough (word):

<del>word</del> or <s>word</s>
Note: to create line breaks you need to leave at least one empty space between one line of text and the next.

Headings

You can make titles with different hierarchic levels by using "=" as follows:

=Main Title=
==Sub Title==
===Sub-sub Title===
===Sub-sub-sub Title===

You can place content under each of these sections.

Signature

There is a nice function in the wiki that is used to end a message with your name: a signature. If you type "~~~" or "~~~~" it will create a signature with your name or name+time.

Simple signature (Manetta (talk)):

~~~

Expanded signature (Manetta (talk) 14:33, 9 February 2017 (CET)):

~~~~

Images

You probably want not only to write, but also to use images, audio and video on the pages you'll be developing. Wiki allows the following formats:

Medium Formats
image png, gif, jpg, jpeg, svg
audio ogg, mp3
video ogv, webm, mp4
Note: The wiki can only include images that have been uploaded.

UPLOADING

There are two ways in which you can upload an image:

upload your image on the upload page

  1. Go to the upload page
  2. Upload your image
  3. Insert the following syntax in your text field:
[[File:myimage.png]]

use the Img-icon-wiki.png icon in the text editor

  1. Check if your image is already uploaded to the wiki on the Special:NewFiles page. Is the file already uploaded? Copy the filename (including File:) and insert it in the Filename field. → Go to step 2.
  1. Do you want to upload a new image to the wiki? Click on the Img-icon-wiki.png icon and hit the 'Upload' button. Select your file and confirm that you have the rights to publish the file on the Beyond Social Wiki.
  2. Select your preferred alignment of the image (left, right, center, none) and the format (thumb, frame, frameless, none). Recommendation: use both none & none, your images will be shown full-width of the content column.
  3. Write a caption that will be displayed under the images.
  4. Click insert, and the following syntax will appear:
[[File:myimage.png|My caption here]]
Note: always leave an empty line before and after an image, no matter if it is preceded or followed by another image or text
Note: the adviced sizes for images: 
minimum width: 750px
maximum width: 1920px

Inline formatting

Captions can also be added to images by using a vertical bar:

[[File:myimage.jpg|Caption under the image]]

Which also applies for the alignment:

[[File:myimage.jpg|Caption under the image|right]]

And format:

[[File:myimage.jpg|Caption under the image|right|thumb]]

Video

To include videos in the wiki we use the EmbedVideo extension. There are different syntaxes that can be used. The shortest one is the following.

{{#ev:service|id}}

For example:

{{#ev:youtube|mL9hRH-ZU1c}}

Where the id comes from the link of the video: https://www.youtube.com/watch?v=mL9hRH-ZU1c

Results in:

Keeping track

How does one keeps track of changes? Add them to your watchlist! To do this, you can click on the Watch button in the sidebar.

If you have a confirmed email-address linked to your user account, the wiki will send you update mails whenever a change is made in one of the articles that you are watching.

Help

there are several ways to ask for help in editing.