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)