HTMList
Introduction
HTMList is a 2.x-only Newton "autopart" which appears in Extras Extensions.
It is a simple HTML "authoring" tool that can save
- formatted text in Notes, NewtWorks or books as HTML
- formatted text/graphics in books as a formatted NewtWorks document
- Notes Outlines or Checklists as HTML,
or as Newt's Cape bookmarks -- this last feature is the source of the original name HTMList.
- adds "text routing" commands to books, e.g., Mail, Beam, Speak --
formerly this was separate RouteBook plugin, which should now be removed.
For a description of these commands and how they're accessed,
see the former RouteBook documentation.
HTMList is demoware and cannot be redistributed without my permission.
© 1997-2005. S. Weyer. All Rights Reserved Worldwide.
Download
Command Summary
- Notes
- Save as HTML (to Notes)
- Newt's Cape:Add Bookmarks (2.x)
- NewtWorks
- Save as HTML (2.1) (to NewtWorks)
- Newt's Cape:Add Bookmarks [2.1]
- books
- Page Range
- Save (formatted text/graphics) to NewtWorks (2.1)
- Save as HTML to NewtWorks (2.1)
- Save as HTML to Notes
- Save as HTML to Desktop
- Mail,Speak,... [2.1]
- Inbox
- Newt's Cape:Add Bookmarks [2.x]
HTMList 1.0k-2 (23 Jan 00)
- 2.x: Inbox:Newt's Cape:Add Bookmarks now works with Text Stationery (for SimpleMail 4.x)
- (docs still need updating to include RouteBook)
1.0j-2 (13 Jan 99)
- to be on the safe side, HTMList closes any apps that it patches: Notes, Inbox, book reader
- 2.x: RouteBook functionality included; remove RouteBook plugin if installed -- otherwise, it will interfere.
- Page Range item indicates the current setting (default: Current).
if you change it, it is saved and applied to all subsequent commands (Save, Speak, etc.)
- Current
- show current page number
- All
- show range of current book -- this uses all pages in later (shorter or longer) books.
Be very careful about selecting All (I have included it by popular request but with misgivings).
If you have a large book, HTMList will create a large 'virtual string' -- this can take awhile,
and could possibly crash due to Newton memory bugs
- Range
- set a specific range; this may use fewer pages in later shorter books
1.0i-2 (8 Jan 99)
- 2.x: Add Bookmarks works for highlighted selections in NewtWorks, Inbox, regular Notes;
you can add just a full URL, e.g., http://... or <http://...>someTitle
multiple items can be separated by return
1.0h-2 (26 Sep 98)
- 2.x: another fix for NewtWorks docs
1.0g-2 (25 Sep 98)
- Save as HTML to Notes added
(due to system size limits, not practical for saving/editing large page ranges)
- 2.x: fixed so that HTML docs saved to Newtworks can be recognized by Newt's Cape
1.0f-2 (11 Sep 98)
- saving HTML from page ranges in 2.x temporary books now works, and includes BASE (if known)
- bold paragraphs in Notes and NewtWorks saved as HTML H1 tags
1.0e-2 (10 Sep 98)
- book Save commands prompt for page range[2.x] or Entire Book/Current Page[1.x];
first page in page range defaults to 1 for regular books,
to current page number for help books
(since there's no other indication of help page #; change to 1 for entire help book);
- Save as HTML commands automatically quote &, <, >
- Save as HTML to Desktop can also use a Sloup connection
1.0d,-2 (28 Aug 98)
- 2.x: Newt's Cape:Add Bookmarks adds bookmarks invisibly (doesn't open Newt's Cape)
- renamed some commands (see summary above)
- new book action commands: (2.x) Save to NewtWorks,
(2.x) Save as HTML to NewtWorks, Save as HTML to Desktop
(which replaces Newt's Cape command:
File:Save as Text to Desktop, and uses HTML subset rather than pseudo-tags,
and outputs via Newt's Cape connection, or NTK Inspector)
1.0c-2 (24 Jun 98)
- changed to Newt's Cape:Add Bookmarks
- fixed bug where heading followed by a colon, but nothing else
- regular Note paragraphs exported with minimal formatting, e.g., B, I
- Newtworks documents exported similar to Notes; "paragraph" defined by a return(newline);
also includes ruler alignment (left,right,center justification)
1.0b-2 (17 Jan 98): added "Add Newt's Cape Bookmarks"
1.0a-2 (4 Oct 97): initial release
The remainder of this document currently describes only the original list features
and needs a major update! (including incorporating RouteBook functionality).
- open Notes
- create a New:Outline or :Checklist (or select an existing one)
- add/move/remove list items and levels
- select in Notes action menu, and view result:
- Export to HTML
- email/beam HTML source (new Note) to a friend, or
view it with Newt's Cape (Newt's Cape:Open in Notes action menu)
(or other web browser that can access Notes documents)
- Newt's Cape:Add Bookmarks
- tap Newt's Cape's Bookmarks button. note: you can use Newt's Cape's Bookmarks:Save as Outline
command to export current bookmarks as a Notes outline.
HTMList generally creates groups of unordered list items, i.e., UL,
which usually are rendered as bulleted items in most browsers.
But depending on content conventions, you can also create
ordered or definition lists, with URLs.
Examples below are also available separately
in Sloup.
This Notes example (bulleted items):
would generate the following HTML source
(HTMList uses the title of the Note as TITLE in HTML source):
<HTML><HEAD>
<TITLE>UL test<TITLE>
<META NAME="ISBN" CONTENT="UL_test.htm">
</HEAD><BODY>
<UL>
<LI>a
<UL>
<LI>b
<LI>c
<UL>
<LI>d
</UL>
</UL>
<LI>e
</UL>
</BODY></HTML>
which would appear in a browser as...
Patterns
There are some special patterns that HTMList recognizes to create other kinds of list items:
- nn. (initial number)
- when an initial digit followed by period occurs in the first item in a group,
HTMList uses OL instead of UL;
it also strips the number and . from this and subsequent items
(most browsers will automatically add consecutive number prefixes).
In particular, you need to add a
number only to the first item (or any items that contain a period). example
- label:value
- when a colon occurs in the first item in a group, HTMList uses DL instead of UL;
it will put the label after DT; and value after DD (instead of LI). Any subsequent item without a :
appears entirely after DT. example
- <url>label
- HTMList surrounds the url with HREF; if there is no label, the url is used.
This can be used in combination with the two earlier patterns;
it could be handy for organizing/annotating your own bookmarks. example
This Notes example (items prefixed with nn.):
would generate the following HTML fragment...
<OL>
<LI>one
<OL>
<LI>a
<LI>b
</OL>
<LI>two
</OL>
which would appear in a browser as...
- one
- a
- b
- two
This Notes example (term and definition separated by :):
would generate the following HTML fragment...
<DL>
<DT>one
<DD>uno
<DT>two
<DD>dos
</DL>
which would appear in a browser as...
- one
- uno
- two
- dos
And finally, this Note example combines several things, along with URLs (surrounded by <...>):
- important pages (as bullets) with labels
- <http://communicrossings.com/html/newton/index.htm>Steve's Newton page
- <http://www.apple.com/>Apple Product Info?
- some pages (numbered) with urls displayed
- 1. <http://www.foo.com/>
- <http://bar.com/>
- some pages (as "definitions" (comments?))
- this is a really great page: <http://www.foo.com/>foo's page
- a so-so page:<http://bar.com/>
- <http://www.zzz.com/>
would generate the following HTML fragment...
<UL>
<LI>important pages (as bullets) with labels
<UL>
<LI><A HREF="http://communicrossings.com/html/newton/index.htm">Steve's Newton page</A>
<LI><A HREF="http://www.apple.com/">Apple Product Info?</A>
</UL>
<LI>some pages (numbered) with urls displayed
<OL>
<LI><A HREF="http://www.foo.com/">http://www.foo.com/</A>
<LI><A HREF="http://bar.com/">http://bar.com/</A>
</OL>
<LI>some pages (as "definitions" (comments?))
<DL>
<DT>this is a really great page
<DD><A HREF="http://www.foo.com/">foo's page</A>
<DT>a so-so page
<DD><A HREF="http://bar.com/">http://bar.com/</A>
<DT><A HREF="http://www.zzz.com/">http://www.zzz.com/</A>
</DL>
</UL>
which would appear in a browser as...