This is an archive copy of wikilivres.ca as of 18 February 2017 (from the WikiTeam dump). The original site is closed.

Template:Anchor/documentation: Difference between revisions

Free texts and images.
Jump to navigation Jump to search
← Older editNewer edit →

imported>Fullstop

imported>Locos epraix
fixing link
imported>Fullstop
fix errors, cleanup and tersify
Line 5: Line 5:
{{TOCright}}
{{TOCright}}
==Usage==
==Usage==
'''<nowiki>{{</nowiki>[[{{ns:Template}}:{{BASEPAGENAME}}|{{BASEPAGENAME}}]]<nowiki>}}</nowiki>''' or its plural alias '''<nowiki>{{</nowiki>{{BASEPAGENAME}}s<nowiki>}}</nowiki>''' will insert one or more [[HTML element#Anchor|HTML anchor]]s in a page at the location of its invocation, enabling direct #Links to this location.{{#ifeq:{{BASEPAGENAME}}|Visible anchor|&nbsp;Unlike {{tl|Anchor}} and {{tl|Anchors}}, the first parameter will be visible text on the page. See the "{{Here|Usage details}}" section for an example.|}}
===Description===
The templates <nowiki>{{</nowiki>[[{{ns:Template}}:{{BASEPAGENAME}}|{{lc:{{BASEPAGENAME}}}}]]<nowiki>}}</nowiki> and <nowiki>{{</nowiki>{{lc:{{BASEPAGENAME}}}}s<nowiki>}}</nowiki> insert one or more [[HTML element#Anchor|HTML anchor]]s in a page. Those locations can then be linked to using <code><nowiki>[[#link|...]]</nowiki></code> syntax. {{#ifeq:{{BASEPAGENAME}}|Visible anchor|&nbsp;Unlike {{tl|Anchor}} and {{tl|Anchors}}, the first parameter will be visible text on the page. See the "{{Here|Usage details}}" section for an example.|}}


===Linking===
===Examples===
After that, you can have links sending directly to the line you marked:


* With <code><nowiki>[[#Bar & Baz|link label]]</nowiki></code> or also assuming use of "link label in {{#ifeq:{{BASEPAGENAME}}|Anchor|an|a}} <nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki>, then {{tlx|Here|link label}} or {{tlx|Here|link label|inline text}} when linking from the same page
1. <code style="color:green;"><nowiki>{{</nowiki>{{lc:{{BASEPAGENAME}}}}|foo<nowiki>}}</nowiki></code>
* With <code><nowiki>[[Article name#Bar & Baz|link label]]</nowiki></code> or <code>{{tlx|sl|Article name|link label}} or {{tlx|sl|Article name|link label|inline text}}</code> when linking from another page.
: could be linked to with <tt><nowiki>[[#foo|...]]</nowiki></tt> from within the same article,
: or it could be linked to with <tt><nowiki>[[</nowiki>''<small>articlename</small>''#foo|...<nowiki>]]</nowiki></tt> from other articles and from redirects.


===Usage details===
2. Anchors can be more suitable for inter-article linking than section titles are. For example,
; Code  : <code><nowiki>Before{{</nowiki>{{BASEPAGENAME}}s<nowiki>|Foo|Bar & Baz|Three}}After</nowiki></code><br />
:<code style="color:gray;"><nowiki>==Section title==</nowiki></code>
:<code style="color:green;"><nowiki>{{</nowiki>{{lc:{{BASEPAGENAME}}}}|foo<nowiki>}}</nowiki></code>
:Here, links via <tt><nowiki>[[</nowiki>''<small>articlename</small>''#foo<nowiki>]]</nowiki></tt> would remain valid even if the section were renamed.


; Gives : Before{{#ifeq:{{BASEPAGENAME}}|Visible anchor|{{Visible anchors|Foo|Bar & Baz|Three}}|{{Anchors|Foo|Bar & Baz|Three}}}}After<br />{{#ifeq:{{BASEPAGENAME}}|Anchor|
3. The template can be used to create up to ten anchors with a single call. For example,
: <code style="color:green;"><nowiki>{{</nowiki>{{lc:{{BASEPAGENAME}}}}|foo|bar|baz<nowiki>}}</nowiki></code>
:will create three anchors that can then be linked to with <tt><nowiki>[[#foo]]</nowiki></tt>, <tt><nowiki>[[#bar]]</nowiki></tt> and <tt><nowiki>[[#baz]]</nowiki></tt>.
:Specifying more than 10 anchors will cause an error message to be displayed.


The template also works for adding aliases directly inside a heading.<br/>
===Limitations===
 
* Anchor names that contain [[Number sign|&#35;]] (hash), [[Vertical_bar|&#124;]] (pipe), [[Equals sign|&#61;]] (equal) will not work as expected. Most other characters, including white space and punctuation are not a problem.
; Code  : <code><nowiki>===Notes{{Anchors|Notes|Details}}===</nowiki></code>
* Anchors cannot be placed in the middle of other wiki syntax. For example, <code style="color:green;"><nowiki>==Heading{{</nowiki>{{lc:{{BASEPAGENAME}}}}|foo<nowiki>}}==</nowiki></code> will not work.  
; Gives : ''(see heading below)''|}}
* The template can create a maximum of 10 anchors. Specifying more than 10 anchors will result in an error message.
 
* Care should be taken to ensure that names are on a single line: For example,  
===Notes {{Anchors|Notes|Details}}===
:<code style="color:green;"><nowiki>{{</nowiki>{{lc:{{BASEPAGENAME}}}}
* The template will handle up to 10 anchor names, but could very easily be extended to do twice as many or more. If you accidentally use more than 10 anchors, the template will output an error message like this: {{#ifeq:{{BASEPAGENAME}}|Visible anchor|{{Visible anchors|1|2|3|4|5|6|7|8|9|10|11}}|{{Anchors|1|2|3|4|5|6|7|8|9|10|11}}}} This will let you know about it instead of having your extra anchors silently ignored.
:|humpty<br />dumpty<nowiki>}}</nowiki></code>  
* When used to add anchors to a paragraph of prose, it is preferable to put the template at the very start of the paragraph (stuck to the first word, without space) so as to ensure that incoming #Links will result in the full paragraph being displayed on the reader's screen.{{#ifeq:{{BASEPAGENAME}}|Anchor|
:will probably not work as expected.
* You can add anchors aliases to a heading by using a syntax such as:
* Anchor names should be unique (with respect to all heading titles and additional anchors) on each page; multiple anchors won't work as expected since the #links will always go to the first anchor with that name.
 
* Unlike section headings, anchors may not work on some (very old) browsers. This is because section headings are tagged with the more backward-compatible <code><nowiki><a name="heading" id="heading"></a></nowiki></code>. Such tagging cannot be achieved with templates.
<pre>
==Heading title {{Anchors|Foo|Bar & Baz}}==
</pre>
 
: This results in "#Foo" and "#Bar & Baz" being alias targets of "#Heading title" which may be subject to change. Anchors are a way to keep links "healthy" despite such local changes. This syntax doesn't alter the heading, which remains a regular heading as functional as if the template wasn't inserted (i.e. still appears in the page's TOC, and section editing works as usual). This method is advantageous in that you can always see the anchors list when editing this section only, and they work exactly like the heading's own regular anchor. (This is not the case when the anchors are added one line above or below the heading.
:* It is better however to add anchors after the heading on the next line, for the anchors in a section title echo inside any section edit summary and work just as well.{{dubious|After-heading trick does not quite work}}
 
<pre>
==Heading title==
{{Anchors|Foo|Bar & Baz}}
<!-- this blank line recommended, the browser will then position
      vertically aligned to the heading -->
Next text line...
</pre>
* Inside a heading, inserting the anchor code before or after the actual heading title works mostly the same. Putting it before the heading makes it work more like an actual heading anchor in more web browsers, but putting it after the heading makes the regular heading more readable and easy to find. Having a space between the template and the heading title is inconsequential, but adding a space keeps it more readable, but does impact the length of section edit titles.<br/><br/>
* Even when you have many long aliases, you need to keep the heading and its embedded anchors on a single line (which may be very long and wrap), as its own single paragraph. Trying to use a vertical format for the template would give all the appearances of working, including section numbering, but actually trying to edit the section results in editing the next section instead, due to a bug. So, in headings, do not use here a vertical format such as:
 
<pre style="background-color:#FDD">
==George Walker Bush {{Anchors
| George W. Bush
| George Bush | Bush
| Dubya
}}==
</pre>|}}
 
* Though aliases <nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki> and <nowiki>{{</nowiki>{{BASEPAGENAME}}s<nowiki>}}</nowiki> will work interchangeably, it is preferable to use the singular alias for a single anchor, and the plural alias for multiple anchors. This will allow [[Special:WhatLinksHere/Template:{{BASEPAGENAME}}s]] to track usage of multiple anchors, and could help detecting and converting old-style <code><nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>|Foo}}{{</nowiki>{{BASEPAGENAME}}<nowiki>|Bar}}</nowiki></code> to <code><nowiki>{{</nowiki>{{BASEPAGENAME}}s<nowiki>|Foo|Bar}}</nowiki></code>. So for maintenance needs, we'd appreciate you maintain the suggested convention.
 
==Known bug==
 
* Currently{{#ifeq:{{BASEPAGENAME}}|Anchor|, as noted above|}}, the anchor code is included in a section-edit summary. For instance, section-editing the "Notes" section of this page will pre-fill your edit summary with:
:: {{Inputbox|<nowiki>/* Notes {{</nowiki>{{BASEPAGENAME}}s<nowiki>|Notes|Details}} */</nowiki>}}
: This is inconsequential for your edit, but can be inconvenient for your edit summary when there are many long anchor names. You can however edit it out to just:
:: {{Inputbox|/* Notes */... ''your normal thorough edit summary''}}
: This bug can't be helped in the template itself. It ''is hoped'', not promised, that a future version of the MediaWiki software will skip template calls in headings for section-edit summaries{{#ifeq:{{BASEPAGENAME}}|Anchor|.
 
==Tips==
 
* When you make a link from article A to article B#Heading, you can preemptively edit article B from
:: <code><nowiki>==Heading==</nowiki></code>
: To:
:: <code><nowiki>==Heading {{Anchor|Heading}}==</nowiki></code>
: (Note the singular "Anchor" here.) This will ensure the perennity of any link to #Heading, regardless of how the actual heading may be changed in the future. Since you can't expect other editors to mind your target anchors, this solution is more efficient and proactive than just adding an HTML comment "this heading is linked from article A" next to the heading. ''Such a comment is still a [[Good Thing|good idea]] though&mdash;most editors will have no clue as to what an <nowiki>{{Anchor}}</nowiki> is or does. The comment makes the link existence, dependency, and need plain.
* Similarly, when you add an anchor alias to a heading, you can preemptively add a copy-paste of the current heading's title along with your new anchor. For instance, for adding a "#Regions" anchor to this heading:
:: <code><nowiki>==Current division==</nowiki></code>
: You would make it:
:: <code><nowiki>==Current division {{Anchors|Current division|Regions}}==</nowiki></code>
: (Note the plural "Anchors" here.) This too will ensure the longevity of both "#Current division" and "#Regions", regardless of other editors' future edits on the heading.|.}}
 
==Anchor names==
 
* Due to technical limitations, anchor names can not include characters "#" (hash), "&#124;" (pipe) or "&#61;" (equal). On the other hand, special characters such as " " (space), "," (comma), "&" (ampersand), etc. can be used directly both in anchors and links, because the software will process them automatically into a URL-compatible format.
* Anchor names should preferably be written in "Sentence case" (as is the [[WP:MOSHEAD|standard for headings]] and thus their anchors); that is, capitalize the first letter of the first word and any proper nouns, but leave the rest lowercase. Examples: "The title of my anchor", "The anchor from Ipanema", etc. Because some browsers have case-sensitive anchors, the anchor name used in a #Link should be absolutely identical to its target (rather than all-lowercase).
* Anchor names should be unique (with respect to all heading titles and additional anchors) on each page; a duplicate anchor won't work since the #Links will always go to the first homonymous anchor on the page.
 
==Technical==
 
* The more backward-compatible <code><nowiki><a name="anchor" id="anchor"></a></nowiki></code> is used by Wikipedia's own headings but disabled for editors in the wikicode and thus not used here.


==See also==
==See also==

Revision as of 23:37, 19 August 2009

Template:TOCright

Usage

Description

The templates {{anchor}} and {{anchors}} insert one or more HTML anchors in a page. Those locations can then be linked to using [[#link|...]] syntax.

Examples

1. {{anchor|foo}}

could be linked to with [[#foo|...]] from within the same article,
or it could be linked to with [[articlename#foo|...]] from other articles and from redirects.

2. Anchors can be more suitable for inter-article linking than section titles are. For example,

==Section title==
{{anchor|foo}}
Here, links via [[articlename#foo]] would remain valid even if the section were renamed.

3. The template can be used to create up to ten anchors with a single call. For example,

{{anchor|foo|bar|baz}}
will create three anchors that can then be linked to with [[#foo]], [[#bar]] and [[#baz]].
Specifying more than 10 anchors will cause an error message to be displayed.

Limitations

  • Anchor names that contain # (hash), | (pipe), = (equal) will not work as expected. Most other characters, including white space and punctuation are not a problem.
  • Anchors cannot be placed in the middle of other wiki syntax. For example, ==Heading{{anchor|foo}}== will not work.
  • The template can create a maximum of 10 anchors. Specifying more than 10 anchors will result in an error message.
  • Care should be taken to ensure that names are on a single line: For example,
{{anchor
|humpty
dumpty}}
will probably not work as expected.
  • Anchor names should be unique (with respect to all heading titles and additional anchors) on each page; multiple anchors won't work as expected since the #links will always go to the first anchor with that name.
  • Unlike section headings, anchors may not work on some (very old) browsers. This is because section headings are tagged with the more backward-compatible <a name="heading" id="heading"></a>. Such tagging cannot be achieved with templates.

See also


Retrieved from "https://ca.wikilivres.ru/index.php?title=Template:Anchor/documentation&oldid=75144"