Wiki tutorial

From Beyond Social wiki
Jump to: navigation, search

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 or your student number.

page creation

How to create a page? In a wiki the information is organized into pages or articles (no great distinction between the two). If you want to say something about something for which there isn't a page, you create that page and start writing its content.

There are multiple options to create a page:

on the Main Page

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

inside an article

  1. add a wiki link to an article
    Example: [[Article Title Here]].
    You can do this either by typing the '[[' and ']]' characters, or use the chain icon in the menu.
  2. save or preview the page
  3. see that the link that you created to the new page is red.
    1. Red link = previously non-existing page. (Lexicons_Beyond_Social - an non-existing page)
    2. Blue link = existing page. (Lexicon - an existing page)
  4. click the link and create that page

change the link in the URL

For instance http://beyond-social.org/wiki/index.php/MYBRANDNEWPAGE where MYBRANDNEWPAGE will be the title of you page.

use the Search box (in the sidebar)

  1. type the title of the article you want to create
  2. the new page name will appear as a RED link
  3. click it and you'll be able to edit that page

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 Wiki Introduction.

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.

Syntax

Although there is a specific 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

A few basics:

  • '''word''' == word
  • ''word'' == word
  • <u>word</u> or <ins>word</ins> == word
  • <del>word</del> or <s>word</s> == word
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.

~~~ creates Manetta (talk)

~~~~ creates Manetta (talk) 14:33, 9 February 2017 (CET)


Audio-visuals

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
  • use the Img-icon-wiki.png icon in the text editor
  1. Click on 'Upload' to select an image, and confirm that you can publish this file under the license.
  2. Set the alignment of the image and the format.
  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]]
Attention: always leave an empty line before and after an image, no matter if it is preceded or followed by another image or text

image captions:

Captions can also be added to images by using a vertical bar: [[File:myimage.jpg|Caption under the image]]

Youtube videos

(We are using YouTube extension; No longer using Widgets)

To include Youtube videos, you need:

  • the ID of the video you want to include in your page
  • to write <youtube>VIDEO-ID</youtube>, such as <youtube>wmjaK1gEdFM<youtube>, in order to embed the following youtube video https://www.youtube.com/watch?v=wmjaK1gEdFM

The YouTube extension allows also to embed videos from these services:

  • Google Video — use the <gvideo> tag
  • Archive.org audio — use the <aoaudio> tag
  • Archive.org video — use the <aovideo> tag

Vimeo

Unfortunately, it's not possible to use Vimeo with this extention. As an alternative, you can just paste the link to a Vimeo video in your article.

external links

To link to external webpages write: [http://www.example.com link title]. A link title is optional.

example: [http://beyond-social.org/ Beyond Social] == Beyond Social

Categories

assign Categories

In Beyond Social we are using Categories to structure the content. When you edit a page, there appears a Category editor right under the save button. The Categories are structured in the following way:

  • BS
    • Issue
    • Meta
    • Overview
    • Section
    • Topic
  • Deprecated
  • Editorial selection
  • Master Class
    • Circular Economy
    • Civic Economy
    • Gamification
    • Sharing Economy
  • Pages using duplicate arguments in template calls

new Categories

To add a Category, click the Create a Category link in the sidebar. Note: At the moment, only Administrators can create new categories. Soon there will be a new group with specific permissions, called Moderators, that also have the permission to add Categories.

Changing pages' titles

Pages' titles can be changed by using the function Move in the top right corner in a dropdown menu next to the star. The Move page permits you to attribute a new name to the current page.

Keeping track

How does one keeps track of changes? Add them to your watchlist! (right-top menu)

Deleting a page

When you delete the content of a page, your content is actually not really gone. As the wiki saves all its edits, your content is still accessible under the "view history" button. However, if you really want to delete a page you can contact one of the Bureaucrats or send them an email. Most of the Bureaucrats have their emailaddress listed on their Userpage.

Help

there are several ways to ask for help in editing.

  • Mediawiki
    • the website on Mediawiki (the software on which Beyond Social wiki runs) provides a lot of information
    • http://www.mediawiki.org/wiki/MediaWiki
    • What you'll be looking for will probably be under "Using MediaWiki"
  • ask others
  • visit the Publication Station