diff --git a/Translating-tracks.textile b/Translating-tracks.textile index 293c8c3..c6e10ea 100644 --- a/Translating-tracks.textile +++ b/Translating-tracks.textile @@ -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