Seth User Guide

this file is being updated

your code has never looked this good

from 2.2 compatible with LC Community Versions from v6.7 onwards

Seth is a helper plugin for LiveCode which allows theming of the LiveCode script editor.

Features

  • Multiple themes can be created, each with their own font, font size, font attributes and colors.
  • Every theme is made up of a list of theme elements i.e BGColor for the editor background color and Singlecomment for one line comments. Each of these can be renamed and their individual attributes customized.
  • Seth comes pre-loaded with two themes. The standard LiveCode theme and a Dark theme.
  • The LiveCode Error script editor can have it’s background color set, configurable with each theme.
  • Once purchased all updates are free.
  • The themes list can be expanded to allow for easy viewing of large theme lists.
  • The themes list can be reordered using drag and drop.
  • Seth themes can be imported and exported to a simple text file.

Thanks to

An extra special thank you goes out to Stephen Ezekwem and Ken Cooper for their extensive pre-release testing of Seth V2, and for their observations and recommendations.
Seth would not be the product it is without them!

I would also like to thank the early adopters of Seth for their feedback and suggestions.

Who created Seth

Seth is a product from Andy Piddock. More info can be found at 2108.co.uk

 

Installing the Seth plugin (1)

Open the LiveCode ide and open Preferences

Installing the Seth plugin (2)

Go to Files & Memory and locate your user plugins location Close the LiveCode ide

Installing the Seth plugin (3)

Copy the revSethEditor.livecode file to your plugins directory

Installing the Seth plugin (4)

Copy or create a new folder ‘seth’ in the plugins directory
The seth folder MUST contain revSethPreferences.livecode file for Seth to operate.
Clicking on the ? in Seth will open the user guide at http://2108.co.uk

Opening Seth

Open LiveCode and pick revSethEditor from the Plugins menu

Start Up

Seth initialization checks

On start up Seth performs checks to make sure that the preferences file exists and that it is formatted correctly. If the preferences file is not found, Seth will notify you of this and shut down after 10 seconds.

Orientation

The Seth panel can be broken down to the following areas and functions.

1. The Main menu, where you can create a new theme, delete themes, import and export themes and a tools option which is where you can check for updates and post issue and feature reports. 2. The theme list displays currently loaded themes.

3. The theme elements list which lists all of the editable elements and attributes of the active theme.

4. The theme list expander increases the height of the theme list to allow for easier viewing of large theme collections. By default the height of the theme list is locked as indicated by the = icon in the button. Clicking the = button unlocks the expander and the button icon changes to V and now when you mouse over the theme list it’s height will increase, returning to it’s normal size when you mouse out of the theme list.

5. Clicking on the help/info button launches the local user guide if it exits or opens the user guide on the Seth web site in the default browser if not.

6. Minimize, shrinks Seth to the size of the 2108 icon (7). This can be dragged around the screen to allow more room for the LiveCode editor.

7. Double clicking the 2108 icon will restore Seth to it’s full size if Seth is in it’s minimized state.

8. Close Seth button. All code inserted into the LiveCode ide when Seth was launched is removed. Changes made to the script editor section of the LiveCode preferences are reset. Loaded themes are saved prior to Seth closing.

Creating a new theme

Each theme therefor can be thought as a template. Once a new theme has been created its properties can be amended to differentiate it from it’s template theme.

Select the theme (by a single left mouse click) to be used as the template for the new theme.

Click the New button. The New Theme dialogue shows with the previously selected theme name in the theme name input field. Change the theme name to the name of the new theme to be created.

Click Save Theme. The new theme will now been shown in the theme list.

Deleting a theme

Select the theme to be deleted (by a single left mouse click).

Click the Delete button. The Delete dialogue shows with the previously selected theme name in the theme name field. Click Delete Theme.

Exporting themes

Themes sets can be exported to a text file. This allows you to move theme sets between different computers which use the Seth plugin.

Note that ALL themes are exported.

Click the In/Out button. The Import/Export dialogue shows.

Click the Export Themes button. The system save file dialogue shows. Type in the name of the text file for the exported theme set.

Click save. After saving a dialogue shows confirming the save and displaying the full file path of the saved file.

Importing themes

Please note that when importing theme sets if a theme of the same name is already loaded in Seth it will be replaced with the imported theme of the same name.

Click the In/Out button. The Import/Export dialogue shows.

Click the Import Themes button. The system open file dialogue shows. Select the theme set file and click Open.

The new themes are now loaded into Seth.

Switching themes

To switch between theme either left click on a theme in the theme list or use the up / down arrows on the keyboard. The script editor automatically uses the newly selected theme.

Setting theme font and font size

The font and font size can be set for each theme.

Double left click on the a theme in the theme list. A panel will slide out from the right. Choose the font and font size for the theme.

Click the Save button.

Setting theme element attributes

Each element of a theme can have color, name and font style set.

Double left click on a theme element in the theme elements list. A panel will slide out from the right.

Click on the color box to bring up the system color picker to change the elements color.

To change he name of the element, type in a new name in the name field and click on the > button to set.

Font styles can be set by clicking the B (bold), I (italic), U (underline) buttons. Clicking the P button will set the font style to the LiveCode default.

Click Save to save your changes.

Expanding the theme list

For ease of use the theme list can be expanded which is useful when you have a large number of themes loaded.

Click on the expander (=) button to change the theme list expander to unlocked, the expander buttons icon will change to (v) to indicate that the theme list expander is unlocked. Now when you mouse into the theme list it will expand in height. When you mouse out the theme list will revert to its default height.

Reordering Themes

To reorder themes, click and hold down the left mouse key on the theme to be moved in the theme list and drag and drop to the new position.

The first theme in the list is the default which is used when Seth starts, so if you have a theme you want at start up, move it to the top of the theme list.

Tools options – Issue Tracker

Click the Tools button to take you to the Tolls sub menu Click the Issue Tracker button

Tools options – Issue Tracker (2)

The Issue Tracker allows you to send bug and Feature Requests to the issue tracker at http://2108.co.uk/issue-tracker/

Fill in the Title and Describe your bug or feature request.
Use the Type dropdown to select the type of report.
The LiveCode version and your system operating system definer will automatically be retrieved.

Click Send to send the report.

Tools options – Updates

Click on the Updates button. Seth will check to see if a new version is available. If there is a new version you will be prompted to download.

Click the Yes button to download the newer version.

Tools options – Updates (2)

Once the download is completed you will be prompted to Close Seth to complete the update.

Click OK. Seth will now close.

Open the new version of Seth from the Plugins menu.

end of user guide.