taskjuggler 0.0.3 → 0.0.4

data/manual/The_TaskJuggler_Syntax

@@ -0,0 +1,104 @@
+== The TaskJuggler Syntax ==
+
+=== Understanding the Syntax Reference ===
+
+This manual provides a comprehensive reference of the TaskJuggler
+syntax. It is automatically generated from the same data that the
+parser uses to read your project files. This ensures that the
+software and the manual always match.
+
+The syntax reference is organized based on the keywords of the
+TaskJuggler syntax. There is an entry for every keyword. In some
+cases, a keyword can appear in different contexts with potentially
+different meanings. In this case, the context is provided in brackets
+after the keyword for at least one of them. That way, every keyword
+is uniquely referenced.
+
+The syntax for each keyword is described in the syntax section of the
+table that is provided for each keyword. The syntax always starts
+with the keyword. Keywords are then followed by arguments.
+In some cases, an argument can be automatically generated.  In such
+cases, the argument is enclosed in square brackets. 
+
+ keyword [<id>]
+
+Arguments can be variable or picked from a predefined list of options.
+Variable arguments are listed with their names enclosed in angle
+brackets.
+
+ keyword <name>
+
+List of predefined options are enclosed in brackets, the
+options separated by a vertical bar.
+
+ keyword ( foo | bar | foobar )
+
+Variable arguments are further described in the ''Arguments'' section of
+the keyword syntax table. The name is listed immediately followed by
+the type of the variable argument. The supported types and their
+meaning is described in the following sections.
+
+==== ABSOLUTE_ID ====
+
+An absolute identifier is composed of identifiers that are
+concatenated by dots, e. g. ''''foo.bar''''. It is used to reference
+a TaskJuggler property that lives in a hierarchical name space.
+Accounts, Tasks, Reports are examples for such hierarchical name
+spaces. To reference the sub-task ''''bar'''' of task ''''foo'''' the
+absolute ID ''''foo.bar'''' is used.
+
+==== ID ====
+
+An identifier is composed of the letters ''''a'''' to ''''z'''',
+''''A'''' to ''''Z'''', the underscore and the digits ''''0'''' to
+''''9''''. There are no limits for the number of characters, but it
+may not begin with a digit.
+
+==== INTEGER ====
+
+An integer is any natural number, e. g. ''''0'''', ''''1'''',
+''''2'''' and so on.
+
+==== STRING ====
+
+Strings are character sequences that are enclosed by special
+character marks. There are three different marks supported. For
+short strings that fit on one lines, you can either use single or
+double quotes.
+
+ 'This is a single quoted string.'
+ "This is a double quoted string."
+
+Single quoted strings may contain double quotes and vice versa.
+
+For multi-line strings cut mark strings are recommended. A
+cut-mark-string starts with ''''<nowiki>-8<-</nowiki>'''' (scissor on
+a dotted line) and ends with ''''->8-''''. The start mark must be
+immediately followed by a line break. The indentation of the first
+line must be repeated for all following lines of the string and is not
+included in the resulting strings. The terminating cut mark must only
+be preceeded by white spaces by may not be indented more than the
+first line indentation.
+
+ -8<-
+   This is a
+   multi-line
+   string.
+   ->8-
+
+=== Predefined Macros ===
+
+TaskJuggler supports a few predefined macros. These are available
+after the project header. They values correspond to the values
+provided in the project header.
+
+* ''''projectstart'''' The start date of the project.
+* ''''projectend'''' The end date of the project.
+* ''''now'''' The current date. If the user does not provide a date
+with the [[now]] keyword, the moment of the processing of the file
+will be inserted. Keep in mind that this will change every time you
+process your project. 
+* ''''today'''' Similar to ''''now'''' but formatted according to
+the [[timeformat]] when the [[now]] attribute was used. The current
+setting of [[timeformat]] has no impact on the expansion of the macro.
+

data/manual/Tutorial

@@ -562,15 +562,16 @@ attribute just like [[center]]. We could enclose it in single or
 double quotes again. But for Strings that span multiple lines and
 potentially include single or double quotes as well, scissor-marks or
 cut-here-marks are recommended. These marks look like a pair of
-scissors that cut along a dashed line. Use ''''-8<-'''' to begin a
-string and ''''->8-'''' to terminate it. The opening cut mark must be
-immediately followed by a line break. The indentation of the
-following line defines the indentation that will be ignored for all
-lines of the string. The following lines must have at least the same
-indentation. The indentation that exceeds the indentation of the
-first line will be kept in the resulting string. With this feature,
-you can define multi-line Rich Text strings without disturbing the
-indentation structure of your project file.
+scissors that cut along a dashed line. Use
+''''<nowiki>-8<-</nowiki>'''' to begin a string and ''''->8-'''' to
+terminate it. The opening cut mark must be immediately followed by a
+line break. The indentation of the following line defines the
+indentation that will be ignored for all lines of the string. The
+following lines must have at least the same indentation. The
+indentation that exceeds the indentation of the first line will be
+kept in the resulting string. With this feature, you can define
+multi-line Rich Text strings without disturbing the indentation
+structure of your project file.
 
 <[example file="tutorial" tag="overview4"]>
 

data/prj_cfg.rb

@@ -10,6 +10,7 @@ UNIX_NAME       = 'taskjuggler'
 USER_NAME       = 'Chris Schlaeger'
 USER_EMAIL      = 'cs@kde.org'
 RUBYFORGE_USER  = ENV['RUBYFORGE_USER']
+#CERT_PRIVATE    = ENV['HOME']/.gem/certs/gem-private-key.pem
 
 # VERSION
 begin
@@ -26,18 +27,23 @@ BIN_DIR         = 'bin'
 LIB_DIR         = 'lib'
 EXT_DIR         = 'ext'
 TEST_DIR        = 'test'
+DATA_DIR        = 'data'
 RDOC_DIR        = 'doc'
 RCOV_DIR        = 'rcov'
 RAKE_DIR        = 'tasks'
-MANUAL_DIR      = 'manual/html'
+MANUAL_DIR      = 'manual'
 
 # FILES
 README          = FileList['README']
 CHANGES         = ''#'CHANGES'
 LICENSE         = 'COPYING'
+DESCRIPTION     = <<'EOT'
+TaskJuggler is a project management software that goes far beyond the commonly
+known Gantt chart editors.
+EOT
 RAKEFILE        = 'Rakefile'
 SETUP_FILE      = 'setup.rb'
 PRJ_FILE        = 'prj_cfg.rb'
 GEM_SPEC_FILE   = 'gem_spec.rb'
-DATA_FILES      = FileList["benchmarks/**/*", "examples/**/*", "manual/*", "test/all.rb", "test/MessageChecker.rb", "test/TestSuite/**/*" ]
+DATA_FILES      = FileList["benchmarks/**/*", "examples/**/*", "manual/*", "test/all.rb", "test/MessageChecker.rb", "test/TestSuite/**/*", "data/**/*"]
 

data/tasks/csts.rake

@@ -34,7 +34,7 @@ DIST_FILES.include("#{RDOC_DIR}/**/*.{html,css}", 'man/*.[0-9]')
 DIST_FILES.exclude('**/tmp_*', '**/*.tmp')
 
 # 
-CLEAN.include( MANUAL_DIR )
+CLEAN.include( MANUAL_DIR + '/html' )
 CLEAN.include( 'README' ) if File.exist? 'README.rb'
 CLEAN.include( 'CHANGES' ) if File.exist? 'CHANGES.rb'
 

data/tasks/manual.rake

@@ -2,9 +2,11 @@
 
 desc 'Generate User Manual'
 task :manual do
-    rm_rf MANUAL_DIR if File.exists? MANUAL_DIR
-    mkdir_p MANUAL_DIR
-    sh "ruby -Ilib lib/tj3man.rb -d #{MANUAL_DIR} -m"
+    htmldir = MANUAL_DIR + '/html'
+    rm_rf htmldir if File.exists? htmldir
+    mkdir_p htmldir
+    ENV['TASKJUGGLER_DATA_PATH'] = Dir.getwd
+    sh "ruby -Ilib lib/tj3man.rb -d #{htmldir} -m"
 end
 
 

data/test/MessageChecker.rb

@@ -3,7 +3,7 @@
 #
 # = MessageChecker.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009 by Chris Schlaeger <cs@kde.org>
+# Copyright (c) 2006, 2007, 2008, 2009, 2010 by Chris Schlaeger <cs@kde.org>
 #
 # This program is free software; you can redistribute it and/or modify
 # it under the terms of version 2 of the GNU General Public License as

data/test/TestSuite/HTML-Reports/Alerts.html

@@ -0,0 +1,172 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- This file has been generated by taskjuggler3 v0.0.3-->
+<html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+  <title>TaskJuggler Report - Alerts</title>
+  <link href="css/tjreport.css" rel="stylesheet" type="text/css"/>
+ </head>
+ <body>
+  <script src="scripts/wz_tooltip.js" type="text/javascript"></script>
+  <noscript><div style="text-align:center; color:#FF0000">This page requires Javascript for full functionality. Please enable it
+in your browser settings!
+</div></noscript>
+  <div style="margin: 35px 5% 25px 5%; ">
+   <table align="center" border="0" cellpadding="0" cellspacing="2" class="tjtable" summary="Report Table"><tbody>
+     <tr><td><table align="center" cellpadding="2" cellspacing="1" class="tabback" width="100%"><tbody>
+         <tr class="tabhead" style="height:19px; font-size:15px;">
+          <td class="tabcell" rowspan="2"><div class="headercelldiv" style="text-align:center; padding-left:5px; padding-right:5px; font-weight:bold; ">Name</div></td>
+          <td class="tabcell" rowspan="2"><div class="headercelldiv" style="text-align:center; padding-left:5px; padding-right:5px; font-weight:bold; ">Alert</div></td>
+         </tr>
+         <tr class="tabhead" style="height:19px; font-size:15px;"/>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Red</div></td>
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; color:#C00000; ">
+            <img align="top" src="icons/flag-red.png" style="margin-right:3px;margin-bottom:2px"/>Red</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/taskgroup.png" style="margin-right:3px;margin-bottom:2px"/>Inherit Red</div></td>
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; color:#C00000; ">
+            <img align="top" src="icons/flag-red.png" style="margin-right:3px;margin-bottom:2px"/>Red</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Red</div></td>
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; color:#C00000; ">
+            <img align="top" src="icons/flag-red.png" style="margin-right:3px;margin-bottom:2px"/>Red</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/taskgroup.png" style="margin-right:3px;margin-bottom:2px"/>Overwrite Red</div></td>
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; color:#C00000; ">
+            <img align="top" src="icons/flag-red.png" style="margin-right:3px;margin-bottom:2px"/>Red</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Red</div></td>
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; color:#C00000; ">
+            <img align="top" src="icons/flag-red.png" style="margin-right:3px;margin-bottom:2px"/>Red</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/taskgroup.png" style="margin-right:3px;margin-bottom:2px"/>Inherit Red</div></td>
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; color:#C00000; ">
+            <img align="top" src="icons/flag-red.png" style="margin-right:3px;margin-bottom:2px"/>Red</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/taskgroup.png" style="margin-right:3px;margin-bottom:2px"/>Inherit Red</div></td>
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; color:#C00000; ">
+            <img align="top" src="icons/flag-red.png" style="margin-right:3px;margin-bottom:2px"/>Red</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/taskgroup.png" style="margin-right:3px;margin-bottom:2px"/>Inherit Yellow</div></td>
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; color:#BEA800; ">
+            <img align="top" src="icons/flag-yellow.png" style="margin-right:3px;margin-bottom:2px"/>Yellow</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Yellow</div></td>
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; color:#BEA800; ">
+            <img align="top" src="icons/flag-yellow.png" style="margin-right:3px;margin-bottom:2px"/>Yellow</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Yellow</div></td>
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; color:#BEA800; ">
+            <img align="top" src="icons/flag-yellow.png" style="margin-right:3px;margin-bottom:2px"/>Yellow</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/taskgroup.png" style="margin-right:3px;margin-bottom:2px"/>Inherit Yellow</div></td>
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; color:#BEA800; ">
+            <img align="top" src="icons/flag-yellow.png" style="margin-right:3px;margin-bottom:2px"/>Yellow</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Yellow</div></td>
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; color:#BEA800; ">
+            <img align="top" src="icons/flag-yellow.png" style="margin-right:3px;margin-bottom:2px"/>Yellow</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Yellow</div></td>
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; color:#BEA800; ">
+            <img align="top" src="icons/flag-yellow.png" style="margin-right:3px;margin-bottom:2px"/>Yellow</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/taskgroup.png" style="margin-right:3px;margin-bottom:2px"/>Inherit Yellow</div></td>
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; color:#BEA800; ">
+            <img align="top" src="icons/flag-yellow.png" style="margin-right:3px;margin-bottom:2px"/>Yellow</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/taskgroup.png" style="margin-right:3px;margin-bottom:2px"/>Overwrite Yellow</div></td>
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; color:#BEA800; ">
+            <img align="top" src="icons/flag-yellow.png" style="margin-right:3px;margin-bottom:2px"/>Yellow</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; color:#008000; ">
+            <img align="top" src="icons/flag-green.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; color:#008000; ">
+            <img align="top" src="icons/flag-green.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; color:#008000; ">
+            <img align="top" src="icons/flag-green.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; color:#008000; ">
+            <img align="top" src="icons/flag-green.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/taskgroup.png" style="margin-right:3px;margin-bottom:2px"/>Inherit Green</div></td>
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; color:#008000; ">
+            <img align="top" src="icons/flag-green.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; color:#008000; ">
+            <img align="top" src="icons/flag-green.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; color:#008000; ">
+            <img align="top" src="icons/flag-green.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+          <td class="taskcell1"><div class="celldiv" style="text-align:left; color:#008000; ">
+            <img align="top" src="icons/flag-green.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+         </tr>
+         <tr class="tabline" style="font-size:12px; ">
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; ">
+            <img align="top" src="icons/task.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+          <td class="taskcell2"><div class="celldiv" style="text-align:left; color:#008000; ">
+            <img align="top" src="icons/flag-green.png" style="margin-right:3px;margin-bottom:2px"/>Green</div></td>
+         </tr>
+        </tbody></table></td></tr>
+     <tr style="font-size:10px;"><td style="padding-left:1px; padding-right:1px;"/></tr>
+    </tbody></table>
+   <div class="copyright">Project: Alerts Version: 1.0 - Created on 2009-12-03 08:47:14 with <a href="http://www.taskjuggler.org">TaskJuggler III</a> v0.0.3</div>
+  </div>
+ </body>
+</html>

data/test/TestSuite/HTML-Reports/Alerts.tjp

@@ -0,0 +1,77 @@
+project "Alerts" 2009-11-18 +2m
+
+task "Green" {
+  journalentry 2009-11-20 "Green"
+}
+
+task "Yellow" {
+  journalentry 2009-11-20 "Yellow" { alert yellow }
+}
+
+task "Red" {
+  journalentry 2009-11-20 "Red" { alert red }
+}
+
+task "Inherit Yellow" {
+  task "Green" {
+  }
+  task "Yellow" {
+    journalentry 2009-11-22 "Yellow" { alert yellow }
+  }
+}
+
+task "Inherit Red" {
+  task "Inherit Yellow" {
+    task "Green" {
+    }
+    task "Yellow" {
+      journalentry 2009-11-23 "Yellow" { alert yellow }
+    }
+  }
+  task "Inherit Green" {
+    task "Green" {
+    }
+  }
+  task "Inherit Red" {
+    task "Green" {
+    }
+    task "Red" {
+      journalentry 2009-11-20 "Yellow" { alert yellow }
+      journalentry 2009-11-21 "Green" { alert green }
+      journalentry 2009-11-22 "Red" { alert red }
+    }
+  }
+}
+
+task "Overwrite Yellow" {
+  journalentry 2009-11-23 "Yellow" { alert yellow }
+  task "Inherit Yellow" {
+    task "Green" {
+    }
+    task "Yellow" {
+      journalentry 2009-11-23 "Yellow" { alert yellow }
+    }
+  }
+  task "Overwrite Red" {
+    journalentry 2009-11-22 "Red" { alert red }
+    task "Green" {
+    }
+  }
+  task "Inherit Red" {
+    task "Green" {
+    }
+    task "Red" {
+      journalentry 2009-11-20 "Yellow" { alert yellow }
+      journalentry 2009-11-21 "Green" { alert green }
+      journalentry 2009-11-22 "Red" { alert red }
+    }
+  }
+}
+
+taskreport "Alerts" {
+  formats html
+  columns name, alert
+  sorttasks alert.down
+  #hidetask plan.alert < 2
+}
+