LibrarySE 'UserManual.txt'
"LibrarySE" Plugin for Script Editor # # # # # # # # # # # # # # # # # # # # # # # # # Author: Jed Green (jobu10000@yahoo.com) # beta version 0.9.4 # public release date: 12.19.06 # # # # # # # # # # # # # # # # # # # # # # # # Introduction: ----------------------- The LibrarySE plugin is a fairly simple tool. It creates a menu in Script Editor's main menu titled "Library". This menu lists all of the scriptable applications and scripting additions you have saved in your Library. Using the Library Menu: ----------------------- After installing LibrarySE, a menu titled "Library" will be created in Script Editor's main menu. The menu lists all of your saved scriptable applications and scripting additions (osax). There are currently three actions available when selecting an item from the Library, two of which are enabled using modifier-key combinations: 1) Selecting a Library item from the menu without any modifier keys opens that item's scripting dictionary in Script Editor. 2) If you select an item from the menu while holding down the "option" key, a new script will be created in Script Editor containing a 'tell block' for that application. 3) If you select an item from the list while holding down the "option" and "shift" keys at the same time, a 'tell block' for that application will be inserted into the frontmost document in Script Editor (if there is one... otherwise this combination does nothing). ** Note: Actions 2 and 3 above only create tell blocks for applications, and do nothing when the selected item is an osax, or scripting addition. The "About LibrarySE" menu item opens a small "About Window" with information about the plugin and it's author, and has links to various internet pages related to the plugin. Selecting the "Manage Items..." menu item opens the LibrarySE item manager window, discussed below. Using the Library Manager: ----------------------- To edit the items contained in the Library list, you use the Library manager window. Similar in appearance to the library window distributed by Apple with Script Editor, the manager window allows you to add, remove, and otherwise act upon the items in your Library. To add an item: Click on the Add (+) button in the toolbar. You will be prompted to select a scriptable application or osax to add to the Library. If the selected item has no scripting terminology, it is not an osax, or an item with the same name is already in the list, the item will be rejected. To remove an item: Select an item in the list that you wish to remove. Click on the Remove (-) button in the toolbar. The item will be immediately removed from the list. To open an item's Scripting Dictionary: Select an item in the list. Click on the Open Dictionary (books icon) button in the toolbar. The item's dictionary will be opened in Script Editor. To create a new script for an item: Select an item in the list. Click on the New Script (script file icon) button in the toolbar. A new script will be created in Script Editor with a 'tell application "XYZ"' block pre-inserted as the script's contents. Note that this only works for applications, and is ignored for scripting additions. To reveal the item in the Finder: Select an item in the list. Click on the Reveal in Finder (Finder icon) button in the toolbar. A new Finder window will open with the selected item highlighted. *** Important *** All of the features available via the Library Manager's toolbar, as outlined above, are also available via a contextual menu for the Library Manager table. Holding down the "control" key (or right-clicking) while selecting an item in the list will pop up a menu containing all of the options listed above. Using Apple's Library & LibrarySE: ----------------------- It is not recommended that you use both LibrarySE and the original Library plugin distributed by Apple with Script Editor. Since the original Library plugin is contained within Script Editor's application bundle, I do not recommend removing the plugin to disable it. Instead, I encourage you to simply "forget" it is there and use ONLY LibrarySE to access and modify items in the library. Both versions can safely co-exist, but the effects of "using" both simultaneously have not been fully explored, and may cause unforeseen problems and potential loss of data. I strongly recommend selecting only one which you will use to manage your Library items, due to the potential of encountering data conflicts while trying to edit one source from two places. LibrarySE makes a better effort to update it's displays more often than Apple's Library, so you can be assured that the list of Library items you are using is always the most current one. Changes made in LibrarySE are not automatically applied to the list in Apple's version, so you must close and then re-open the window to ensure that changes are reflected in Apple's Library.
LibrarySE ‹
Home ‹
