<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html> <head> <title>FreeGuide : Translate Free Guide </title> <meta http-equiv='Content-Style-Type' content='text/css' /> <link rel='stylesheet' href='../pub/skins/plain-freeguide/plain1.css' type='text/css' /> <link rel="icon" href="../pub/skins/plain-freeguide/favicon.gif" type="image/x-icon" /> <link rel="shortcut icon" href="../pub/skins/plain-freeguide/favicon.gif" type="image/x-icon" /> <!--HeaderText--><style type='text/css'><!-- ul, ol, pre, dl, p { margin-top:0px; margin-bottom:0px; } code.escaped { white-space: nowrap; } .vspace { margin-top:1.33em; } .indent { margin-left:40px; } .outdent { margin-left:40px; text-indent:-40px; } a.createlinktext { text-decoration:none; border-bottom:1px dotted gray; } a.createlink { text-decoration:none; position:relative; top:-0.5em; font-weight:bold; font-size:smaller; border-bottom:none; } img { border:0px; } .editconflict { color:green; font-style:italic; margin-top:1.33em; margin-bottom:1.33em; } table.markup { border:2px dotted #ccf; width:90%; } td.markup1, td.markup2 { padding-left:10px; padding-right:10px; } table.vert td.markup1 { border-bottom:1px solid #ccf; } table.horiz td.markup1 { width:23em; border-right:1px solid #ccf; } table.markup caption { text-align:left; } div.faq p, div.faq pre { margin-left:2em; } div.faq p.question { margin:1em 0 0.75em 0; font-weight:bold; } .frame { border:1px solid #cccccc; padding:4px; background-color:#f9f9f9; } .lfloat { float:left; margin-right:0.5em; } .rfloat { float:right; margin-left:0.5em; } a.varlink { text-decoration:none; } --></style> <meta name='robots' content='index,follow' /> <link rel='stylesheet' href='../pub/skins/plain-freeguide/plain2.css' type='text/css' /> </head> <body> <!--PageHeaderFmt--> <table id='wikihead' cellspacing='0' cellpadding='0' align='center'><tr> <td id='homelink'><img src='../pub/skins/plain-freeguide/favicon.gif' /> <a href='http://www.artificialworlds.net/freeguide'>FreeGuide</a></td> <td id='location'><span class='pagegroup'><a href='Developers.html'>Developers</a> »</span> <h1 class='pagetitle'>Translate Free Guide</h1></td> <td id='wikicmds'><ul><li class='browse'><a accesskey='' class='selflink' href='TranslateFreeGuide.html'>View</a> </li><li class='edit'> </li><li class='diff'> </li><li class='print'> </li></ul> </td> </tr></table> <!--/PageHeaderFmt--> <table id='wikimid' cellspacing='0' cellpadding='0' align='center'><tr> <!--PageLeftFmt--> <td id='wikileft' valign='top'> <p><form action='http://www.artificialworlds.net/freeguide'> <input type='hidden' name='n' value='Developers.TranslateFreeGuide' /> <input type='hidden' name='action' value='search' /> <input type='text' name='q' value=' Search ' class='inputbox searchbox' onfocus="if(this.value=' Search ') {this.value=''}" onblur="if(this.value=='') {this.value=' Search '}" /><input type='submit' class='inputbutton searchbutton' value='Go' /></form></p><br /> <ul><li><a class='wikilink' href='../Main/HomePage.html'>Home Page</a> </li><li><a class='wikilink' href='../DownloadAndInstall/DownloadAndInstall.html'>Download And Install</a> </li><li><a class='wikilink' href='../UserGuide/UserGuide.html'>User Guide</a> </li><li><a class='wikilink' href='../FAQ/FAQ.html'>Help And FAQ</a> </li><li><a class='wikilink' href='Developers.html'>Developers</a> <ul><li><span style='font-size:83%'><a class='wikilink' href='HelpUsMakeFreeGuide.html'>How to help</a></span> </li><li><span style='font-size:83%'><a class='wikilink' href='RunTheNightlyBuild.html'>Nightly Builds</a></span> </li><li><span style='font-size:83%'><a class='wikilink' href='BuildTheLatestSource.html'>Build The Latest Source</a></span> </li><li><span style='font-size:83%'><a class='wikilink' href='CodeRules.html'>Code Rules</a></span> </li><li><span style='font-size:83%'><a class='wikilink' href='CreateInstallationPackagesForDifferentPlatforms.html'>Building Installers</a></span> </li><li><span style='font-size:83%'><a class='selflink' href='TranslateFreeGuide.html'>Translate FreeGuide</a></span> </li><li><span style='font-size:83%'><a class='wikilink' href='Design.html'>Design</a></span> </li><li><span style='font-size:83%'><a class='wikilink' href='Roles.html'>Roles</a></span> </li><li><span style='font-size:83%'><a class='wikilink' href='SourceLayout.html'>Source Layout</a></span> </li><li><span style='font-size:83%'><a class='wikilink' href='ChangingTheVersion.html'>Changing The Version</a></span> </li><li><span style='font-size:83%'><a class='urllink' href='http://bugs.launchpad.net/freeguide-tv/+bugs' rel='nofollow'>Bug tracker -></a></span> </li><li><span style='font-size:83%'><a class='urllink' href='http://freeguide-tv.git.sourceforge.net/git/gitweb.cgi?p=freeguide-tv/freeguide-tv;a=tree' rel='nofollow'>Browse source -></a></span> </li><li><span style='font-size:83%'><a class='urllink' href='http://sourceforge.net/projects/freeguide-tv' rel='nofollow'>Sourceforge -></a></span> </li></ul></li><li><a class='wikilink' href='../Main/Credits.html'>Credits</a> </li><li><a class='wikilink' href='../Main/Screenshots.html'>Screenshots</a> </li><li><a class='wikilink' href='../Main/Links.html'>Links</a> </li><li><a class='wikilink' href='../Main/SiteMap.html'>Site Map</a> <div class='vspace'></div></li><li><a class='wikilink' href='../Main/ContactUs.html'>Contact Us</a> </li></ul><div class='vspace'></div> </td> <!--/PageLeftFmt--> <td id='wikibody' valign='top'> <!--PageText--> <div id='wikitext'> <h1>Translating <span class='wikiword'>FreeGuide</span></h1> <h3>Files to translate</h3> <p>You can help translating <span class='wikiword'>FreeGuide</span> by downloading a source package and providing translated versions of all the files called "something.en.properties" that you find inside the "src/resources/i18n" folder, but the best way is to <a class='wikilink' href='BuildTheLatestSource.html'>Build the latest source</a>. Then you can test your work more easily, and keep it up-to-date with the latest changes to <span class='wikiword'>FreeGuide</span>. </p> <p class='vspace'>There are quite a lot of files in the src/resources/i18n folder, but the most important (and largest) file is <span class='wikiword'>MessagesBundle</span>.en.properties. </p> <p class='vspace'>To translate a file, copy the file ending with .en.properties, and rename it for your language and region (e.g. ".fr.properties" or ".en_US.properties"). Ask on the developers' mailing list if you don't know what your language and region codes should be. Now, modify the copied file so that everything on the right-hand side of the "=" sign is in your language (leave everything on the left of the "=" exactly as it is). </p> <p class='vspace'>It looks like a lot of files, but most of these only have a few entries in them. </p> <p class='vspace'>Now send the translated files to the developers' mailing list: freeguide-tv-devel@lists.sourceforge.net. Thank you! </p> <p class='vspace'>It would also be great to get the documentation translated - email the developers to find out exactly what needs translating and how to do it. </p> <p class='vspace'>In general, we really welcome translations of <span class='wikiword'>FreeGuide</span>, so if you need help, please do ask and we'll do our best to help you. </p> <div class='vspace'></div><h3>Testing your translation</h3> <p>To test your translation, follow the instructions on how to <a class='wikilink' href='BuildTheLatestSource.html'>Build the latest source</a>. (The short answer is: run "ant compile".) </p> <p class='vspace'>Put your translated files into the src/resources/i18n folder with the others. </p> <p class='vspace'>Now run <span class='wikiword'>FreeGuide</span> from within the src directory like this: </p> <div class='vspace'></div><pre class='escaped'>cd bin java -Duser.language=zh -Duser.country=TW freeguide.startup.Startup</pre> <p class='vspace'>replacing "zh" with your language code, and "TW" with your region code. </p> <p class='vspace'>If you are not using a region code, the correct command is just: </p> <div class='vspace'></div><pre class='escaped'>cd bin java -Duser.language=zh freeguide.startup.Startup</pre> <p class='vspace'>Alternatively, if you want to test the translation inside the JAR files once they have been created (i.e. after running "ant jar") then the command would look something like this: </p> <div class='vspace'></div><pre class='escaped'>cd jar java -Duser.language=zh -Duser.country=TW -jar FreeGuide.jar</pre> <p class='vspace'>Do ask the developers (see <a class='wikilink' href='../Main/ContactUs.html'>Contact Us</a>) if you run into any problems or have questions. </p> </div> </td> </tr></table> <!--PageFooterFmt--> <table id='wikifoot' cellspacing='0' cellpadding='0' align='center'> <tr><td class='passwordlink' colspan='2'>If you would like to help improve this site, please <a class='wikilink' href='../Main/ContactUs.html'>Contact Us</a> and we will give you the password to edit pages.</td></tr> <tr> <td class='lastmod'>Page last modified on May 24, 2010, at 01:21 PM <a class='pmwikiinfolink' href="../Main/PmWikiInfo.html">PmWiki Info</a></td> <td class='footnav'><div style='text-align: right;' > <p> - - - () - </p></div> </td> </tr> </table> <!--/PageFooterFmt--> </body> </html>