{"id":29567,"date":"2015-11-09T11:12:28","date_gmt":"2015-11-09T05:42:28","guid":{"rendered":"http:\/\/www.tothenew.com\/blog\/?p=29567"},"modified":"2015-11-09T11:12:28","modified_gmt":"2015-11-09T05:42:28","slug":"i18n-implementation-using-sightly","status":"publish","type":"post","link":"https:\/\/www.tothenew.com\/blog\/i18n-implementation-using-sightly\/","title":{"rendered":"i18n implementation using Sightly"},"content":{"rendered":"

Internationalization (i18n)\u00a0is the process of generalizing a product so that it can handle multiple languages and cultural conventions without the need for re-design\u00a0.<\/p>\n

a. Structure format required for i18n implementation :<\/strong><\/p>\n

1) Create a i18n node of type sling:Folder as below<\/em><\/p>\n

\"i18n<\/span><\/span><\/em><\/strong><\/p>\n

2) Create a node of type sling:Folder under i18n of mixin type mix:language and add a property called jcr:language and assign value of lang code \u00a0as below<\/em><\/p>\n

\"i18n-folder<\/p>\n

3) Create a message node of type\u00a0sling:MessageEntry and a property called sling:key which will used to pull the value of the variable and also add a property called sling:message which will specify the value of the key as below<\/em><\/p>\n

\"i18n-message<\/p>\n

As soon as you create this structure you can look in CQ5-Translator and you\u00a0should have similar translations created :<\/p>\n

\"i18n-translator\"<\/p>\n

b. Normal way to implement i18n in Sightly :\u00a0<\/strong><\/p>\n

We can implement i18n directly by using the below syntax :<\/em><\/p>\n

${'key' @ i18n}\r\n${'key' @ i18n, source='user', hint='Translation Hint'}\r\n${'key' @ i18n, locale='en', hint='Translation Hint'}<\/pre>\n
The default source<\/strong> for the language is ‘resource’, meaning that the text gets translated to the same language as the content. If you specify it to\u00a0‘user’ than the language is taken from the browser locale or from the locale of the logged-in user.But when we provide an explicit locale<\/strong> than we overrides the source settings and would take the specified locale.<\/p>\n
In Sightly if we don’t define the attribute locale than it would automatically convert the text\u00a0according to\u00a0current page locale .<\/p>\n
The hint<\/strong>\u00a0is used to provide\u00a0information about the context for the translators.<\/p>\n
Issue and it’s alternative approach :<\/strong><\/p>\n
When I tried using the above approach for i18n implementation in sightly, it\u00a0didn’t worked in a usual manner for different locale as it should work on.<\/p>\n
Solution :\u00a0<\/strong>So if such a scenario happened with you, you can also achieve it by creating a local template<\/strong>\u00a0to which you can pass the variable identifying your key and\u00a0than calling it by using \u00a0data-sly-call :<\/p>\n
Implementation for the same is as below :<\/p>\n
<template data-sly-template.i18=\"${@ key}\">\r\n ${key @ i18n}\r\n<\/template>\r\n\r\n<div data-sly-call=\"${i18 @ key='key-name'}\"><\/div>\r\n<\/em><\/pre>\n
This approach holds\u00a0good and worked for me in all use cases .<\/p>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
Internationalization (i18n)\u00a0is the process of generalizing a product so that it can handle multiple languages and cultural conventions without the need for re-design\u00a0. a. Structure format required for i18n implementation : 1) Create a i18n node of type sling:Folder as below 2) Create a node of type sling:Folder under i18n of mixin type mix:language and […]<\/p>\n","protected":false},"author":723,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"iawp_total_views":216,"footnotes":""},"categories":[1],"tags":[1235,492,2727],"class_list":["post-29567","post","type-post","status-publish","format-standard","hentry","category-technology","tag-adobe-cq5","tag-i18n","tag-sightly"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t