relax(1) relax(1)
NAME
relax - HTML editor
SYNOPSIS
relax
DESCRIPTION
relax is an editor that supports the creation of documents for the WWW
(World Wide Web) in the HTML markup language. Since knowing and
editing HTML tags using an ordinary text editor tends to be a hard
job, this application is supposed to provide an easier way of writing
HTML documents.
The HTML editor relax was developed with the Motif1.2 Toolkit. So it
shows the typical Motif look when run on the X Window System. The
application is intended to be controlled by a mouse pointer as well as
by keyboard input.
MAIN WINDOWS
Editing Window
This window shows up when relax is first executed. Its components are:
Name Label
On the very top of the Editing Window is the name of the editor.
File Label
Below the name label appears the path of the currently edited
file. If the document has not been saved it is labelled
"*unknown*".
Menu Bar
The menu bar offers various buttons for editing and manipulating
the text. These may either be selected by clicking on their item
names or by pressing the underscored character (mnemonic) while
holding down the [ALT] key. By activating the desired button a
pulldown menu of its related functions pops up. The latter also
have mnemonics to be pressed. Some show "accelerators" (e.g. Load:
CTRL+L) that provide a quick way of directly choosing a function
while editing the document.
Text Field
This is the area where the actual ASCII text (including HTML tags)
is typed in. Horizontal and vertical scrollbars may move larger
documents.
Buttons Bar
Frequently needed buttons are placed on the bottom of the window .
- 1 - relax (5/94)
relax(1) relax(1)
Parsed Text Window
The "Parse" button in the menu and buttons bar executes a function
that displays the edited ASCII text in Mosaic style and puts it into a
separate window.
Name Label
This is only the label of the Parsed Text Window.
Document Title
Usually a title is specified in an HTML document. If this is the
case, it is revealed in the Parsed Text Window. Otherwise this
label shows "*NO TITLE*".
Parsed Text Field
As opposed to the Editing Window the Parsed Text Window shows the
same text that is being edited in a Mosaic formatted style.
Please note: Images with a reference in the ASCII text are not
displayed as actual pictures but they are substituted by the
default Mosaic logo.
Cancel Button
This button removes the Parsed Text Window.
MENU ITEMS
File
This menu item contains the following options: "New", "Load", "Save",
"Save As", "Quit". When "Load" or "Save" is selected, a file selection
box appears that allows the user to choose a file. The functions
"New", "Load" and "Quit" check for unsaved changes before removing the
document and pop up a warning message if necessary.
Edit
Besides the commonly known operations "Cut", "Copy", "Paste", "Undo"
and "Delete", Edit provides a "Parse" option which sets up the Parsed
Text Window with the formatted ASCII Text (see above).
The following menu items contain buttons for inserting various HTML
tags into the document. If an area of the text was selected, the
chosen HTML tags wrap the selection up between the starting tag and
the ending tag; otherwise only the starting tag and the ending tag
appear at the cursor position and the cursor is placed right between
them. (For a complete description of HTML tags see On HTML... in the
on-line help of the Mosaic program)
Text
Text provides tags for different text styles like "Bold", "Italics",
etc. The title of the document may be entered using "Title". "Special
Chars" pops up a list of special characters that can be inserted in
the ASCII text.
- 2 - relax (5/94)
relax(1) relax(1)
Headlines
All six Mosaic header levels ("H1", "H2", .., "H6") are found in this
menu. "H1" represents the biggest header, "H6" the smallest header.
Block
Functions under Block mainly deal with larger sections of the text.
Some examples are "Paragraph", "Blockquote", "Listing", etc. The
"Paragraph" tag is needed to indicate the end of any paragraph in the
document, since line breaks, multiple spaces and indentations are
ignored by HTML browsers (except the text is a "Listing" or is
"Preformatted"). A "Horizontal Ruler" is used to separate different
parts of the document.
Lists
Here the user may choose to fill in an "Unnumbered", "Numbered" or
"Descriptive" list form. The "Add <LI>" and "Add <DT>" buttons allow
the addition of further list items to an already existing list.
Links
"Set Name" and "Link To Name" are used to create a name and to make a
reference to a name in the same document. References to other
documents and to images can be set by executing "Link To File" and
"Link To Image" respectively. These functions pop up a dialog window
where frequently accessed anchors (or images) may be added to or
deleted from history lists that are read in when the editor is
started. As selected in the dialog window images are aligned to the
bottom or to the top of the line on which they appear.
FILES
relax relax executable
Relax application defaults file; this file
should be moved to /usr/lib/X11/app-
defaults/Relax or $HOME/Relax
$HOME/.relax_image_hist history file for images (created on
first execution)
$HOME/.relax_link_hist history file for links (created on first
execution)
relax.1 manual page to be put in the appropriate
place, e.g. /usr/man/man1/relax.1
relax.c main source file
relax_procs_file.c functions of the File menu
relax_procs_edit.c functions of the Edit menu
- 3 - relax (5/94)
relax(1) relax(1)
relax_procs_tags.c functions of the Text, Headlines and
Block menu
relax_procs_link.c functions of the Link menu
relax_global-defines.h defines for all source files
relax_menu-specs.h menu specifications
relax_widget-stuff.h Motif 1.2 include files
BUGS
When starting relax the following warning message is printed:
Warning: Actions not found: process-return, delete-previous-character,
...
Probably this message is caused by translations that are bound to the
"Scrolled Text Widget" but are not accepted by one of its parents.
Simple as the solution might be we have not yet found a way to fix the
problem. However, this does not trouble the performance or stability
of the program at all.
Some very strange behaviour appears while running relax under the
Motif Window Manager mwm. Choosing any button from the menu bar
results in the ASCII Text Field losing its input focus so that it
becomes impossible to enter any more text. In that case, just select
another menu item (without activating a function) and you will get
your keyboard focus back.
NOTES
relax is partly based on the NCSA Mosaic software. NCSA Mosaic
software, both binary and source (hereafter, Software) is copyrighted
by The Board of Trustees of the University of Illinois (UI), and
ownership remains with the UI.
The editor relax uses the 'htmlWidgetClass' and the 'HTMLSetText'
procedure of the 'HTML.h' include file for parsing the edited text
into a Mosaic formatted style. Moreover, 'HTMLamp.h' is included for
the special character popup.
Certainly, relax is not the original NCSA Mosaic but uses some of its
Software for such derivative work.
COPYRIGHT
relax is Copyright (C) 1994, Department of Computer Science at the TUM
(Munich University of Technology), Germany.
NCSA Mosaic is Copyright (C) 1993, Board of Trustees of the University
of Illinois.
- 4 - relax (5/94)
relax(1) relax(1)
AUTHORS
Bernhard Blaette blaetteb@informatik.tu-muenchen.de
Michael Tiefenbacher tiefenba@informatik.tu-muenchen.de
SEE ALSO
xmosaic(1)
- 5 - relax (5/94)
