Please define the file format

[lquenti]

Could you formally document how the expected file format for kanbans should look like?

Would be great, both for auxiliary tools and possible migration if the project diverges with the personal needs

[PlankCipher]

Not really sure what you mean by "formally". Do you mean as in a wiki or something?

If it helps, here is how it's documented in the man page:

FILES
       $HOME/.local/share/kabmat/data
              Main data file (see NOTES for info about syntax in this file).
 
       $HOME/.local/share/kabmat/data_bkp
              A  backup  file  to  which content of main data file is copied before writing anything into main
              date file to minimize data loss on crashes.
 
NOTES
       The syntax of the data file simply depends on indentation. Here is how. (The start and end  of  a  line
       are marked with ^ and $ respectively for demo purposes only)
 
       ^a board's name$
 
       ^ a column's name in that board$
 
       ^  a card's content in that column$
 
       ^   -a not done checklist item in that card$
 
       ^   +a done checklist item in that card$
 
       ^    Description of this card.$
 
       ^    The description of the card can be multi-line$
 
       ^another board starts here$
 
       ^ and so on...$
 
       Each line is an entry. A board's name has no spaces before it. A column's title has 1. A card's content
       has 2. A card's checklist item has 3. A card's description has 4.
 
       A checklist item is marked not done by adding a - before its content and marked done by adding + before
       it.