diff --git a/tracks/db/schema.rb b/tracks/db/schema.rb index 30485695..e90254cf 100644 --- a/tracks/db/schema.rb +++ b/tracks/db/schema.rb @@ -5,16 +5,16 @@ ActiveRecord::Schema.define(:version => 38) do create_table "contexts", :force => true do |t| - t.column "name", :string, :default => "", :null => false - t.column "position", :integer + t.column "name", :string, :null => false + t.column "position", :integer, :default => 0 t.column "hide", :boolean, :default => false t.column "user_id", :integer, :default => 1 t.column "created_at", :datetime t.column "updated_at", :datetime end - add_index "contexts", ["user_id"], :name => "index_contexts_on_user_id" add_index "contexts", ["user_id", "name"], :name => "index_contexts_on_user_id_and_name" + add_index "contexts", ["user_id"], :name => "index_contexts_on_user_id" create_table "notes", :force => true do |t| t.column "user_id", :integer, :null => false @@ -24,8 +24,8 @@ ActiveRecord::Schema.define(:version => 38) do t.column "updated_at", :datetime end - add_index "notes", ["project_id"], :name => "index_notes_on_project_id" add_index "notes", ["user_id"], :name => "index_notes_on_user_id" + add_index "notes", ["project_id"], :name => "index_notes_on_project_id" create_table "open_id_associations", :force => true do |t| t.column "server_url", :binary @@ -68,8 +68,8 @@ ActiveRecord::Schema.define(:version => 38) do add_index "preferences", ["user_id"], :name => "index_preferences_on_user_id" create_table "projects", :force => true do |t| - t.column "name", :string, :default => "", :null => false - t.column "position", :integer + t.column "name", :string, :null => false + t.column "position", :integer, :default => 0 t.column "user_id", :integer, :default => 1 t.column "description", :text t.column "state", :string, :limit => 20, :default => "active", :null => false @@ -79,8 +79,8 @@ ActiveRecord::Schema.define(:version => 38) do t.column "completed_at", :datetime end - add_index "projects", ["user_id"], :name => "index_projects_on_user_id" add_index "projects", ["user_id", "name"], :name => "index_projects_on_user_id_and_name" + add_index "projects", ["user_id"], :name => "index_projects_on_user_id" create_table "sessions", :force => true do |t| t.column "session_id", :string @@ -88,7 +88,7 @@ ActiveRecord::Schema.define(:version => 38) do t.column "updated_at", :datetime end - add_index "sessions", ["session_id"], :name => "sessions_session_id_index" + add_index "sessions", ["session_id"], :name => "index_sessions_on_session_id" create_table "taggings", :force => true do |t| t.column "taggable_id", :integer @@ -110,7 +110,7 @@ ActiveRecord::Schema.define(:version => 38) do create_table "todos", :force => true do |t| t.column "context_id", :integer, :null => false t.column "project_id", :integer - t.column "description", :string, :default => "", :null => false + t.column "description", :string, :null => false t.column "notes", :text t.column "created_at", :datetime t.column "due", :date @@ -120,15 +120,15 @@ ActiveRecord::Schema.define(:version => 38) do t.column "state", :string, :limit => 20, :default => "immediate", :null => false end - add_index "todos", ["user_id", "state"], :name => "index_todos_on_user_id_and_state" - add_index "todos", ["user_id", "project_id"], :name => "index_todos_on_user_id_and_project_id" - add_index "todos", ["project_id"], :name => "index_todos_on_project_id" - add_index "todos", ["context_id"], :name => "index_todos_on_context_id" add_index "todos", ["user_id", "context_id"], :name => "index_todos_on_user_id_and_context_id" + add_index "todos", ["context_id"], :name => "index_todos_on_context_id" + add_index "todos", ["project_id"], :name => "index_todos_on_project_id" + add_index "todos", ["user_id", "project_id"], :name => "index_todos_on_user_id_and_project_id" + add_index "todos", ["user_id", "state"], :name => "index_todos_on_user_id_and_state" create_table "users", :force => true do |t| - t.column "login", :string, :limit => 80, :default => "", :null => false - t.column "crypted_password", :string, :limit => 40 + t.column "login", :string, :limit => 80, :null => false + t.column "crypted_password", :string, :limit => 40, :null => false t.column "token", :string t.column "is_admin", :boolean, :default => false, :null => false t.column "first_name", :string diff --git a/tracks/db/tracks-15-blank.db b/tracks/db/tracks-15-blank.db new file mode 100644 index 00000000..b3597802 Binary files /dev/null and b/tracks/db/tracks-15-blank.db differ diff --git a/tracks/db/tracks-15.db b/tracks/db/tracks-15-example.db similarity index 78% rename from tracks/db/tracks-15.db rename to tracks/db/tracks-15-example.db index 57a58930..b9b4473b 100644 Binary files a/tracks/db/tracks-15.db and b/tracks/db/tracks-15-example.db differ diff --git a/tracks/doc/manual.html b/tracks/doc/manual.html index 9f591444..679c9a21 100644 --- a/tracks/doc/manual.html +++ b/tracks/doc/manual.html @@ -8,13 +8,13 @@ - - + - + Tracks 1.5 Manual @@ -29,7 +29,7 @@ http://creativecommons.org/licenses/by-nc-sa/3.0/" />

Tracks 1.5 has been thoroughly beta tested by a large number of people, and should be fully stable for everyday use. However, once set up, Tracks will contain the majority of your plans for your work and personal life, so it’s only sensible to make sure that you have frequent, reliable backups of your data. Full changenotes on the release can be found in doc/CHANGELOG. Full API documentation can be found at doc/app/index.html, once you have run rake appdoc

-

There are two methods of downloading Tracks 1.5:

+

There are two methods of downloading Tracks 1.5 (N.B. These links will not work until Tracks 1.5 final is released)):

  1. (Recommended for most people) Download the zipped package, and unzip in your preferred location (e.g. ~/Sites for Mac OS X users).
    2. @@ -54,7 +54,7 @@ http://creativecommons.org/licenses/by-nc-sa/3.0/" />

    This is the easiest solution for Mac OS X 10.4 or Windows users wanting to run Tracks locally.

      -
    1. Mac OS X. Locomotive is an all-in one installer for Mac OS X 10.4, which includes everything you need to run Tracks with a SQLite3 database. Locomotive isn’t currently Leopard compatible, and doesn’t work with Panther.
      2. +
    2. Mac OS X. Locomotive is an all-in one installer for Mac OS X 10.4, which includes everything you need to run Tracks with a SQLite3 database. Locomotive doesn’t work with Panther, and isn’t really required for Leopard because the default Rails installation works very well. However, if you prefer to use Locomotive, it does work on Leopard.
    3. Windows. Instant Rails includes everything you need, including MySQL.
    @@ -118,7 +118,7 @@ http://creativecommons.org/licenses/by-nc-sa/3.0/" />
    1. If you downloaded Tracks 1.5 via Subversion, you need to duplicate the files database.yml.tmpl and environment.yml.tmpl and remove the *.tmpl extension from the duplicates. Similarly, duplicate /log.tmpl and remove the *.tmpl extension, then edit the files as described in steps 2 and 3.
      2. -
    2. Open the file /config/database.yml and edit the production: section with the details of your database. If you are using MySQL the adapter: line should read adapter: mysql, host: localhost (in the majority of cases), and your username and password should match those you assigned when you created the database. If you are using SQLite3, you should have only two lines under the production section: adapter: sqlite3 and database: db/tracks-15.db.
      3. +
    3. Open the file /config/database.yml and edit the production: section with the details of your database. If you are using MySQL the adapter: line should read adapter: mysql, host: localhost (in the majority of cases), and your username and password should match those you assigned when you created the database. If you are using SQLite3, you should have only two lines under the production section: adapter: sqlite3 and database: db/tracks-15-blank.db. If you downloaded the zipped file, the database.yml file is already configured to use the provided SQLite3 file.
    4. Open the file /config/environment.rb, and read through the settings to make sure that they suit your setup. In most cases, all you need to change is the SALT = "change-me" line (change the string “change-me” to some other string of your choice), and the time zone setting.
    5. If you are using Windows, you may need to check the ‘shebang’ lines (#!/usr/bin/env ruby) of the /public/dispatch.* files and all the files in the /script directory. They are set to #!/usr/bin/env ruby by default. This should work for all *nix based setups (Linux or Mac OS X), but Windows users will probably have to change it to something like #c:/ruby/bin/ruby to point to the Ruby binary on your system.
    diff --git a/tracks/doc/manual.markdown b/tracks/doc/manual.markdown index f2dd9a35..148a7f8c 100644 --- a/tracks/doc/manual.markdown +++ b/tracks/doc/manual.markdown @@ -1,9 +1,9 @@ Title: Tracks 1.5 Manual Author: Tracks Development Team -Date: 2007-11-25 -Revision: $Id: manual.markdown 654 2007-12-16 15:01:05Z bsag $ +Date: 2008-03-06 +Revision: $Id: manual.markdown 733 2008-03-06 17:42:00Z bsag $ Version: 1.5 -Copyright: 2007 rousette.org.uk +Copyright: 2008 rousette.org.uk This work is licensed under a Creative Commons License. http://creativecommons.org/licenses/by-nc-sa/3.0/ XMP: CCAttributionShareAlike @@ -20,7 +20,7 @@ CSS: manual.css Tracks 1.5 has been thoroughly beta tested by a large number of people, and should be fully stable for everyday use. However, once set up, Tracks will contain the majority of your plans for your work and personal life, so it's only sensible to make sure that you have frequent, reliable backups of your data. Full changenotes on the release can be found in `doc/CHANGELOG`. Full API documentation can be found at `doc/app/index.html`, once you have run `rake appdoc` -There are two methods of downloading Tracks 1.5: +There are two methods of downloading Tracks 1.5 **(N.B. These links will not work until Tracks 1.5 final is released)**): 1. (Recommended for most people) Download the [zipped package](http://www.rousette.org.uk/projects/files/tracks-current.zip), and unzip in your preferred location (e.g. `~/Sites` for Mac OS X users). 2. Download using Subversion: @@ -41,7 +41,7 @@ Tracks stores its data in a database, and you can either use SQLite3, MySQL or P This is the easiest solution for Mac OS X 10.4 or Windows users wanting to run Tracks locally. -1. **Mac OS X**. [Locomotive](http://locomotive.sourceforge.net/) is an all-in one installer for Mac OS X 10.4, which includes everything you need to run Tracks with a SQLite3 database. Locomotive isn't currently Leopard compatible, and doesn't work with Panther. +1. **Mac OS X**. [Locomotive](http://locomotive.sourceforge.net/) is an all-in one installer for Mac OS X 10.4, which includes everything you need to run Tracks with a SQLite3 database. Locomotive doesn't work with Panther, and isn't really required for Leopard because the default Rails installation works very well. However, if you prefer to use Locomotive, it does work on Leopard. 2. **Windows**. [Instant Rails](http://instantrails.rubyforge.org/wiki/wiki.pl) includes everything you need, including MySQL. ### What is included with the Tracks package ### @@ -94,7 +94,7 @@ Before you go any further, you need to decide which database you will use. See t ### Configure variables [config_install] ### 1. If you downloaded Tracks 1.5 via Subversion, you need to duplicate the files `database.yml.tmpl` and `environment.yml.tmpl` and remove the `*.tmpl` extension from the duplicates. Similarly, duplicate `/log.tmpl` and remove the `*.tmpl` extension, then edit the files as described in steps 2 and 3. -2. Open the file `/config/database.yml` and edit the `production:` section with the details of your database. If you are using MySQL the `adapter:` line should read `adapter: mysql`, `host: localhost` (in the majority of cases), and your username and password should match those you assigned when you created the database. If you are using SQLite3, you should have only two lines under the production section: `adapter: sqlite3` and `database: db/tracks-15.db`. +2. Open the file `/config/database.yml` and edit the `production:` section with the details of your database. If you are using MySQL the `adapter:` line should read `adapter: mysql`, `host: localhost` (in the majority of cases), and your username and password should match those you assigned when you created the database. If you are using SQLite3, you should have only two lines under the production section: `adapter: sqlite3` and `database: db/tracks-15-blank.db`. If you downloaded the zipped file, the database.yml file is already configured to use the provided SQLite3 file. 3. Open the file `/config/environment.rb`, and read through the settings to make sure that they suit your setup. In most cases, all you need to change is the `SALT = "change-me"` line (change the string "change-me" to some other string of your choice), and the time zone setting. 4. If you are using Windows, you may need to check the 'shebang' lines (`#!/usr/bin/env ruby`) of the `/public/dispatch.*` files and all the files in the `/script` directory. They are set to `#!/usr/bin/env ruby` by default. This should work for all *nix based setups (Linux or Mac OS X), but Windows users will probably have to change it to something like `#c:/ruby/bin/ruby` to point to the Ruby binary on your system. diff --git a/tracks/doc/manual.pdf b/tracks/doc/manual.pdf index 6a8d04fd..e69de29b 100644 Binary files a/tracks/doc/manual.pdf and b/tracks/doc/manual.pdf differ diff --git a/tracks/doc/manual.tex b/tracks/doc/manual.tex index 8f465e86..46c728f9 100644 --- a/tracks/doc/manual.tex +++ b/tracks/doc/manual.tex @@ -44,7 +44,7 @@ \chapterstyle{BlueBox} \setsecheadstyle{\sffamily\bfseries\Large} -\setsubsecheadstyle{\sffamily\bfseries\Normal} +\setsubsecheadstyle{\sffamily\bfseries\normal} \makepagestyle{myruledpagestyle} \makeevenhead{myruledpagestyle}{\thepage}{}{\leftmark} @@ -112,11 +112,11 @@ \usepackage{booktabs} % Better tables \usepackage{tabulary} % Support longer table cells \usepackage[utf8]{inputenc} % For UTF-8 support -% \usepackage{xcolor} % Allow for color (annotations) +\usepackage{xcolor} % Allow for color (annotations) %\geometry{landscape} % Activate for rotated page geometry -% \usepackage[parfill]{parskip} % Activate to begin paragraphs with an empty +\usepackage[parfill]{parskip} % Activate to begin paragraphs with an empty % line rather than an indent @@ -129,15 +129,15 @@ \VerbatimFootnotes \def\myauthor{Tracks Development Team} \def\baseheaderlevel{2} -\def\mycopyright{2007 rousette.org.uk \\ This work is licensed under a Creative Commons License. \\ http://creativecommons.org/licenses/by-nc-sa/3.0/} -\date{2007-11-25} +\def\mycopyright{2008 rousette.org.uk \\ This work is licensed under a Creative Commons License. \\ http://creativecommons.org/licenses/by-nc-sa/3.0/} +\date{2008-03-06} \def\format{complete} \def\latexxslt{memoir-twosided-manual.xslt} -\def\revision{Revision: \$Id: manual.markdown 654 2007-12-16 15:01:05Z bsag \$} +\def\revision{Revision: \$Id: manual.markdown 733 2008-03-06 17:42:00Z bsag \$} \def\mytitle{Tracks 1.5 Manual} \def\version{1.5} -% \usepackage{xmpincl} -% \includexmp{CCAttributionShareAlike} +\usepackage{xmpincl} +\includexmp{CCAttributionShareAlike} % @@ -263,7 +263,7 @@ Tracks 1.5 has been thoroughly beta tested by a large number of people, and should be fully stable for everyday use. However, once set up, Tracks will contain the majority of your plans for your work and personal life, so it's only sensible to make sure that you have frequent, reliable backups of your data. Full changenotes on the release can be found in \texttt{doc/CHANGELOG}. Full API documentation can be found at \texttt{doc/app/index.html}, once you have run \texttt{rake appdoc} -There are two methods of downloading Tracks 1.5: +There are two methods of downloading Tracks 1.5 \textbf{(N.B. These links will not work until Tracks 1.5 final is released)}): \begin{enumerate} @@ -303,7 +303,7 @@ This is the easiest solution for Mac OS X 10.4 or Windows users wanting to run T \begin{enumerate} -\item \textbf{Mac OS X}. \href{http://locomotive.sourceforge.net/}{Locomotive} is an all-in one installer for Mac OS X 10.4, which includes everything you need to run Tracks with a SQLite3 database. Locomotive isn't currently Leopard compatible, and doesn't work with Panther. +\item \textbf{Mac OS X}. \href{http://locomotive.sourceforge.net/}{Locomotive} is an all-in one installer for Mac OS X 10.4, which includes everything you need to run Tracks with a SQLite3 database. Locomotive doesn't work with Panther, and isn't really required for Leopard because the default Rails installation works very well. However, if you prefer to use Locomotive, it does work on Leopard. \item \textbf{Windows}. \href{http://instantrails.rubyforge.org/wiki/wiki.pl}{Instant Rails} includes everything you need, including MySQL. \end{enumerate} @@ -411,7 +411,7 @@ Before you go any further, you need to decide which database you will use. See t \item If you downloaded Tracks 1.5 via Subversion, you need to duplicate the files \texttt{database.yml.tmpl} and \texttt{environment.yml.tmpl} and remove the \texttt{*.tmpl} extension from the duplicates. Similarly, duplicate \texttt{/log.tmpl} and remove the \texttt{*.tmpl} extension, then edit the files as described in steps 2 and 3. -\item Open the file \texttt{/config/database.yml} and edit the \texttt{production:} section with the details of your database. If you are using MySQL the \texttt{adapter:} line should read \texttt{adapter: mysql}, \texttt{host: localhost} (in the majority of cases), and your username and password should match those you assigned when you created the database. If you are using SQLite3, you should have only two lines under the production section: \texttt{adapter: sqlite3} and \texttt{database: db/tracks-15.db}. +\item Open the file \texttt{/config/database.yml} and edit the \texttt{production:} section with the details of your database. If you are using MySQL the \texttt{adapter:} line should read \texttt{adapter: mysql}, \texttt{host: localhost} (in the majority of cases), and your username and password should match those you assigned when you created the database. If you are using SQLite3, you should have only two lines under the production section: \texttt{adapter: sqlite3} and \texttt{database: db/tracks-15-blank.db}. If you downloaded the zipped file, the database.yml file is already configured to use the provided SQLite3 file. \item Open the file \texttt{/config/environment.rb}, and read through the settings to make sure that they suit your setup. In most cases, all you need to change is the \texttt{SALT = "change-me"} line (change the string ``change-me" to some other string of your choice), and the time zone setting.