Difference between revisions of "Help:Links"

From sureai
Jump to: navigation, search
m
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
{{breadcrumb|[[Help:Contents|Help]]}}
+
{{breadcrumb}}
 
{{Stub}}
 
{{Stub}}
  
Line 17: Line 17:
  
 
There is also the main namespace in which every project lays, the namespace without any prefix. There are only nine articles - the portal sites towards the repsective the projects. No other articles should be added to this main namespace.
 
There is also the main namespace in which every project lays, the namespace without any prefix. There are only nine articles - the portal sites towards the repsective the projects. No other articles should be added to this main namespace.
So if you want to include a link to an article, you always have to prepend the correct namespace. A link towards an article about the NPC "Finn Dalires" should '''not''' look like this: <nowiki>[[Finn]]</nowiki>, but like this: <nowiki>[[Enderal:Finn|]].</nowiki> Important is the vertical line after the article name ("|"), which is meant to seperate the readable text from the actual link, so the link will be displayed without the namespace prefix. The "|" should only be used if the link shown should be different from the actual article name because of grammar or formulation, otherwise this will be done by the Wiki software automatically.
+
So if you want to include a link to an article, you always have to prepend the correct namespace. A link towards an article about the NPC "Finn Dalires" should '''not''' look like this: <code><nowiki>[[Finn]]</nowiki></code>, but like this: <code><nowiki>[[Enderal:Finn|]]</nowiki></code>. Important is the vertical line after the article name (<code><nowiki>|</nowiki></code>), which is meant to seperate the readable text from the actual link, so the link will be displayed without the namespace prefix. The <code><nowiki>|</nowiki></code> should only be used if the link shown should be different from the actual article name because of grammar or formulation, otherwise this will be done by the Wiki software automatically.
  
 
If you leave out the vertical line, the namespace will be displayed within the link which which is bad for readability in articles.
 
If you leave out the vertical line, the namespace will be displayed within the link which which is bad for readability in articles.
Line 52: Line 52:
 
The Breadcrumb of all articles shall eventually point towards the big portal sites of the individual SureAI projects ([[Enderal|Enderal]], [[Nehrim|Nehrim]], [[Arktwend|Arktwend]], [[Myar_Aranath:_Relict_of_Kallidar|Myar Aranath]], [[Cube_Experimental|Cube Experimental]]).
 
The Breadcrumb of all articles shall eventually point towards the big portal sites of the individual SureAI projects ([[Enderal|Enderal]], [[Nehrim|Nehrim]], [[Arktwend|Arktwend]], [[Myar_Aranath:_Relict_of_Kallidar|Myar Aranath]], [[Cube_Experimental|Cube Experimental]]).
  
If an article is located directly "under" a portal page in the system, it is easy to install the <nowiki> {{breadcrumb}} </nowiki> template at the top of the article. The portal page of the respective name space is automatically recognized and displayed:
+
If an article is located directly "under" a portal page in the system, it is easy to install the <code><nowiki>{{breadcrumb}}</nowiki></code> template at the top of the article. The portal page of the respective name space is automatically recognized and displayed:
 
{|border="1" cellspacing="1" cellpadding="3" style="border-collapse:collapse; background-color:#FFFFFF; solid;"
 
{|border="1" cellspacing="1" cellpadding="3" style="border-collapse:collapse; background-color:#FFFFFF; solid;"
 
|<font color=#517488>'''Used on these sites for example'''</font>
 
|<font color=#517488>'''Used on these sites for example'''</font>
Line 68: Line 68:
  
  
If you want to inlcude a Breadcrumb in an article which is "under"r Systematik „unter“ these just mentioned articles, you only have to add the link to the parent page, separated by a vertical line ("|"), the so-called "pipe":
+
If you want to inlcude a Breadcrumb in an article which is "under" these just mentioned articles, you only have to add the link to the parent page, separated by a vertical line (<code><nowiki>|</nowiki></code>), the so-called "pipe":
 
{|border="1" cellspacing="1" cellpadding="3" style="border-collapse:collapse; background-color:#FFFFFF; solid;"
 
{|border="1" cellspacing="1" cellpadding="3" style="border-collapse:collapse; background-color:#FFFFFF; solid;"
 
|<font color=#517488>'''Used on these sites for example'''</font>
 
|<font color=#517488>'''Used on these sites for example'''</font>
Line 84: Line 84:
  
  
If you want to go a level deeper, simply expand the Breadcrumb accordingly. You have to insert the "<" character yourself:
+
If you want to go a level deeper, simply expand the Breadcrumb accordingly. You have to insert the <code><nowiki><</nowiki></code> character yourself:
  
 
{|border="1" cellspacing="1" cellpadding="3" style="border-collapse:collapse; background-color:#FFFFFF; solid;"
 
{|border="1" cellspacing="1" cellpadding="3" style="border-collapse:collapse; background-color:#FFFFFF; solid;"
Line 104: Line 104:
 
*If it is not possible to include an important term in the text as a link, it should be referred to at the end of the article
 
*If it is not possible to include an important term in the text as a link, it should be referred to at the end of the article
 
*Between headings should not contain links
 
*Between headings should not contain links
*Links to paragraphs in another article, thus to the between headings, are also possible
+
*Links to paragraphs in another article, thus to the between headings, are also possible. E.g. a link to a between heading on the main page [[Enderal#Character|Character]]; Looking like this <code><nowiki>[[Enderal#Character|Character]]</nowiki></code>
  
 
==Internal Links (Wikilinks)==
 
==Internal Links (Wikilinks)==
Wörter die auf Wiki-interne Seiten verlinken sollen, müssen nur als sog. "Interner Link" mit zwei eckigen Klammern "[[]]" umgeben werden. Dieser Vorgang lässt sich auch vereinfachen, indem man das gewünschte wort mit der Maus markiert und in der Bearbeitungswerkzeugleiste über dem Vorschaufenser die unterstrichene "AB"-Anweisungen anklickt.
+
Words which link to internal Wiki pages are so called "Internal Links". They can be used with two square bracket <code><nowiki>[[]]</nowiki></code> surrounding the address.
*Nicht zwangsläufig muss die Adresse des Artikels auch dem Wortlaut es Links entsprechen! Wenn nach der Linkadresse, mit einem senkrechten Strich "|" getrennt, ein weiterer Text eingegeben wird, so wird dieser im Artikel angezeigt und nicht die Adresse des eigentlichen Linkziels. Dies macht sich besonders gut bei leichen Änderungen an Wörtern, die nicht extra eine [[Hilfe:Begriffsklärung|Begriffsklärung]] benötigen
+
*The address of the linked article does not have to match the wording of the link! Simply put a vertical line <code><nowiki>|</nowiki></code> after the link address and write an additional text between the vertical line and the closing square brackts. This way the additional text will be displayed instead of the actual link.
[[Hauptseite]]
+
 
 
{| border="1" style="border-collapse:collapse; background-color:#FFFFFF;"  
 
{| border="1" style="border-collapse:collapse; background-color:#FFFFFF;"  
! Link im Artikel
+
! Link in the article
! Link in der Syntax
+
! Link in the syntax
! Ergebniss-Beschreibung
+
! Description of the result
 
|-
 
|-
|[[Hauptseite]]
+
|[[Main Page]]
|<nowiki>[[Hauptseite]]</nowiki>
+
|<nowiki>[[Main Page]]</nowiki>
|Normaler interner Link
+
|This is a normal internal link.
 
|-
 
|-
|[[Hauptseite|Das Wiki von SureAI]]
+
|[[Main Page|The ain page of the Wiki]]
|<nowiki>[[Hauptseite|Das Wiki von SureAI]]</nowiki>
+
|<nowiki>[[Main Page|The ain page of the Wiki]]</nowiki>
|<nowiki>Neue Beschreibung des Links mit einem senkrechten Strich "|" getrennt</nowiki>
+
|The new desciption is separated from the link by the vertical line "|",
 
|}
 
|}
  
  
 
==External Links==
 
==External Links==
Die Syntax bietet Möglichkeiten Links auf externe Seiten verschieden anzeigen zu lassen.
+
It is possible to link to external page. Like internal links, they can be used differently.
*Man kann einefach einen rohen Link aus dem Browser in den Artikel kopieren
+
*You can simply put a normal URL from your browser into an article
*Die Linkadresse mit eckigen Klammern "[]" umgeben um besonders lange externe Links auf ein Thumbnail zu verkürzen
+
*The adress can be surrounded by a single pair of square brackts <code><nowiki>[]</nowiki></code> to shorten the link to a thumbnail
*Den gekennzeichneten externen Link benennen, indem man einen Text, durch ein Leerzeichen getrennt von der Linkadresse einfügt
+
*The thumbnail can be customized by putting a space behind the link and then write the description/thumbnail of the link yourself.
 
{| border="1" style="border-collapse:collapse;  background-color:#FFFFFF"  
 
{| border="1" style="border-collapse:collapse;  background-color:#FFFFFF"  
! Link im Artikel
+
! Link in the article
! Link in der Syntax
+
! Link in the syntax
! Ergebniss-Beschreibung
+
! Description of the result
 
|-
 
|-
|http://www.sureai.de/wiki/index.php/Hauptseite
+
|https://www.sureai.de/wiki/index.php/Main_Page
|<nowiki>http://www.sureai.de/wiki/index.php/Hauptseite</nowiki>
+
|<nowiki>https://www.sureai.de/wiki/index.php/Main_Page</nowiki>
|Hier wurde der externe Link nur aus dem Browser in den Artikel kopiert
+
|The link was simply copied directly from the browser
 
|-
 
|-
|[http://www.sureai.de/wiki/index.php/Hauptseite]
+
|[https://www.sureai.de/wiki/index.php/Main_Page]
|<nowiki>[http://www.sureai.de/wiki/index.php/Hauptseite]</nowiki>
+
|<nowiki>[https://www.sureai.de/wiki/index.php/Main_Page]</nowiki>
|<nowiki>Hier ist der externe Link als solcher für die Syntax
+
|The external link is shortened to a thumbnail
mit zwei eckigen Klammern "[[]]" gekennzeichnet</nowiki>
+
 
|-
 
|-
|[http://www.sureai.de/wiki/index.php/Hauptseite SureAI Hauptseite]
+
|[https://www.sureai.de/wiki/index.php/Main_Page SureAI main page]
|<nowiki>[http://www.sureai.de/wiki/index.php/Hauptseite SureAI Hauptseite]</nowiki>
+
|<nowiki>[https://www.sureai.de/wiki/index.php/Main_Page SureAI main page]</nowiki>
|<nowiki>Ein gekennzeichneter externer Link kann auch benannt werden, man muss nur die Benennung,
+
|The shortened thumbnail is customized
mit einem Leerzeichen getrennt, hinter die Linkadresse setzen</nowiki>
+
 
|}
 
|}
 +
 
[[Category:Help]]
 
[[Category:Help]]

Latest revision as of 09:18, 28 June 2017

< Help
SureaiLogo2016.png
Stub
The following page or section is still a stub and is incomplete.


This page provides guidelines and guidance where links should be used within an article, which types of links are possible with the Wiki syntax and how these can look.

Links in the SureAI Wiki

Most links in the SureAI Wiki have a peculiarity in contrast to other links used in other wikis in which the linked article names are simply placed between two square brackets: the Namespace.

There are already five different projects from SureAI. Many terms are used in several of these projects (eg "skills", "creatures", "alchemy", "goblin" etc.), but they have quite different characteristics and meanings in the individual projects. Therefore every article needs an additional name space with a double point, which shows the project for the respective article:

  • Myar:
  • Arktwend:
  • Nehrim:
  • Enderal:
  • Cube:

As in every wiki, there are also other, fixed namespaces, for example, all help articles are located in the namespace Help: or every image in the namespace File:.

There is also the main namespace in which every project lays, the namespace without any prefix. There are only nine articles - the portal sites towards the repsective the projects. No other articles should be added to this main namespace. So if you want to include a link to an article, you always have to prepend the correct namespace. A link towards an article about the NPC "Finn Dalires" should not look like this: [[Finn]], but like this: [[Enderal:Finn|]]. Important is the vertical line after the article name (|), which is meant to seperate the readable text from the actual link, so the link will be displayed without the namespace prefix. The | should only be used if the link shown should be different from the actual article name because of grammar or formulation, otherwise this will be done by the Wiki software automatically.

If you leave out the vertical line, the namespace will be displayed within the link which which is bad for readability in articles.

Some simple examples:

Wiki syntax of the link in the source code Visible result on the page
[[Enderal:Finn|]] is gathering herbs at the suncoast. Finn is gathering herbs at the suncoast.
[[Enderal:Finn|Finn]] is gathering herbs at the suncoast. Finn is gathering herbs at the suncoast.
[[Enderal:Finn|Finn's]] task is to gather herbs at the suncoast. Finn's task is to gather herbs at the suncoast.
If you leave the abandoned tower at the suncoast, [[Enderal:Finn|one of the apothecarii]] wants talk to you. If you leave the abandoned tower at the suncoast, one of the apothecarii wants talk to you.
Hey [[User:Tilliboy|]], could you please help my formatting the article of [[Enderal:Finn]]? Hey Tilliboy, could you please help my formatting the article of Enderal:Finn?

The Breadcrumb navigation

Every article in the SureAI Wiki should get a linking path in the upper left corner, which shows how it is arranged in the systematics of the wiki: a so-called Breadcrumb navigation.

At the moment there are many different methods of navigations links in the Wiki, especially links like "back to ..." (e.g. at the End of a Enderal quest article "back to [[Enderal:Quests|Quests]"). Those links should be replaced by Breadcrumbs. You never know how a user gets to the article. There are many links within the wiki and you can also easily come across a search engine for the article, so the phrase "back to" is unfitting.

To make it easier to use breadcrumb navigation we've already have a template Breadcrumb which should be used on every site. If the formatting of the navigation should be changed at one point, this can be achieved by simply changing the template on all pages.

The Breadcrumb of all articles shall eventually point towards the big portal sites of the individual SureAI projects (Enderal, Nehrim, Arktwend, Myar Aranath, Cube Experimental).

If an article is located directly "under" a portal page in the system, it is easy to install the {{breadcrumb}} template at the top of the article. The portal page of the respective name space is automatically recognized and displayed:

Used on these sites for example Wiki syntax in the source code Visible result at the top left of the page
Enderal:NPCs {{breadcrumb}} < Enderal
Enderal:Quests {{breadcrumb}} < Enderal


If you want to inlcude a Breadcrumb in an article which is "under" these just mentioned articles, you only have to add the link to the parent page, separated by a vertical line (|), the so-called "pipe":

Used on these sites for example Wiki syntax in the source code Visible result at the top left of the page
Enderal:Finn {{breadcrumb|[[Enderal:NPCs|People]]}} < Enderal < People
Enderal:Main_Quest {{breadcrumb|[[Enderal:Quests|]]}} < Enderal < Quests


If you want to go a level deeper, simply expand the Breadcrumb accordingly. You have to insert the < character yourself:

Used on these sites for example Wiki syntax in the source code Visible result at the top left of the page
Enderal:A_Nice_Day_in_Summer {{breadcrumb|[[Enderal|Quests|]] < [[Enderal:Main_Quest|Main Quest]]}} < Enderal < Quests < Main Quest


Directives

  • If a term is used more than once in a text, it should be linked at the first occurrence only. For longer texts (e.g. All the Dead Souls), which are not necessarily meant to be read from top to bottom, each section should be readable and understandable. That means each section should contain all necessary links.
  • When writing a new article, it is recommended to link it to as many other articles as possible, so that it can also be found by interested users
  • If an article is not linked internally, it will be included in the Dead-End pages
  • Internal links to non-existent articles can be created as a precaution if one considers that this term deserves its own article (non-existent link destinations are displayed red instead of white)
  • If it is not possible to include an important term in the text as a link, it should be referred to at the end of the article
  • Between headings should not contain links
  • Links to paragraphs in another article, thus to the between headings, are also possible. E.g. a link to a between heading on the main page Character; Looking like this [[Enderal#Character|Character]]

Internal Links (Wikilinks)

Words which link to internal Wiki pages are so called "Internal Links". They can be used with two square bracket [[]] surrounding the address.

  • The address of the linked article does not have to match the wording of the link! Simply put a vertical line | after the link address and write an additional text between the vertical line and the closing square brackts. This way the additional text will be displayed instead of the actual link.
Link in the article Link in the syntax Description of the result
Main Page [[Main Page]] This is a normal internal link.
The ain page of the Wiki [[Main Page|The ain page of the Wiki]] ",


External Links

It is possible to link to external page. Like internal links, they can be used differently.

  • You can simply put a normal URL from your browser into an article
  • The adress can be surrounded by a single pair of square brackts [] to shorten the link to a thumbnail
  • The thumbnail can be customized by putting a space behind the link and then write the description/thumbnail of the link yourself.
Link in the article Link in the syntax Description of the result
https://www.sureai.de/wiki/index.php/Main_Page https://www.sureai.de/wiki/index.php/Main_Page The link was simply copied directly from the browser
[1] [https://www.sureai.de/wiki/index.php/Main_Page] The external link is shortened to a thumbnail
SureAI main page [https://www.sureai.de/wiki/index.php/Main_Page SureAI main page] The shortened thumbnail is customized