Jacob Matthan <findians -at- NETPPL -dot- FI>
Wed, 19 Jun 1996 22:29:40 +0300
Due to number of you who mailed me for more details about the simplest way
to do HTML MarkUp here is an edited version of the documentation which
comes with this $20 powerful shareware product. I have nothing
whatsoever to do with the author but I can vouch that it does all that it
is claimed as simply as it is claimed. Hundred files converted in
seconds - yes.
Installation - a couple of minutes
First use - without any prior knowledge - a couple of minutes
Advanced use - about 15 minutes
Extremely advanced use - read the very simply written manual.
Problems - not one to date.
(I repeat I have nothing whatsoever to do with the author od the
Editor: Findians Briefings; Kooler talk (Web Version); Seventh Heaven
HTML Markup is a fast, effective, economical, and customizable way to put
existing text documents on the Web. Online help is available for all menu
items and options through Balloon Help. To turn on Balloon Help, select
"Show Balloons" from the help menu and point to the item that you would
like to know more about.
HTML Markup is the easiest and most flexible way to put existing content
on the Web. Users asked for an easy and standard way to pick the colors of
their documents, so color wheels were added. You suggested that
preferences could be saved in sets, so these were added. You wanted more
conversion options. You got 'em. More output options. They're in there.
Better interface. Better documentation. Visual status indicator. It's all
in HTML Markup 2.0.
Installing HTML Markup 2.0
HTML Markup is installed on your hard drive by running the "Install HTML
Markup" program. This program will automatically install a version of HTML
Markup customized for your Mac.
1. Double-click the "Install HTML Markup" program
2. When you see the "splash screen", click "Continue"
3. Read the installation notes and click "OK"
4. Click "Install" to install a version of HTML Markup 2.0 native for
5. When the installer is done, click "Quit" to return to the Finder
HTML Markup 2.0 is now installed and ready to use!
HTML Markup is very easy to get up and running.
1. Launch HTML Markup by double-clicking on the icon
2. Select the conversions that you would like to apply on the "Job
3. Click "Convert File..."
4. Select the text file you would like to convert
5. HTML Markup will convert the file and prompt you for a place to
That's all! Five easy steps.
If you want to get more involved, HTML Markups allows you to do a lot
more. You can select document colors from a color wheel, add your
company's logo as a footer, process hundreds of files in seconds using
Drag-and-Drop, and save your settings for future use.
HTML Markup 2.0 Features
Titles and Headers
Use file name as <TITLE> - Makes the name of each
file the HTML title of the converted file
Convert first line to <TITLE> - Makes the first line
of each file the HTML title of the converted file
Convert first line to <H1> - Changes the first line
of each file into a large bold HTML header item
Center first line - If the above option is selected, this
will center the header item
End all lines with break <BR> - Forces a carriage
return at the end of each line
Convert bulleted/dashed lists <UL> - Makes lines in
your source that begin with a dash or a bullet into items of an HTML list.
Lists can be nested with tabs.
Convert numbered lists <OL> - Makes lines in your
source that begin with a pound sign (#) into items of an HTML numbered
Convert dashed lines/rules <HR> - Makes a sequence of dashes
into a normal line, a sequence of equals signs into a short thick line,
and a sequence of asterisks into an unshaded line
Convert capital lines to headers - Changes lines of your
files that are all capital into HTML headers.
Convert URLs into links <HREF> - Changes addresses
of FTP sites Gopher sites, Telnet sites, and Web pages into clickable
links. The addresses must be in URL format, preceded by http://,
telnet://, gopher://, or ftp://
Keep existing HTML - Leaves any HTML already in your
Show final summary - When HTML Markup is done converting
your files, provides you with a summary of what was converted
Create index.html - HTML Markup creates a file that
contains links to all the files that were converted
Current Set - Popup menu to select which set to use to convert the
Save Current Settings as a Set... - Saves the current settings in
a set in the HTML Markup preferences file. Sets can be used and modified
Remove Current Set - Removes the currently-selected set from the
Rename Current Set - Changes the name of the current set as it
appears in the set popup menu
BGCOLOR, TEXT, LINK, VLINK, ALINK - Selects the color to use for
the web page's background, text, links, visited links, and active links
Background... - Allows you to specify the path of the file to use
as a background pattern on your pages
Comment - Allows you to write a comment line which will be
included in all the files but won't be displayed by the web browser. Good
place for copyright lines.
Select Header File, Select Footer File - Allows you to select a
file to pre-pend and/or post-pend to all the converted files. These files
can/should contain HTML and won't be converted by HTML Markup, just added.
This is an excellent way to add copyright lines, company logos, site
directories, and graphics.
Add date and time - Puts the date and time that the file was
converted at the end of each file
Append credit line - Adds a few lines at the end of the file that
say that the file was converted with HTML Markup, with a link to the HTML
Markup home page
Header style for all caps lines - Selects the size of the headers
that capital lines will be converted to if "Convert capital lines to
headers" is selected on the job ticket. H1 is the largest.
Use Same Name - Saves the converted files with the same name as
the originals. WARNING! The original files will be overwritten!
Add .html - Removes .txt from the end of the original filename (if
it's there as Mac files do not need such endings) and adds .html to the
end of the names
Prompt me - HTML Markup will prompt you for a place to save each
individual file. You may not want to do it this way if you're converting
hundreds of files!
File Creator Code - Selects the creator type of the converted
files. All files will be HTML, but files created with Netscape will open
in Netscape when double-clicked.
Remove Spaces - Gets rid of spaces within the filenames and
capitalizes letters that come after the spaces
Keep Spaces - Leaves the spaces that appear in file names
Convert Spaces to Underscores - Replaces spaces in file names with
the _ character
Convert file names to lower case - Makes the file names all lower
Drag-and-Drop - HTML Markup 2.0 supports Macintosh Drag-and-Drop.
To convert files, you can drag them onto the HTML Markup icon, drag them
into any HTML Markup window (when HTML Markup is the frontmost
application), or open them by selecting the "Convert file" menu item or
clicking on the "Convert file" button on the job ticket.
Guaranteed Memory Estimation -Version 2.0 performs a trial run on
each file, allocating just the right amount of memory so the program won't
waste memory or cause unexpected crashes (do you ever expect a crash?)
Non-Modal and Non-Linear - Unlike other converters, HTML Markup is
non-modal. This means that you can switch to other programs while HTML
Markup is running and you can perform several jobs without launching the
program each time.
Attention to Style - Unlike other converters and many HTML
editors, HTML Markup pays close attention to the style of the output.
Instead of just producing HTML that displays correctly, HTML Markup makes
sure that the HTML source is readable, leaving blank lines and tabs when
Using HTML Markup Sets - an Introduction
Sets are a new feature in HTML Markup 2.0 that allow you to store
different sets of preferences so that they can be used later. There are
many reasons for wanting to do this. Most users find that they are always
selecting the same conversion options for their jobs. Rather than to
select the same ones each time, these options can be saved in a set named
"Default" Each time HTML Markup is launched, it will automatically make
the "Default" set active (Note: If you have more than one set named
Default, the first one will be selected). If two or more people are using
HTML Markup on the same machine to convert files, sets are a great way to
store each user's preferences. Sets deal with all aspects of conversion,
including document colors, conversion options, output options, and just
about everything else. Sets also deal with header and footer files
dynamically. This means that the file is read into memory each time the
set is selected. So if you use your company's address as a footer and the
address changes, all you have to do is change it in the footer file and
the next time the set is selected, it will be updated.
Sets are very powerful because it makes HTML Markup an even faster and
easier program to use. If you convert several different types of files,
you can have a separate set for each type.
There are two versions of HTML Markup 2.0. The shareware version, which
means that you have not paid for it. This version is fully-working and has
most of the features of the registered version. However, for a small fee,
you can pay for this software and receive the registered version.
Scott J. Kleper <klephacks -at- kagi -dot- com> is a 18 year old freshman at Stanford
University programming Macs for about four years. He has been writing
shareware for almost as long. Other programs include MacFolklore, HTML
Markdown, Jot, and PowerSpaceTabsPlus. All are available from his home
page at http://htc.rit.edu/scott.html
For snail mail contact:
Scott J. Kleper
Attn: HTML Markup 2.0
134 Caversham Woods
Pittsford, NY 14534-2834
Post Message: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
Get Commands: LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU with "help" in body.
Unsubscribe: LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU with "signoff TECHWR-L"
Listowner: ejray -at- ionet -dot- net
Search our Technical Writing Archives & Magazine