{"_id":"560b629c3616ac17004f1ca3","parentDoc":null,"project":"55a6e72e8cc73e0d00096635","__v":9,"category":{"_id":"560b5cd0c341310d00de2a02","project":"55a6e72e8cc73e0d00096635","version":"55a6e72f8cc73e0d00096638","__v":9,"pages":["560b629c3616ac17004f1ca3","560b63343bcbd80d0077d10a","560b637e5148ba0d009bd0d0","560b63c53616ac17004f1ca8","560b63dd5148ba0d009bd0d3","560b63f42d00ca0d00a1fdbf","560b64ee5148ba0d009bd0d5","5617054c7f74330d00dfd73c","561705cbbd70650d00977851"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-30T03:53:52.522Z","from_sync":false,"order":15,"slug":"internationalizationlocalization","title":"Internationalization/Localization"},"user":"55a6caa022cfa321008e01d6","version":{"_id":"55a6e72f8cc73e0d00096638","project":"55a6e72e8cc73e0d00096635","hasReference":false,"__v":29,"hasDoc":true,"createdAt":"2015-07-15T23:05:19.125Z","releaseDate":"2015-07-15T23:05:19.125Z","categories":["55a6e7308cc73e0d00096639","55b7ed07aea7c8190058badb","5604567c0c78b00d0039b191","5605e6f23a93940d002b3e4a","5605f2bba4574a0d00811365","5605f309a4574a0d00811366","5608e3b98aedf50d0004cf8f","5608e4318aedf50d0004cf90","5608e6b5a7cc2f0d00d9754d","5608e6d331beb60d001b6560","5608f879a7cc2f0d00d97580","560b097887b71d0d000d3bd9","560b13cbafa0990d00979545","560b5cbec341310d00de2a01","560b5cd0c341310d00de2a02","566a35b81e08750d00a0c49b","566a3e8503b4b20d00d02a4a","567889d307bf6a0d0083edc8","569c8b7c15bb390d00db6f9d","56b254dc65ddf50d0076ba8f","57a8ebc4cdeea20e001d2a63","57e48a4000c8680e00fae6e7","5808216773557d0f00a1e428","58105ad54a8aa50f00aa4cba","58105bf298aea40f00afa3ba","58105f548a4aed0f00d67536","581061b898aea40f00afa3be","584b3de7e5f3a42300df6ef7","596839a75965d400155bb750"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-30T04:18:36.894Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"[block:html]\n{\n  \"html\": \"The Stencil framework allows you to define multiple linguistic translations for each theme, based on a predefined schema. Theme developers are not required to localize a theme in order to make it work, and BigCommerce does not provide translations for the theme’s content.<br>\\n\\n<p></p>However, you have the option of localizing your themes for desired target languages, based on the provided schema. For details about this schema and its usage, see this section's following pages.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"* Theme translation occurs only to the extent that you create JSON files for each language that you choose to support, and include key/value pairs for the text blocks/parameters that you choose to translate. (The&#160;following pages provide details for these steps.)\\n\\n* Stencil's multi-language capabilities are currently limited to these specific strings that you specify within the theme. The Stencil framework does not currently translate content rendered from a store's catalog database – for example, products' names. \\n\\n* If you want to fully support multiple languages, we recommend that you set up a separate storefront for each language. This will enable you to thoroughly customize all of your content (including your product catalog) for each target audience.\",\n  \"title\": \"What Does and Doesn't Translate\"\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"<!-- ADD A NEW SECTION *OR PAGE*, PROVIDING A SCHEMATIC/SKELETON THREADING THROUGH THE FOLOWING ADDITIONAL STEPS, WITH KB LINKS. MAYBE CHECKOUT LINKS/CALLOUT SHOULD BE CONSOLIDATED HERE, TOO?:\\n\\n* **Must go to cp > Orders > Order Statuses, in order to translate order statuses!**\\n  - [Customize order statuses](https://support.bigcommerce.com/articles/Public/Understanding-Order-Statuses#customize)\\n\\n* **To turn off emails (because you can't translate them), must go to either:**\\n  - **cp > Storefront > Emails [entry in left nav – new, being tested on 50% of new stores];** *OR:*\\n  - **cp > Storefront Design > My Themes > Design Options > Emails tab [legacy].**\\n\\n  For details, see:\\n  - [Turn off email templates](https://support.bigcommerce.com/articles/Public/Customizing-Email-Templates/)\\n\\n* Consider using 3rd-party email apps: Derrek will follow up with Alyss and Stuart on any specific recommendations.\\n-->\"\n}\n[/block]","excerpt":"","slug":"basis-for-i18n","type":"basic","title":"Basis for Internationalization"}

Basis for Internationalization


[block:html] { "html": "The Stencil framework allows you to define multiple linguistic translations for each theme, based on a predefined schema. Theme developers are not required to localize a theme in order to make it work, and BigCommerce does not provide translations for the theme’s content.<br>\n\n<p></p>However, you have the option of localizing your themes for desired target languages, based on the provided schema. For details about this schema and its usage, see this section's following pages." } [/block] [block:callout] { "type": "info", "body": "* Theme translation occurs only to the extent that you create JSON files for each language that you choose to support, and include key/value pairs for the text blocks/parameters that you choose to translate. (The&#160;following pages provide details for these steps.)\n\n* Stencil's multi-language capabilities are currently limited to these specific strings that you specify within the theme. The Stencil framework does not currently translate content rendered from a store's catalog database – for example, products' names. \n\n* If you want to fully support multiple languages, we recommend that you set up a separate storefront for each language. This will enable you to thoroughly customize all of your content (including your product catalog) for each target audience.", "title": "What Does and Doesn't Translate" } [/block] [block:html] { "html": "<!-- ADD A NEW SECTION *OR PAGE*, PROVIDING A SCHEMATIC/SKELETON THREADING THROUGH THE FOLOWING ADDITIONAL STEPS, WITH KB LINKS. MAYBE CHECKOUT LINKS/CALLOUT SHOULD BE CONSOLIDATED HERE, TOO?:\n\n* **Must go to cp > Orders > Order Statuses, in order to translate order statuses!**\n - [Customize order statuses](https://support.bigcommerce.com/articles/Public/Understanding-Order-Statuses#customize)\n\n* **To turn off emails (because you can't translate them), must go to either:**\n - **cp > Storefront > Emails [entry in left nav – new, being tested on 50% of new stores];** *OR:*\n - **cp > Storefront Design > My Themes > Design Options > Emails tab [legacy].**\n\n For details, see:\n - [Turn off email templates](https://support.bigcommerce.com/articles/Public/Customizing-Email-Templates/)\n\n* Consider using 3rd-party email apps: Derrek will follow up with Alyss and Stuart on any specific recommendations.\n-->" } [/block]