---
lang: en
title: Translating the glossary
authors:
 - Mor Rubinstein
section: meta
---

<h2> What's new in the glossary</h2>
<p>In the old version of the handbook, the glossary was one page with all of the term in it. In the new version, we gave each glossary a webpage for better referencing and linking.<\p>
Glossaries that were translated in the old version of the handbook have been transfered to the new site. Please checkCheck if your language has an old version of the glossary -
. You can find them <a href=https://github.com https://github.com/{{ site.github_username }}/tree/gh-pages/glossary> here </a>

<h3><b>If you do have an old version translated, follow these steps:</b></h3>
<p> The old glossary format does not allow linking from the new version of the guide, and you will need to transfer the term to the new format.</p>

<h3> 1. Create a new folder for the term</h3>

<p>Under your language folder, Follow the breadcrumb trail <code>{{ site.github_repo }} / glossary / es /</code>, to the right of which is a plus symbol <code><strong>+</strong></code>. create a folder for each term by pressing on the '+' sign and type the term name in English. The folder names should be in lower-case letters with dashes ‘-’ instead of white spaces. Add a ‘/’ in the end of the name to create a new folder.</p>

<h3> 2. Translate the term</h3>
<p> open a new index.md file by clicking on the '+'. </p>

In the text editor below add the front matter:
<pre>
---
section: terms
lang: en
title: Bulk
---
</pre>

<p> Change the 'lang' field to your language code. Change the title to the term title in YOUR language.</p>
<p>Below the front matter copy the term from the old glossary.</p>

<h3> 3. Make a pull request.</h3>

<p>All done! Keep doing this until all terms got their own folder and page.</p>

<h2><b>If you have never translated the glossary before, follow the these steps:</b></h2>

<h3> Copy the English Glossary</h3>

<p> Copy the English terms directory into your target language directory in the glossary folder. This step can not be done through the Github website and you will have to fork the handbook for you machine. Information about forking and cloning can be find <a href=https://help.github.com/articles/fork-a-repo/>here</a> . Notice, some languages have already been moved and translated. Check the folder to make sure you are not overwriting someone’s work.</p>

<h3>Edit the term</h3>

<p>Choose a term and open the index.md file.</p>
<p>The front matter looks as follows:</p>

<pre>
---
section: terms
lang: en
title: Bulk
---
</pre>

<p>Change the lang field to your language code.</p>
<p>Change the title to the term title in YOUR language.</p>
<p>In the text editor, below the front matter, enter your translation to the term.</p>

<h3>3. Submit changes through a pull request.</h3>

<p> All done! Thank you for your help! </p>