Creating tasks¶
To produce tasks you need to create text file in YAML
format (.yaml
extension).
It isn`t necessary for you to know all yaml syntax.
All you need is be careful with number of spaces per indent
(There is no requirement in YAML to indent any concrete number of spaces,
but you need to use the same number of spaces in all your YAML file)
and read this article.
Basic¶
Let`s create the first task. Here is the simple example:
1My first task:
2 start: 2020-01-01
3 length: 5
In the first line you specify task name. It may be any string you want.
After task name must be symbol :
To specify properties for task you need to write indent and key-value pair.
Key and value separated by symbol :
and one space symbol after it.
In the second line after date
keyword you specify date when task starts.
All dates must be in format <year>-<month>-<day>
.
If you don`t specify start date Linum will consider it as a current day.
And in the third line after length
keyword you specify length of a task.
If you don`t specify length it will consider as one day length.
All lines with keywords are optional, but you must specify at least one of them.
Length or finish¶
You may use finish
keyword instead of length
to specify date when task is over.
If both of keyword were used then finish
would be in priority.
1My second task:
2 start: 2020-01-10
3 finish: 2020-02-10
Color¶
You may specify color to render for certain task.
To do it use color
keyword and hex rgb integer as value.
1Red task:
2 start: 2020-02-10
3 color: 0xFF0000
If you don`t set color property then random color from material design palette will be applied.
Sub tasks¶
It is possible to specify sub tasks for certain task
using sub
keyword. There are two ways to do it.
If you want to create several tasks with one name use list sub tasks.
If you want to create tasks with different names use dictionary sub tasks.
In both cases parent properties will be inherited for a child.
It is possible to specify sub tasks for sub tasks.
List sub tasks¶
In YAML list elements start by minus symbol and one space after it.
1 List Task:
2 length: 3
3 sub:
4 - date: 2020-01-01
5 - date: 2020-01-20
6 length: 4
7 - date: 2020-02-10
8 color: 0x000000 # Black color
For this example Linum will create 3 tasks. First starts at 2020-01-01, second starts at 2020-01-20 and has length 4 days, and third starts at 2020-02-10 and has black color.
Dictionary sub tasks¶
For every dictionary sub task title would be computed as parent name plus sub task name.
1Task 1.:
2 color: 0x00FF00
3 length: 3
4 sub:
5 1:
6 start: 2020-03-01
7 2:
8 start: 2020-03-05
9 finish: 2020-03-08
For this example Linum will create 2 tasks: “Task 1.1” and “Task 1.2”.