Document Views

Screem provides a number of methods of viewing the document currently being worked on.

6.1. The Editor View

From the View menu. Choose the Editor menu item.

The text editor based view is the main authoring section of Screem. It has all the usual features you find in gedit, the default GNOME text editor. There are of course a number of extra features geared towards editing HTML / XML documents.

6.1.1. Editor features

Context menu

In addition to the usual right click popup menu Screem adds options to save and close the current document.

When working on HTML / XML documents an extra item is added at the top of the menu if the click occurs inside a tag. This submenu will provide you with a method of inserting any valid attribute for the tag, along with a value. The actual inserted value may just be the type of data the attribute requires rather than any specific, e.g. CDATA.

If a wizard has been loaded that supports an HTML / XML tag that has been clicked on, then an option to edit the tag in the wizard will also be provided.

Enhanced copy / paste support

As well as supporting copy / pasting of text, the editor also supports html that may be in the clipboard. This means you could for instance select part of a page you are viewing in Epiphany and paste it directly into Screem without having to search through the source of the page you are viewing. Other applications such as Abiword and Gnumeric can provide html when pasted into Screem

The editor also has a special paste mode, which will encode the relevant characters as entities, so actual HTML can be shown in the page.

These pasting features are available by selecting the following menu items:

  • Edit → Paste
  • Edit → Paste Encoded
  • Edit → Paste Unformatted
Select Context

When dealing with markup it can be useful to select the entire element block you are working on, for instance a complete row of a table. For this reason the editor has the ability to select the current element context, based on the cursor location. Doing this multiple times will select the parent element.

This feature is available by selecting Edit → Select Context from the main menu.

Select Element Content

Similar to select context you may just like to select the content of the current element, rather than selecting the open and close tags as well.

This feature is available by selecting Edit → Select Element Content from the main menu.

Goto Context Start / End

After making changes to some text it can be useful to move to the start of the element block you are in, or perhaps then end, Screem provides support for doing just that.

These are available from the Search → Goto Context Start and Search → Goto Context End menu items.

Goto Parent Element

As well as support for jumping to the start and end of the current element you can also jump up to the start of the parent element.

This is available from the Search → Goto Parent Element menu item.

Special Block Operations

A number of block operations are supported, that will operate on the whole document, or the selected text.

  • Auto indent, which will indent the block based on the document structure
  • Indent / Unindent, which will change the indentation taking no account of the document structure,
  • Encode as Entities, which will convert any necessary characters to HTML / XML entities
  • URI Encode, changes all characters to their URI encoded equivalent. e.g. a space becomes %20
  • Convert between upper / lower case for tag names.

All of these operations are available under the Edit → Block Operations submenu.

Spell Checking

A markup aware spell checker is included, that will ignore tags, and only check their content.

This is accessible from the Tools → Spell Check menu item.

Document structure based auto indentation

This is the same automatic indentation that is available as a block operation, but can be enabled to operate while editing, e.g. pressing Return or Tab will indent the next, or current line based on the document structure.

Intelligent tag closing

Using this feature > will be automatically inserted when a < is entered. In addition if a / is typed between <> the correct closing tag will be automatically filled in.

Auto completion

Based on Screem tag trees and reference files, and the type of document being edited, autocompletion may be provided.

Auto completion is always provided for markup based documents after a < has been typed, providing a list of all tag names.

Tooltips

Tooltips are also provided based off tag trees and reference files. These are displayed when hovering keywords with the mouse, or in the case of function calls, when the cursor is within the function call itself.

Inline tagging

Inline tagging occurs when you press space inside a tag, and presume you are about to enter a new attribute. As such a popup is provided listing all valid attributes for that tag, based on the doctype in use.

Automatic entity insertion

Some characters are forbidden in HTML / XML documents, such as < and >. As such the editor helps ease the use of the correct entity. Typing an & will auto insert the trailing ; character, then pressing the key for the character you want will insert the correct entity. Depending on what mode the entity insertion is in, when keys are pressed even not inside a &; an entity will be inserted.

Enhanced Drag and Drop support

The editor has extensive drag and drop support. As well as dropping text into the editor you can drag html from your browser window, or a color from The Gimp, or a URI / file.

Pressing Alt or middle button dragging an item onto the editor will also provide a popup menu of how to insert the drop. URIs / files for example can have their full pathname inserted, or a relative pathname, or even an appropriate tag based on what the file type is. For text based URIs / files you can even insert their contents directly.

Error highlighting

The editor has the option to highlight invalid markup in HTML / XML documents, if such a section is right clicked on a "Learn More" item will appear in the context menu.

The "Learn More" feature will open your web browser to a page hosted at www.screem.org, although no help pages are currently available.

6.2. The Preview View

From the View menu. Choose the Preview menu item.

The preview provides a quick way of checking how your HTML pages may look in web browsers. It has rudimentary CSS support, and no support for scripting.

6.3. The Link View

From the View menu. Choose the Link View menu item.

The link view provides an overview of all the links contained documents, centered upon the current one, and going to a choosable depth. It will show which files need to be uploaded to a remote site, and can also check all links to see if any are broken or not.

6.4. The Tree View

From the View menu. Choose the Tree View menu item.

Currently the tree view only shows you the document structure of the file you are working on. This can be used to help you spot missing closing tags, tags in the wrong place etc.

Future versions of Screem will allow you to edit from within this view