Lucid Builder v4

How to attach a web page to a Feature, Couplet or Entity

Applies to Matrix and Pathway key projects

Web pages may be attached to any Feature, Couplet or Entity. The page may be remote to your local computer (that is, located on a Internet Web server accessible via a URL), or it may be a page that you have created and saved to the key’s HTML folder. If it is a local page in the key’s HTML folder, you should ensure that any media (images etc) associated with the page, and any linked pages, are also either saved to the key’s HTML folder or are remote World Wide Web resources.

To attach a web page to an item (Feature, Couplet or Entity), first select the appropriate item. Right-click the Html folder in the Media panel or click the Attach Media button. To attach a local file, choose the Attach Html File (Shortcut key Ctrl + L) menu option and choose the file using the Open File dialog box that appears. To attach a file by URL, choose the Attach Html URL (shortcut key Ctrl + Shift + L) menu option and enter the URL address (or paste a copied URL) into the dialog box.

Lucid Builder attach HTML media options
Lucid Builder attach HTML media options

Important Note

When copying files to the HTML directory using your computer’s file management system, be aware that web pages often comprise many files (e.g. CSS, JavaScripts etc), all of which need to be copied correctly. Embedded images and hyperlinks to other pages will be broken if the files are not copied correctly, or if they have been assigned in the page using absolute rather than relative references. Consult your web page authoring software for more information.

Lucid Builder v4

Lucid Builder Understanding the Lucid Media Directory structure

Before beginning to attach multimedia files (web pages and images) to items in the key, you should understand the Lucid directory structure. In some cases, it is necessary to create files at the correct location within this directory structure before they can be attached to the key.

When a Lucid key is first saved, the Lucid Builder creates a set of directories for storing the various data files required. The basic directory structure for a key is as follows:

Lucid Builder default key folder structure
Lucid Builder default key folder structure

Save Directory is the folder you chose to save the key into. Inside this directory the Builder will write a file called {Key Name}.lk5 (where Key Name is the name given to the key in the Save As dialog box). Key Name.lk5 stores information necessary for the Lucid Builder.

The Key Name directory is created by the Lucid Builder at the time you save the key, and given the same name as the .lk5 file.

Data is a directory that stores essential key data. 


Never alter any content within the Data directory, you will almost certainly irretrievably corrupt your key.

The media directories MediaHtml, Images and Thumbs are created by the Builder to hold media files attached to the key. You may, if you wish, create sub directories within the Html and Images directories.

Web pages for attachment to items in the key must be authored outside Lucid, using HTML authoring tools such as Fact Sheet Fusion (available from For details see Web pages (except external web pages accessible via the Internet) must be created in the key’s HTML directory (or sub folder), and must not refer to images and other media elements (e.g. CSS, JavaScripts etc) outside the key’s media folders. Otherwise, links will be broken when the key is moved to a different folder or deployed.

Images for attachment to items in the key may be sourced outside the key’s folders, or  manually placed into the key’s Images directory (or sub folder) and attached from there. If a media file located outside the key’s Images directory and is attached to an item, Lucid will automatically create a copy of the media file in the key’s Images directory.


Editing an original file located outside the scope of the key folder, for instance, at its original location, will have no effect on the copy held within the keys media folder.

The Thumbs directory holds thumbnails, created by the Lucid Builder, for all images attached to items in the key.

Also see: Automatic backup of key data files

Lucid Builder v4

Lucid Builder Attaching media to items in the key

Features and Entities in Lucid keys can be provided with images and web pages, to help users and provide further information about the items. For example, Features and States may be illustrated with images and notes to help users understand the terms involved, and Entities may be provided with web pages including images, descriptions, notes on ecology, distribution etc.

Valid multimedia items are:

  • Images in JPEG, GIF or PNG formats, and URL references to images on the Internet.
  • Web (html) pages, URL references to web pages on the Internet and PDFs.

(Note that video and sound multimedia are accommodated in Lucid via the web page attachments.)

The Media tab to the left of the main window provides access to the Media Panel. This panel allows the user to attach all multimedia to items in the Features and Entities trees.

Also see:

Attaching a web page to a Feature or Entity

Attaching an image to a Feature or Entity

Creating Natural Language Descriptions