(Arne Babenhauserheide)
2017-01-17: update version and documentation with merged kanban-fill update version and documentation with merged kanban-fill
diff --git a/kanban.el b/kanban.el --- a/kanban.el +++ b/kanban.el @@ -1,8 +1,9 @@ ;;; kanban.el --- Parse org-todo headlines to use org-tables as Kanban tables ;; ;; Copyright (C) 2012-2016 Arne Babenhauserheide <arne_bab@web.de> +;; and 2013 stackeffect -;; Version: 0.1.7 +;; Version: 0.2.0 ;; Author: Arne Babenhauserheide <arne_bab@web.de> ;; Keywords: outlines, convenience @@ -39,7 +40,7 @@ ;; * Zero state Kanban: Directly displaying org-mode todo states as kanban board ;; ;; Use the functions kanban-headers and kanban-zero in TBLFM lines to -;; get your org-mode todo states as kanban table. Update with C-c C-c +;; get your org-mode todo states as kanban table. Update with C-c C-c ;; on the TBLFM line. ;; ;; Example: @@ -51,6 +52,15 @@ ;; #+TBLFM: @1$1='(kanban-headers)::@2$1..@>$>='(kanban-zero @# $# "TAG" '(list-of-files)) ;; "TAG" and the list of files are optional ;; +;; Faster Example with kanban-fill: +;; +;; | | | | +;; |---+---+---| +;; | | | | +;; | | | | +;; #+TBLFM: @2='(kanban-fill "TAG" '(list-of-files))::@1$1='(kanban-headers $#):: +;; "TAG" and the list of files are optional +;; ;; * Stateful Kanban: Use org-mode to retrieve tasks, but track their state in the Kanban board ;; ;; | | | | @@ -60,15 +70,16 @@ ;; #+TBLFM: @1$1='(kanban-headers)::@2$1..@>$1='(kanban-todo @# @2$2..@>$> "TAG" '(list-of-files)) ;; "TAG" and the list of files are optional ;; -;; TODO: The links don’t yet work for tagged entries. Fix that. There -;; has to be some org-mode function to retrieve the plain header. -;; +;; More complex use cases are described in the file sample.org +;; ;; TODO: kanban-todo sometimes inserts no tasks at all if there are multiple tasks in non-standard states. ;; ;; TODO: bold text in headlines breaks the parser (*bold*). ;; ;; ChangeLog: ;; +;; - 0.2.0: Finally merge the much faster kanban-fill from stackeffect. +;; I’m sorry that it took me 3 years to get there. ;; - 0.1.7: strip keyword from link for org-version >= 9 and ;; avoid stripping trailing "* .*" in lines ;; - 0.1.6: defcustom instead of defvar diff --git a/sample.org b/sample.org --- a/sample.org +++ b/sample.org @@ -20,7 +20,7 @@ Example Kanban File | | | | | | | | | | | | | | | | | | | | | -#+TBLFM: @2$1..@>$>='(kanban-zero @# $# "+prj-HOLD" '("sample.org"))::@1='(kanban-headers $#) +#+TBLFM: @1='(kanban-headers $#)::@2$1..@>$>='(kanban-zero @# $# "+prj-HOLD" '("sample.org")) * Zero state Kanban: kanban-fill: == * Attention * == | | | | | WAITING | |