Tagsistant

All your files, quickly and easily.


Tagsistant 0.6 howto - tags/ and relations/ directories

The tags/ directory is where Tagsistant allows you to create tags and tag files, directories and other objects. In respect to the archive/ directory, this one is the most different, so we'll start by creating tags, which is the most intuitive operation. Remember that in Tagsistant a tag is just a directory created under the tags/ directory. Knowing this, all we have to do is use mkdir:

$ mkdir ~/myfiles/tags/video/
$ mkdir ~/myfiles/tags/scifi/
$ mkdir ~/myfiles/tags/startrek

What we have done here can be translated in English as: create a tag called video, a tag called scifi, and a tag called startrek. Remember that only directories under tags/ are considered tags and that tags can be created under the tags/ directory only.

Now we leave the tags/ directory to take a quick tour of another one, strictly related: the relations/ directory. This one is used to manage relations between tags. A relation always involves two tags and can be of two types:

  1. TAG1 is equivalent to TAG2
  2. TAG1 includes TAG2

For example, you can tell Tagsistant that scifi/ includes startrek/. To do it, you just need to:

$ mkdir ~/myfiles/relations/scifi/includes/startrek/

That's it. The first tag must be already present in the tags/ directory, but Tagsistant can create the second tag for you if it doesn't exists, like in:

$ mkdir ~/myfiles/relations/scifi/includes/starwars/

Now list the tags and you'll find the starwars/ tag:

$ ls ~/myfiles/tags/
scifi  startrek  starwars  video

Let's wrap up what we have seen so far. We have created some tags (video, scifi, startrek and lastly starwars) and we have established two relations: scifi includes startrek and scifi includes starwars. Now we are ready to tag our files.