The default category

At any time, hlg operates in the context of a category. Thus, even if you have not provided a fully-qualified bookmark name, hlg will simply translate the bare bookmark name into a qualified one using a category.

The category that hlg picks to be its default context is known as a “default category”

hlg ships with a category appropriately called, “default”

However, you are free to set one of your newly-created categories as a default category in the configuration file.

For example, if we have just created a category called "books" and want to set it as the default, we would do this:

  1. Launch the configuration file by typing, hlg --edit-configuration or just hlg -E (That’s an uppercase E).

  2. Find the `"default-category`" entry in the configuration file.

  3. By default it reads:

    default-category = "default"

  4. We delete the “default” and change it to our chosen category books like this:

    default-category = "books"

  5. From now on, the “books” category will be the default category.

What does a default category do?

  • A default category is what hlg uses for bookmark name lookups when no other category is passed to it on the command-line.

  • So when you type hlg . without any arguments, the home bookmark that opens is that of the default category.

  • In short, any operations you do without providing a category name are done in the default category such as:

    • editing bookmarks,

    • Listing keys, and

    • Launching any bookmark without a category qualifier.