Wiki editing guide
From WikiEducators Guggenheim Bilbao
Educators Wiki is made up of two types of sections: The first are the sections that function as categories, which in turn contain a series of articles; these sections are Idea lab and Multimedia gallery.
The second type, sections such as Let's talk and Resources, are articles that integrate different headings or sections. The content is added to the page itself, and a table of contents is then generated automatically.
Before posting your content, you should make sure the article doesn't already exist in Educators Wiki. You can do this by checking the sections mentioned above or by searching for the heading or name of your article.
All of the sections contained in the Educators Wiki, except for a few restricted ones, can be edited by users. However, in order to ensure content quality, users are required to register or identify themselves before editing any texts.
Contents |
Creating a new article or page
After you’ve made sure the content does not already exist, and you've registered or identified yourself as an Educators Wiki user, you can create an article or page:
Sections that function as categories
There are two ways to create new content:
- Using the browser:
From the path displayed in the browser, type a forward slash “/”, followed by the heading of your article. Take a look at the example below:
http://www.guggenheim-bilbao.es/wikidocentes/en/index.php/Leo
This path will take you to a page that has not been created yet. If you are a registered user, click on the "edit" link at the top of the page. This will bring you to a new page where you can post your own content.
When you are finished inserting all of your content, you should categorize it. To do this, you'll need to think about what section you want to put your article in. For example, if you want your article to be included in the “Idea lab” section, you should type [[Category: Idea lab]] at the very end of the content.
Be sure you write the name of the category correctly. If the name is not exactly the same, a new category will be created instead of including your article in the existing category.
Your article will be alphabetized according to the first letter of the title. In other words, if the title is Cy Twombly, you'll find it under the letter C.
If you think your article does not fit into any of the existing categories, you can create a new one by inserting the code [[Category:Category name]].
When you are finished with an edit, don't forget to click "Save page" to save your article.
- Using the search tool:
Enter the heading of your article in the search box. If there is no page already with that exact name, the search results page will say:
There is no page titled "pagename".You can create this page.
Clicking on the link will take you to an editing page where you can add your article or page.
You should also categorize your content just like the previous example.
When you are finished with an edit, remember to click "Save page" to save your article.
Sections that function as articles
It's easier to add content to these sections. Simply enter the section you're interested in, for example, Resources, then the subsection, i.e. Library, and edit the page.
There is an "Edit" tab at the top of the page. The Edit page will take you to an editable version where you can include your content.
It is a good idea to follow the same organizational logic by inserting your comment in alphabetical order. For example, if the content title begins with B, place it after all of the titles that begin with A.
The contents within an article do not need to be categorized, since all of the additions or changes are recorded on the same page.
When you finish editing, press "Save page" to keep all the changes made to the section.
Changing an article or page
Existing articles on Educators Wiki can be changed and updated. To make changes to an article press the "Edit" tab at the top of the page to access the edit mode.
It's important to keep in mind that the content you wish to edit was created by another Educators Wiki user. Therefore, it's recommended not to change any of the substantial information in an article and to try to keep the original author's tone.
It's a good idea to include a short summary of your changes to facilitate identification by other users. Remember that all changes made to the page are recorded.
If the change you have made to the page is minor, such as a spelling or grammar correction, be sure to check the box "This is a minor edit".
When you finish editing the document, press “Save page” to record your changes.
Wiki formatting
All editable pages have a toolbar like this 
to make editing easier.
This is how to format your documents:
- Select the text you want to format.
- Press the corresponding button, i.e.
for bold text.
You can also edit manually. Simply follow the format example you see when you press the button.
Bold text and italicized text
To create bold type and italics, use the apostrophe (') on your keyboard (the apostrophe is usually on the same key as the question mark).
For bold text, type in 3 apostrophes immediately before and three apostrophes immediately after the text you want to highlight. The same thing can be done automatically by select the text and pressing 
.
For italicized text, insert 2 apostrophes immediately before and two apostrophes immediately after the text you want to highlight. The same thing can be done automatically by select the text and pressing 
.
You can also highlight words in both bold and italicized text simultaneously. Just type 5 apostrophes before and five apostrophes after the text you want to highlight. If you'd rather do the same thing automatically, select the text and press the followed by the .
Headings and subheadings
Normally there's no need to create a heading for your article. When you use the search tool to create a page, you'll usually find that the heading already exists.
Headings should be put on a separate line with no text before of after.
The equal sign (=) is used to create headings. Top-level headings are surrounded one equal sign (=); second-level headings, by two equal signs (==), lesser subheadings by three (===), and so on.
Top-level headings are too large, so the second level headings are generally used ==Title==. This can also be done automatically by pressing 
.
Below are some examples of headings and subheadings.
==Title=====Subtitle=======Subtitle======Title=====Subtitle===
You can also divide the content of your article by including a line across the page. To make a line press 
, or type four hyphens in a row: ----.
Lists
In the Educators Wiki you can create two types of lists.
Numbered lists: The pound symbol (#) is used to create numbered lists. You can create levels by inserting one or more pound sign for each level. Use a single pound sign for the first level, two pound signs for the second level, and so on. Here is an example:
#Level one##Level two###Level three
It will look like this:
- Level one
- Level one
- Level two
- Level three
- Level two
Bulleted lists: To create a bulleted list, use the asterisk sign (*). Just like numbered lists, here we use one or more consecutive asterisks to create the various levels. For example:
*Level one**Level two***Level three
It will look like this:
- Level one
- Level two
- Level three
- Level two
Indentation
The tabulator key cannot be used on this wiki for indentation. To indent a paragraph, use the colon sign :.
Begin with a single indent by typing one colon before the text you want to indent. For each level of indentation, add one or more colons. For example:
:Single indent::Double indent:::Triple indent
It will look like this:
- Single indent
- Double indent
- Triple indent
- Double indent
Links
External links:
Generally speaking, the most common types of links you'll be using in this project are external, whether they be examples of the materials you've developed, references, etc.
There is a button to create these links 
, which will create a syntax that looks like this: [http://www.example.com Title of link]. Insert the file path in the first part. The way to do this is to visit the page you want to link to and copy the file/path from the address bar in your browser. Make sure you copy the entire path so that the link works properly (including http://).
Then paste the path and leave a space to write the title of the link. The title you write after the path is what the users will see. It will look like this: Title of link
Internal links:
Internal links can be used to connect different articles within the Educators Wiki or to make it easier to access different sections from the same page.
You can also use links to pages that haven't been created yet. Internal links make it easier to find related information by conveniently accessing other articles.
Create internal links by using the button 
, or by writing the linked text inside double brackets: [[linked text]]. Just select the text and press the button, or write the corresponding words inside the brackets.
If you want to link the text to an article that already exists, make sure it is the same as the article title or section heading you want to link to. Links to pages already existing will appear in blue.
If the page does not exist, the link color will appear in red. This way another user can follow the link and create the corresponding article.
If you want to create a link with a different name, do as follows: [[Name of page|Text]]. In "Name of page" you should write the title of the page you want to link to, and in "Text", write exactly what you want the link to say.
If you want to link to a category, use the following syntax [[:Category:Name of category |View]]. This link must be done manually since there is no automatic mode. Made sure you type the exact name of the category to link it properly. Type the name of the category in “name of category”, and the text you want to see in “View”.
Multimedia content
The Educators Wiki welcomes images, videos, and audio files to be used as teaching material in the articles you edit and the Multimedia gallery.
Before you upload any multimedia content, make sure you're not violating any copyright restrictions that might apply to the material.
Images and photographs
If you want to include photographs in your articles, the first step is to upload them to the Educators Wiki. In the toolbox at the lefthand side of the page you'll find an option to "Upload file". Here you can upload images and sound files.
To upload your images, simply press "browse...", look for the file in your computer, and press "upload file". It's important to remember the file name. When you want to post it in a particular section you'll have to type in the exact name so that the system can locate the file.
Once the file is uploaded you can begin to paste your images wherever you like.
Linking images from an article
If you want to add an image to an article, place the cursor at the end of the last word where you want to insert the image. In the toolbox you'll find a button like this 
, which will create the following link [[Image:Example.jpg]]. Write the name of the image you want to include where you see the bold type. Accepted formats include .jpg and .png.
To learn more about formats and image sizes, click on the following link
Video
To add a video, you'll need to have a Youtube account (enlazar). To embed the video in the content, add this format syntax (insertar etiquetas) before and after the video code.
This example will show you clearly how to embed the video.
- Video code in bold type:
http://es.youtube.com/watch?v=ZsiN3jUFIuI - Embed the video in the article:
<youtube>ZsiN3jUFIuI</youtube>
Readers will be able to see the video on the same page but it will be housed on Youtube.
Audio
The process for adding audio files is the same as it is for images. Simply upload the file in mp3 format and place it in corresponding spot using the following syntax markers: <flashmp3>example.mp3</flashmp3>.
Don't forget to write the name of the file correctly or the system won't be able to find the right file.
Multimedia Gallery
This section functions like a category. Within the general category "Multimedia gallery" are the rest of the subcategories, in other words, the multimedia articles created by users.
To create your own gallery you should create a new page (see Creating a new article or page) and place it in the Multimedia gallery.
More information
If you want to learn more about wiki editing, visit the following page:
Wiki Editing Manual (Spanish only)
