Translating the guide

<!doctype html> <html class="no-js" lang=""> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <title>Translating the guide</title> <meta name="description" content="Guides, case studies and resources for government & civil society on the "what, why & how" of open data. "> <meta name="viewport" content="width=device-width, initial-scale=1"> <meta name="google-site-verification" content="U6RmQ0BoQ9f1Omog3Mnas-Yd1At38pTDZbM1AtnOpnc" /> <link rel="apple-touch-icon" href="apple-touch-icon.png">  <link rel="stylesheet" href="//a.okfn.org/html/oki/panel/assets/css/frontend.css"> <link rel="stylesheet" href="/css/main.css"> <link href="https://fonts.googleapis.com/css?family=Lato:100,300,400,700,900,100italic,300italic,400italic,700italic,900italic" rel='stylesheet' type='text/css'> <link href="https://fonts.googleapis.com/css?family=Lora:400,700,400italic,700italic" rel='stylesheet' type='text/css'> <link rel="canonical" href="http://opendatahandbook.org/contribute/translate-guide/"> <script src="/js/vendor/modernizr-2.8.3.min.js"></script> <script> var okiConsent = { analyticsTrackingID: 'UA-8271754-28' } </script> <script src="https://a.okfn.org/html/oki/consent/assets/js/consent.js"></script> </head> <body>  <div id="ok-panel" class="closed"><div class="container"><iframe src="//a.okfn.org/html/oki/panel/panel.html" scrolling="no"></iframe></div></div> <div> <div id="ok-panel-wrapper"> <a class="white ok-ribbon" href="https://okfn.org/"><img src="//a.okfn.org/html/oki/panel/assets/images/oki-ribbon.png" alt="Open Knowledge International"></a> </div> <div> <header class="site-header"> <a href="#menu" class="show-menu"><span class="text">Open the menu</span></a> <a class="site-title" href="/">Open Data Handbook</a> </header> <nav id="menu"> <ul> <li> <a href="/">Home</a> </li> <li > <a href="/guide/en/introduction/">Guide</a> <ul>  <li > <a href="/guide/en/introduction/">Introduction</a> <span class="subsections"> <a href="#target-audience">Target Audience</a> <a href="#credits">Credits</a> </span> </li> <li > <a href="/guide/en/why-open-data/">Why Open Data?</a> </li> <li > <a href="/guide/en/what-is-open-data/">What is Open Data?</a> </li> <li > <a href="/guide/en/how-to-open-up-data/">How to Open Up Data</a> </li> <li > <a href="/guide/en/following-up/">So I've Opened Up Some Data, Now What? </a> </li> <li > <a href="/guide/en/events/">Make data social</a> </li> <li > <a href="/guide/en/appendices/">Appendices</a> </li>  <li> <a href="/glossary/en/">Glossary</a> </li>   </ul> </li>  <li> <a href="/value-stories/en/">Value Stories</a> </li>   <li> <a href="/resources/">Resources</a> </li>   <li class="apps-menu"> <a href="/solutions/en/">Solutions</a> <ul class="app-sub-menu"> <li class="search"> <input type="search" placeholder="Search" class="quicksearch"> </li> <li class="problems filter active"> <a>Problems</a> <span class="filter-items"> <a data-filter=".selector-problem-reusefederatedtools" data-pid=".problem-reusefederatedtools">(Re)use federated tools</a> <a data-filter=".selector-problem-assessholisticmetrics" data-pid=".problem-assessholisticmetrics">Assess holistic metrics</a> <a data-filter=".selector-problem-categoriseopennessofdata" data-pid=".problem-categoriseopennessofdata">Categorise openness of data</a> <a data-filter=".selector-problem-crossagencystrategy" data-pid=".problem-crossagencystrategy">Cross Agency strategy</a> <a data-filter=".selector-problem-developanopendatapublicationplan" data-pid=".problem-developanopendatapublicationplan">Develop an Open Data Publication Plan</a> <a data-filter=".selector-problem-developdatasetcriteria" data-pid=".problem-developdatasetcriteria">Develop dataset criteria</a> <a data-filter=".selector-problem-enablefeedbackchannelsforimprovingdataquality" data-pid=".problem-enablefeedbackchannelsforimprovingdataquality">Enable feedback channels for improving data quality</a> <a data-filter=".selector-problem-enablequalityassessmentofopendata" data-pid=".problem-enablequalityassessmentofopendata">Enable quality assessment of open data</a> <a data-filter=".selector-problem-encouragecrowdsourcingaroundpsi" data-pid=".problem-encouragecrowdsourcingaroundpsi">Encourage crowdsourcing around PSI</a> <a data-filter=".selector-problem-establishopengovernmentportal" data-pid=".problem-establishopengovernmentportal">Establish Open Government Portal</a> <a data-filter=".selector-problem-establishanopendataecosystem" data-pid=".problem-establishanopendataecosystem">Establish an Open Data Ecosystem</a> <a data-filter=".selector-problem-identifywhatyoualreadypublish" data-pid=".problem-identifywhatyoualreadypublish">Identify what you already publish</a> <a data-filter=".selector-problem-influxofhousingpriceincreases" data-pid=".problem-influxofhousingpriceincreases">Influx of Housing Price Increases</a> <a data-filter=".selector-problem-internationalaidandtransparency" data-pid=".problem-internationalaidandtransparency">International Aid & Transparency</a> <a data-filter=".selector-problem-opendatabusinessmodels" data-pid=".problem-opendatabusinessmodels">Open Data Business Models</a> <a data-filter=".selector-problem-openuppublictransportdata" data-pid=".problem-openuppublictransportdata">Open Up Public Transport Data</a> <a data-filter=".selector-problem-providepsiatzerocharge" data-pid=".problem-providepsiatzerocharge">Provide PSI at zero charge</a> <a data-filter=".selector-problem-publishstatisticaldatainlinkeddataformat" data-pid=".problem-publishstatisticaldatainlinkeddataformat">Publish Statistical Data In Linked Data Format</a> <a data-filter=".selector-problem-publishoverviewofmanageddata" data-pid=".problem-publishoverviewofmanageddata">Publish overview of managed data</a> <a data-filter=".selector-problem-ride-sharingandpublictransit" data-pid=".problem-ride-sharingandpublictransit">Ride-sharing and Public Transit</a> <a data-filter=".selector-problem-standardsforgeospatialdata" data-pid=".problem-standardsforgeospatialdata">Standards for Geospatial Data</a> <a data-filter=".selector-problem-trackingmodernwarfare" data-pid=".problem-trackingmodernwarfare">Tracking Modern Warfare</a> <a data-filter=".selector-problem-unveilingincarcerationrates" data-pid=".problem-unveilingincarcerationrates">Unveiling Incarceration Rates</a> </span> </li> <li class="filter"> <a>Themes</a> <span class="filter-items"> <a data-filter=".selector-theme-internationalconflict"> International Conflict</a> <a data-filter=".selector-theme-transport"> Transport</a> <a data-filter=".selector-theme-civilconflict">Civil Conflict</a> <a data-filter=".selector-theme-gentrification">Gentrification</a> <a data-filter=".selector-theme-health">Health</a> <a data-filter=".selector-theme-internationalaid">International Aid</a> <a data-filter=".selector-theme-modernwarfare">Modern Warfare</a> <a data-filter=".selector-theme-prisonpolicy">Prison Policy</a> <a data-filter=".selector-theme-sharepsi">Share PSI</a> <a data-filter=".selector-theme-transport">Transport</a> </span> </li> <li class="filter"> <a>Tags</a> <span class="filter-items"> <a data-filter=".selector-tag-civilconflict"> Civil Conflict</a> <a data-filter=".selector-tag-crime"> Crime</a> <a data-filter=".selector-tag-development"> Development</a> <a data-filter=".selector-tag-drones"> Drones</a> <a data-filter=".selector-tag-e-government"> E-Government</a> <a data-filter=".selector-tag-foreignaffairs"> Foreign Affairs</a> <a data-filter=".selector-tag-housingprices"> Housing Prices</a> <a data-filter=".selector-tag-humanrights"> Human Rights</a> <a data-filter=".selector-tag-incarcerationrates"> Incarceration Rates</a> <a data-filter=".selector-tag-internaldisplacement"> Internal Displacement</a> <a data-filter=".selector-tag-internationalconflict"> International Conflict</a> <a data-filter=".selector-tag-internationalsecurity"> International Security</a> <a data-filter=".selector-tag-metro"> Metro</a> <a data-filter=".selector-tag-sharepsi"> Share PSI</a> <a data-filter=".selector-tag-transparency"> Transparency</a> <a data-filter=".selector-tag-corruption"> corruption</a> <a data-filter=".selector-tag-development"> development</a> <a data-filter=".selector-tag-e-government"> e-government</a> <a data-filter=".selector-tag-foreignpolicy"> foreign policy</a> <a data-filter=".selector-tag-metro"> metro</a> <a data-filter=".selector-tag-publictransit"> public transit</a> <a data-filter=".selector-tag-ride-sharing"> ride-sharing</a> <a data-filter=".selector-tag-gentrification">Gentrification</a> <a data-filter=".selector-tag-internationalaid">International Aid</a> <a data-filter=".selector-tag-modernwarfare">Modern Warfare</a> <a data-filter=".selector-tag-prisonpolicy">Prison Policy</a> <a data-filter=".selector-tag-taxi">Taxi</a> <a data-filter=".selector-tag-transparency">Transparency</a> <a data-filter=".selector-tag-insurance">insurance</a> <a data-filter=".selector-tag-internationalaid">international aid</a> <a data-filter=".selector-tag-transparency">transparency</a> </span> </li> </ul> </li>  <li class="Selected"> <a href="/contribute/">Contribute</a> <ul> <li > <a href="/contribute/">Contributing To The Handbook</a> </li> <li > <a href="/contribute/adding/">Adding A Page</a> </li> <li > <a href="/contribute/editing/">Editing A Page</a> </li> <li > <a href="/contribute/add-term/">Adding A Term To The Glossary</a> </li> <li > <a href="/contribute/add-resource/">Adding A Resource To The Library</a> </li> <li class="Selected"> <a href="/contribute/translate-guide/">Translating The Guide</a> </li> <li > <a href="/contribute/translate-glossary/">Translating The Glossary</a> </li> <li > <a href="/contribute/markdown-examples/">Markdown Examples</a> </li> </ul> </li>  <li> <a href="/credits/">Credits</a> </li> </ul> </nav> <div class="page-content"> <div class="docs"> <article class="post-content"> <a href="/contribute/" class="pre-header">contribute</a> <h1 class="post-title">Translating the guide</h1> <div class="author">Written by <ul> <li>Mor Rubinstein</li> </ul> </div> <p class="lead">Translating the guide is easy, no need to any other software, all you need is a github account!</p> <p>Some languages already have translated versions of the guide. If you don’t have a version in your language, here is how to do it.</p> <h2 id="1-create-a-new-language-folder">1. Create a new language folder</h2> <p>In github, under the breadcrumb - <code class="highlighter-rouge">opendatahandbook / guide /</code> there will be a plus symbol <code class="icon-plus"><span>[plus icon]</span></code>. Click on it and enter your <a href="https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes">two letter languages code</a>. Add a slash (‘/’) after the two letter to create a folder.</p> <h2 id="2-create-a-page-folder">2. Create a page folder</h2> <p>Now you will see your language code and a plus symbol <code class="icon-plus"><span>[plus icon]</span></code> on the breadcrumb. Add a page name that you want to translate in <strong>English</strong> and add a slash at the end.</p> <h2 id="3-translate-the-content">3. Translate the content</h2> <p>You will now see a new plus symbol <code class="icon-plus"><span>[plus icon]</span></code>. Add the file name ‘index.md’.</p> <p>In the text editor add the following front matter:</p> <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>--- section: guide lang: The two letter code for your language title: The title in your language --- </code></pre></div></div> <p>Translate as usual.</p> <h2 id="4-create-a-pull-request">4. Create a pull request</h2> <p>If all good, we will add it to the site.</p> <p>Repeat for other parts of the guide if needed. That’s it, you are all done!<br /> Thank you for helping us to make the guide accessiable to others!</p> </article> </div> <div class="page-tools"> <ul> <li class="edit tooltip-item"> Improve this page <span class="tooltip"> <a href="https://github.com/okfn/opendatahandbook/edit/master/contribute/translate-guide.md" class="github" rel="external">Edit on Github</a> <a href="/contribute/" target="_blank">Help and instructions</a> </span> </li> <li class="donate tooltip-item"> Donate <span class="tooltip"> <p>If you have found this useful and would like to support our work please consider making a small donation.</p> <form method="post" action="https://www.paypal.com/cgi-bin/webscr" target="_blank"> <select name="currency_code"> <option value="USD">US Dollar $</option> <option value="EUR">Euro €</option> <option value="GBP">UK £</option> <option value="AUD">Australian Dollar</option> <option value="CAD">Canadian Dollar</option> <option value="CZK">Czech Koruna</option> <option value="DKK">Danish Krone</option> <option value="HKD">Hong Kong Dollar</option> <option value="HUF">Hungarian Forint</option> <option value="JPY">Japanese Yen</option> <option value="NOK">Norwegian Krone</option> <option value="NZD">New Zealand Dollar</option> <option value="PLN">Polish Zloty</option> <option value="SEK">Swedish Krona</option> <option value="SGD">Singapore Dollar</option> <option value="CHF">Swiss Franc</option> </select> <input type="text" value="2.00" name="amount"> <input type="submit" value="Donate via PayPal" name="submit"> <img width="1" border="0" height="1" src="https://www.paypal.com/en_GB/i/scr/pixel.gif" alt=""> <img width="1" border="0" height="1" src="https://www.paypal.com/en_US/i/scr/pixel.gif" alt=""> <input type="hidden" value="_xclick" name="cmd"> <input type="hidden" value="admin@okfn.org" name="business"> <input type="hidden" value="Open Data Handbook Donation to Open Knowledge" name="item_name"> </form> </span> </li> <li class="share tooltip-item"> Share <span class="tooltip"> <a href="https://www.facebook.com/sharer/sharer.php?u=http://opendatahandbook.org/contribute/translate-guide/" class="facebook" rel="external">Share on Facebook</a> <a href="https://twitter.com/home?status=Translating the guide: http://opendatahandbook.org/contribute/translate-guide/" class="twitter" rel="external">Share on Twitter</a> </span> </li> </ul> </div> </div> <footer class="site-footer"> <div> <div class="primary"> <a href="https://okfn.org/" rel="external"><img src="//a.okfn.org/img/oki/landscape-grey-468x122.png" width="123" height="32" alt="Open Knowledge International"></a> <div class="supporters"> <h6>Supported by</h6> <a href="https://www.shuttleworthfoundation.org/" rel="external"><img src="/img/supporters/shuttleworth-footer.png" alt="Shuttleworth Foundation"></a> <a href="http://www.worldbank.org/" rel="external"><img src="/img/supporters/worldbank-footer.png" alt="The World Bank"></a> <a href="http://od4d.net/" rel="external"><img src="/img/supporters/od4d-footer.png" alt="OD4D"></a> </div> </div> <div class="secondary"> <ul> <li><a href="/contribute/">Contribute</a></li> <li><a href="https://okfn.org/terms-of-use/" rel="external">Terms of use</a></li> <li><a href="https://okfn.org/privacy-policy/" rel="external">Privacy policy</a></li> <li class="button"><a href="http://opendefinition.org/" rel="external"><img src="/img/open-content.svg" width="80" height="15" alt="Open Content"/></a></li> </ul> </div> <div class="tertiary"> <div> <h6>Related Projects</h6> <ul> <li><a href="http://opengovernmentdata.org/">OpenGovernmentData.org</a></li> <li><a href="http://datahub.io/">The DataHub</a></li> <li><a href="http://dataportals.org/">DataPortals.org</a></li> <li><a href="http://openspending.org/">OpenSpending.org</a></li> <li><a href="http://schoolofdata.org/">SchoolOfData.org</a></li> <li><a href="http://opendefinition.org/">OpenDefinition.org</a></li> <li><a href="http://okfn.org/opendata/">Introducing Open Data</a></li> </ul> </div> <ul class="icons"> <li class="donate"><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=admin@okfn.org&lc=GB&item_name=Open Data Handbook%20Donation%20to%20Open%20Knowledge&no_note=0&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest" rel="external"><span>Donate</span></a></li> <li class="discuss"><a href="https://discuss.okfn.org/c/open-data-handbook" rel="external"><span>Contact</span></a></li> <li class="source"><a href="https://github.com/okfn/opendatahandbook" rel="external"><span class="text">Source</span></a></li> </ul> </div> </div> </footer> </div> </div> <script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js"></script> <script>window.jQuery || document.write('<script src="js/vendor/jquery-1.11.2.min.js"><\/script>')</script> <script src="/js/plugins.js"></script> <script src="/js/main.js"></script> <script src="//a.okfn.org/html/oki/panel/assets/js/frontend.js"></script> <script> // Append headings with link to ID function headingLink(heading) { $.each($(heading), function() { var headingID = $(this).attr('id'); var headingURL = '#' + headingID; if(typeof headingID != 'undefined') { $( this ).append( '<span class="headerlink"><a class="icon-section"></a><span class="url"><a class="icon-link" href="'+headingURL+'"></a>http://opendatahandbook.org/contribute/translate-guide/'+headingURL+'</span></span>' ); } }); } headingLink('.post h1'); headingLink('.post h2'); headingLink('.post h3'); headingLink('.post h4'); headingLink('.post h5'); headingLink('.post h6'); $(".headerlink a").click(function() { $(this).parent('.headerlink').toggleClass("active"); }); </script> </body> </html>

CINXE.COM

Translating the guide