<html><head><style>
body {
font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
padding:1em;
margin:auto;
background:#fefefe;
}
h1, h2, h3, h4, h5, h6 {
font-weight: bold;
}
h1 {
color: #000000;
font-size: 28pt;
}
h2 {
border-bottom: 1px solid #CCCCCC;
color: #000000;
font-size: 24px;
}
h3 {
font-size: 18px;
}
h4 {
font-size: 16px;
}
h5 {
font-size: 14px;
}
h6 {
color: #777777;
background-color: inherit;
font-size: 14px;
}
hr {
height: 0.2em;
border: 0;
color: #CCCCCC;
background-color: #CCCCCC;
}
p, blockquote, ul, ol, dl, li, table, pre {
margin: 15px 0;
}
a, a:visited {
color: #4183C4;
background-color: inherit;
text-decoration: none;
}
#message {
border-radius: 6px;
border: 1px solid #ccc;
display:block;
width:100%;
height:60px;
margin:6px 0px;
}
button, #ws {
font-size: 12 pt;
padding: 4px 6px;
border-radius: 5px;
border: 1px solid #bbb;
background-color: #eee;
}
code, pre, #ws, #message {
font-family: Monaco;
font-size: 10pt;
border-radius: 3px;
background-color: #F8F8F8;
color: inherit;
}
code {
border: 1px solid #EAEAEA;
margin: 0 2px;
padding: 0 5px;
}
pre {
border: 1px solid #CCCCCC;
overflow: auto;
padding: 4px 8px;
}
pre > code {
border: 0;
margin: 0;
padding: 0;
}
#ws { background-color: #f8f8f8; }
.bloop_markdown table {
border-collapse: collapse;
font-family: Helvetica, arial, freesans, clean, sans-serif;
color: rgb(51, 51, 51);
font-size: 15px; line-height: 25px;
padding: 0; }
.bloop_markdown table tr {
border-top: 1px solid #cccccc;
background-color: white;
margin: 0;
padding: 0; }
.bloop_markdown table tr:nth-child(2n) {
background-color: #f8f8f8; }
.bloop_markdown table tr th {
font-weight: bold;
border: 1px solid #cccccc;
margin: 0;
padding: 6px 13px; }
.bloop_markdown table tr td {
border: 1px solid #cccccc;
margin: 0;
padding: 6px 13px; }
.bloop_markdown table tr th :first-child, table tr td :first-child {
margin-top: 0; }
.bloop_markdown table tr th :last-child, table tr td :last-child {
margin-bottom: 0; }
.bloop_markdown blockquote{
border-left: 4px solid #dddddd;
padding: 0 15px;
color: #777777; }
blockquote > :first-child {
margin-top: 0; }
blockquote > :last-child {
margin-bottom: 0; }
.send { color:#77bb77; }
.server { color:#7799bb; }
.error { color:#AA0000; }</style></head><body><p>Hey guys!</p>
<p>I know this library lately cause a lot of pain for many of you especially for people who worked on updating strings on webmaker sites and the script kept overriding the content of our source language (the one language directory on /locale/en_US/*).</p>
<p>So, I decided to rewrite the script a bit and update its API so that we can permanently solve this ongoing problem…</p>
<p>I have updated and publish it to NPM and the most up-to-date version is node-transifex@1.4.1 <a href="https://github.com/alicoding/node-transifex">https://github.com/alicoding/node-transifex</a></p>
<p>The API for the library itself is very up-to-date and synced with Transifex but for the binary script I didn’t update that part for the documentation yet (not that I’m lazy but I need to make sure it’s the most stable version with unit test written before I expose this to other people to start using it), but I figured that I still need to write to people in the dev-team since we use it heavily for almost all the project we have here in Webmaker land.</p>
<p>The update I have here is I added couple more options.</p>
<ol>
<li>Meta info
This is currently being use in https://webmaker.org/healthcheck basically we add meta information about when is the last translation added for that specific language. The option that I add here is that you will now be able to choose if you want to download this meta info files. The advantage for allowing the user to not download is huge here because if you have 100 languages with 5 resource files so you will have to double the amount here because we have meta-file for each resource files of each languages. (That’s 1000 files!)</li>
</ol>
<p>Example:</p>
<pre><code>transifex -u username:password -p "webmaker" -c "webmaker" -d locale -m
</code></pre>
<ol>
<li>Override Source Language Code
I guess this option is what people would care the most because with adding this option now we no longer need to worry about the strings on the site is not up-to-date for source language. When I say source language again I meant our one and only one “en_US” (Unless that project is setup with different source language).</li>
</ol>
<p>Example usage:</p>
<pre><code>transifex -u username:password -p "webmaker" -c "webmaker" -d locale -s
</code></pre>
<p>The above will override the source language, so if you don’t want it to override make sure you don’t put <code>-s</code> there.</p>
<p>Codes:</p>
<pre><code>-u : credential
-p : project name
-p : category name
-d : directory name (to write the files)
-m : meta option enable
-s : override source_language
</code></pre>
<p>Ali Al Dallal</p>
<p>Twitter: <a href="https://twitter.com/alicoding">@alicoding</a><br>
Blog: <a href="https://alicoding.com">https://alicoding.com</a> </p></body></html>