aH! - Ascii <-> html !
(c)'97-98 Arnaud BERCEGEAY

*****************************************************************
                       ENGLISH VERSION
*****************************************************************

To get an english version of aH!, just copy the file
AH.RSC (the one in the english folder) in the main
directory of aH!. That will overwrite the original RSC
file (which is the french version).

    Enjoy !

*****************************************************************

The whole documentation is in french. So, here is a summary :

aH! What's for ?
^^^^^^^^^^^^^^^^
  The aim of aH! is to help you writing html file if, as me,
  you did them with a simple text editor.
  aH! will convert all ascii code to html equivalent. That's
  very usefull for characters with accents, but, not only...

Accents
^^^^^^^
  aH! can convert ascii code greater than 127 in their html equivalent
  if aH! knows them (in other case, aH! display a warning message).
  For exemple, the character "" will be converted in "&eacirc;".
  aH! can do the job in the other way, too (html to ascii). This is
  usefull to edit html file that are already in html codes, an not
  easy to read in that format.
  
  From version 1.40, aH! could also read file in ISO-8859-1 ASCII,
  and/or convert files to that ISO-8859-1 ASCII.
  
  Ok, for english speaking people, this is not very interesting, but
  this is not the only job aH! can do :

Ponctuation
^^^^^^^^^^^
  Let's talk about ponctuation. In the end of exclamatives sentences,
  there is a '!'.
  Here is an exemple : "Tralalala blablabla blablabla !"
  When this sentence is displayed on a web-browser, you can obtain this :
  +-----------------------------+
  |Tralalala blablabla blablabla| with the '!' on the other line
  |!                            |
  +-----------------------------+
  aH! can replace the space before '!' by a non-breakable
  space : the character "&nbsp;"
  The sentence become "Tralalala blablabla blablabla&nbsp;!"
  With the same browser, the result is :
  +-----------------------------+
  |Tralalala blablabla          | the last "blablabla" and the "!" are
  |blablabla !                  | now considerated as a whole word.
  +-----------------------------+
  ...and the ponctuation could no longer be alone on the other line.
  
End of line
^^^^^^^^^^^
  In the standard atari ascii, end of line are made by two carcacteres :
  CR and LF. Under unix, there's just one. So, if you edit a file typed
  on an Atari computer (or even on PC), on the unix editor, you obtain
  "^M" in each end of line.
  
  aH! can convert all end of lines from the Atari to unix standard.
  Usefull ? So, the file is smaller (lost of a byte per line), it could
  by edited directly on a unix computer, and as much of atari text
  editor could read fine unix end of line, the file could always be
  edited on atari computer.
  
Filename
^^^^^^^^  
  In your html code, you certainly did some links to others file,
  whith <a href="dir/file.gif"> for example. In atari computer,
  you can use '\' in the filename after a folder name.
  aH! can translate this character in the unix standard one : '/'.

Let's go
^^^^^^^^
  You can do the job on just a file, some selected files, or even
  a whole web site.
  To start, put the file to be converted on the application.
  
  The file could be a html file (*.htm, *.html or *.shtml)
  In that case, you can specify if you want aH! to do a recursion on
  others file referenced by that file. This a very simple way to convert
  a whole web site using the home page.
  
  The file could be a qpj file (*.qpj)
  This file is considerated as a list of file. It can be very easily
  generated by qed (it's qed project file). This is an ascii file,
  whith the full name of htm-file on each line, separated by CR + LF.
  Let's have a look at eH! documentation : there's a lot of examples.
  
Other option
^^^^^^^^^^^^
  Make .dup file
  This is a safe way : all original html file are renamed with '.dup'
  as new extension.
  
  Open stdout windows
  If yes, a windows will be opened on the begining of the work,
  and diplayed all Ah! do : the name of the file already converted,
  the file which is converted, maybe some error- or warning- messages.
  
  Create a resultat.txt file
  An ascii text will be created in the main directory of Ah!
  It contain all that should be displayed on the stdout window.

Break !
^^^^^^^
  To interrupt the work, just close the windows which display
   +------------------------+
   +------------------------+
   |      converting        |
   |   d:\dir1\file.html    |
   +------------------------+

What's else ?
^^^^^^^^^^^^^
  aH! is FREEWARE !   USE IT AT YOUR OWN RISK !!!!!
  If you find aH! usefull, think about a missing function you'd like
  aH! to do, or if you didn't use it because it didn't work, please,
  let's me know about that : just e-mail me !
  
Contact me !
^^^^^^^^^^^^
  My name : Arnaud BERCEGEAY
  e-mail  : arnaud.bercegeay@wanadoo.fr
  web     : http://perso.wanadoo.fr/arnaud.bercegeay/

Other stuff
^^^^^^^^^^^
  aH! is a part of a package called "le pacH!"
  Let's have a look at my web site for more details.

-EOF-