Short: Entity-Codes, Alternatives, Color-Codes Author: honma@thepentagon.com (Tamio Patrick Honma) Uploader: honma@thepentagon.com (Tamio Patrick Honma) Version: 1.8.2 Type: util/conv Replaces: util/conv/Raw2Ent* This program is usefull for HTML-Develpers and can also be used for Internet-, Compuserve-, FIDO-, ZCONNECT-Newsgroups and eMails. It supports the ability to convert 8Bit-characters into 7Bit-characters and reverse with the help of character-entity-codes or -names or alternative characters. Additionaly it can convert HTML 3.2- and Netscape-color-names into color-codes and reverse. This program is written in 100% assembly language for the Motorola MC68000. It runs on every AmigaOS 2.0 and higher. It may run under pOS - please report! A GUI is not implemented at this moment, but an ARrexx-Script adds this program into Cygnus ED's Interface. Files: Raw2Ent 1.8.2 (22.01.97) Raw2Ent.ced 1.01 (26.12.96) Raw2Ent.doc english documentation Raw2Ent.dok german documentation Raw2Ent.rexx 1.4.1 (14.07.96) Raw2Ent.rexx.old 1.3.4 (01.11.96) Raw2EntCheck 1.0 (12.12.96) Raw2EntHTMLColors.iff HTML 3.2-Color-Names, -Codes and -Colors Raw2EntLogic.asc logical-structure documentation Raw2EntMeta.asc meta-structure documentation Raw2EntTables.doc code-tables documentation WHAT'S NEW SINCE LAST RELEASE? List-Modes added to Raw2Ent and Color-Code-Picture included into package. NOTE: Since version 1.8: HTML 3.2 and Netscape Color-Code and Color-Name convertion included! NOTE: Since version 1.7: "Cygnus ED"-Support included NOTE: Since version 1.6.3: The NOBACKUP-Feature will switch off the new backup-feature. Now the destination- and source-file may have the same names! NOTE: Since version 1.5 you can use Raw2Ent as an Ent2Raw! NOTE: Since version 1.3 you can use Raw2Ent as a "Raw2Uml", which means that the destination file will contain readable characters, words or shortcuts. (i.e.: "ü" -> "ue", "£" -> "pound", "©" -> "(C)", etc.) FAST INTRODUCTION: (see below for a larger introduction) Raw2Ent can convert 8Bit-ASCII (ISO-8859-1 [Amiga]) -> 7Bit-ASCII with Character-Entity-Codes example: "Hallöchen" -> "Hallöchen" 7Bit-ASCII with Entity-Codes -> 8Bit-ASCII (ISO-8859-1 [Amiga]) example: Hallöchen -> Hallöchen 8Bit-ASCII (ISO-8859-1 [Amiga]) -> 7Bit-ASCII with alternative characters example: "Hallöchen" -> "Halloechen" HTML32- or NETSCAPE-COLOR-NAMES -> HTML-Color-Codes example: BGCOLOR="Red" -> BGCOLOR="#FF0000" HTML-Color-Codes -> HTML32- or NETSCAPE-COLOR-NAMES example: BGCOLOR="#FF0000" -> BGCOLOR="Red" INTRODUCTION Raw2Ent converts raw 8-Bit-ASCII-Text into 7-Bit-ASCII-Text with entity-codes and reverse. The ASCII-Format is a standardized format for information interchange, but it is only standardized seven-bit-wide, which means that 128 codes are defined. One Byte consists of eight bits and can represent 256 different bit combinations. Therefore the last 128 bit combinations are defined for free use by any operation-system. The problem is that accent-characters and other special characters are not standardized, because they are defined in (guess where?! ;) ) the free part of ASCII by the operation system developers. The goal of the Wold Wide Web developers was that it could be used on every important operation system. So it was clear that the ASCII-Based HTML-Source-Code had to use the standardized seven-bit area of the ASCII-Code. To represent accent-characters or other special characters in a seven-bit-code, it was neccesary to invent something. And this was the entity-code - a kind of escape-code. An entity-code consists of an introducing "&" and a ";" at the end. Between these symbols is a character-name the browser can interpret. It is a very hard and stupid work to convert the ASCII-Text by hand. So just use Raw2Ent! Raw2Ent produces real 7-Bit-ASCII-Code. All printable Amiga-characters in the 8-bit-area will be converted into entity-codes, without any exception. The use of names instead of code-numbers will make the entity-codes easier to be read by humans. If no name was defined in the HTML 3.2 reference, the code-number will be used. You can use Raw2Ent also to check, wether your file contains pure seven-bit codes or not. If not, Raw2Ent will present you the position of the 8-Bit-Characters in the text. Raw2Ent can also handle color-codes and -names. SEND COMMENTS TO: Tamio Patrick Honma eMail: honma@thepentagon.com WWW: http://www.netforward.com/thepentagon/?honma *>> Love all over the world! <<* ============================= Archive contents ============================= Original Packed Ratio Date Time Name -------- ------- ----- --------- -------- ------------- 9884 5036 49.0% 22-Jan-97 02:07:58 Raw2Ent 21607 7730 64.2% 22-Jan-97 02:43:18 Raw2Ent.doc 23672 8636 63.5% 22-Jan-97 02:50:58 Raw2Ent.dok 1131 580 48.7% 17-Nov-96 23:07:06 Raw2Ent.rexx 5120 1482 71.0% 17-Nov-96 23:07:06 Raw2Ent.rexx.old 465 287 38.2% 12-Dec-96 13:11:32 Raw2EntCheck 14604 2587 82.2% 27-Dec-96 03:24:00 Raw2EntHTMLColors.iff 1489 322 78.3% 26-Dec-96 16:28:44 Raw2EntLogic.asc 1227 255 79.2% 13-Dec-96 00:07:34 Raw2EntMeta.asc 4866 2201 54.7% 27-Dec-96 14:21:32 Raw2EntTables.doc -------- ------- ----- --------- -------- 84065 29116 65.3% 01-Feb-97 23:12:54 10 files