Difference between revisions of "Help:Anchors: creating and referencing"

From selfstudy
(New page: {{Template:Anchor}})
 
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Template:Anchor}}
+
__NOTOC__
 +
Anchors allow you to link to a specific portion of a page.
 +
 
 +
==Setting anchors==
 +
===Automatic anchors===
 +
Section headings automatically act as anchors, with the heading text as the "anchor_name".  In the case of multiple sections with identical headings, the anchor name of each has "_2", "_3", etc. appended, starting from the second occurrence.
 +
 
 +
===Using the <nowiki>{{anchor}}</nowiki> template===
 +
#set your anchor anywhere in the page by using
 +
<pre>{{anchor|your_anchorname}}</pre>
 +
 
 +
===Manual anchors===
 +
Manually-set anchors are useful for linking to "unlinkable" things like a table (title or cell), a section of plain text, etc. 
 +
There are a number of ways to set an anchor at an arbitrary position:
 +
 
 +
* Generic anchor: <code><nowiki><span id="anchor_name">some text</span></nowiki></code>.  For a hidden anchor, omit the text.
 +
 
 +
* The reserved name <code><nowiki>[[#top]]</nowiki></code> always links to the [[#top|top of a page]].
 +
 
 +
* On some wikis, a template called "anchor" exists, providing a simple, standardized method for that wiki. The Self Study wiki does use [[Template:Anchor]].
 +
 
 +
==Referencing anchors==
 +
Inside a regular wiki link <nowiki>[[page#anchor_name|shows_as]]</nowiki>, include the hash sign (#) and the header name or the id tag name as you have written it.
 +
 
 +
Links of the form <code><nowiki>[[#anchor_name]]</nowiki></code> will link to the first anchor on the page matching that "anchor_name", usually the first identical section heading.
 +
 
 +
;See also
 +
*http://meta.wikimedia.org/wiki/Help:Link#Anchors

Latest revision as of 11:13, 26 February 2008

Anchors allow you to link to a specific portion of a page.

Setting anchors

Automatic anchors

Section headings automatically act as anchors, with the heading text as the "anchor_name". In the case of multiple sections with identical headings, the anchor name of each has "_2", "_3", etc. appended, starting from the second occurrence.

Using the {{anchor}} template

  1. set your anchor anywhere in the page by using
{{anchor|your_anchorname}}

Manual anchors

Manually-set anchors are useful for linking to "unlinkable" things like a table (title or cell), a section of plain text, etc. There are a number of ways to set an anchor at an arbitrary position:

  • Generic anchor: <span id="anchor_name">some text</span>. For a hidden anchor, omit the text.
  • On some wikis, a template called "anchor" exists, providing a simple, standardized method for that wiki. The Self Study wiki does use Template:Anchor.

Referencing anchors

Inside a regular wiki link [[page#anchor_name|shows_as]], include the hash sign (#) and the header name or the id tag name as you have written it.

Links of the form [[#anchor_name]] will link to the first anchor on the page matching that "anchor_name", usually the first identical section heading.

See also