Changes

Jump to navigation Jump to search
41 bytes removed ,  12:37, 11 July 2009
no edit summary
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 [[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>[[DesignTeam/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>[[DesignTeam/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 &mdash; 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]]''&mdash;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 &mdash; 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]]''&mdash;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''[[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]]''&mdash;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]]''&mdash;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>&lt;div id="original header"/&gt;</tt> (a ruthless hack) was done by [[User:Xavi|Xavi]] after discovering that the <tt>&lt;a&gt;</tt> is not allowed.  That solution broke down after an update of the wiki. The solution was to switch to an html compliant <tt>&lt;div id="original header"&gt;&lt;/div&gt;</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>&lt;div id="original header"/&gt;</tt> (a ruthless hack) was done by [[User:Xavi|Xavi]] after discovering that the <tt>&lt;a&gt;</tt> is not allowed.  That solution broke down after an update of the wiki. The solution was to switch to an html compliant <tt>&lt;div id="original header"&gt;&lt;/div&gt;</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 &mdash; suggestion by [[User:MitchellNCharity|MitchellNCharity]].
+
So now, this is part of a (hopefully) better solution &mdash; suggestion by [[olpc:User:MitchellNCharity|MitchellNCharity]].
 
</noinclude>
 
</noinclude>

Navigation menu