Documentation

Copy an existing package

Making a copy of a package

To create a copy of an existing package, you can either copy the *.PKG file to a new filename using the normal Windows File Explorer, or you can go into the Package Editor in TeSSH, load an existing package, and then use the "Save Package As" command in the File menu.

The "Save Package As" command will save the package to a new *.PKG filename. But nothing else will change. You'll still see the same original package name, module name, and scripts.

Example

In our example of editing the "Clickable URLs" package, we select the "Clickable URLs" package tab and then use File/Save Package As. Let's enter a filename of "myurl.pkg". It doesn't look like anything obvious has happened, but if we select the Edit/Package Properties menu, we will see our new filename displayed at the bottom of the window.

While viewing the Package Properties, edit the name of the Package to be "My URLs" and click the Save Changes button. The Package Properties will close and you will see that the tab for this package has changed to "My URLs".

But notice the contents of the package in the tree view on the left. It still shows "Clickable URLs". What's the deal with this?

This illustrates an important point: A Package is a FILE, and has both a FileName (the name of the file you see on disk, like mykeypad.pkg), and it has a Name (which you view in the Package Properties). Each package file contains one or more Modules or Windows. In this example, there is a published Module called "Clickable URLs". Changing the name of the Package does not change the name of the Modules or Windows stored inside of the Package.

Some people get confused by this fact because they think the first module displayed in the tree-view on the left is the same as the package itself. It isn't. A package can contain many modules and windows.

Let's go back to our example. Click on the "Clickable URLs" MODULE in the tree-view on the left side of the screen. Edit the name in the field on the right to be "My URL Module". Then click Save Changes.

Now you can change one of the triggers in your "My URL Module" module to work differently.  For example, in the first trigger that contains "https?|ftp|telnet" you can add an additional protocol that you wish to make into a clickable url.

Now we have a new package, called "My URLs", stored in the file myurls.pkg. It contains a single Module called "My URL Module". This Module contains two triggers copied from the original "Clickable URLs" package.

Add comment

Login or register to post comments