iWisdom

PSRenamer

PSTextMerge

URL Union User Guide

Introduction
System Requirements
License
Installation
Creating a New File
Importing URLs
Saving a URL Collection
Opening Recent Files
The Four Data Fields
The Tool Bar
The List
Tags
Find and Replace
Publish
Preferences

Introduction

URL Union is a desktop software program for storing URLs (aka bookmarks).

URL Union was written with the following design goals in mind.

One set of bookmarks for all browsers and all devices. URL Union can publish your URLs in a variety of convenient HTML formats that allow you to view and use your URLs from any Web browser, including those found on an iPad, iPhone or other mobile device.
Storing URLs in HTML. It just seems perverse to me to store URLs in a proprietary, binary format, since HTML is the native, natural language for such links. URL Union stores its bookmarks in an HTML file that can be easily read by any text editor, and any Web browser.
Supporting both tags and folders. It seems that many bookmark managers allow you to assign multiple, single-level tags to each URL. Other bookmark managers allow you to organize your URLs into nested folders, but typically allow each URL to appear in only one folder. URL Union allows you to assign multiple tags to each URL, and each tag can be nested up to 10 levels deep.
Intelligent import and merge capabilities. Many bookmark managers allow you to add additional bookmarks to a central file via an import function, but simply add the new bookmarks to your existing list. URL Union will allow only one record for each unique URL, and will intelligently merge duplicates when they are added via an import.
Import from multiple sources. URL Union supports import capabilities for multiple file formats, essentially allowing users to import their URLs from most existing sources in which they might be stored.
Export. URL Union can easily publish your URLs in the traditional Netscape bookmarks format, which can be imported by almost any Web browser or other URL manager.

System Requirements

URL Union is written in Java and can run on any reasonably modern operating system, including Mac OS X, Windows and Linux. URL Union requires a Java Runtime Environment (JRE), also known as a Java Virtual Machine (JVM). The version of this JRE/JVM must be at least 1.5. Visit www.java.com to download a recent version for most operating systems. The JVM is pre-installed as part of Mac OS X, and may be updated from the Software Update panel.

License

When running in demonstration mode, URL Union will store no more than 20 URLs. Please visit our store to purchase a license and remove the demo restrictions.

Redistribution and use in binary forms, without modification, is permitted provided that the software retains attribution using the above copyright notice.

This software is provided “as is” and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose, are disclaimed. In no event shall the copyright owner or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.

Installation

Download the latest version from PowerSurgePub.com. Decompress the downloaded file. Drag the resulting file or folder into the location where you normally store your applications.

Creating a New File

The first time you launch URL Union, or after selecting New from the File menu, you will see a fresh collection of URLs, containing only a single entry, for PowerSurge Publishing. New users will have their first set of bookmarks saved automatically for them in a default location, in a “URL Union” folder within their Documents folder.

Importing URLs

Select Import from the File menu to import existing bookmarks.

You must specify an existing bookmark file to import. The bookmark file to be imported should be an HTML file. You may need to export your URLs from some other program, into an HTML file, before importing them into URL Union. URL Union can import bookmarks from an HTML file in the traditional Netscape format), as well as from an HTML file formatted by the Delicious social bookmarking service.

URL Union comes with an AppleScript file that can be used to export bookmarks from Yojimbo into an HTML file that is acceptable for import by URL Union. Simply open the AppleScript file using AppleScript Editor, and then click the Run button. Be patient when exporting from Yojimbo. It may take several minutes for the AppleScript to complete its execution.

Saving a URL Collection

After selecting Save As from the File menu, you will be prompted to select a location at which to store your collection.

The default file name will be urlunion.html, and it is recommended (although not required) that you use this default name.

You may pick any folder you like in which to store your URL Union file, but it is recommended that you store your file in a new, empty folder especially created for this purpose. When you later use the Publish menu command, other files will be created for you, optionally in the same folder, and it will generally be cleaner if this folder is devoted to storage of URL Union files.

If you are a subscriber to Mobile Me, then you may wish to store your URL Union files in a sub-folder within the Sites folder on your iDisk, since doing so will allow you to access your URLs from any Web browser with an Internet connection.

Opening Recent Files

On subsequent launches, URL Union will automatically open the last URL Union collection you used. You may also open a recent file by selecting Open Recent from the File menu.

The Four Data Fields

For each URL, you may enter the following fields.

Title — A brief title for the Web site or page referenced by the URL.
URL — The URL itself.
Tags — Use a period to nest one tag within another. Use a comma to separate multiple tags. The “Favorites” tag by default identifies URLs you wish to appear in your favorites file (see the Publish section below). The “Startup” tag identifies URLs you wish to have launched in your favorite Web Browser whenever URL Union launches, so long as this is requested in your Preferences.
Comments — Enter whatever you like here, or leave it blank.

A toolbar with multiple buttons appears at the top of the user interface.

OK — Indicates that you have completed adding/editing the fields for the current URL.
+ — Clear the data fields and prepare to add a new URL to the collection.
- — Delete the current URL.
<< — Display the first URL in the collection.
< — Display the next URL in the collection.
> — Display the next URL in the collection.
>> — Display the last URL in the collection.
Launch — Launch the current URL in your Web browser. (This may also be accomplished by clicking the arrow that appears just to the left of the URL itself.)
Find — Looks for the text entered in the field just to the left of this button, and displays the first URL containing this text in any field, ignoring case. After finding the first occurrence, this button’s text changes to Again, to allow you to search again for the next URL containing the specified text.

The List

On the first half of the main screen, you’ll see two tabs. The first of these displays the List. This is just a simple list of all your URLs. The URL column appears first, and the list is sorted by domain name (“Google”, etc.). You can rearrange/resize columns. You can’t sort by other columns. Click on a row to select that URL for display on the other half of the main screen.

Find and Replace

A Replace option can be found under the List menu. Selecting this menu item opens a Replace Window. The window allows the user to specify which fields to search, and whether case sensitivity is desired. From this window the user has buttons to Find, Replace, Replace & Find or Replace All.

Publish

The publish option allows you to easily publish your URLs in a variety of useful formats.

To begin the publication process, select the Publish… command from the File menu.

You will then see a window with the following fields available to you.

Publish to:

You may use the Browse button above and to the right to select a folder on your computer to which you wish to publish your URLs. You may also enter or modify the path directly in the text box. When modifying this field, you will be prompted to specify whether you wish to update the existing publication location, or add a new one. By specifying that you wish to add a new one, you may create multiple publications, and then later select the publication of interest by using the drop-down arrow to the right of this field.

Equivalent URL:

If the folder to which you are publishing will be addressable from the World-Wide Web, then enter its Web address here.

Templates:

This is the address of a folder containing one or more publishing templates. This will default to the location of the templates provided along with the application executable. You may use the Browse button above and to the right to pick a different location, if you have your own templates you wish to use for publishing.

Select:

Use the drop-down list to select the template you wish to use.

Favorites Plus — This template will produce the following files and formats.
- index.html — This file is an index file with links to the other files. You can browse this locally by selecting Browse local index… from the File menu.
- favorites.html — This file tries to arrange all of the URLs you have tagged as “Favorites” into a four-column format that will fit on a single page.
- bookmark.html — This file formats your URLs in the time-honored Netscape bookmarks format, suitable for import into almost any Web browser or URL manager.
- outline.html — This is a dynamic html file that organizes your URLs within your tags, allowing you to reveal/disclose selected tags.

Apply

Press this button to apply the selected template. This will copy the contents of the template folder to the location specified above as the Publish to location.

Publish Script:

Specify the location of the script to be used. The PSTextMerge templating system is the primary scripting language used for publishing. A PSTextMerge script will usually end with a ‘.tcz’ file extension.

Publish when:

You may specify publication ‘On Close’ (whenever you Quit the application or close a data collection), ‘On Save’ (whenever you save the data collection to disk), or ‘On Demand’.

Publish Now

Press this button to publish to the currently displayed location. Note that, if you’ve specified ‘On Demand’, then this is the only time that publication will occur.

View:

Select the local file location or the equivalent URL location.

View Now

Press this button to view the resulting Web site in your Web browser.

Preferences

The following preference tabs are available.

General Prefs

SplitPane: Horizontal Split? — Check the box to have the List and Tags appear on the left of the main screen, rather than the top.
Deletion: Confirm Deletes? — Check the box to have a confirmation dialog shown whenever you attempt to delete a URL.
Software Updates: Check Automatically? — Check the box to have URL Union check for newer versions whenever it launches.
Check Now — Click this button to check for a new version immediately.
File Chooser — If running on a Mac, you may wish to select AWT rather than Swing, to make your Open and Save dialogs appear more Mac-like. However, Swing dialogs may still appear to handle options that can’t be handled by the native AWT chooser.
Look and Feel — Select from one of the available options to change the overall look and feel of the application.
Menu Location — If running on a Mac, you may wish to have the menus appear at the top of the screen, rather than at the top of the window.

Favorites Prefs

Open Startup Tags at Program Launch? — Indicate whether you want URLs tagged with “Startup” launched within your Web browser whenever URL Union starts.
Favorites Tags — Specify the tags that you’d like Favorites pages to be generated for. The default is ‘Favorites’, but you may specify whatever you’d like here, separating separate tags with commas. Each tag identified here will have a separate page generated with a name matching the tag.
Favorites Columns — Specify the number of columns you wish to appear on the Favorites page.
Favorites Rows — Specify the maximum number of rows you wish to appear on the Favorites page.

http://www.powersurgepub.com/ | opguide.html | Revised: 1/20/12