8,288
edits
Changes
→Usage
<includeonly><span id="{{{1}}}"></span></includeonly><noinclude>[[Category:Template]]
This template is used to create an anchor without requiring a specific (sub) section header to be made.
The main purpose is to allow the translation of links without interfering in the translation of content. The most usual 'problem' arising when translating is that some section titles are much less immutable than the original. For example, in the [[HIG]] there's the concept of [[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor#Home|Home]]. The word itself may have several possible translations in a given language, and one may be prefered to others but may not have been the 'initial' choosing. In later revisions, the header could be changed for a ''better wording'', but then all the links pointing to it would be broken. The solution is to use this template as the ''anchor'' for the original language header.
; Example : In a page you are translating there's the following link:
<nowiki>[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor#Home]]</nowiki> # Original link
OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx # Translated page
<nowiki>[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx#Home]]</nowiki> # Translated link
: The linking of translated pages (and their sections) can be done regardless of how the ''Home'' section header was translated — in [[spanish]] it could be translated as either ''[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home|Hogar]]'' or ''[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home|Casa]]''—both actually linking to the ''anchor'' [[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home|#Home]] and will both work.
: It's also possible to link the translated terms ''[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Hogar|#Hogar]]'' or ''[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Casa|#Casa]]''—but in this case, one of them will not work.
== Usage ==
ORIGINAL PAGE TRANSLATED PAGE REVISED TRANSLATION<nowiki>
{{Anchor|Home}} {{Anchor|Home}}</nowiki>
== Home == == Hogar == == Casa ==
'''NOTE:''' the <tt><nowiki>{{Anchor|original header}}</nowiki></tt> must be in the '''previous''' line. Reason for this is that if placed below, when 'jumping' to it, the header will 'lost' (because it's above). The downside of this is that while editing a section, you can't manipulate it because it 'belongs' to the previous section.
Its use is '''discouraged''' outside the context of [[translating]] pages. If used outside that context, it is recommended to be used only within the same page (no inter-page linking using ''hidden anchors'').
If the purpose is to avoid having a <tt><nowiki>__TOC__</nowiki></tt> too deep, we should consider other solutions (heard about a <tt><nowiki>{{TOClevel|n}}</nowiki></tt> to limit the depth shown.
== History & Credits ==
The concept of ''anchor'' is essential to hypertext. The adaptation of using <tt><div id="original header"/></tt> (a ruthless hack) was done by [[User:Xavi|Xavi]] after discovering that the <tt><a></tt> is not allowed. That solution broke down after an update of the wiki. The solution was to switch to an html compliant <tt><div id="original header"></div></tt>. If the anchor had been originally reified (instead of manually embeding it in the wiki text) a simple update of the [[Template:Anchor]] would've solved the problem.
So now, this is part of a (hopefully) better solution — suggestion by [[User:MitchellNCharity|MitchellNCharity]].
</noinclude>
This template is used to create an anchor without requiring a specific (sub) section header to be made.
The main purpose is to allow the translation of links without interfering in the translation of content. The most usual 'problem' arising when translating is that some section titles are much less immutable than the original. For example, in the [[HIG]] there's the concept of [[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor#Home|Home]]. The word itself may have several possible translations in a given language, and one may be prefered to others but may not have been the 'initial' choosing. In later revisions, the header could be changed for a ''better wording'', but then all the links pointing to it would be broken. The solution is to use this template as the ''anchor'' for the original language header.
; Example : In a page you are translating there's the following link:
<nowiki>[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor#Home]]</nowiki> # Original link
OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx # Translated page
<nowiki>[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx#Home]]</nowiki> # Translated link
: The linking of translated pages (and their sections) can be done regardless of how the ''Home'' section header was translated — in [[spanish]] it could be translated as either ''[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home|Hogar]]'' or ''[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home|Casa]]''—both actually linking to the ''anchor'' [[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home|#Home]] and will both work.
: It's also possible to link the translated terms ''[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Hogar|#Hogar]]'' or ''[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Casa|#Casa]]''—but in this case, one of them will not work.
== Usage ==
ORIGINAL PAGE TRANSLATED PAGE REVISED TRANSLATION<nowiki>
{{Anchor|Home}} {{Anchor|Home}}</nowiki>
== Home == == Hogar == == Casa ==
'''NOTE:''' the <tt><nowiki>{{Anchor|original header}}</nowiki></tt> must be in the '''previous''' line. Reason for this is that if placed below, when 'jumping' to it, the header will 'lost' (because it's above). The downside of this is that while editing a section, you can't manipulate it because it 'belongs' to the previous section.
Its use is '''discouraged''' outside the context of [[translating]] pages. If used outside that context, it is recommended to be used only within the same page (no inter-page linking using ''hidden anchors'').
If the purpose is to avoid having a <tt><nowiki>__TOC__</nowiki></tt> too deep, we should consider other solutions (heard about a <tt><nowiki>{{TOClevel|n}}</nowiki></tt> to limit the depth shown.
== History & Credits ==
The concept of ''anchor'' is essential to hypertext. The adaptation of using <tt><div id="original header"/></tt> (a ruthless hack) was done by [[User:Xavi|Xavi]] after discovering that the <tt><a></tt> is not allowed. That solution broke down after an update of the wiki. The solution was to switch to an html compliant <tt><div id="original header"></div></tt>. If the anchor had been originally reified (instead of manually embeding it in the wiki text) a simple update of the [[Template:Anchor]] would've solved the problem.
So now, this is part of a (hopefully) better solution — suggestion by [[User:MitchellNCharity|MitchellNCharity]].
</noinclude>