{"id":3711,"date":"2021-10-27T21:11:11","date_gmt":"2021-10-27T18:11:11","guid":{"rendered":"https:\/\/creativethemes.com\/blocksy\/?post_type=documentation&#038;p=3711"},"modified":"2024-01-25T10:42:27","modified_gmt":"2024-01-25T08:42:27","slug":"how-to-translate-blocksy","status":"publish","type":"documentation","link":"https:\/\/creativethemes.com\/blocksy\/docs\/general\/how-to-translate-blocksy\/","title":{"rendered":"How to Translate Blocksy"},"content":{"rendered":"\n<p>We&#8217;ve worked super hard to make <strong>Blocksy<\/strong> and its <strong>Companion<\/strong> plugin fully localisable. It already comes with the necessary <strong>POT<\/strong> template files, ready to be translated into any language.<\/p>\n\n\n\n<p>You can use any software that supports these kind of files. <strong>POedit<\/strong> is a good choice if you wish to translate these files offline. You can also use <strong>Loco Translate<\/strong> for an inbox translation experience, meaning you do not have to leave your website and download additional software to translate.<\/p>\n\n\n\n<p>Our translation efforts are 100% community based. Here&#8217;s how you can contribute.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Blocksy Theme<\/h2>\n\n\n\n<p>The <strong>Blocksy<\/strong> theme translation files are located on <a href=\"https:\/\/translate.wordpress.org\/projects\/wp-themes\/blocksy\/\" data-type=\"URL\" data-id=\"https:\/\/translate.wordpress.org\/projects\/wp-themes\/blocksy\/\" rel=\"nofollow noopener\" target=\"_blank\">WordPress.org<\/a>. You can use their built in web application to contribute to these translations, all you need is a WordPress.org account.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Blocksy Companion<\/h2>\n\n\n\n<p>For the <strong>Blocksy Companion<\/strong> plugin, the story is extremely similar. You will need to visit the <a href=\"https:\/\/translate.wordpress.org\/projects\/wp-plugins\/blocksy-companion\/\" data-type=\"URL\" data-id=\"https:\/\/translate.wordpress.org\/projects\/wp-plugins\/blocksy-companion\/\" rel=\"nofollow noopener\" target=\"_blank\">WordPress.org repository<\/a> and start translating using their web application.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">Getting Started with WordPress.org<\/h2>\n\n\n\n<p>When accessing the translation project on WordPress.org, you will see a screen kind of like this.<\/p>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;69d2218f29305&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"69d2218f29305\" class=\"wp-block-image size-large has-lightbox wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2021\/10\/Screenshot-2021-10-27-at-22.13.44-1024x553-1.png\" alt=\"\" class=\"wp-image-3720\" \/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\taria-label=\"Enlarge\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.imageButtonRight\"\n\t\t\tdata-wp-style--top=\"state.imageButtonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">Blocksy Translation Welcome Screen<\/figcaption><\/figure>\n\n\n\n<p>As you can see, the list is sorted automatically by the completion of that specific language. Some of these languages have a not so complete translation. <\/p>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;69d2218f298f7&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"69d2218f298f7\" class=\"wp-block-image size-large has-lightbox wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2021\/10\/Screenshot-2021-10-27-at-22.14.56-1024x849-1.png\" alt=\"\" class=\"wp-image-3722\" \/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\taria-label=\"Enlarge\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.imageButtonRight\"\n\t\t\tdata-wp-style--top=\"state.imageButtonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">Language Completion<\/figcaption><\/figure>\n\n\n\n<p>If you&#8217;re kind, you can easily contribute to your favourite language.<\/p>\n\n\n\n<figure class=\"wp-block-video\"><video controls src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2021\/10\/Screen-Recording-2021-10-27-at-22.29.16.mov\"><\/video><figcaption class=\"wp-element-caption\">Translating Blocksy<\/figcaption><\/figure>\n\n\n\n<p>Simply choose your language, then click on the Blocksy project. You will be presented with all the available strings that you can translate. Ready to start editing?<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">Blocksy Companion Pro<\/h2>\n\n\n\n<p>The story here is a little bit different, but similar. Because our <strong>Blocksy Companion Pro <\/strong>plugin is a separate commercial plugin, it does not adhere to the WordPress.org rules. We have to use a system that&#8217;s similar to the one of WordPress.org&#8217;s, but not as pretty.<\/p>\n\n\n\n<p>It&#8217;s a little piece of software called <strong>GlotPress<\/strong> and works in exactly the same way as the translations on WordPress.org.<\/p>\n\n\n\n<p>Address where you can translate &#8211; <a href=\"https:\/\/translate.creativethemes.com\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/translate.creativethemes.com<\/a><\/p>\n\n\n\n<figure class=\"wp-block-video\"><video controls src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2021\/10\/Screen-Recording-2021-10-27-at-22.37.47.mov\"><\/video><figcaption class=\"wp-element-caption\">Translating with GlotPress.<\/figcaption><\/figure>\n\n\n\n<p>Translating with GlotPress is super simple. Simply select the project, choose your preferred language and translate away! The new translations will be automatically sent to us for approval and inclusion in Blocksy Companion Pro.<\/p>\n\n\n\n<p>With GlotPress you have an even bigger advantage, because you can upload your own .<strong>PO<\/strong> files. This means if you&#8217;ve already translated Blocksy Companion Pro offline, you can upload these translation files and they will automatically get submitted to us.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">Offline Translation<\/h2>\n\n\n\n<p>If you only wish to translate Blocksy for yourself, you can easily use the Loco Translate plugin. It has the same interface as the usual translation tools.<\/p>\n\n\n\n<figure class=\"wp-block-embed is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"Translating Blocksy with Loco Translate | Blocksy Integrations\" width=\"1290\" height=\"968\" src=\"https:\/\/www.youtube.com\/embed\/MRDu6BH22aA?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>We&#8217;ve worked super hard to make Blocksy and its Companion plugin fully localisable. It already comes with the necessary POT template files, ready to be translated into any language. You can use any software that supports these kind of files. POedit is a good choice if you wish to translate these files offline. You can [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_categories":[111],"class_list":["post-3711","documentation","type-documentation","status-publish","hentry","doc_categories-general"],"blocksy_meta":{"styles_descriptor":{"styles":{"desktop":"","tablet":"","mobile":""},"google_fonts":[],"version":6}},"acf":[],"_links":{"self":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/3711","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/types\/documentation"}],"author":[{"embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/comments?post=3711"}],"version-history":[{"count":3,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/3711\/revisions"}],"predecessor-version":[{"id":9275,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/3711\/revisions\/9275"}],"wp:attachment":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/media?parent=3711"}],"wp:term":[{"taxonomy":"doc_categories","embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/doc_categories?post=3711"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}