\begindata{text,1059324}
\textdsversion{12}
\template{help}
\define{description
menu:[Region~4,Description~11]
attr:[LeftMargin LeftMargin Cm 187268]
attr:[Indent LeftMargin Cm -187269]
attr:[Tabs TabClear Point 36]
attr:[Tabs TabClear Point 72]
attr:[Tabs LeftAligned Point 81]
attr:[Flags KeepPriorNL Int Set]
attr:[Flags KeepNextNL Int Set]}
\chapter{HTMLView, version 1.2

}
\section{What htmlview is

}\leftindent{
This is an ATK object which allows you to create and edit HTML in a WYSIWYG 
fashion. It supports all HTML entities, and you can cut and paste HTML into 
and out of the window (although see the section "Warnings").  This is 
purely an editing/viewing object: it does not support following links.  It 
does support almost everything else in plain HTML, including inline images. 
 By default, the view is configured to look remarkably similar to that 
produced by NCSA Mosaic.

}
\section{Starting htmlview

}\leftindent{
Edit a file with the extension ".html". For example

\programexample{ez home.html}

If this does not work correctly, it is most probable that the html 
extension is not being recognised. The following line is needed in the 
ezinit file:

\programexample{addfiletype .html html


}When a new document is read in, the document will be scanned for errors in 
the HTML.  If any are found, they will be displayed in the 
\italic{HTML-Errors} buffer, with approximate line numbers attached to each 
error message.\programexample{

}}
\section{Warnings

}\leftindent{
See the doc/TODO.html document, which comes with the source for this 
package, for known problems and current development paths. Also, the 
ChangeLog, included in this distribution, shows any recent changes and 
bugfixes.

}
\section{Pop-up menu meanings

}\leftindent{
All logical markup is provided in the Styles menu.  From the Font menu you 
can find physical effects (such as bold and italic).  From the HTML menu 
you can find special commands relating to the document (e.g. for creating 
hyperlinks, inserting images, setting the document title) and in the Lists 
menu, you can find the various types of list. \


}
\section{Using htmlview

}\leftindent{
The easiest way to use the html editor is to just type your text in and 
then apply logical markup to the document after you have typed the text. 
 Lists are created in a special manner:

\quotation{The method of annotating a section of text to be a list is to 
select a region and then to request a specific list to be placed over that 
region. Each line in the selection will be made into an appropriate list 
item, and the correct list environment wrapped around the whole. When no 
selection is present and a list environment is requested, the current line 
is made into a list. If the current line is located within or immediately 
adjacent to a list environment of the same type, it is merged with that 
list. This allows you to incrementally add items to lists, and by using the 
selection method it allows sub-lists to be created. \



}If you want to change something after you've added it in (e.g. you've 
placed a hypertext link into your document and you want to change it's 
destination, "href"), then you should use the "Edit attributes at point" 
option from the HTML menu.  This will provide you with a dialog box for 
editing all the variables/attributes attached to the current environment. 
 If you are in a section of text which has multiple nested styles, then you 
can flick between the different styles by using the "Next environment" 
button  (Note that you can always find out quickly what styles are in 
effect at a particular point by using the Meta-S key, which will display in 
the message line the current stack of styles).  To delete an attribute, 
select it from the list and give it a value of "" (i.e. type two double 
quotes with no content).  This will delete the attribute.


It is possible to change the manner in which HTML styles are displayed, by 
editing the HTML template.  See the help on \helptopic{lookz} and on 
\helptopic{templates}. The template defining how the HTML appears is found 
in the file "html.tpl".


}\section{Preferences

}\leftindent{
\description{\bold{defaultImage}:	This is a pathname of an image to use 
when no data can be found for an inline image.  This really, really, really 
should be a correct, readable GIF image.  If not, bizarre effects may 
occur.


}\description{\bold{webPath}:	This is a comma-seperated list of pathnames 
which should be used as prefixes when looking for an inline image which is 
specified absolutely.  For example, at City University CS dept, all the web 
documents and images are kept in the directory /vol/web/root.  This is 
hidden by the HTTP server and so the user never sees this path.  To get the 
editor to work correctly, we set the webPath to have the value 
"/vol/web/root".


\bold{TitleFont}:	The font to use for the document title.


\bold{TitleSize}:	The point size of the font being used to display the 
document title.}

}
\section{Program Author}

\leftindent{
Nick Williams, <njw@cs.city.ac.uk>

}
\section{Recent changes to htmlview

}\leftindent{
See the ChangeLog file, distributed with the source, and also available by 
looking at http://web.cs.city.ac.uk/homes/njw/htmltext/htmltext.html which 
describes the package in general.

The current version of the htmltext package is 1.5

}
\section{Related tools}  \



\leftindent{\helptopic{image}

\helptopic{initfiles}

\helptopic{lookz}

\helptopic{templates}


}\enddata{text,1059324}