2022.2

1. OntheTranslationspane,clickontheNew Empty Stringbuttontocreatethetranslationentry.
2. Makesurethatanyelementinwhichthetextisinserted,aretaggedfortranslation.Therearesev-
eralwaystodothat:
l
LetthescriptinsertthetaggedHTMLelementaswellasthetext,forexample:
results.html( "<p data-translate>Bill to @CustNumber@</p>" );.
l
Ifthescriptinsertstextintoanexisting,emptyHTMLelement,switchtotheSourceview
andaddthedata-translateattributetotheelement(e.g.<pid="p1"data-translate>).
Dataplaceholdersintranslationentries
Atranslationentryinasnippetmayincludeplaceholdersfordatafields,e.g."Dear@name@".(For
moreinformationaboutplaceholderssee"Variabledataintext:scriptsandplaceholders"on
page311.)
Placeholdersmustnotbetranslated;otherwisethepersonalizationscriptwillnolongerreplacethem
withdata
Typically,translatorsarefamiliarwithentriesthatcontainvariables,butyoumayaddacomment
explainingthattheplaceholderisusedasavariableandthatitshouldnotbetranslated.
Toaddacomment,simplydouble-clicktheentryintheTranslationspaneandenteryourcommentin
theCommentsfield.CommentswillbeaddedtothePOTfileandarevisibletotranslatorsintheirtrans-
lationtools.
HTMLtagsintranslationentries
AtranslationentrymaycontainHTMLtags,forexamplewhenpartofthetextisstyledorwhenthereis
ahyperlinkinthetext.HTMLtagsmustnotbetranslatedorremoved.Normally,translatorswillrecog-
nizeasimpleboldoritalictag(<b>...</b>or<i>...</i>respectively),butmorecomplexelementslike
hyperlinkscouldcauseproblems.Thetranslatormayaccidentallymodifythetag,andbreakthehyper-
linkforexample.
OnewaytoavoidthisistosplitthetextaroundandinsideHTMLtagsintoseparatechunks,nomatter
howshort.SelecttherespectivetextinthetemplateandselectWrap in Spanfromthecontextual
menu.Subsequentlytagthenew<span>elementfortranslation.
AlternativelyyoucouldalsoaddacommentexplainingthattheHTMLtagshouldnotbechanged.
Toaddacomment,simplydouble-clicktheentryintheTranslationspaneandenteryourcommentin
theCommentsfield.CommentswillbeaddedtothePOTfileandarevisibletotranslatorsintheirtrans-
lationtools.
Page 419