Document Properties: Destination

The Destination properties page specifies the title for the document and the destinations where iSiloX copies the converted document.

Document Title

Each document must have a title. The title may be up to 31 characters long. You should make sure that you give each document a unique title.

There are a couple of important points you need to be aware of with regard to the requirement that the title you assign a document should be unique.

Dynamic title components

In addition to static characters in the title, the title can also have dynamic components such as the date of conversion or the title of the first source file. Dynamic components always begin with the two-character sequence consisting of a backslash and an uppercase X, followed by the component name. If the component has additional parameters, a question mark follows the component name and the parameters follow the question mark. A semicolon marks the end of a component.

The following table lists the available title components:
Component Description
\Xdate; Text: The date the conversion starts.

Default format: A six character sequence in the format Y2M2D2, where Y2 is the last two digits of the year, M2 is the two digit month, and D2 is the two digit day.

Parameters: Any of the following parameters can be provided in any order. Additional characters may also be interspersed between the parameters as separators that are included in the resulting text.

  • Y: The year in natural format (e.g., 1999, 2004)
  • Y2: The year in two-digit format (e.g., 99, 04)
  • M: The month in natural format (e.g., 8, 12)
  • M2: The month in two-digit format (e.g., 08, 12)
  • D: The day of the month in natural format (e.g., 9, 31)
  • D2: The day of the month in two-digit format (e.g., 09, 31)
\Xtime; Text: The time the conversion starts.

Default format: A four character sequence in the format H2M2, where H2 is the two digit hour in 24-hour format and M2 is the two digit minute.

Parameters: Any of the following parameters can be provided in any order. Additional characters may also be interspersed between the parameters as separators that are included in the resulting text.

  • H: The hour in 24-hour natural format (e.g., 2, 23)
  • H2: The hour in 24-hour two-digit format (e.g., 02, 23)
  • M: The minute in natural format (e.g., 8, 51)
  • M2: The minute in two-digit format (e.g., 08, 51)
  • S: The second in natural format (e.g., 9, 38)
  • S2: The second in two-digit format (e.g., 09, 38)
\Xtitle; Text: The title of the first source file.

Parameters: This component has no parameters.


Example titles with dynamic components

Title Specification Description
\Xdate; Short Stories of Yore
If the date of conversion is December 25, 2004, this title specification sets the title to "041225 Short Stories of Yore". This title uses the default date format.
\Xdate?M-D-Y; Short Stories of Yore
If the date of conversion is December 25, 2004, this title specification sets the title to "12-25-2004 Short Stories of Yore". Notice the inclusion of hyphens between the month, day, and year parameters, which result in the insertion of hyphens between those parts in the same places in the resulting title.
Short Stories of \Xdate?D-M-Y2; Yore
If the date of conversion is March 1, 2005, this title specification sets the title to "Short Stories of 1-3-05 Yore".
Short Stories of \Xdate?D2-M2-Y2; Yore
If the date of conversion is March 1, 2005, this title specification sets the title to "Short Stories of 01-03-05 Yore".

Adding HotSync® Destinations

If you have HotSync® installed, then you can add users to the HotSync® destination list. After iSiloX converts the document, it queues the document for installation to the listed users so that the next time the user performs a HotSync®, the document is installed to the user's device.

Adding a HotSync® user destination

To add one or more HotSync® destinations, click the Add HotSync® Destination... button. This presents the HotSync® Users dialog. Select one or more users from the list, select one of the Destination options (described next), then click OK to add the user(s) to the destination list.

Handheld device memory

Selecting Handheld device memory for the Destination option installs the document to the internal storage memory of the Palm OS® device.

External memory card

Selecting External memory card for the Destination option installs the document to the /Palm/Programs/iSilo/ folder of the first memory card with enough free space for the document. Note that some Palm OS® devices may have built-in memory cards and that the order in which the HotSync® Manager presents the memory cards to the iSilo™ Install conduit may differ from one HotSync® operation to the next. For specific control over exactly which memory card the document installs to, use the Path destination option described next.

Path

Selecting Path for the Destination option installs the document to the path entered in the adjacent field. The path specifies the memory card and location on the card to which to install the document and must be a full path with slashes as path component separators. Either forward slashes or backslashes may be used as path component separators.

The first component of the path must be the volume name or label of the memory card. If the volume name is empty or not that of a mounted memory card at the time of HotSync®, the document installs to the first memory card with available space.

Following the volume name component is the path of the folder to which to install the document. If the full path ends in a slash, the filename is based on the document title as described above. Otherwise, the last component of the path is the file name the document takes on the memory card.

If any of the folders in the path do not exist at the time of installation, the iSilo™ Install conduit creates them.

Following are some example paths:

Example Path Description
/Johns Card/Documents/iSilo/Diary for September.pdb Volume: Johns Card
Folder: /Documents/iSilo/
File name: Diary for September.pdb
/128M/Entertainment/ Volume: 128M
Folder: /Entertainment/
File name: based on document title
//Documents/iSilo/ Volume: first one with enough free space
Folder: /Documents/iSilo/
File name: based on document title
//My Hobbies/Fishing/Laws and Regulations/DeepFish Volume: first one with enough free space
Folder: /My Hobbies/Fishing/Laws and Regulations/
File name: DeepFish

Note that the path must begin with a slash and that the characters listed in the table below can not be used for any part of the folder path or file name. However, there may be additional characters that can not be used and are dependent on the file system of the card. Using invalid characters will result in problems or errors during installation of the document:

Disallowed characters in paths
CharacterDescription
"Double-quote
*Asterisk
:Colon
<Less than
>Greater than
?Question mark
|Vertical bar

Removing HotSync® destinations

To remove one or more HotSync® destinations, select the destinations to remove and then click the Remove Selected Users button. iSiloX presents a dialog for you to confirm that you want to remove the selected users.

Changing the HotSync® destination

You can control-click any entry in the list to get a context menu to change the specific destination. In the context menu, a checkmark appears next to the currently selected destination. Click the desired destination in the menu to change it.

If you click Path and the current destination is already a path, you can edit the current path. Otherwise, if the current destination is either Handheld device memory or External memory card, selecting Path allows you to change the destination to be a path and to enter the specific path for the document.

You can not directly change an added destination to another user. Just remove the entry you want to change and add the new one in the normal manner.

Adding a File Destination

To have the converted document copied to a file, click the Add File Destination... button. This presents the Choose Destination Folder dialog from where you select the destination folder. After selecting the destination folder and clicking OK, iSiloX adds the full path of the folder to the file destination list. The path name has a colon appended to indicate that it is a folder.

By default, unless you specify a file name, iSiloX copies the converted document to the folder as a file with the same file name as the Document Title and with an extension of .pdb.

Specifying the file name

If you want to give the destination file a specific file name, right-click the entry to get the context menu, then click Edit. Type the file name after the last backslash and hit Enter to accept the change or Esc to cancel the change.

Editing the file name

To edit an entry in the file names list, hold down the control key and click the entry to get the context menu, then click Edit. Make your changes and click OK to accept or Cancel to cancel any changes.

Removing file destinations

To remove one or more file destinations, select the file destination entries to remove and then click the Remove Selected Files button. iSiloX presents a dialog for you to confirm that you want to remove the selected files.

Notes

  • iSiloX automatically overwrites the destination file without prompting, so make sure you are aware of this.
  • Remember that if the file name ends in a colon, then iSiloX assumes that it is a folder and uses the Document Title with an extension of .pdb as the name of the destination file.
  • All folders in the path leading to the destination file must exist or iSiloX will not be able to copy the converted document to its destination.