Copyright 1996, 1997 by Johan Linde
<jl@theophys.kth.se>
September 1997
HTML mode is for editing HyperText Markup Language documents (suffix .html, .htm or .shtml). Whenever you open or save a file with a name with any of these suffixes, Alpha switches to HTML mode and inserts the HTML mode menus in the menu bar. You can also manually switch to HTML mode with the popup mode menu in the status bar, see the picture to the right. Alpha has many different modes giving you different features depending on which type of document you are editing. When you edit HTML documents, make sure you are using HTML mode.
The basic idea with this HTML environment is to save you time while typing, by providing powerful tools for editing HTML code. HTML mode does not teach you HTML. Therefore you have to know at least some HTML to use it. You don't have to be an expert and know every single tag and every single arribute, but a knowledge of the basics is required to be able to use HTML mode.
If you do not know about HTML, I recommend that you read A Beginner's Guide to HTML. It is a good first text to read. I have collected some other links to HTML guides. See the section on HTML Tutorials and references.
This manual is only a manual for Alpha's HTML, JavaScript, and CSS modes. It does not descibe any of the many other modes Alpha has, and not any of Alpha's many other features. They are documented elsewhere. You can open many different help files under the system help menu. If you haven't used Alpha at all before I recommend that you at least read the Quick Start before reading this manual.
In HTML mode there are support for editing of both JavaScript and Cascading Style Sheets (CSS) within HTML documents. There are also a separate JavaScript mode for editing JavaScript documents (suffix .js) and a CSS mode for editing CSS documents (suffix .css).
Note that within HTML mode the support for JavaScript and CSS is not fully enabled by default. This is because it's more convenient to have a few things disabled if you are not using JavaScript or CSS. Read the corresponding sections of this manual to see what to do to get full JavaScript and CSS support.
First of all, I would like to thank Pete Keleher for writing Alpha, the best editor in the world, without which my TCL code would be pretty useless. I am also indebted to Scott Brim who wrote an earlier version of Alpha's HTML mode. Some original ideas and tcl code were taken from html.el for GNU Emacs and latex.tcl for Alpha. François Pottier gave me lots of help with the code which makes Alpha talk to Big Brother. The algorithm for extracting the width and height of JPEG images were written by Alex Knowles and Andrew Tong. Many thanks to Michael O'Henly for making the wonderful Alpha HTML mode intro site. He has also sent me a list with corrections of the language in an earlier version of this manual. (Don't blame him for the new errors in this version!) And thanks to everybody who has sent me suggestions and bug reports. You know who you are.
All comments on HTML mode are welcome. Many features in HTML mode were suggested by HTML mode users. Don't hesitate to send me your ideas. Please tell me if you find a bug which annoys you. If you tell me about it I'll do my best to fix it. If you don't tell me about it I may not discover it myself.
I have a page with information about HTML mode where you can download new versions before they are included in the general Alpha distribution.
If you want to be notified about new releases of HTML mode, including beta releases, send me a mail and I'll put you on my mailing list.
Johan Linde jl@theophys.kth.se
All Tcl code I've written for Alpha is free. This means that it may be used freely, and distributed freely, as long as the receiver is not obligated in any way by receiving it. Don't do silly things like charging for it! The files I've written are html.tcl, html32.tcl, htmlCustom.tcl, htmlElems.tcl, htmlEngine.tcl, htmlExtensions.tcl, htmlHomePageUtils.tcl, htmlMenu.tcl, htmlMode.tcl, htmlStatusBar.tcl, htmlUtils.tcl, cssMode.tcl, hctsmsl.tcl, hctsmslMenu.tcl, hctsmslShared.tcl, javaScriptMode.tcl, frontierMenu.tcl and the corresponding documentation.
However, Alpha itself is not free. It's shareware.
Writing HTML mode has taken a considerable amount of time. Therefore, if you like HTML mode and use it a lot, I would very much appreciate if you send me a colorful postcard and tell me that. It would give me new energy to add new features to HTML mode. Note that emails don't count as postcards. Emails are not pretty enough to put on the wall. My address is
Johan Linde
Lojovägen 61
SE-181 47 LIDINGÖ
SWEDEN
My mother tongue is Swedish. Therefore you will, no doubt, find grammatical and other errors in this manual and in HTML mode.
But before you complain, I must tell you that I know that "color" is spelt "colour". :-)
To give you a true feeling of reading an Alpha document, the color of the links in this manual is the same as the color of Alpha's hypertext links.
You can choose between two versions of this manual, one which uses frames (for those of you with large monitors), and one which doesn't use frames. At the bottom of every page there are three buttons to help you navigate,
They are mainly intended to be used if you don't use frames. However, if you use frames the button 'Table of Contents' will let you leave the frames.
Now continue to