A Bookmark Utility for
the Libronix Digital Library System

by Stephen Genusa

Current Version

1.4.4 November 23, 2004

Requirements

• Libronix Digital Library System version 2.0
• Microsoft Windows Scripting Runtime (most systems already have this installed)
• Microsoft XML 4.0 (most systems already have this installed)
• OLEACC.DLL (make sure this is installed in your system32 directory. If you don't have it use the older v 1.1 copy below)

Terms

You may use and download this utility, for free, based on the conditions of the license agreement.
          Briefly, (1) the license agreement has the standard "no liability" clause and (2) prevents redistribution of the utility.

 

 

 

Installation and Updating

• New Installs: Simply run the Installation EXE and follow the prompts

• Existing Installations:

  • BACKUP your bookmark file which is usually located at C:\Program Files\LDLS Bookmarks\LDLSBookmarks.xml

  • Uninstall the old version

  • Run the new Installation EXE and follow the prompts

  • Copy your bookmark file from the location you backed it up to, back into the program's directory.

  I will attempt to improve this process for future updates.

Usage

You will notice that the bookmark utility is built on the idea of Categories/Bookmarks. To start using the program click the Add Category button. Type in the category name and select OK. Once a Category is selected you can press the Add Bookmark button. Whichever window is active in LDLS will have a new bookmark created under the currently selected category.

Categories

Double-clicking a category will expand/collapse the category.
Single-clicking a category waiting a second and then clicking it again will enter the Category name edit mode.
Clicking delete on a category will delete the category and all bookmarks for that selected category.

Bookmarks

Double-clicking a bookmark (or clicking the Goto button) will cause LDLS to load that selected resource.
Single-clicking a bookmark, waiting a second, and then clicking it again will enter the Bookmark name edit mode.
If the "Activate LDLS on Selection" checkbox is checked the LDLS window will be moved to the top. If it is not checked it will appear behind the Bookmark Utility.

General Notes

The Current Link Command edit box is useful for sharing links with others.

The "Into Libronix" button   moves the Bookmark Utility into the Libronix application as a child window of the Libronix Application. Note: The one disadvantage to running it internally to Libronix is that it causes the active Resource window to lose focus. This can change the bookmark names that are generated for Bible resources. The program does not currently appear in the list of Libronix windows since the Libronix API does not appear to support registering pre-created windows. So if you use this button you need to realize that other Libronix windows may obscure the Bookmark application's window, and then the only way to show the Bookmark window is to move those windows which are hiding it out of the way, or start the Bookmark program again which will bring the first instance to the top. The "New Instance" checkbox will not be visible if you use this button since it would be confusing for the program to be a child window of an instance of LDLS it is not tracking windows in.

The Bookmark window can be reduced or enlarged vertically but not horizontally.

You can rapidly (as fast as Libronix will call them up) review a series of bookmarks by unchecking the "Activate LDLS on selection" checkbox and then double-clicking on the Bookmarks you want to view. Place the Bookmark window opposite the location where the resources are displayed.

The Workspaces listbox shows all saved workspaces at the time the Bookmark utility was started. To change workspaces just double-click the one you want. When the Bookmark utility is operating as a child window in Libronix there is a slight delay and then the Bookmark window is moved to the top.

If you have the "New Instance" checkbox checked and you double-click the workspaces listbox, a new instance of LDLS will be created and the selected workspace will be loaded into that instance of LDLS. Warning: Because the bookmark program cannot run as an integral child window of LDLS, it can only track windows (and therefore bookmark names) for one instance of LDLS. I think there's a way this could be worked around with a lot of Win32 API code (the COM ROT table would have to be walked, the z-order of windows would have to be determined, if possible, via Win32 code &c). Better yet, I'd rather wait for Libronix to have a bookmark feature before I have to write that code!

The bookmarks are saved to an xml format for interoperability with other applications that may wish to use the xml format. The file is created in the SAME directory the EXE is installed into. Future versions may allow multiple bookmark files. For now it is limited to a single file.

 

Copyright © 2003, 2004 by Stephen Genusa