Page 1 of 1

tag.dat documentation

Posted: 05 Jan 2015 09:32
by bdeshi
An incomplete explanation of the tag database tag.dat.

Code: Select all

XYplorer File Tags v3
;lines with preceding ; are explanatory comments. They should not exist in tag.dat (else the db is read incorrectly and gets corrupted)
;
;fields in < > must not be empty. fields in [ ] can be empty. Everything else is compulsory

Labels:
Red||FC7268;Orange||F6AB46;Yellow||EFDC4A;Green||B5D74A;Blue||5DA4FE;Purple||E29CDC;Grey||B5B5B5;Cyan||00FFFF;Yes||FC7268;No||5BD004
;syntax: <Name>|[Text HEXcolor]|[Back HEXcolor];<Name>|[Text HEXcolor]|[Back HEXcolor]; ...
;  <Name>          name of the label
;  [Tex HEXcolor]  text color in hex format
;  [Back HEXcolor] Background color in hex format
;At most 15 labels may be specified. Label records are ;-separated
;if [Text HEXcolor] is empty it is interpreted as 000000 (black); if [back HEXcolor] is empty it is interpreted as FC7268
;no field can include | or ;

Extra Tags:
Rating|4|0|0|||||
Note|0|0|0|||||
Mark|3|0|0|||||
Lnk|6|0|0|||||
Demo|5|0|0|popupTag1;popupTag2||||
;five entry lines for five extra tag columns. (All five lines must exist.)
;Extra Tag data for tagged items are stored in `Data:` section in fields denoted with [extratag#]
;syntax: [Column Name]|<type>|[1?]|[2?]|[popuplist values]|[4?]|[5?]|[6?]|[7?]
;  <type> is a numerical index and corresponds to "Configure Extra Column" type dropdown list. eg, 4 = Rating Stars
;           (in filelist, right click the Extra Tag column header -> Configure)
;  [1?]   unknown. default <0>
;  [2?]   unknown. default <0>
;  [popuplist] are values used for [popuplist] tag type. List values are ;-separated.
;           The section is cleared when <type> != 5
;             PopUpTags|5|0|0|item 1;item 2||||
;  [4?]   unknown. default []
;  [5?]   unknown. default []
;  [6?]   unknown. default []
;  [7?]   unknown. default []
;
;for <type> = 3 (Checkbox), associated value in `Data:` section:
;  EMPTY => unchecked, 0 or 1 or anything else => checked (yes, 0 = checked) 
;No field (except possibly the last one) can hold the | char

Data:
?:\Portable\XYplorer\Lic.ini|1|license,private||||||Comment Line1¶Line 2, and a some plumbing ||||
;one line for each tagged item; all tag data recorded in one line
;syntax: <tagged item>|[label]|[tag(s)]|[extratag1]|[extratag2]|[extratag3]|[extratag4]|[extratag5]|[comment]
;  <tagged item> is path of the tagged item. It must match the letter case of the item: D:\File.txt != D:\file.txt when showing tags
;  [label]       is a numerical index between 0-15. 1-15 corresponds to label list in `Labels:` section or Config->Tags. 0 or empty means no label. 
;  [tag(s)]      applied tags. Tags are separated by `, ` (comma,space). Tags may be recorded here in any order, but are resorted A-Z after XY save
;  [extratag#]   fields hold applied values (if any) for corresponding Extra Tag columns.
;                 If Extra Tag type is changed afterwards, recorded values might not correspond to or match new type.
;  [comment]     holds comments. line breaks are stored as ¶. Comments can include | (pipes)
;No field except [comments] can hold the | char


Re: tag.dat documentation

Posted: 05 Jan 2015 21:34
by Enternal
Awesome! Pretty neat and small documentation. Thanks!