From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Re: [ANN] Exporter for taskjuggler Date: Tue, 6 Apr 2010 12:09:33 +0200 Message-ID: <78A30CB6-C038-4FAF-B7BE-DF65CD5F2767@gmail.com> References: <87ljdarxpw.fsf@saadawi.sbszh.ch> Mime-Version: 1.0 (Apple Message framework v936) Content-Type: text/plain; charset=ISO-8859-1; format=flowed; delsp=yes Content-Transfer-Encoding: quoted-printable Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Nz5j7-0006ao-Ah for emacs-orgmode@gnu.org; Tue, 06 Apr 2010 06:09:45 -0400 Received: from [140.186.70.92] (port=55111 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Nz5j2-0006ZF-SD for emacs-orgmode@gnu.org; Tue, 06 Apr 2010 06:09:44 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1Nz5j0-0003kA-Ef for emacs-orgmode@gnu.org; Tue, 06 Apr 2010 06:09:40 -0400 Received: from mail-ew0-f214.google.com ([209.85.219.214]:56034) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Nz5j0-0003k4-6u for emacs-orgmode@gnu.org; Tue, 06 Apr 2010 06:09:38 -0400 Received: by ewy6 with SMTP id 6so42459ewy.32 for ; Tue, 06 Apr 2010 03:09:37 -0700 (PDT) In-Reply-To: <87ljdarxpw.fsf@saadawi.sbszh.ch> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Christian Egli Cc: emacs-orgmode@gnu.org Hi Christian, this look interesting. Should we put this into the contrib directory for now, or are you aiming for the Org-mode core? - Carsten On Mar 30, 2010, at 10:59 AM, Christian Egli wrote: > > Hi all > > In theory we're developing according to agile methods here, but in > practice people still want to see the classic waterfall project plan. > > So in order to create a professional looking gant and resource usage > charts I implemented an exporter from org-mode to TaskJuggler > (http://www.taskjuggler.org/). The code is attached and I'm looking =20= > for > feedback and would love to get this integrated in the org-mode > distribution. > > TaskJuggler uses a text format to define projects, tasks and =20 > resources, > so it is a natural fit for org-mode. It can produce all sorts of =20 > reports > for tasks or resources in either HTML, CSV or PDF. The current version > of TaskJuggler requires KDE but the next version is implemented in =20 > Ruby > and should therefore run on any platform. > > The exporter is a bit different from other exporters, such as the HTML > and LaTeX exporters for example, in that it does not export all the > nodes of a document or strictly follow the order of the nodes in the > document. > > Instead the TaskJuggler exporter looks for a tree that defines the > tasks and a optionally tree that defines the resources for this > project. It then creates a TaskJuggler file based on these trees > and the attributes defined in all the nodes. > > * Installation > > Put the attached file into your load-path and the following line into > your ~/.emacs: > > (require 'org-taskjuggler) > > The interactive functions are similar to those of the HTML and LaTeX > exporters: > > M-x `org-export-as-taskjuggler' > M-x `org-export-as-taskjuggler-and-open' > > * Tasks > > Let's illustrate the usage with a small example. Create your tasks as > you usually do with org-mode. Assign efforts to each task using > properties (it's easiest to do this in the column view). You should =20= > end > up with something similar to the example by Peter Jones in > = http://www.contextualdevelopment.com/static/artifacts/articles/2008/projec= t-planning/project-planning.org=20 > . > Now mark the top node of your tasks with a tag named > "taskjuggler_project" (or whatever you customized > `org-export-taskjuggler-project-tag' to). You are now ready to export > the project plan with `org-export-as-taskjuggler-and-open' which will > export the project plan and open a gant chart in TaskJugglerUI. > > * Resources > > Next you can define resources and assign those to work on specific > tasks. You can group your resources hierarchically. Tag the top node =20= > of > the resources with "taskjuggler_resource" (or whatever you customized > `org-export-taskjuggler-resource-tag' to). You can optionally assign =20= > an > ID to the resources (using the standard org properties commands) or =20= > you > can let the exporter generate IDs automatically (the exporter picks =20= > the > first word of the headline as the ID as long as it is unique). Using > that ID you can then allocate resources to tasks. This is again done > with the "allocate" property on the tasks. Do this in column view or > when on the task type > > C-c C-x p allocate RET RET > > Once the allocations are done you can again export to TaskJuggler and > check in the Resource Allocation Graph which person is working on what > task at what time. > > * Export of properties > > The exporter also takes TODO state information into consideration, =20 > i.e. > if a task is marked as done it will have the corresponding attribute =20= > in > TaskJuggler ("complete 100"). Also it will export any property on a =20= > task > resource or resource node which is known to TaskJuggler, such as =20 > limits, > vacation, shift, booking, efficiency, journalentry, rate for resources > or account, start, note, duration, end, journalentry, milestone, > reference, responsible, scheduling, etc for tasks. > > * Dependencies > > The exporter will handle dependencies that are defined in the tasks > either with the ORDERED attribute (see TODO dependencies in the Org =20= > mode > manual) or with the BLOCKER attribute (see org-depend.el) or > alternatively with a depends attribute. Both the BLOCKER and the =20 > depends > attribute can be either "previous-sibling" or a reference to an ID =20 > which > is defined for another task in the project. > > Thanks > Christian > > > --=20 > Christian Egli > Swiss Library for the Blind, Visually Impaired and Print Disabled > Grubenstrasse 12, CH-8045 Z=FCrich, Switzerland > _______________________________________________ > Emacs-orgmode mailing list > Please use `Reply All' to send replies to the list. > Emacs-orgmode@gnu.org > http://lists.gnu.org/mailman/listinfo/emacs-orgmode - Carsten