Update translation instructions to improve clarity of differences between <=2.1 and >=2.2

zoombody 2013-02-02 08:39:28 -08:00
parent d0a69c86ba
commit 4eb54c00cf

@ -10,22 +10,24 @@ In general the steps are:
* get a copy of tracks
** either make a copy of your running tracks (to make sure you always have a working verions)
** or get it from git using @git clone git://github.com/TracksApp/tracks.git@
* create a new locale for the language you want to add to Tracks
** for Tracks 2.2, this can be done from the webpage
** for Tracks 2.1, create an empty locale file in @/config/locales@, i.e. @touch /path/to/copy/of/tracks/config/locales/XX.yml@
** or get it from git using @git clone https://github.com/TracksApp/tracks.git@
* for Tracks 2.1, create a new locale for the language you want to add to Tracks
** create an empty locale file in @/config/locales@, i.e. @touch /path/to/copy/of/tracks/config/locales/XX.yml@
*** @XX.yml@ is the locale file for your language where @XX@ is the short name for your country like the following who are already there: en (english) or de (german) or nl (dutch).
* run Tracks in development mode: @script/server -e development@
** this will run tracks on localhost on port 3000
* Make sure the database is current: @bundle exec rake db:migrate@
** this will require you to configure a database in @config/databases.yml@ for the development environment. To be safe, use a copy of your database or make backups!
** Make sure the database is current: @rake db:migrate@
* launch the built-in Tracks server in development mode:
** for Tracks 2.2: @bundle exec rails s@
** for Tracks 2.1: @script/server -e development@
** this will run tracks on localhost on port 3000
** access it by pointing your webbrowser to @http://localhost:3000@
* go to your preferences page and select your language as default
** all pages should look wrong or fail or just display everything in English (fallback option). No worry!
* For Tracks 2.2, import the existing translations into the Tolk database: @bundle exec rake tolk:sync && bundle exec rake tolk:import@
* For Tracks 2.2, point your browser to @http://localhost:3000/tolk@
** Select the language you want to work on or create a new one
** When you are done, either submit the new language file to Assembla or create a pull request
*** using @rake tolk:dump_all@ will write all changes to the locale files in @/path/to/tracks/config/locale@. You can then test it on @http://localhost:3000@
*** using @bundle exec rake tolk:dump_all@ will write all changes to the locale .yml files in @/path/to/tracks/config/locale@. You can then test it on @http://localhost:3000@
*** Or: download the locale file: @http://localhost:3000/tolk/locales/XX.yml@ where @XX@ is the name of your locale (for example nl or de or cz)
* For Tracks 2.1, point your browser to @http://localhost:3000/translate@
** this is the translate plug-in that will show you all strings that need to be translated