Products | iWisdom

iWisdom User Guide

Table of Contents

Introduction

iWisdom is a desktop application for storing, organizing and displaying small bits of wisdom, such as quotations. Some of its special features are:

• a number of related fields, including title, category, author, source, year of initial publication, and rights;

• storage of your wisdom in an open, non-proprietary XML format;

• multiple sorting and selection fields;

• multiple files with remembered viewing options for each;

• multiple categories and levels of categorization, with a tree view to let you see your items within categories;

• automatic Web Publishing;

• automatic XML publishing (to create RSS feeds, for example);

• a Find function;

• a Category Mass Change function;

• Web Page validation;

• an import capability that can extract existing wisdom from a number of different file formats;

• options to modify the look and feel of iWisdom;

• a transfer function to convert a wisdom item to readable plain text, with a corresponding accept function to convert the plain text (after possible transmission via e-mail, etc.) into a new wisdom item on another iWisdom list.

Getting Started

System Requirements

iWisdom is written in Java, which allows it to be easily run on almost any modern operating system, including Apple’s Mac OS X and Microsoft’s Windows. iWisdom 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 (aka 5.0). 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 Mac OS X Software Update panel.

License

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

Copyright © 2010, Herb Bowie
PowerSurgePub.com
All rights reserved.

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. If a folder is present, then drag the entire folder, and keep the inner files and folders in the same folder, without changing their names or locations.

Launching iWisdom

The iWisdom program can be launched by opening (double-clicking on) the file named “iwisdom.jar” or, on a Mac, the application simply named “iWisdom”.

Demo Mode

Each time that iWisdom is launched in demo mode, a small window will appear offering the opportunity to purchase a license, to enter your registration code, and/or to continue execution in demo mode. Once the program is registered, this window will cease to appear.

File Locations

The default location for your initial Wisdom collection is in your home directory, then in a folder named Wisdom, then in a folder named iWisdom. This collection will open automatically when you launch iWisdom.

You can create other Wisdom collections by selecting New from the File Menu. You can set one collection to be your primary collection by selecting Information from the File menu and then clicking on the check box to make the current folder your primary collection: your primary collection will then open automatically when launching iWisdom.

Note that an iWisdom collection consists of a folder and a number of files and sub-folders.

Once you have created an iWisdom collection, you may open it be selecting Open from the File Menu, and then selecting the collection’s folder. You may also use the Open Known item on the File Menu, to be able to select a collection from a list of previously opened collections.

The name of the current iWisdom collection appears at the bottom left of your main window. This display consists of the collection’s folder and its parent folder, followed by “(P)” if this is your primary collection. Hover over the display to see the full path to the collection.

Import Quotations

To jump-start your Wisdom collection, select Import from the File menu, then select the Portable Wisdom collection from the Favorites drop-down, then click on Import. (You will need an active Internet connection to import any of the Favorites.)

iWisdom is able to import wisdom from a number of different formats (including plain text and multiple XML-based formats). When importing, iWisdom will recognize duplicates (based on the actual content of each item’s body) and intelligently combine duplicates if they contain differing degrees of detail.

Import Quotations from WikiQuote

Quotations may also be imported from www.WikiQuote.org. Select Import from WikiQuote from the File menu. In the resulting panel, select your desired language, then enter the name of an author and/or a particular work (book, movie, etc.). You may also optionally enter a word or phrase in the Containing field, to search for a quotation containing the entered text (capitalization is not significant).

Click on the Search button to initiate the search of the specified WikiQuote page. You may then click on the Next button repeatedly to see each matching quotation, one by one. When you see a quotation you wish to capture for your collection, click on the Import button. Clicking on the Browse button will open the specified WikiQuote page in your Web browser.

Please note that, due to variability in the way quotations are entered into WikiQuote page, not all quotations may appear as candidates for import. If you wish to specific examples of failures to our attention, drop us a note at support@powersurgepub.com.

Backing Up and Restoring Quotations

The File menu contains a Backup command, and a Revert from Backup command. When performing a backup, the file location and name will default to a folder in your current iWisdom folder, and a name containing the current date and time. The Revert from Backup command will default to the same folder.

It is recommended that you perform a backup before each Import (see the next section for info about this) so that you can easily revert to your prior state if the import creates unwanted results. It is also recommended that you perform a backup before installing a new version of iWisdom.

Overall User Interface

Tabs and Windows

The iWisdom user interface consists of a number of windows. The main window shows a split pane. On the left/top you will see your current collection, either in a List or grouped by Categories. On the right/bottom you will see the currently selected piece of wisdom, either in Display mode or in Edit mode.

Opening the Preferences window will allow you to modify a number of the operating characteristics of the program. The Preferences window can be found under the iWisdom menu on the Mac, and under Tools / Options on other operating systems.

Tool Bar

The iWisdom interface also contains a Tool Bar containing a number of Buttons: the “OK” button saves your changes after adding/editing a wisdom item; the “+” and “-” buttons allow you to add a new item or delete an existing one, respectively. The next four buttons move you to the first item in your collection, the next item, the prior item or the last item, again respectively. Two other buttons allow you to quickly add or remove enclosing quotation marks around the Body of a piece of wisdom. The Scan button starts a process of briefly showing each item in your collection on a rotating basis.

The following text box allows you to enter a text string you wish to search for. The following button, initially labeled Find, causes the first item containing that text string to be found and displayed. After the first item is found, this button will be relabeled Again, and will then allow you to continue forward through the list of found items.

Menus and Keyboard Shortcuts

There are also a number of Menus listed across the top. If a command has a keyboard shortcut, then it will be listed as part of the command’s menu item.

The most commonly used commands are accessible in multiple ways. For example, you may navigate to the first item in the collection by clicking on the Tool Bar Button, or by selecting the command from the Item Menu, or through a keyboard shortcut.

Following is a list of all the menus, with a brief description of each menu’s purpose.

• File — Functions to open and save external disk files
• Edit — Standard Cut, Copy and Paste commands.
• List — Functions that affect the list as a whole.
• Item — Functions that affect a particular wisdom item.
• Tabs — Provides Keyboard Shortcuts for accessing Tabs
• View — List of Named Views.
• Tools — Access to Options/Preferences.
• Window — Access to special windows.
• Help — Access the iWisdom User Guide or Web Site.

Following is a list of all keyboard shortcuts. The command key is used in conjunction with another key to invoke shortcuts on a Mac, while the control key is used on other platforms.

Customizing the Look and Feel

The program’s General Preferences contain a number of options for modifying the program’s look and feel. Feel free to experiment with these to find your favorite configuration. Some options may require you to quit and re-launch iWisdom before the changes will take effect.

Wisdom Data

Your Wisdom List

The List Tab will list all the items in your collection. You may change the sequence of the items on the List Tab by selecting the appropriate View from the View Menu. You may create a new View in the View Preferences, by clicking on the + sign and then entering the name of your View and its sort fields.

Adding and Editing Wisdom

The Edit Tab allows you to enter or modify information associated with a Wisdom item. To create a new item, click on the “+” Button on the Tool Bar, or select New from the Item Menu. The data fields to be entered are then split between the Content, Author and Work tabs.

When you are done editing an item, simply click on the Display Tab, or click on the OK button on the Tool Bar, in order to leave the Edit Tab and save all your entries to disk.

Formatting Wisdom

On the Edit Tab, the Body field contains the actual wisdom or quotation. This field may be formatted using common HTML commands. If you wish to use quotation marks, enter normal “straight” quotation marks. For an em dash (or long dash), use two consecutive hyphens. Separate paragraphs with a blank line.

Categories

For each piece of wisdom, you may enter one or more categories and, for each, one or more sub-categories. Each category level is separated from the next by a forward slash or a period. Each separate category (including sub-categories) is separated from others by a comma.

Once a category is established for one piece of wisdom, you may assign it to other pieces of wisdom by selecting the desired category from the drop-down menu. You may do this by scrolling and clicking, or by typing the beginning letters of the desired category and pressing Return/Enter.

If you don’t see an appropriate category on the drop-down list, simply type in the new category that you want. Once you complete your edits for that item, your new category will become available the next time you select the drop-down list.

If you decide to stop using a category, simply remove it or change it on all the items to which it has been assigned. The next time you quit and relaunch iWisdom unused categories will disappear from the list.

If you’d like to change a Category name, use the Add/Replace Category Menu Item from the List menu to change all occurrence of one Category to a new one.

The Categories Tab organizes your collection by Category. Click on a disclosure triangle to view enclosed items and sub-categories.

Authors and Source Titles

When entering an author, you may select an existing author from the drop-down menu by entering the beginning characters of their name (either first name first or last name first), or by scrolling down the list, then pressing Return/Enter to select the desired author.

Selecting an existing source title may be done in the same way.

Book and Author Links

On the Edit tab, enter a book’s 10-digit ISBN in the Source ID field, to enable access to the book’s entry on Amazon.com from the Display tab.

Similarly, entering the Author’s name on the Edit tab will allow the author’s Wikipedia entry to be accessed from the Display tab.

Copying Last Author and Work

When entering multiple quotations from the same source, you can use the Last Author and Work command from the Item menu to copy information about the Author and Work from the last item you entered to the new item you are currently entering.

Displaying Wisdom

The Display Tab allows you to view a piece of wisdom. Click on an author’s name to use your Web browser to view the author’s entry in Wikipedia. Click on the name of a book to view the books’s entry on Amazon.com.

Note that the Display Preferences allow the display to be customized. You can select a particular font, font size, and colors for the background and the text.

You may also tailor which fields are displayed along with the wisdom body and its author, with Title, Source, Source Type, Added Date and Time, and iWisdom ID number all being optional.

Getting Wisdom out of iWisdom

iWisdom offers several different ways to get your wisdom out of iWisdom, in a variety of formats.

Transfer/Accept

A Transfer works like a Copy, with a couple of differences:

• An entire wisdom item is copied, and not just one particular wisdom field;
• You may select the format you wish to use for the copied data.

Use the Transfer Preferences to specify the format you wish to use. The following options are currently available:

• Fortune — A simple text format, with minimal data and minimal markup.
• Markdown — A plain text format, using simplified markup, designed for easy conversion to HTML.
• OPML — An XML format designed for outlines.
• Text Block — A simple format that will allow the wisdom item to easily be Accepted (i.e., pasted) back into iWisdom (on a different computer or in a different collection), using the Accept command from the Item Menu.

Note that Transfer and Accept both make use of the System clipboard — the same area used by Cut/Copy/Paste commands. So, for example, the following sequence of commands, using the Text Block format, will allow you to move a Wisdom item from one collection on one computer to a different collection on a different computer.

1. From within iWisdom, select the desired item in the first collection.
2. Select Transfer from the Item Menu.
3. Compose an e-mail to be sent to the owner of the second computer.
4. Perform a normal Paste command in your E-mail program to paste the wisdom item into the body of your e-mail.
5. Send the e-mail.
6. Upon receipt of the e-mail, select the entire text block containing the wisdom item and perform a normal copy.
7. Fire up iWisdom, and select Accept from the Item menu.

Export

The Export command, available from the File menu, allows you to export part or all of your collection into an external file that can be used by other programs.

The following Export options are available, once you select the Export command.

Field Scope

Allows you to select one of the following options.

• All Fields — This options can be used for exporting into a format that preserves all iWisdom data fields as discrete entities in the resulting output file. This option is best when you will be using the output from iWisdom as import to another program (or to another iWisdom collection).
• Wisdom List — This option creates a list of the desired wisdom entries, but formatted primarily to be read by a human, rather than a computer.

Item Scope

Allows you to select one of the following options.

• Current Item — Exports only the single item that is currently selected.
• Selected Category — Exports all items in the Category that you select below.
• Entire Collection — Exports all items in the currently opened collection.

Format

If you selected a Field Scope of All Fields, then you can select from one of the following formats.

• XML — Using the format used internally by iWisdom.
• Tab-Delimited Text — Formatted in rows and columns, with tabs between each column. Suitable for importing into spreadsheets and databases.
• Text Block — A format that can be easily read by humans and by iWisdom.

If you selected a field scope of Wisdom List, then you may select from any of the following output formats.

• Fortune — A simple text format, with minimal data and minimal markup.
• HTML — The native language of the World-Wide Web.
• Markdown — A plain text format, using simplified markup, designed for easy conversion to HTML.
• OPML — An XML format designed for outlines.
• Textile Syntax 1 — Another lightweight markup language.
• Textile Syntax 2 — Textile again, but with links encoded differently.

Publish

The publish option allows you to publish your entire wisdom collection as a complete Web site.

To simply complete the publication process with your latest changes, select the Publish command from the File menu.

To modify the Publish options, select the Export command from the File menu, and then the Publish tab. You will then see the following fields available to you.

Themes…

Pressing this button will allow you to specify a folder that contains the various themes you wish to use for Web publishing of your collection. The default location for your themes is in your application folder, and this location may be used so long as you are content to use the stock themes supplied with iWisdom. If you generate your own custom themes, then you would normally want to move your themes folder to a more stable location, one that will not be overwritten each time you install a new version of the software.

Theme

Select a theme from the drop-down list. These correspond to the folders available in the themes location specified above. Note that iWisdom comes with the following themes pre-installed.

portablewisdom1

This is the theme used to generate the wisdom collection for the PortableWisdom.org Web site.

portablewisdom2

This is a theme that can be used to generate a stand-alone collection of wisdom (not integrated into the rest of the PortableWisdom.org Web site).

Apply

Pressing this button will apply your selected theme to your wisdom collection’s HTML representation.

Publish

Pressing this button will execute a script of XSL transformations. Note that it may take several seconds for the publication process to be completed.

Help

The following commands are available. Note that the first two commands open local documentation installed with your application, while the next group of commands will access the Internet and access the latest program documentation, where applicable.

• Purchase License — Takes you to a Web page from which you may register your copy of iWisdom.

• Product Registration — Pops up a dialogue box in which you can enter your User Name and Registration Code.

• Program History — Opens the program’s version history in your preferred Web browser.

• User Guide — Opens the program’s user guide in your preferred Web browser.

• iWisdom Home Page — Open’s the iWisdom product page on the World-Wide Web.

• iWisdom Import Sources — Takes you to a Web where you will find a number of potential iWisdom import sources.

• Reduce Window Size — Restores the main iWisdom window to its default size and location. Note that this command has a shortcut so that it may be executed even when the iWisdom window is not visible. This command may sometimes prove useful if you use multiple monitors, but occasionally in different configurations. On Windows in particular, this sometimes results in iWisdom opening on a monitor that is no longer present, making it difficult to see.

Home | Products | Store | Donations | Downloads | Support

Copyright © 1999-2010 Herb Bowie • All rights reserved • E-mail:

http://www.powersurgepub.com/ | opguide.html | Revised: 8/21/10

WWW PowerSurgePub.com