Home | Arachnophilia | Documentation |     Share This Page
Arachnophilia 5.4 Version Notes
Arachnophilia is © Copyright 2015, P. Lutus.

Arachnophilia is CareWare

Introduction | XHTML | Converting to XHTML | Unicode | Additional changes

Introduction
Newer versions of Arachnophilia (5.3 and more recent) represent one of those departure points in the history of this program, points at which it is necessary to make a fresh start. Specifically, the changes in this version are so far-reaching — including a rewrite of most of the macro set and the documentation — that it is necessary to delete the Arachnophilia user directory to realize the full benefit of the changes.

To make this change, please read these instructions and then:

  • Exit Arachnophilia
  • Delete the directory (user home directory)/.Arachnophilia
  • Re-run Arachnophilia

After taking these steps, the user will see a reinstallation of the Arachnophilia user files — that's a sign that the deletion was carried out successfully. By the way, this is the correct approach to dealing with problems that seem insurmountable — to overcome various problems that might come up, simply delete (user home directory)/.Arachnophilia and run Arachnophilia again.

Arachnophilia 5.3 represents a big change, and has many new features. It's been three years since the last major upgrade to this program, plenty of time to collect a list of desired improvements. This page explains what's new.

XHTML
Beginning with Arachnophilia Version 5.3, Arachnophilia has become an XHTML workshop.

A new version of HTML has appeared, named "XHTML," that has so many advantages over HTML that Arachnophilia has been completely reworked to take advantage of it. Elsewhere in these directions, and in Arachnophilia's menus and prompts, the term HTML appears, but remember that this is simply a syntactical convenience — it refers to XHTML.

Earlier Arachnophilia difficulties with beautifying and formatting HTML, and analyzing Web pages for tag errors, have been corrected in this version. In past Arachnophilia versions, certain features had to be dropped because they couldn't coexist with the internal ambiguities and inconsistencies of straight HTML. In the new Arachnophilia version, the best of those features has been restored. Specifically, HTML Beautify now works reliably and HTML Validate — a tool for finding and correcting structural errors, a feature not seen since Arachnophilia 4.0 — is back and works very well.

XHTML is internally consistent in a way that HTML cannot be, and it greatly simplifies the task of Web page design and maintenance. Arachnophilia is now structured around XHTML and it can help you convert your pages from HTML to XHTML.

If your site has HMTL pages and you don't want to convert them, some of Arachnophilia's features aren't going to work for you, in particular the features "HTML Beautify" and "HTML Validate" will likely misbehave. If you do decide to upgrade to XHTML, I offer these comments:

  • In XHTML, there are no tag ambiguituies. A particular tag always appears the same way, there is no latitude about how a tag can be used.
  • All XHTML tags are either paired <like> </this>, or they are single self-closing tags <like this/>. There is but one exception (the DOCTYPE tag at the top of a page).
  • Past versions of Arachnophilia contained some "relaxed" (read: wrong) tag definitions and practices, in particular the absence of closing </li> and </option> tags. These errors have been corrected.
  • Contrary to what the reader may believe, due in part to the relaxed syntax of HTML and in part because of my errors in earlier versions of Arachnophilia, the "img" tag is self-closing: <img src="path" />. So are <input />, <meta /> tags and about a dozen others. And some tags I believed to be orphans are actually supposed to have associated closing tags, for example <li></li> and <option></option>.
  • To conclude this list, I want to restate the basic idea — all XHTML tags fall into two categories:

    • Single, self-closing tags <like this/>.
    • Paired tags <like> </this>.

    There is only one exception — the <!DOCTYPE ... > tag that appears at the beginning of each HTML or XHTML page is an oddball that fails to agree with the strict pattern.

    Remember that this change is in place. If you use the new HTML Beautify or HTML validate and they don't work as you expect, it will be because of page tags that do not meet this strict XHTML syntax.
Converting to XHTML
Because Arachnophilia supports regular expressions and can apply them to many pages at once, it should be relatively easy to convert a set of Web pages from HTML to XHTML by converting tags en masse. This sort of task is better done with a dedicated script applied to an entire Web site at once, but for a few pages, Arachnophilia's automation and macro creation capability should make it relatively easy.

Arachnophilia now uses XHTML conventions throughout, but this doesn't guarantee that your pages will pass XHTML validation. One example error is to put formatting tags outside block elements like this:

  <b>
    <div style="style">
      text content
    </div>
  </b>
            
Arachnophilia will let you do this, and its HTML Validator won't complain (because the tags are properly nested), but the page will fail online XHTML validation. The right format is:

  <div style="style">
    <b>
      text content
    </b>
  </div> 
            
Another common error is to lay out tags in what seems like a logical way but is wrong:

<i><b>my text</i></b>
            
The correct form:

<i><b>my text</b></i>
            
Arachnophilia's HTML Validator will catch this class of error and help you fix them, because it checks for proper tag sequencing.

Unicode
Unicode Support
Beginning with Arachnophilia Version 5.4, Unicode is supported by way of the UTF8 character set. File loading and saving, and clipboard operations, support UTF8 characters and files. These features are more fully descibed under "Advanced Features".
Additional changes
Jump to Opposite Tag
There is a new feature in recent versions of Arachnophilia, one added by popular demand. You can now jump from one HTML tag to its partner with a keystroke (Alt-J, menu item "HTML ... Jump to Opposite Tag"). If the tag is at the far end of a large document, this feature will take you there. If the partner tag is is only a few characters away in the same line, this feature will place the editing cursor to the immediate left of the partner tag. If you press Alt-J repeatedly, the editing cursor jumps back and forth between the partners.

This feature is useful for sorting out syntax issues that don't necessarily produce an error message in HMTL Beautify or HTML Validate, or for understanding the structure of a document by browsing through its hierarchy of tags.

Display Enhancements / Antialiasing
Arachnophilia's display routines have been recoded to use antialiasing, a font smoothing technique. On most systems, this change greatly improves the appearance of the editing windows and some other diplays.

But on some systems, this font smoothing feature may not work as planned. If the antialiasing feature causes problems on your system, you can turn it off. Simply click menu item "Text ... AntiAliasing on/off".

HTML Beautify, HTML Validate
HTML Validate is a new feature (there was an earlier form of this feature in Arachnophilia 4.0) that interactively displays and helps correct page syntax errors. Like all new Arachnophilia features, this one strictly follows XHTML syntax rules. A dialog appears that lets you click specific error messages, and the program responds by jumping back and forth between tag locations that don't match up.

HTML Beautify is more polite than in past versions. Apart from following XHTML rules in its behavior, it doesn't try to force each tag onto a separate line as in earlier versions, something that turned out to be a mistake. The new version produces a clean, readable listing that doesn't change the displayed appearance of the pages it beautifies. If you want a more readable listing and you have multiple tags per line in your pages, you can separate the tags manually to suit your requirements.

Both HTML Beautify and HTML Validate function best when the processed documents contain valid XHTML tag syntax.

XHTML Issues
Arachnophilia's internal routines have been reworked to properly take XHTML rules into account, including the provision of a closing </li> tag, a longstanding error.

I created a new addition to Arachnophilia after trying to validate my pages using an online XHTML validator. It turns out that (a) contrary to what I wrongly beieved, there's a closing </li> tag, (b) the location of this closing tag is deterministic — there is zero latitude about its placement, and (c) determining that location by eye surpasses the puny skills of mere mortals.

I responded to this need by writing a new feature that begins by stripping all the </li> tags out of the document and then proceeds to locate all of them correctly. It is quite reliable and avoids a lot of frustration. The new function is named "[ReplaceLiTags]" and it is available in the "HTML ... More Functions" menu. It was only after writing the first version of this routine that I was able to partially automate the conversion of my pages from (my rather sloppy) HTML to XHTML.

I must add (and if I don't, one of my readers will give me the business) that a tag whose placement is completely deterministic serves no purpose. The opening <li> tag identifies a line that is to be bulleted one way or another, and its closing partner must exist. As I said, there is no latitude about the closing tag's placement. The proof of this is I can automate the placement of the closing tag, no matter how large or complex the document, and if there is a difference between the algorithm's tag placement and that of a human, this can only mean the human made a mistake.

If the user encounters a syntax error while using HTML Validate that involves <li> ...</li> tags, "[ReplaceLiTags]" should be the first applied remedy.

File Change Tracking
Arachnophilia now tracks changes to each open document's disk file, and if the disk file is changed by another program while editing is underway, once Arachnophilia has the user's attention (technically, "focus") again, it will alert the user and provide a list of choices.

Display Issues
The display, somewhat annoying, still has two distinct modes (syntax coloring without line wrap, and line wrap without syntax coloring). The display is unchanged except that it looks better because of antialiasing. This dual personality may change in the future, but for it to change, I realized I would have to throw out the entire code base and start over, something I am not inclined to do at this time.

Other Changes
A CSS file type has been added, because of the increasing importance of Cascading Style Sheets in page design. Both the syntax coloring and code beautification features work with this new file type.

Some internal configuration files are now gone. In particular, a set of configuration files responsible for listing tag variants and exceptions is gone, because there are no such things in XHTML.

I have corrected a raft of small but annoying bugs that I've been tracking over the past few years, too numerous to list here.

I hope you enjoy this new version of Arachnophilia!
 

Home | Arachnophilia | Documentation |     Share This Page