# HTML Tidy Eclipse Plug-in

HTML Tidy Eclipse plug-in provides two very useful tasks of HTML Tidy: Formatting and Checking (X)HTML or XML code. It doesn't provide any editor and can be used while editing in your favorite HTML/XML editor for Eclipse.

To install HTML Tidy plug-in in Eclipse, download the zip file and follow the notes attached to it.

Bugs and Feature Requests can be reported at eclipsetidy SourceForge project page . Please, eclipsetidy site should only be used for issues related to the integration of HTML Tidy in Eclipse. Feature Requests like "JSP support" or Bugs like "Tidy doesn't work with this file" should be published at JTidy SourceForge project page.

This plug-in has been developed by Pierre Baumard (France).

## What's new

### eclipsetidy 1.2.1

- Bug "format is looped endlessly" fixed
- Complete migration to eclipse 3.0
- Small improvements of warning/error marker messages

### eclipsetidy 1.2.0

- Migration to eclipse 3.0, this plug-in doesn't work with eclipse 2.1.
- Markers added to files are now of type "HTML Tidy" derived from Problem Markers, they can be filtered in the Problems View. ATTENTION: if an older version of Eclipse Tidy plug-in was installed and markers were persistent, the "older" markers are not recognized by the new plug-in, you have to remove these markers on files, folders or project that have been checked with an older version of the plug-in. It can be performed with the action "HTML Tidy > Remove All Problem Markers" in the popup menu of the Package Explorer.
- Automatic Checking
- Tidy Preferences can be configured for each project separately through Project properties.
- Follows eclipse UI Guidelines:
  - Pop-up menus are now only shown on files with extensions asp & php, or extensions ending with htm, html or xml.
  - Accessibility with keyboards mnemonics.
- Bug fixed: tidy error/warning on line > 999 is shown with a marker
- Refactoring to follow Eclipse coding guidelines and improve code quality with Checklipse, Metrics and PMD.

### eclipsetidy 1.1.1

- The error file can be a non existing file in Preferences

### eclipsetidy 1.1.0

- Error File bug fixed.
- It does not automatically save the changes after Format if the file is opened in an editor (see "Open before Format or Check" option)
- Folders and projects can be selected, only the files matching a pattern are formatted or checked (see "File Filter" option)
- The Workbench Menu actions and the key bindings work on a selection in the Package explorer
- Tool bar actions
- Progress dialog and canceling on the Package Explorer action
- Other small UI improvements

### eclipsetidy 1.0.0

- First release of the completely new Eclipse Tidy plug-in based on the java version of HTML Tidy (JTidy).

## HTML Tidy Introduction

With Dave Ragget's authorization, the following introduction is derived from http://www.w3.org/People/Raggett/tidy (The original document is Copyright © 1994-2003 W3C ® (MIT, ERCIM , Keio), All Rights Reserved. W3C liability, trademark and document use rules apply.)

When editing HTML it's easy to make mistakes. Wouldn't it be nice if there was a simple way to fix these mistakes automatically and tidy up sloppy editing into nicely layed out markup? Well now there is! Dave Raggett's HTML TIDY is a free utility for doing just that. It also works great on the atrociously hard to read markup generated by specialized HTML editors and conversion tools, and can help you identify where you need to pay further attention on making your pages more accessible to people with disabilities.

Tidy is able to fix up a wide range of problems and to bring to your attention things that you need to work on yourself. Each item found is listed with the line number and column so that you can see where the problem lies in your markup. Tidy won't generate a cleaned up version when there are problems that it can't be sure of how to handle. These are logged as "errors" rather than "warnings".

Dave Raggett has now passed the baton for maintaining Tidy to a group of volunteers working together as part of the open source community at Source Forge. The source code continues to be available under an open source license, and you are encouraged to pass on bug reports and enhancement requests at http://tidy.sourceforge.net .

Tidy can now perform wonders on HTML saved from Microsoft Word 2000! Word bulks out HTML files with stuff for round-tripping presentation between HTML and Word. If you are more concerned about using HTML on the Web, check out Tidy's" Word-2000" config option! Of course Tidy does a good job on Word'97 files as well!

Tidy features as tool of the month on Unix Review by Joe Brockmeier, who writes:

> "One thing I love about the UNIX philosophy is the idea that each program should do one job and do it really well. There are zillions of small tools for UNIX-type OSes that make life much easier and are hugely useful, but they don't necessarily get written about. They certainly don't receive the same kind of coverage that Apache and Sendmail receive. One of my favorites, HTML Tidy, is a tool for HTML/Web development that I think will interest a lot of folks. HTML Tidy cleans up HTML produced by WYSIWYG editors and such."

You can also read a longer introduction to HTML Tidy features.

## Copyright

HTML Tidy Eclipse plug-in is provided under the Common Public License - v 1.0 .

It is derived from:

Java HTML Tidy - JTidy
HTML parser and pretty printer

  Copyright © 1998-2000 World Wide Web Consortium (Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, Keio University). All Rights Reserved.

  JTidy License
  W3C ® Software License

## Acknowledgements

This plug-in owes its existence to the following people:

- Dave Raggett for developing the original HTML Tidy,

- Berthold Daum for conceiving the Overlay Pages,

- and the development team of HTML Tidy and JTidy