GengoCodeGuide

Rulesfortranslatingcode

1
1.CODE

Dealingwithcodeandcode-relatedelementsisanimportantpartofbeingaGengo
Translator,andthebiggestchallengenewbiesface.Translatingcodecorrectlyisespecially
importantasmistakescancauseseriousformattingissueswithyourcustomerswebpage.

Inbasicterms,codeisasetofinstructionsthatdirectsacomputertoperformspecific
operations.Forexample,codedefinesthefont,colorandsizeoftextonawebpage,where
linebreaksgoandwhathappenswhenyouclickahyperlink.

YoudontneedcodingskillstotranslatewithGengo,butitsimportanttounderstandthe
followingbasicprinciples:

Mostcodeelementsarewrittenwitha<starttag>andan</endtag>,whichare
enclosedwithinbrackets.Endtagsaredistinguishedfromstarttagsbyaslashafter
theopeningbracket.Forexample,toboldcheeseinthefollowingsentence,
surrounditwithstrongemphasistags,e.g.,Ilike<strong>cheese</strong>.

Changingoneletterofbracketedtext,omittingasingletagorforgettingaslashcan
causecodetobreak,whichcanleadtoseriouswebsitereadabilityorfunctionality
problems.Usecopyandpastetoensureexactreplicationandcheckyourwork
carefully.

Sometimesyouneedtomovethepositionofthecodeinasentencetoensurethat
itstayswiththerelevanttextinthetranslation.Let'slookatacoupleofexamples
withincorrectandcorrecttranslations.

Example1

Sourcetext:Ilike<ahref="http://en.wikipedia.org/wiki/Cheese">cheese</a>.


IncorrectJapanesetranslation:
<ahref="http://en.wikipedia.org/wiki/Cheese"></a>
CorrectJapanesetranslation:

<ahref="http://en.wikipedia.org/wiki/Cheese"></a>

TheHTMLtaghereislinkingtoapageaboutcheese.Sincethetermforcheese( )
movestothemiddleofthesentenceinJapanese,soshouldtheHTMLtag.

2
 Example2

Sourcetext:<ul><li>Delicious,refreshing
<ahref="http://www.marthastewart.com/339243/marthas-
pineapple-papaya-juice">papayajuice</a></li></ul>

IncorrectSpanishtranslation:
<ahref="http://www.marthastewart.com/339243/marthas-
pineapple-papaya-juice">Zumodepapaya<ul><li>deliciosoy
refrescante</a></li></ul>

CorrectSpanishtranslation:
<ul><li><ahref="http://www.marthastewart.com/339243/marthas-
pineapple-papaya-juice">Zumodepapaya</a>deliciosoyrefrescante</li></ul>

Here,the<ul><li>and</li></ul>tags(codeforbulletpoints)areassociatedwiththewhole
textwhereasthe<ahref="http://weluvpapayajuice.com>and</a>arestrictlyassociated
withpapayajuice(ZumodepapayainSpanish).


2.TRIPLEBRACKETS

Thisfeatureisforcustomerswhowouldliketoexcludecertainwords,names,timestamps,
etc.fromgettingtranslated.Pleasedonottranslateanythinginthetriplebrackets;copy
thetext(asis,includingthebrackets)intoyourtranslation.Toreducetheriskoferror,
pleaseusethecopyandpastefunctionandcarefullycheckyourwork.

Example

Heywe'relookingforaDJtospinonMondaynightat[[[#SXSW]]].Tweet
recommendationsto

[[[@deyto]]]and[[[@sarah_ross]]]

shouldbetranslatedintoJapaneseas:

[[[#SXSW]]]DJ
[[[@deyto]]]
[[[@sarah_ross]]]

3
3.DEFLATEDHTMLTAGS

Toavoidconfusion,weusuallydeflateHTMLtagsintoshorter,moremanageable
numberedtags.Forexample,<strong>Hello</strong>becomes{1}Hello{/1}.So,usingthe
exampleslistedabove,thecodewillappearasfollows:

Example1

Sourcetext:Ilike{1}cheese{/1}.
{1}{/1}

IncorrectJapanesetranslation:
CorrectJapanesetranslation:{1}{/1}

Example2

Sourcetext:{1}{2}Delicious,refreshing{3}papayajuice{/3}{/2}{/1}

IncorrectSpanishtranslation:{3}Zumodepapaya{1}{2}deliciosoy
refrescante{/3}{/2}{/1}

CorrectSpanishtranslation:{1}{2}{3}Zumodepapaya{/3}deliciosoy
refrescante{/2}{/1}

Note:openingtagsdonotalwayshavematchingclosingtags(i.e.thereisnotalwaysa{/1}
tomatcha{1}).

4.COMMONERRORS

Whentranslatingtheseelements,pleasekeepawatchfuleyeandbecarefulnottofallfor
thefollowingcommonerrors.

Pleaseensureyoudonotputaspacebetweenthecodeandthewordthecodeis
beingappliedto.Ifyouareunsure,pleasefollowthespacingofthesourcetext.

Source:Ilike{1}cheese{/1}.

IncorrectFrenchtranslation:Jaimele{1}fromage{/1}.

CorrectFrenchtranslation:Jaimele{1}fromage{/1}.

4
 Althoughitisourpolicytoplaceallcodewithintriplebrackets,somejobswillhave
non-standardpiecesofcodethatmaylooklikeregulartext.Itmaybedifficultto
figureoutwhichelementsarecodeandwhicharenot,soherearesomeexamples
ofnon-standardcodethatyoumaycomeacross.Pleasenotethatyouwouldnot
needtotranslateanyelementsthatareshowninredandyoushouldsimplycopy
andpastethemintoyourtranslation.

Account:%1$s\nProtocol:%2$s

from{{departure}}to{{arrival}}

The-contestTitle-Challengestartssoon,andyourenotonateamyet.
There'sstilltimejoinorcreateateamnow.

Sorry,butoursystemhasa%{minimum_amount}minimumgiftamount.

Can'tconnecttothelicensingserver.\nPleasecheckyourinternet
connectionandtryagain.

__nights__nightsin__place__

Minimallengthofopinionis{min_length}chars.

Pleasecopythecapitalisationandpunctuationofsmallpiecesoftextyoumaysee.
Thesemaybemenubuttonsorotherelementsofawebsitethatshouldappearin
thesameformatasthesourcetext.

Source:optional

IncorrectPortuguesetranslation:Opcional.

CorrectPortuguesetranslation:opcional