The bookmark database

A bookmarks database is the directory in the $HLG_HOME called “bookmarks”

It holds files with bookmark entries. These files are considered to be categories, as the assumption is that bookmark entries in one file are related by subject-matter.

So a bookmark database is made up of one or more categories.

hlg ships with one category called “default” and you can add other categories as you judge appropriate to your working style.

Otherwise, you are free to just continue working with that one default category if your bookmarks are not that many. hlg has no problem with how you store your bookmarks and where you store them, as long as they are correctly entered in the bookmark format.

The format of the bookmark entry had been described throughout this guide, but to emphasize:

  • A bookmark entry must be made on its own line.

  • This means that a bookmark cannot use more than one line.

  • Metadata content may be entered along with a bookmark entry just above the line with the bookmark entry.

  • Metadata content must be entered on only one line just before the bookmark entry it is to be attached to.

  • A bookmark entry has got three fields, namely:

    • The bookmark name;

    • The location; and

    • The handler for this bookmark.

hlg comes with the ten default bookmark entries which you can see how entries are made inside the bookmark file.

You can add some comments in your bookmark file. Each line beginning with a # (hash mark) is a comment, and will be used by `hlg to generate new metadata content. A comment line provides either the description or the tags for the bookmark entry, or both. If both are provided, the description must start and then the tags.

Only enter metadata for a bookmark entry only on one line for it to be attached to the bookmark entry on the next line.