Difference between revisions of "Getting started on HCE wiki"

From HCE Wiki - The Human Cognitive Enhancement Wiki
Jump to navigation Jump to search
(created)
 
(a correction)
 
(22 intermediate revisions by one other user not shown)
Line 1: Line 1:
Welcome to HCE Wiki and thank you for deciding to help! If you are new to wikipedia editing, or just new to HCE Wiki, this is a right place to begin. The following page will teach you basics of how to write a wiki article and offer links to places on the Internet should you wish to expand your knowledge further. If you have an idea on how to expand this guide or if you feel something is explained poorly, please head to this page's talk page and post a comment.
+
Welcome to HCE Wiki and thank you for deciding to help! If you are new to Wikipedia editing, or just new to HCE Wiki, this is the right place to begin. The following page will teach you the basics of how to write a wiki article and offer links to places on the Internet should you wish to expand your knowledge further. If you have an idea on how to expand this guide or if you feel something is explained poorly, please head to [[Talk:Getting_started_on_HCE_wiki|this page's talk page]] and post a comment.
 +
 
 +
== Creating or Editing an Article ==
 +
 
 +
Luckily, creating an article in wiki, or any MediaWiki based wiki for that matter, is easy. For writing, you do not need to have any HTML and CSS knowledge as the wiki takes care of most of the layout and text-style formatting itself.
 +
 
 +
==== Creating an Article ====
 +
 
 +
<i class="fa fa-exclamation-circle"></i>See also the [[Entry template]] for information about the general layout of a new article on the HCE Wiki.
 +
 
 +
The fastest way to create an article on the wiki is to search for the entry you wish to create using the search bar on the top right. After telling you it can't find such an article, the wiki will offer you the opportunity to start one. Another way to create an article is to click on the red link that you may find in some articles. The red colour indicates that there is no such article, even though the page tries to link to it. By clicking on the link, you essentially do the same as searching for it, except you did not have to type the name of the article first as someone already expected such an article to be made. You will then be presented with an edit window.
 +
 
 +
==== Editing an Article ====
 +
 
 +
To edit an already existing article, simply click the Edit button on the top right corner of the page, just left of the search bar.
 +
 
 +
=== The Edit Window ===
 +
 
 +
Provided you have the sufficient rights as a user to edit the article, you will be presented with an Edit window. It should look like this:
 +
 
 +
[[File:Edit Window.png|800px|thumbnail|center]]
 +
 
 +
If you are accustomed to using text processors like Microsoft Word, then this view should be pretty familiar. Let's go over the different elements of it.
 +
 
 +
==== Wikitext, Preview and Changes Tabs ====
 +
 
 +
On the top, you can see three tabs. The first one is the editing view you are already in. This view is for the raw text that will be displayed on the page after you save it. The next tab is to preview the changes you just made without actually saving them. The third tab shows you how the version of the article you are writing differs from the one that was saved before. Of course, in case of a new article, it won't show you much.
 +
 
 +
Moving down to the second row, this is the part that you will use the most. Here you can change the formatting of selected text much like you would inside a desktop text processor. Apart from the '''B'''old and ''I''talics buttons, the second row also contains a number of other buttons that are explained below.
 +
 
 +
[[File:Edit window second bar.png|framed|center]]
 +
 
 +
==== User Signature ====
 +
 
 +
A. Adds your signature. This is useful for commenting in the Talk pages, since you don't need to write your nickname and make a link to your profile every time you are making a comment. During the editing, you will see the signature as a number of hyphens and tildes. But don't worry, these will get replaced by your signature and a link to your profile after saving the page.
 +
 
 +
Note: This applies only to Talk pages. Toolbars for editing normal articles will not feature the Add signature button at all.
 +
 
 +
==== Insert a Link ====
 +
 
 +
B. Inserts a link--either a local wiki link to an article here, or an external link that leads to somewhere on the Internet.
 +
 
 +
The Insert link form has two fields. The <code>Target page or URL:</code> and the <code>Text to display:</code>. This allows you to customise how the link will appear in an article. If you only fill in the first field, the link will appear as the full URL (e.g., http://hcenat.zcu.cz/wiki/index.php). If you also fill in the second field, the long URL will get replaced by the text you've put in, but the link will functionally stay the same (e.g. [http://hcenat.zcu.cz/wiki/index.php HCE Wiki]).
 +
 
 +
You may have also noticed the little blue arrows on the right side of the links. These indicate that they are external links and lead outside of the wiki. A local link that goes to an article that is on this very wiki does not have the little arrow. Example: [[Smartglasses]]. The wiki will take care of forming a proper HTML link for the article so you don't have to worry about creating a HTML link manually.
 +
 
 +
==== Embed a File ====
 +
 
 +
C. Inserts a file--usually a picture--to the body of the article.
 +
 
 +
The <code>Filename:</code> field is mandatory. You will need to upload the file to the wiki first, using the [[Special:Upload]] page. After successfully uploading the file, you can copy the file name, including the File: part, into the <code>Filename:</code> field, click Insert, and the file will be embedded into the page at the place of the cursor. See [[How to upload a file]] guide for more information on uploading files to this wiki.
 +
 
 +
You can also type the caption for the file, as well as select its position and dimensions on the page. For more information on how to work with inserting images and other files, refer to the [https://www.mediawiki.org/wiki/Help:Images MediWiki Images Help page].
 +
 
 +
==== Add a Reference ====
 +
 
 +
D. Creates a reference at the position of the cursor.
 +
 
 +
This way you can create a reference for what you are currently writing about, be it a link to a news article or a book. You type the bibliographic reference into the form, click Insert, and the reference will be created. It will not display the entire reference in the body of the article, though. A numbered link will be placed at the position where you create the reference. The full text will be automatically placed at the end of the article, together with other references in chronological order based on their position throughout the article.
 +
 
 +
It is advised that you place <code>== References ==</code> as the second-to-last thing, just before categories, at the end of the article you are writing. The wiki tries to look for the References section to properly place the list of references.
 +
 
 +
You can use a particular reference multiple times. When you place a reference, a <code><nowiki><ref>...</ref></nowiki></code> code will be generated. The <code><nowiki><ref></nowiki></code> tags tell the wiki that the text inside of them is a reference. To use one reference several times, you will need to name it. This is done by editing the generated ref tags by adding <code>name=...</code> with ... being the unique name of the reference. For example, you can make a reference that will look like this: <code><nowiki><ref>DOE, John. On Editing a Wiki Article. Oxford Press, 2015</ref></nowiki></code> and then add the name <code>name="doe2015"</code> so the reference looks like this: <code><nowiki><ref name="doe2015">DOE, John. On Editing a Wiki Article. Oxford Press, 2015</ref></nowiki></code>. If you want to use the reference again somewhere else, you just write <code><nowiki><ref name="doe2015" /></nowiki></code> and the reference will link to the original one. No need to write the whole reference again.
 +
 
 +
==== Creating Quotes ====
 +
 
 +
You can use the following template to create a stylised quote:
 +
 
 +
<pre style="white-space: pre-wrap;
 +
white-space: -moz-pre-wrap;
 +
white-space: -pre-wrap;
 +
white-space: -o-pre-wrap;
 +
word-wrap: break-word;">
 +
<blockquote class="templatequote">
 +
<p>Quote text.</p>
 +
<cite><div class="templatequotecite">—Author, Source</div></cite>
 +
</blockquote>
 +
</pre>
 +
 
 +
==== Advanced & Special Characters ====
 +
 
 +
The Advanced button is used to display further available settings, like changing the heading level or making a list. What the individual buttons do should be self-explanatory. The Special Characters list allows you to easily include characters you may not find on your keyboard. The Help button displays a short summary of Wikitext markups and keywords you can use to format the text of the article you are writing.
 +
 
 +
If you need more information about wiki markup language, head to the [https://www.mediawiki.org/wiki/Help:Formatting MediWiki Help:Formatting page] to learn more.
 +
 
 +
== Saving an Article ==
 +
 
 +
Before you save the article, please add a short summary of the changes you have made into the Summary: field. Deciding whether the change is a minor edit or not is upon your own discretion. Usually, the rule of thumb is that if you fixed a typo, it's just a minor edit, but if you added a whole paragraph, then it's a regular edit. You can also mark the page to be added into your watch list if you wish to closely inspect the changes other users may do in it.
 +
 
 +
If you are happy with the changes made and you wrote the summary for them too (see above), you can save and publish the page by clicking on the Save Page button.
 +
 
 +
== Dynamic Page List =
 +
 
 +
This wiki uses a third-party extension called [https://www.mediawiki.org/wiki/Extension:DynamicPageList3 DynamicPageList3] to allow authors to create an automatically generated list of pages based on certain criteria. This is mainly utilised in the category synopses to create a list of pages that fall into these categories. You can see the extension in action on [[Virtual Reality Devices]] or [[Smartglasses]], for example.
 +
 
 +
A dynamic list is created by including the code <code><nowiki><DPL>foo</DPL></nowiki></code>, in which the <code>foo</code> is a placeholder for additional parameters. To create a list of pages under a certain category, you need to replace the placeholder with <code>category=nameOfTheCategory</code>. The extension will now generate a list of ''all'' pages that are under the chosen category. The list can be further refined by adding more parameters such as <code>sortkey=</code> that allows for controlling the order in which the list is displayed. Full list of all available parameters can be found in the official documentation here: http://help.gamepedia.com/DPL:Manual#Parameters
 +
 
 +
Here is an example of a dynamic list code that creates a list of all pages under the category of [[Speech Technologies]] and sorts them alphabetically:
 +
 
 +
<pre>
 +
<DPL>
 +
category=Speech Technologies
 +
ordermethod=sortkey
 +
</DPL>
 +
</pre>
 +
 
 +
[[Category:Guides]]

Latest revision as of 13:25, 13 June 2017

Welcome to HCE Wiki and thank you for deciding to help! If you are new to Wikipedia editing, or just new to HCE Wiki, this is the right place to begin. The following page will teach you the basics of how to write a wiki article and offer links to places on the Internet should you wish to expand your knowledge further. If you have an idea on how to expand this guide or if you feel something is explained poorly, please head to this page's talk page and post a comment.

Creating or Editing an Article

Luckily, creating an article in wiki, or any MediaWiki based wiki for that matter, is easy. For writing, you do not need to have any HTML and CSS knowledge as the wiki takes care of most of the layout and text-style formatting itself.

Creating an Article

See also the Entry template for information about the general layout of a new article on the HCE Wiki.

The fastest way to create an article on the wiki is to search for the entry you wish to create using the search bar on the top right. After telling you it can't find such an article, the wiki will offer you the opportunity to start one. Another way to create an article is to click on the red link that you may find in some articles. The red colour indicates that there is no such article, even though the page tries to link to it. By clicking on the link, you essentially do the same as searching for it, except you did not have to type the name of the article first as someone already expected such an article to be made. You will then be presented with an edit window.

Editing an Article

To edit an already existing article, simply click the Edit button on the top right corner of the page, just left of the search bar.

The Edit Window

Provided you have the sufficient rights as a user to edit the article, you will be presented with an Edit window. It should look like this:

Edit Window.png

If you are accustomed to using text processors like Microsoft Word, then this view should be pretty familiar. Let's go over the different elements of it.

Wikitext, Preview and Changes Tabs

On the top, you can see three tabs. The first one is the editing view you are already in. This view is for the raw text that will be displayed on the page after you save it. The next tab is to preview the changes you just made without actually saving them. The third tab shows you how the version of the article you are writing differs from the one that was saved before. Of course, in case of a new article, it won't show you much.

Moving down to the second row, this is the part that you will use the most. Here you can change the formatting of selected text much like you would inside a desktop text processor. Apart from the Bold and Italics buttons, the second row also contains a number of other buttons that are explained below.

Edit window second bar.png

User Signature

A. Adds your signature. This is useful for commenting in the Talk pages, since you don't need to write your nickname and make a link to your profile every time you are making a comment. During the editing, you will see the signature as a number of hyphens and tildes. But don't worry, these will get replaced by your signature and a link to your profile after saving the page.

Note: This applies only to Talk pages. Toolbars for editing normal articles will not feature the Add signature button at all.

Insert a Link

B. Inserts a link--either a local wiki link to an article here, or an external link that leads to somewhere on the Internet.

The Insert link form has two fields. The Target page or URL: and the Text to display:. This allows you to customise how the link will appear in an article. If you only fill in the first field, the link will appear as the full URL (e.g., http://hcenat.zcu.cz/wiki/index.php). If you also fill in the second field, the long URL will get replaced by the text you've put in, but the link will functionally stay the same (e.g. HCE Wiki).

You may have also noticed the little blue arrows on the right side of the links. These indicate that they are external links and lead outside of the wiki. A local link that goes to an article that is on this very wiki does not have the little arrow. Example: Smartglasses. The wiki will take care of forming a proper HTML link for the article so you don't have to worry about creating a HTML link manually.

Embed a File

C. Inserts a file--usually a picture--to the body of the article.

The Filename: field is mandatory. You will need to upload the file to the wiki first, using the Special:Upload page. After successfully uploading the file, you can copy the file name, including the File: part, into the Filename: field, click Insert, and the file will be embedded into the page at the place of the cursor. See How to upload a file guide for more information on uploading files to this wiki.

You can also type the caption for the file, as well as select its position and dimensions on the page. For more information on how to work with inserting images and other files, refer to the MediWiki Images Help page.

Add a Reference

D. Creates a reference at the position of the cursor.

This way you can create a reference for what you are currently writing about, be it a link to a news article or a book. You type the bibliographic reference into the form, click Insert, and the reference will be created. It will not display the entire reference in the body of the article, though. A numbered link will be placed at the position where you create the reference. The full text will be automatically placed at the end of the article, together with other references in chronological order based on their position throughout the article.

It is advised that you place == References == as the second-to-last thing, just before categories, at the end of the article you are writing. The wiki tries to look for the References section to properly place the list of references.

You can use a particular reference multiple times. When you place a reference, a <ref>...</ref> code will be generated. The <ref> tags tell the wiki that the text inside of them is a reference. To use one reference several times, you will need to name it. This is done by editing the generated ref tags by adding name=... with ... being the unique name of the reference. For example, you can make a reference that will look like this: <ref>DOE, John. On Editing a Wiki Article. Oxford Press, 2015</ref> and then add the name name="doe2015" so the reference looks like this: <ref name="doe2015">DOE, John. On Editing a Wiki Article. Oxford Press, 2015</ref>. If you want to use the reference again somewhere else, you just write <ref name="doe2015" /> and the reference will link to the original one. No need to write the whole reference again.

Creating Quotes

You can use the following template to create a stylised quote:

<blockquote class="templatequote">
<p>Quote text.</p>
<cite><div class="templatequotecite">—Author, Source</div></cite>
</blockquote>

Advanced & Special Characters

The Advanced button is used to display further available settings, like changing the heading level or making a list. What the individual buttons do should be self-explanatory. The Special Characters list allows you to easily include characters you may not find on your keyboard. The Help button displays a short summary of Wikitext markups and keywords you can use to format the text of the article you are writing.

If you need more information about wiki markup language, head to the MediWiki Help:Formatting page to learn more.

Saving an Article

Before you save the article, please add a short summary of the changes you have made into the Summary: field. Deciding whether the change is a minor edit or not is upon your own discretion. Usually, the rule of thumb is that if you fixed a typo, it's just a minor edit, but if you added a whole paragraph, then it's a regular edit. You can also mark the page to be added into your watch list if you wish to closely inspect the changes other users may do in it.

If you are happy with the changes made and you wrote the summary for them too (see above), you can save and publish the page by clicking on the Save Page button.

= Dynamic Page List

This wiki uses a third-party extension called DynamicPageList3 to allow authors to create an automatically generated list of pages based on certain criteria. This is mainly utilised in the category synopses to create a list of pages that fall into these categories. You can see the extension in action on Virtual Reality Devices or Smartglasses, for example.

A dynamic list is created by including the code <DPL>foo</DPL>, in which the foo is a placeholder for additional parameters. To create a list of pages under a certain category, you need to replace the placeholder with category=nameOfTheCategory. The extension will now generate a list of all pages that are under the chosen category. The list can be further refined by adding more parameters such as sortkey= that allows for controlling the order in which the list is displayed. Full list of all available parameters can be found in the official documentation here: http://help.gamepedia.com/DPL:Manual#Parameters

Here is an example of a dynamic list code that creates a list of all pages under the category of Speech Technologies and sorts them alphabetically:

<DPL>
category=Speech Technologies
ordermethod=sortkey
</DPL>