The TaskJuggler III User Manual

Project Management beyond Gantt Chart drawing
Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011 by Chris Schlaeger <chris@linux.com>
Generated on 2011-09-13

This manual covers TaskJuggler III version 0.2.2.




1 Introduction
1.1 About TaskJuggler
1.2 About TaskJuggler III
1.3 License and Copyright
1.4 Features and Highlights
1.5 TaskJuggler on the Web
1.6 TaskJuggler 2.x Migration
1.7 Using TaskJuggler 2.x and TaskJuggler 3.x in parallel
1.8 Reporting Bugs and Sending Feedback
2 Installation
2.1 Requirements
2.1.1 Supported Operating Systems
2.1.2 Other required Software
2.2 Installation Steps for Users
2.2.1 The easy way
2.2.2 The manual way
2.3 Update from older TaskJuggler III versions
2.4 Installation Steps for Developers
2.5 Quickly switching between various TaskJuggler III versions
2.6 Installing a newer Ruby version
2.7 Installing the Vim Support
2.8 How to Contribute
2.8.1 Why contribute?
2.8.2 Preparing a contribution
2.8.3 Creating a Patch
2.8.4 Contributing to the User Manual
2.8.5 Contributing to the Test Suite
2.8.6 Contributing to the Ruby code
2.8.7 Some final words to Contributors
3 Getting Started
3.1 Basics
3.2 Structure of a TJP File
4 The Tutorial: Your first Project
4.1 Starting the project
4.2 Global Attributes
4.3 Macros
4.4 Declaring Flags
4.5 Declaring Accounts
4.6 Declaring Resources
4.7 Specifying the Tasks
4.8 Specifying Milestones
4.9 Visualizing the Project
5 The TaskJuggler Syntax
5.1 Understanding the Syntax Reference
5.1.1 ABSOLUTE_ID
5.1.2 ID
5.1.3 INTEGER
5.1.4 STRING
5.2 Predefined Macros
5.3 Environment Variable Expansions
5.4 Rich Text Attributes
5.4.1 Block Markups
5.4.2 In-Line Markups
5.4.3 Block and Inline Generators
6 The TaskJuggler Software
6.1 tj3
6.2 tj3man
6.3 tj3d
6.4 tj3client
7 Day To Day Juggling
7.1 Working with multiple scenarios
7.2 Important and fall-back Tasks
7.3 Tracking the Project
7.4 Recording Progress
7.4.1 Using completion values
7.4.2 Using bookings
7.5 Tracking status and actuals
7.5.1 The reporting and tracking cycle
7.6 Implementing the status tracking system
7.6.1 Prerequesites
7.6.2 The Time Sheet Template Sender
7.6.3 The Time Sheet Receiver
7.6.4 Time Sheet Template Requests
7.6.5 Time Sheet Summaries
7.6.6 Updating the Project Plan
7.7 Recording actual Resource Usage
7.7.1 Status Sheets
7.7.2 The Status Sheet Template Sender
7.7.3 Requesting Status Sheet Templates
7.7.4 The Status Sheet Receiver
8 TaskJuggler Internals
8.1 How the Scheduler works
9 GNU Free Documentation License
A Syntax Reference
A.1 account
A.2 account (task)
A.3 accountprefix
A.4 active
A.5 adopt (task)
A.6 alert
A.7 alert level
A.8 allocate
A.9 alternative
A.10 author
A.11 balance
A.12 booking (resource)
A.13 booking (task)
A.14 caption
A.15 cellcolor (column)
A.16 celltext (column)
A.17 center
A.18 charge
A.19 chargeset
A.20 columnid
A.21 columns
A.22 complete
A.23 copyright
A.24 credit
A.25 currency
A.26 currencyformat
A.27 dailymax
A.28 dailymin
A.29 dailyworkinghours
A.30 date
A.31 date (extend)
A.32 definitions
A.33 depends
A.34 details
A.35 disabled
A.36 duration
A.37 efficiency
A.38 effort
A.39 email
A.40 enabled
A.41 end
A.42 end (column)
A.43 end (limit)
A.44 end (report)
A.45 end (timesheet)
A.46 endcredit
A.47 epilog
A.48 export
A.49 extend
A.50 fail
A.51 flags
A.52 flags (account)
A.53 flags (journalentry)
A.54 flags (report)
A.55 flags (resource)
A.56 flags (statussheet)
A.57 flags (task)
A.58 flags (timesheet)
A.59 fontcolor (column)
A.60 footer
A.61 formats
A.62 functions
A.63 gapduration
A.64 gaplength
A.65 halign (center)
A.66 halign (column)
A.67 halign (left)
A.68 halign (right)
A.69 hasalert
A.70 header
A.71 headline
A.72 hidejournalentry
A.73 hidereport
A.74 hideresource
A.75 hidetask
A.76 icalreport
A.77 include (macro)
A.78 include (project)
A.79 include (properties)
A.80 inherit (extend)
A.81 interval1
A.82 interval2
A.83 interval3
A.84 interval4
A.85 isactive
A.86 ischildof
A.87 isdependencyof
A.88 isdutyof
A.89 isfeatureof
A.90 isleaf
A.91 ismilestone
A.92 isongoing
A.93 isresource
A.94 istask
A.95 journalattributes
A.96 journalentry
A.97 journalmode
A.98 left
A.99 length
A.100 limits
A.101 limits (allocate)
A.102 limits (resource)
A.103 limits (task)
A.104 listitem (column)
A.105 listtype (column)
A.106 loadunit
A.107 logicalexpression
A.108 logicalflagexpression
A.109 macro
A.110 managers
A.111 mandatory
A.112 maxend
A.113 maximum
A.114 maxstart
A.115 milestone
A.116 minend
A.117 minimum
A.118 minstart
A.119 monthlymax
A.120 monthlymin
A.121 navigator
A.122 newtask
A.123 nikureport
A.124 note (task)
A.125 now
A.126 numberformat
A.127 onend
A.128 onstart
A.129 opennodes
A.130 overtime (booking)
A.131 period (column)
A.132 period (limit)
A.133 period (report)
A.134 period (task)
A.135 persistent
A.136 precedes
A.137 priority
A.138 priority (timesheet)
A.139 project
A.140 projectid
A.141 projectid (task)
A.142 projectids
A.143 projection
A.144 prolog
A.145 properties
A.146 purge
A.147 rate
A.148 rate (resource)
A.149 reference (extend)
A.150 remaining
A.151 replace
A.152 report
A.153 reportprefix
A.154 resource
A.155 resourceattributes
A.156 resourceprefix
A.157 resourcereport
A.158 resourceroot
A.159 resources (limit)
A.160 responsible
A.161 richtext (extend)
A.162 right
A.163 rollupresource
A.164 rolluptask
A.165 scale (column)
A.166 scenario
A.167 scenario (ical)
A.168 scenarios
A.169 scenarios (export)
A.170 scenariospecific (extend)
A.171 scheduled
A.172 scheduling
A.173 select
A.174 selfcontained
A.175 shift
A.176 shift (resource)
A.177 shift (task)
A.178 shift (timesheet)
A.179 shifts (allocate)
A.180 shifts (resource)
A.181 shifts (task)
A.182 shorttimeformat
A.183 sloppy (booking)
A.184 sloppy (projection)
A.185 sortjournalentries
A.186 sortresources
A.187 sorttasks
A.188 start
A.189 start (column)
A.190 start (limit)
A.191 start (report)
A.192 startcredit
A.193 status (statussheet)
A.194 status (timesheet)
A.195 statussheet
A.196 statussheetreport
A.197 strict (projection)
A.198 summary
A.199 supplement
A.200 supplement (resource)
A.201 supplement (task)
A.202 tagfile
A.203 task
A.204 task (statussheet)
A.205 task (timesheet)
A.206 taskattributes
A.207 taskprefix
A.208 taskreport
A.209 taskroot
A.210 text (extend)
A.211 textreport
A.212 timeformat
A.213 timeoff (nikureport)
A.214 timesheet
A.215 timesheetreport
A.216 timezone
A.217 timezone (export)
A.218 timezone (report)
A.219 timezone (shift)
A.220 timingresolution
A.221 title
A.222 title (column)
A.223 tooltip (column)
A.224 trackingscenario
A.225 treelevel
A.226 vacation
A.227 vacation (resource)
A.228 vacation (shift)
A.229 warn
A.230 weeklymax
A.231 weeklymin
A.232 weekstartsmonday
A.233 weekstartssunday
A.234 width (column)
A.235 work
A.236 workinghours (project)
A.237 workinghours (resource)
A.238 workinghours (shift)
A.239 yearlyworkingdays



Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011 by Chris Schlaeger <chris@linux.com>.TaskJuggler is a trademark of Chris Schlaeger.