# Added time zone setting to environment.rb.tmpl. It's commented out by default, but if your server is set to a different time zone than the local machine on which you access Tracks, you can set your local time zone here to have all of the dates adjusted. This setting is global for all users, and is an interim measure until I can get per-user time zone settings working. Fixes #238.

# Added config/environment.rb.tmpl and set svn:ignore on environment.rb so that your personal setting for SALT and ENV['TZ'] isn't committed to the public repository if you have commit access. You need to copy the changes in environment.rb.tmpl to your environment.rb if you already have an installation, or copy environment.rb.tmpl to environment.rb if it's a new installation. Fixes #235.



git-svn-id: http://www.rousette.org.uk/svn/tracks-repos/trunk@226 a4c988fc-2ded-0310-b66e-134b36920a42

tracks/config/environment.rb

@@ -51,4 +51,12 @@ end
 # Include your application configuration below
 # This is the 'salt' to add to the password before it is encrypted
 # You need to change this to something unique for yourself
-SALT = "change-me"
+SALT = "change-me"
+
+# Time zone setting. If the server on which you run Tracks is not the same
+# as the time zone in which you are using it, you can uncomment the line below
+# and set the time zone to your own (local value) to make the display of dates
+# correct. You should be able to find a list of time zones in /usr/share/zoneinfo
+# e.g. if you are in the Eastern time zone of the US, but your server runs under
+# the GMT timezone, set the value below.
+# ENV['TZ'] = 'US/Eastern'

tracks/config/environment.rb.tmpl

@@ -0,0 +1,62 @@
+# Be sure to restart your webserver when you modify this file.
+# Uncomment below to force Rails into production mode
+
+# (Use only when you can't set environment variables through your web/app server)
+# ENV['RAILS_ENV'] = 'production'
+
+# Bootstrap the Rails environment, frameworks, and default configuration
+require File.join(File.dirname(__FILE__), 'boot')
+
+Rails::Initializer.run do |config|
+  # Skip frameworks you're not going to use
+  # config.frameworks -= [ :action_web_service, :action_mailer ]
+
+  # Add additional load paths for your own custom dirs
+  # config.load_paths += %W( #{RAILS_ROOT}/app/services )
+
+  # Force all environments to use the same logger level 
+  # (by default production uses :info, the others :debug)
+  # config.log_level = :debug
+
+  # Use the database for sessions instead of the file system
+  # (create the session table with 'rake create_sessions_table')
+  config.action_controller.session_store = :active_record_store
+
+  # Enable page/fragment caching by setting a file-based store
+  # (remember to create the caching directory and make it readable to the application)
+  # config.action_controller.fragment_cache_store = :file_store, "#{RAILS_ROOT}/cache"
+
+  # Activate observers that should always be running
+  # config.active_record.observers = :cacher, :garbage_collector
+
+  # Make Active Record use UTC-base instead of local time
+  # config.active_record.default_timezone = :utc
+  
+  # Use Active Record's schema dumper instead of SQL when creating the test database
+  # (enables use of different database adapters for development and test environments)
+  config.active_record.schema_format = :ruby
+
+  # See Rails::Configuration for more options
+end
+
+# Add new inflection rules using the following format 
+# (all these examples are active by default):
+# Inflector.inflections do |inflect|
+#   inflect.plural /^(ox)$/i, '\1en'
+#   inflect.singular /^(ox)en/i, '\1'
+#   inflect.irregular 'person', 'people'
+#   inflect.uncountable %w( fish sheep )
+# end
+
+# Include your application configuration below
+# This is the 'salt' to add to the password before it is encrypted
+# You need to change this to something unique for yourself
+SALT = "change-me"
+
+# Time zone setting. If the server on which you run Tracks is not the same
+# as the time zone in which you are using it, you can uncomment the line below
+# and set the time zone to your own (local value) to make the display of dates
+# correct. You should be able to find a list of time zones in /usr/share/zoneinfo
+# e.g. if you are in the Eastern time zone of the US, but your server runs under
+# the GMT timezone, set the value below.
+# ENV['TZ'] = 'US/Eastern'

tracks/installation.html

@@ -50,9 +50,9 @@
 </pre>
 
 <ul>
-<li>Copy the file <code>config/database.yml.tmpl</code> to <code>config/database.yml</code>, and <code>log.tmpl</code> to <code>log</code>.</li>
+<li>Copy the file <code>config/database.yml.tmpl</code> to <code>config/database.yml</code>, <code>config/environment.rb.tmpl</code> to <code>config/environment.rb</code> and <code>log.tmpl</code> to <code>log</code>.</li>
 <li>Open the <code>tracks/config/database.yml</code> file, and enter your username and password details for the database you just set up under the 'production' and 'development' sections. <strong>NB</strong>: If you do set up the entry for 'test', make sure that you specify a different database, or when you run tests, they will overwrite your data. It's very important that you don't use TABS in any of the <code>*.yml</code> files. Just use spaces to indent.</li>
-<li>Open the file <code>config/environment.rb</code> and look at the last line which should read: <code>SALT = "change-me"</code>. Change the word change-me to something else of your choosing. This string will be used as a 'salt' to encrypt your password and make it a bit more secure.</li>
+<li>Open the file <code>config/environment.rb</code> and look at the last line which should read: <code>SALT = "change-me"</code>. Change the word change-me to something else of your choosing. This string will be used as a 'salt' to encrypt your password and make it a bit more secure. Also look at the timezone setting at the bottom. You can leave it commented out if your server is in the same time zone as you, but you may need to adjust it if your server is in a different time zone.</li>
 <li>Run 'rake migrate', which will create the necessary tables in your database, including some required contents:</li>
 </ul>
 
@@ -99,8 +99,8 @@ database: /PATH/TO/TRACKS/db/tracks-104.db
 <ul>
 <li>For safety, rename your current Tracks directory to 'tracks-old' or something similar.</li>
 <li>Before you do anything else, <strong>BACK UP YOUR DATABASE</strong> (tables and content) and keep the SQL dumps somewhere safe so that you can recreate the old database if necesary.</li>
-<li>Copy the file <code>config/database.yml.tmpl</code> to <code>config/database.yml</code>, and copy <code>log.tmpl</code> to <code>log</code></li>
-<li>Open the file <code>config/environment.rb</code> and look at the last line which should read: <code>SALT = "change-me"</code>. Change the word change-me to something else of your choosing. This string will be used as a 'salt' to encrypt your password and make it a bit more secure.</li>
+<li>Copy the file <code>config/database.yml.tmpl</code> to <code>config/database.yml</code>, <code>config/environment.rb.tmpl</code> to <code>config/environment.rb</code> and <code>log.tmpl</code> to <code>log</code>.</li>
+<li>Open the file <code>config/environment.rb</code> and look at the last line which should read: <code>SALT = "change-me"</code>. Change the word change-me to something else of your choosing. This string will be used as a 'salt' to encrypt your password and make it a bit more secure. Also look at the timezone setting at the bottom. You can leave it commented out if your server is in the same time zone as you, but you may need to adjust it if your server is in a different time zone.</li>
 <li>In <code>database.yml</code> insert your old database name, user and password under the 'development' section.</li>
 <li>Run the command <code>rake extract_fixtures</code> inside the Tracks directory. This will populate the <code>db/exported_fixtures</code> directory with <code>*.yml</code> files corresponding to the contexts, projects and todos table from the contents of your old database.</li>
 <li>Open <code>db/exported_fixtures/todos.yml</code> and search for the lines starting <code>created:</code> and replace with <code>created_at:</code>.</li>
@@ -117,8 +117,8 @@ database: /PATH/TO/TRACKS/db/tracks-104.db
 <ul>
 <li>For safety, rename your current Tracks directory to 'tracks-old' or something similar (making sure that you keep your old database safe), create a new directory for the new version.</li>
 <li>Copy (NOT MOVE!) your old database into the new tracks/db directory.</li>
-<li>Copy the file <code>config/database.yml.tmpl</code> to <code>config/database.yml</code>, and copy <code>log.tmpl</code> to <code>log</code></li>
-<li>Open the file <code>config/environment.rb</code> and look at the last line which should read: <code>SALT = "change-me"</code>. Change the word change-me to something else of your choosing. This string will be used as a 'salt' to encrypt your password and make it a bit more secure.</li>
+<li>Copy the file <code>config/database.yml.tmpl</code> to <code>config/database.yml</code>, <code>config/environment.rb.tmpl</code> to <code>config/environment.rb</code> and <code>log.tmpl</code> to <code>log</code>.</li>
+<li>Open the file <code>config/environment.rb</code> and look at the last line which should read: <code>SALT = "change-me"</code>. Change the word change-me to something else of your choosing. This string will be used as a 'salt' to encrypt your password and make it a bit more secure. Also look at the timezone setting at the bottom. You can leave it commented out if your server is in the same time zone as you, but you may need to adjust it if your server is in a different time zone.</li>
 <li>In <code>database.yml</code> insert your old database name, user and password under the 'development' section.</li>
 <li>Run the command <code>rake extract_fixtures</code> inside the Tracks directory. This will populate the <code>db/exported_fixtures</code> directory with <code>*.yml</code> files corresponding to the contexts, projects and todos table from the contents of your old database.</li>
 <li>Open <code>db/exported_fixtures/todos.yml</code> and search for the lines starting <code>created:</code> and replace with <code>created_at:</code>, and <code>done: "0"</code> with <code>done: "f"</code> and <code>done: "1"</code> with <code>done: "t"</code>. You need to replace the similar 'done' lines in <code>projects.yml</code>, and in <code>contexts.yml</code> replace <code>hide: "0"</code> with <code>hide: "f"</code> and <code>hide: "1"</code> with <code>hide: "t"</code>.</li>