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 one of two open, non-proprietary formats: XML or Structured Text;
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.
iWisdom is written in Java and can run on any reasonably modern operating system, including Mac OS X, Windows and Linux. 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 6. Visit www.java.com to download a recent version for most operating systems. Installation happens a bit differently under Mac OS X, but generally will occur fairly automatically when you try to launch a Java app for the first time.
Because iWisdom may be run on multiple platforms, it may look slightly different on different operating systems, and will obey slightly different conventions (using the CMD key on a Mac, vs. an ALT key on a PC, for example).
iWisdom Copyright 2003 - 2016 by Herb Bowie
Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
iWisdom also incorporates or adapts the following open source software libraries.
JExcelAPI — Copyright 2002 Andrew Khan, used under the terms of the GNU General Public License.
parboiled — Copyright 2009-2011 Mathias Doenitz, used under the terms of the Apache License, Version 2.0.
flexmark-java — Copyright 2016 Vladimir Schneider, used under the terms of the [2-Clause BSD License](2-Clause BSD License).
Xerces — Copyright 1999-2012 The Apache Software Foundation, used under the terms of the Apache License, Version 2.0.
Saxon — Copyright Michael H. Kay, used under the terms of the Mozilla Public License, Version 1.0.
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. Double-click on the jar file (or the application, if you’ve downloaded the Mac app) to launch.
iWisdom works with chunks of wisdom and associated data, organized into collections.
Selecting Get Info from the File menu will bring up a window that allows you to enter a number of information items applicable to an entire wisdom collection.
These fields pertain to the content of each wisdom item.
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.
These fields pertain to the author(s) of the wisdom item.
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. Entering the Author's name will allow the author's Wikipedia entry to be accessed from the Display tab
These fields pertain to the work from which the wisdom was taken.
File operations may be accessed via the File menu.
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 Get Info 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 possibly sub-folders.
Once you have created an iWisdom collection, you may open it by selecting Open from the File Menu, and then selecting the collection’s folder. You may also use the Open Recent 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.
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.
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, 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 firstname.lastname@example.org.
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 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, or changing any of the storage options.
The Backup Preferences allow you to choose one of three backup modes:
Manual Only – Backups will only be performed when they are explicitly initiated by the user, via the File / Backup menu item.
Occasional Suggestions – iWisdom will remind the user to perform a backup every seven days, and prior to major events such as imports and program upgrades.
Automatic Backups – Backups will be performed automatically whenever the program quits, as well as prior to major events such as imports and program upgrades.
The program will default to occasional suggestions.
A toolbar with multiple buttons appears at the top of the user interface.
The main window contains three different panes.
On the first half of the main window, you’ll see two tabs. The first of these displays the List. This is just a simple list of all your Wisdom Items. You can rearrange/resize columns. You can’t sort by other columns. Click on a row to select that Wisdom Item for display on the other half of the main window. Use the entries on the View menu to select a different sorting/filtering option. Use the View Preferences to modify your view options.
The second Tab on the first half of the main window displays the Categories. This is an indented list of all your Categories, with Wisdom Items appearing under as many Categories as have been assigned to them, and with Wisdom Items with no Categories displaying at the very top. Click to the left of a Category to expand it, showing Wisdom Items and/or sub-tags contained within it.
Note that Categories that were once used, but that are used no more, will stick around until you close the iWisdom file and re-open it. If you wish, you may accelerate this process by selecting Reload from the File menu.
The detailed data for the currently selected Wisdom Item appears on the second half of the main window.
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.
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.
iWisdom offers several different ways to get your wisdom out of iWisdom, in a variety of formats.
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 Updated (i.e., pasted) back into iWisdom (on a different computer or in a different collection), using the Upate command from the Item Menu.
XML – A format using XML markup.
Text - Structured – A subset of YAML that is easy for humans to read and edit.
Note that Transfer and Update 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.
From within iWisdom, select the desired item in the first collection.
Select Transfer from the Item Menu.
Compose an e-mail to be sent to the owner of the second computer.
Perform a normal Paste command in your E-mail program to paste the wisdom item into the body of your e-mail.
Send the e-mail.
Upon receipt of the e-mail, select the entire text block containing the wisdom item and perform a normal copy.
Fire up iWisdom, and select Update from the Item menu.
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.
* 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.
* 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.
* 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. * Text - Structured -- A subset of YAML that is easily human-readable and easy for humans to update. 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.
The publish option allows you to easily publish your Wisdom Items 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.
**Favorites Plus**: This template will produce the following files and formats. 1. 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. 2. favorites.html -- This file tries to arrange all of the Wisdom Items you have tagged as "Favorites" into a four-column format that will fit on a single page. 3. 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. 4. outline.html -- This is a dynamic html file that organizes your URLs within your tags, allowing you to reveal/disclose selected tags.
The following preference tabs are available.
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.
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.
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.
Check for Updates – Checks the PowerSurgePub web site to see if you’re running the latest version of the application.
iWisdom Home Page – Open’s the iWisdom product page on the World-Wide Web.
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.
iWisdom Import Sources – Takes you to a Web page where you will find a number of potential iWisdom import sources.