Difference between revisions of "Help:Linking within wiki articles"

From COLLADA Public Wiki
Jump to navigation Jump to search
(lots of linking info)
 
(change subheads to example/results)
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
{{HelpTOC}}
 
A '''Wiki link''' is an easily formatted link to other articles within the wiki or external to the wiki site.
 
A '''Wiki link''' is an easily formatted link to other articles within the wiki or external to the wiki site.
  
 +
==Examples==
 
You can either use  the name of an article as a link, or you can pipe the link so that text appears that is different from the article's title.  Links to external sites are formatted--and appear--slightly differently.
 
You can either use  the name of an article as a link, or you can pipe the link so that text appears that is different from the article's title.  Links to external sites are formatted--and appear--slightly differently.
  
 +
===Main namespace articles===
 
{|
 
{|
 
|-
 
|-
!Link format
+
!width=25%|
!Looks like
+
!Example
 +
!Results
 
|-
 
|-
|<nowiki>[[wiki]]</nowiki>
+
|Basic link to article title (see capitalization info below).
 +
|
 +
<nowiki>[[wiki]]</nowiki>
 
|[[wiki]]
 
|[[wiki]]
 
|-
 
|-
|<nowiki>[[wiki]]s</nowiki>
+
|Plurals and other suffixes adjacent to the link display as part of the link.
 +
|
 +
<nowiki>[[wiki]]s</nowiki>
 
|[[wiki]]s
 
|[[wiki]]s
 
|-
 
|-
|<nowiki>[[wiki|some wiki software]]</nowiki>
+
|Adjacent suffixes display as part of the link, but not prefixes.
 +
|
 +
<nowiki>re[[wiki]]fication</nowiki>
 +
|re[[wiki]]fication
 +
|-
 +
|Piping: Display the text after the vertical bar as the link text.
 +
|
 +
<nowiki>[[wiki|some wiki software]]</nowiki>
 
|[[wiki|some wiki software]]
 
|[[wiki|some wiki software]]
 +
|}
 +
 +
===Other namespace articles===
 +
{|
 +
|-
 +
!width=25%|
 +
!Example
 +
!Results
 +
|-
 +
|Full [[namespace]] title displayed as link.
 +
|
 +
<nowiki>[[Help:Adding an article]]</nowiki>
 +
|[[Help:Adding an article]]
 +
|-
 +
|Shortcut to suppress [[namespace]] when displaying link.
 +
|
 +
<nowiki>[[Help:Adding an article|]]</nowiki>
 +
|[[Help:Adding an article|Adding a new article]]
 +
|}
 +
 +
===Subheadings within articles===
 +
{|
 +
|-
 +
!width=25%|
 +
!Example
 +
!Results
 +
|-
 +
|Use HTML notation for a named link within a document; the subheading of the article is the link. (You do not need to encode spaces or special characters.)
 +
|
 +
<nowiki>[[Softimage XSI extensions#<light> extra]]</nowiki>
 +
|[[Softimage XSI extensions#<light> extra]]
 +
|}
 +
 +
===URLs===
 +
{|
 +
|-
 +
!width=25%|
 +
!Example
 +
!Results
 
|-
 
|-
|<nowiki>http://www.collada.org</nowiki>
+
|URL displayed as link ("external link" icon appears automatically for all URL links).
 +
|
 +
<nowiki>http://www.collada.org</nowiki>
 
|http://www.collada.org
 
|http://www.collada.org
 
|-
 
|-
|<nowiki>[http://www.collada.org]</nowiki>
+
|URL displayed as automatically incremented number; particularly useful for references within an article.
|[http://www.collada.org]
+
|
 +
<nowiki>[http://www.collada.org]</nowiki><BR><nowiki>[http://www.khronos.org]</nowiki>
 +
|[http://www.collada.org]<BR>[http://www.khronos.org]
 
|-
 
|-
|<nowiki>[http://www.collada.org Collada web site]</nowiki>
+
|Text following URL displayed as link.
 +
|
 +
<nowiki>[http://www.collada.org Collada web site]</nowiki>
 
|[http://www.collada.org Collada web site]
 
|[http://www.collada.org Collada web site]
 
|}
 
|}
  
 +
==Capitalization==
 +
The wiki software is somewhat sensitive to capitalization:
 +
* To make it easier to use article titles in sentences, the ''first'' character of a title is ''not'' case sensitive; for example, [[wiki]] and [[Wiki]] go to the same article; so do [[runtime database]] and [[Runtime database]].
 +
* The rest of the letters ''are'' case sensitive. For example, [[COLLADA]] and [[coLLada]] do ''not'' go to the same article; neither do [[runtime database]] and [[Runtime Database]].
  
[[Category:Help]][[Category:Wiki terminology]]
+
[[Category:Help|Linking within wiki articles]][[Category:Wiki terminology]]

Latest revision as of 01:28, 20 July 2011

Help
Wiki

About (overview)
Search
FAQ
Help

Navigation

Portals
Categories
Searching

Editing

Basic editing
Article names
Adding article
Formatting
Linking
Tables
Redirects
Deleting
Copying
Images

Policies and guidelines

Standard article layout
Review edits, spam
Bugs

COLLADA

FAQ
Tutorials

A Wiki link is an easily formatted link to other articles within the wiki or external to the wiki site.

Examples

You can either use the name of an article as a link, or you can pipe the link so that text appears that is different from the article's title. Links to external sites are formatted--and appear--slightly differently.

Main namespace articles

Example Results
Basic link to article title (see capitalization info below).
[[wiki]]
wiki
Plurals and other suffixes adjacent to the link display as part of the link.
[[wiki]]s
wikis
Adjacent suffixes display as part of the link, but not prefixes.
re[[wiki]]fication
rewikification
Piping: Display the text after the vertical bar as the link text.
[[wiki|some wiki software]]
some wiki software

Other namespace articles

Example Results
Full namespace title displayed as link.
[[Help:Adding an article]]
Help:Adding an article
Shortcut to suppress namespace when displaying link.
[[Help:Adding an article|]]
Adding a new article

Subheadings within articles

Example Results
Use HTML notation for a named link within a document; the subheading of the article is the link. (You do not need to encode spaces or special characters.)
[[Softimage XSI extensions#<light> extra]]
Softimage XSI extensions#<light> extra

URLs

Example Results
URL displayed as link ("external link" icon appears automatically for all URL links).
http://www.collada.org
http://www.collada.org
URL displayed as automatically incremented number; particularly useful for references within an article.
[http://www.collada.org]
[http://www.khronos.org]
[1]
[2]
Text following URL displayed as link.
[http://www.collada.org Collada web site]
Collada web site

Capitalization

The wiki software is somewhat sensitive to capitalization: