Template:Anchor - Revision history

FGrose at 16:37, 11 July 2009

2009-07-11T16:37:46Z

Dfarning: fix broken links

2009-04-09T00:21:58Z

fix broken links

← Older revision		Revision as of 20:21, 8 April 2009
Line 2:		Line 2:
	This template creates an HTML anchor without creating a visible section header or a TOC entry.		This template creates an HTML anchor without creating a visible section header or a TOC entry.

	Its main use is to allow the translation of links without interfering with 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 [[Design Team/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 preferred 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.		Its main use is to allow the translation of links without interfering with 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 [[Design_Team/Human_Interface_Guidelines]] there's the concept of [[Design Team/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 preferred 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 ==		== Example ==

Dfarning: fix camelcase links

2009-04-08T04:59:24Z

fix camelcase links

Dfarning-bot: Robot: Automated text replacement (-[OLPC Human Interface Guidelines +[DesignTeam/Human Interface Guidelines)

2009-02-05T03:43:11Z

Robot: Automated text replacement (-[OLPC Human Interface Guidelines +[DesignTeam/Human Interface Guidelines)

Dfarning: 4 revisions

2009-02-04T18:24:02Z

4 revisions

← Older revision	Revision as of 14:24, 4 February 2009
(No difference)

Skierpage: improve the example

2008-09-14T11:06:18Z

improve the example

← Older revision		Revision as of 07:06, 14 September 2008
Line 1:		Line 1:
	<includeonly><span id="{{{1}}}"></span></includeonly><noinclude>[[Category:Template]]		<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~~.		This template creates an HTML anchor without creating a visible section header or a TOC entry.

	~~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 preferred 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.		Its main use is to allow the translation of links without interfering with 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 preferred 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:		== Example ==
			In a page you are translating there's the following link to a section:
			<nowiki>[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor#Home]]</nowiki>
			You know the translated page will be named
			OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx
			You want to leave the link as
			<nowiki>[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx#Home]]</nowiki>
			so you don't have locate the translated section text and change the link to use it.

	~~<nowiki>[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor#Home]]</nowiki> # Original link~~		If the page you are linking to uses [[Template:Anchor]] then you can do this;
	~~OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx # Translated~~ page		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.
	~~<nowiki>~~[[~~OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx#Home~~]]~~</nowiki> # Translated link~~		: It's also possible to link the translated section heading, for example''[[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.

	~~: 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 ==		== Usage ==
Line 21:		Line 25:
	'''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.		'''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 [[~~TranslationTeam~~]] pages. If used outside that context, it is recommended to be used only within the same page (no inter-page linking using ''hidden anchors'').		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.		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.
Line 27:		Line 31:
	== History & Credits ==		== 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 ~~template~~ had been originally ~~defined~~ (instead of manually ~~embedding~~ it in the wiki text) a simple update of the ~~<nowiki>~~[[Template:Anchor]]~~</nowiki>~~ would've solved the problem.		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]].		So now, this is part of a (hopefully) better solution — suggestion by [[User:MitchellNCharity\|MitchellNCharity]].
	</noinclude>		</noinclude>

Dfarning: update links

2008-05-30T19:13:50Z

update links

← Older revision		Revision as of 15:13, 30 May 2008
Line 21:		Line 21:
	'''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.		'''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'').		Its use is '''discouraged''' outside the context of [[TranslationTeam]] 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.		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.

Walter at 01:53, 18 May 2008

2008-05-18T01:53:40Z

← Older revision		Revision as of 21:53, 17 May 2008
Line 2:		Line 2:
	This template is used to create an anchor without requiring a specific (sub) section header to be made.		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.		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 preferred 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:		; Example : In a page you are translating there's the following link:
Line 10:		Line 10:
	<nowiki>[[OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx#Home]]</nowiki> # Translated link		<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.		: 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.		: 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.

Line 27:		Line 27:
	== History & Credits ==		== 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.		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 template had been originally defined (instead of manually embedding it in the wiki text) a simple update of the <nowiki>[[Template:Anchor]]</nowiki> would've solved the problem.

	So now, this is part of a (hopefully) better solution — suggestion by [[User:MitchellNCharity\|MitchellNCharity]].		So now, this is part of a (hopefully) better solution — suggestion by [[User:MitchellNCharity\|MitchellNCharity]].
	</noinclude>		</noinclude>

Walter: New page: Category:Template This template is used to create an anchor without requiring a specific (sub) section header to be made...

2008-05-18T01:49:56Z

New page: <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...

← Older revision	Revision as of 21:49, 17 May 2008
(No difference)

FGrose: /* Usage */

2008-02-25T16:51:12Z

Usage

New page

<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>

← Older revision		Revision as of 12:37, 11 July 2009
Line 2:		Line 2:
	This template creates an HTML anchor without creating a visible section header or a TOC entry.		This template creates an HTML anchor without creating a visible section header or a TOC entry.

	Its main use is to allow the translation of links without interfering with 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 [[~~Design_Team/Human_Interface_Guidelines~~]] there's the concept of [[~~Design Team/~~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 preferred 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.		Its main use is to allow the translation of links without interfering with 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 [[Human Interface Guidelines]] there's the concept of [[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 preferred 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 ==		== Example ==
	In a page you are translating there's the following link to a section:		In a page you are translating there's the following link to a section:
	<nowiki>[[~~Design Team/~~Human Interface Guidelines/The Laptop Experience/Zoom Metaphor#Home]]</nowiki>		<nowiki>[[Human Interface Guidelines/The Laptop Experience/Zoom Metaphor#Home]]</nowiki>
	You know the translated page will be named		You know the translated page will be named
	~~OLPC~~ Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx		Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx
	You want to leave the link as		You want to leave the link as
	<nowiki>[[~~Design Team/~~Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx#Home]]</nowiki>		<nowiki>[[Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx#Home]]</nowiki>
	so you don't have locate the translated section text and change the link to use it.		so you don't have locate the translated section text and change the link to use it.

	If the page you are linking to uses [[Template:Anchor]] then you can do this;		If the page you are linking to uses [[Template:Anchor]] then you can do this;
	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 ''[[~~Design Team/~~Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|Hogar]]'' or ''[[~~Design Team/~~Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|Casa]]''—both actually linking to the ''anchor'' [[~~Design Team/~~Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|#Home]] and will both work.		the linking of translated pages (and their sections) can be done regardless of how the ''Home'' section header was translated — in [[olpc:Spanish language\| spanish]] it could be translated as either ''[[Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|Hogar]]'' or ''[[Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|Casa]]''—both actually linking to the ''anchor'' [[Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|#Home]] and will both work.
	: It's also possible to link the translated section heading, for example''[[~~Design Team/~~Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Hogar\|#Hogar]]'' or ''[[~~Design Team/~~Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Casa\|#Casa]]''—but in this case, one of them will not work.		: It's also possible to link the translated section heading, for example''[[Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Hogar\|#Hogar]]'' or ''[[Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Casa\|#Casa]]''—but in this case, one of them will not work.

	== Usage ==		== Usage ==
Line 31:		Line 31:
	== History & Credits ==		== 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.		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 embedding 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]].		So now, this is part of a (hopefully) better solution — suggestion by [[olpc:User:MitchellNCharity\|MitchellNCharity]].
	</noinclude>		</noinclude>

← Older revision		Revision as of 00:59, 8 April 2009
Line 2:		Line 2:
	This template creates an HTML anchor without creating a visible section header or a TOC entry.		This template creates an HTML anchor without creating a visible section header or a TOC entry.

	Its main use is to allow the translation of links without interfering with 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 [[~~DesignTeam~~/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 preferred 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.		Its main use is to allow the translation of links without interfering with 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 [[Design Team/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 preferred 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 ==		== Example ==
	In a page you are translating there's the following link to a section:		In a page you are translating there's the following link to a section:
	<nowiki>[[~~DesignTeam~~/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor#Home]]</nowiki>		<nowiki>[[Design Team/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor#Home]]</nowiki>
	You know the translated page will be named		You know the translated page will be named
	OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx		OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx
	You want to leave the link as		You want to leave the link as
	<nowiki>[[~~DesignTeam~~/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx#Home]]</nowiki>		<nowiki>[[Design Team/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx#Home]]</nowiki>
	so you don't have locate the translated section text and change the link to use it.		so you don't have locate the translated section text and change the link to use it.

	If the page you are linking to uses [[Template:Anchor]] then you can do this;		If the page you are linking to uses [[Template:Anchor]] then you can do this;
	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 ''[[~~DesignTeam~~/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|Hogar]]'' or ''[[~~DesignTeam~~/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|Casa]]''—both actually linking to the ''anchor'' [[~~DesignTeam~~/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|#Home]] and will both work.		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 ''[[Design Team/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|Hogar]]'' or ''[[Design Team/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|Casa]]''—both actually linking to the ''anchor'' [[Design Team/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|#Home]] and will both work.
	: It's also possible to link the translated section heading, for example''[[~~DesignTeam~~/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Hogar\|#Hogar]]'' or ''[[~~DesignTeam~~/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Casa\|#Casa]]''—but in this case, one of them will not work.		: It's also possible to link the translated section heading, for example''[[Design Team/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Hogar\|#Hogar]]'' or ''[[Design Team/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Casa\|#Casa]]''—but in this case, one of them will not work.

	== Usage ==		== Usage ==

← Older revision		Revision as of 23:43, 4 February 2009
Line 2:		Line 2:
	This template creates an HTML anchor without creating a visible section header or a TOC entry.		This template creates an HTML anchor without creating a visible section header or a TOC entry.

	Its main use is to allow the translation of links without interfering with 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 preferred 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.		Its main use is to allow the translation of links without interfering with 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 [[DesignTeam/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 preferred 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 ==		== Example ==
	In a page you are translating there's the following link to a section:		In a page you are translating there's the following link to a section:
	<nowiki>[[~~OLPC~~ Human Interface Guidelines/The Laptop Experience/Zoom Metaphor#Home]]</nowiki>		<nowiki>[[DesignTeam/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor#Home]]</nowiki>
	You know the translated page will be named		You know the translated page will be named
	OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx		OLPC Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx
	You want to leave the link as		You want to leave the link as
	<nowiki>[[~~OLPC~~ Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx#Home]]</nowiki>		<nowiki>[[DesignTeam/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-xx#Home]]</nowiki>
	so you don't have locate the translated section text and change the link to use it.		so you don't have locate the translated section text and change the link to use it.

	If the page you are linking to uses [[Template:Anchor]] then you can do this;		If the page you are linking to uses [[Template:Anchor]] then you can do this;
	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.		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 ''[[DesignTeam/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|Hogar]]'' or ''[[DesignTeam/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|Casa]]''—both actually linking to the ''anchor'' [[DesignTeam/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Home\|#Home]] and will both work.
	: It's also possible to link the translated section heading, for example''[[~~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.		: It's also possible to link the translated section heading, for example''[[DesignTeam/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Hogar\|#Hogar]]'' or ''[[DesignTeam/Human Interface Guidelines/The Laptop Experience/Zoom Metaphor/lang-es#Casa\|#Casa]]''—but in this case, one of them will not work.

	== Usage ==		== Usage ==