Wiki Tutorial: Difference between revisions

From XPUB & Lens-Based wiki
No edit summary
Line 19: Line 19:


=Wiki editing=
=Wiki editing=
==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 ''Simon''.
==cheatsheet==
 
 
<nowiki>''italics''
'''bold'''
'''''bold and italics'''''  
==standard header==
===next-level header=== (...and so on)
[[Internal link]]
[[Internal link|alternate text]]
[http://example.com text of external link]
[[Category:Example]] (category tag)
[[:Category:Example]] (link to category)
---- (horizontal line)
* bulleted item
# numbered item
:indentation
::double indentation (...and so on)
;term : definition
[[File:Image-name.jpg|thumb|frame|Caption text]]
{{:Transcluded page name}}
{{Template name}} (call to template)
#REDIRECT [[Page name]]</nowiki>


==editing==
==editing==
Line 37: Line 75:


Once done editing <span style="background:yellow">'''save the page'''</span>, otherwise your contribution will be lost.  
Once done editing <span style="background:yellow">'''save the page'''</span>, otherwise your contribution will be lost.  
==text formating==
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 [http://www.mediawiki.org/wiki/Help:Formatting cheat-sheet] with the most important syntax. 
You can experiment with writing and formating your own '''User page'''. You can get go 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.
'''Attention: to create line breaks you need to leave at least one empty space between one line of text and the next.'''


==Title Headings==
==Title Headings==
Line 59: Line 88:


You can place content under each of these section
You can place content under each of these section
The result when the page is saved will be:
=Main Title=
Content under Main Title
==Sub Title==
Content under Sub Title
===Sub-sub Title===
Content under Sub-sub Title
===Sub-sub-sub Title===
Content under Sub-sub-sub Title


==page creation==
==page creation==
Line 95: Line 112:


==external links==
==external links==
To link to external webpages, use the '''world icon'''.
<nowiki>[http://beyond-social.org/ Beyond Social] </nowiki>


You'll be presented with:
[http://beyond-social.org/ Beyond Social]
<nowiki>[http://www.example.com link title]</nowiki> and simply need to replace them with url and title(optional)
 
like:
 
<nowiki>[http://beyond-social.org/ Beyond Social] </nowiki> == [http://beyond-social.org/ Beyond Social]


==Audio-visuals==
==Audio-visuals==
Line 123: Line 135:
'''To upload''' you can use the picture icon on the menu. It asks you for the file name of the file you are going to upload (they must match) and a caption, if you to say something about that image, video, or audio.  
'''To upload''' you can use the picture icon on the menu. It asks you for the file name of the file you are going to upload (they must match) and a caption, if you to say something about that image, video, or audio.  


When at this upload menu, <span style="background:yellow">instead of "caption" select "none" as the format of your upload</span>.
The syntax to insert an image:


<nowiki>[[File:myimage.png|My caption]]</nowiki>
<nowiki>[[File:myimage.png|My caption]]</nowiki>


 
Captions can be added to images by using a vertical bar (the "pipe"):
This action doesn't upload the file, it only inserts a bit syntax that allow you do the upload the file. In order to do so, you need to:
* Save the page you are working on
* Click on the red link of the file you want to upload
* Follow the instruction to upload your file
 
[[File:myimage.png]]
 
===image captions===
Captions can be added to images by using a vertical bar


<nowiki>[[File:myimage.jpg|Caption under the image]] </nowiki>
<nowiki>[[File:myimage.jpg|Caption under the image]] </nowiki>


===Youtube/Vimeo videos===
===Youtube/Vimeo videos===
Line 151: Line 153:


{{youtube|UyCIB_ChlV0}}
{{youtube|UyCIB_ChlV0}}


{{youtube|A1YYv_J2csk}}  
{{youtube|A1YYv_J2csk}}  
Line 169: Line 169:


How do collaborators, editors, proofreaders, coordinators and designers communicate withing this ecosystem ?
How do collaborators, editors, proofreaders, coordinators and designers communicate withing this ecosystem ?
''
 
Say one totally disagrees with what is said in page where she is collaborating.''   
''Say one totally disagrees with what is said in page where she is collaborating.''   


There are several ways to go about it.
There are several ways to go about it.
On of the places that could be used is the talk page.


= By the book =
= By the book =

Revision as of 17:18, 28 September 2020

Wiki Intro

A little history

The first wiki was create in 1995 by Ward Cunningham, and it was called Wiki Wiki Web (Wiki in Hawaii means quick!).

Interview with Ward Cunningham

Wikis are about speed and easiness of writing and publishing on the Web.

Also about collaboration. According to Ward Cunningham ‘People discovered that they can create something with other people, that they don't even know. But they come to trust and they make something that surprises them in terms of its value’.

For a more detailed page on Wikis, its historical historical perspective and some of its many possibilities see the Wiki page.

This page is more how-to guide.

As it is a wiki, feel free to edit it.

Wiki editing

cheatsheet

''italics'' 
 
 '''bold''' 
 
 '''''bold and italics''''' 
 
 ==standard header== 
 
 ===next-level header=== (...and so on) 
 
 [[Internal link]] 
 
 [[Internal link|alternate text]] 
 
 [http://example.com text of external link] 
 
 [[Category:Example]] (category tag) 
 
 [[:Category:Example]] (link to category) 
 
 ---- (horizontal line) 
 
 * bulleted item 
 
 # numbered item 
 
 :indentation 
 
 ::double indentation (...and so on) 
 
 ;term : definition 
 
 [[File:Image-name.jpg|thumb|frame|Caption text]]
 
 {{:Transcluded page name}} 
 
 {{Template name}} (call to template) 
 
 #REDIRECT [[Page name]] 

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.

Title 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 section

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.

To create a page create internal links [[name of new page]] for that page

The other easy way to create is to use the search function with the name of the page you want to create. When searching, you are given the possibility to create that page.

Note: For your work you should use sub pages under your user namespace. [[User:yourusername/mypage]]

  • Red link = previously non-existing page.
  • Blue link = existing page.

Wiki - an existing page

oooooooo - an non-existing page

external links

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

Beyond Social

Audio-visuals

uploading 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

To upload you can use the picture icon on the menu. It asks you for the file name of the file you are going to upload (they must match) and a caption, if you to say something about that image, video, or audio.

The syntax to insert an image:

[[File:myimage.png|My caption]]

Captions can be added to images by using a vertical bar (the "pipe"):

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

Youtube/Vimeo videos

To include, you need:

  • the ID of the video you want to include in you page
  • to write {{youtube|id}} for Youtube or {{vimeo|id}} for vimeo. Where the id is the sequence of numbers and letters that follow ?v= in Youtube videos url, and vimeo.com/ in Vimeo videos)

Example: {{youtube|A1YYv_J2csk}} {{vimeo|68841788}}

will results in:

Error in widget YouTube: unable to write file /data/www/wdka.nl/pzwiki.wdka.nl/mw-mediadesign/extensions/Widgets/compiled_templates/wrt67400b4e679121_52137252
Error in widget YouTube: unable to write file /data/www/wdka.nl/pzwiki.wdka.nl/mw-mediadesign/extensions/Widgets/compiled_templates/wrt67400b4e691629_70031248
Error in widget Vimeo: unable to write file /data/www/wdka.nl/pzwiki.wdka.nl/mw-mediadesign/extensions/Widgets/compiled_templates/wrt67400b4e6bcf98_50446894

http://vimeo.com/68841788

Chaging 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


Communication

How do collaborators, editors, proofreaders, coordinators and designers communicate withing this ecosystem ?

Say one totally disagrees with what is said in page where she is collaborating.

There are several ways to go about it.

On of the places that could be used is the talk page.

By the book

A good free online resource is Yaron Koren's Working with MediaWiki. Yaron Koren is a contributor to the MediaWiki software community, particularly around integrating data and journalism (he's the primary author of the Cargo extension).

Some Key Topics