/**************************************************************************** * NCSA Mosaic for the X Window System * * Software Development Group * * National Center for Supercomputing Applications * * University of Illinois at Urbana-Champaign * * 605 E. Springfield, Champaign IL 61820 * * mosaic@ncsa.uiuc.edu * * * * Copyright (C) 1993, Board of Trustees of the University of Illinois * * * * NCSA Mosaic software, both binary and source (hereafter, Software) is * * copyrighted by The Board of Trustees of the University of Illinois * * (UI), and ownership remains with the UI. * * * * The UI grants you (hereafter, Licensee) a license to use the Software * * for academic, research and internal business purposes only, without a * * fee. Licensee may distribute the binary and source code (if released) * * to third parties provided that the copyright notice and this statement * * appears on all copies and that no charge is associated with such * * copies. * * * * Licensee may make derivative works. However, if Licensee distributes * * any derivative work based on or derived from the Software, then * * Licensee will (1) notify NCSA regarding its distribution of the * * derivative work, and (2) clearly notify users that such derivative * * work is a modified version and not the original NCSA Mosaic * * distributed by the UI. * * * * Any Licensee wishing to make commercial use of the Software should * * contact the UI, c/o NCSA, to negotiate an appropriate license for such * * commercial use. Commercial use includes (1) integration of all or * * part of the source code into a product for sale or license by or on * * behalf of Licensee to third parties, or (2) distribution of the binary * * code or source code to third parties that need it to utilize a * * commercial product sold or licensed by or on behalf of Licensee. * * * * UI MAKES NO REPRESENTATIONS ABOUT THE SUITABILITY OF THIS SOFTWARE FOR * * ANY PURPOSE. IT IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED * * WARRANTY. THE UI SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY THE * * USERS OF THIS SOFTWARE. * * * * By using or copying this Software, Licensee agrees to abide by the * * copyright law and all other applicable laws of the U.S. including, but * * not limited to, export control laws, and the terms of this license. * * UI shall have the right to terminate this license immediately by * * written notice upon Licensee's breach of, or non-compliance with, any * * of its terms. Licensee may be held legally responsible for any * * copyright infringement that is caused or encouraged by Licensee's * * failure to abide by the terms of this license. * * * * Comments and questions are welcome and can be sent to * * mosaic-x@ncsa.uiuc.edu. * ****************************************************************************/ /**************************************************************************** * AraMosaic - Arabic ISO8859-6 support version of NCSA Mosaic. AraMosaic * * is a derivative work on NCSA Mosaic done by LangBox International. * * Copyright (C) 1996 LangBox International. Extensions made to NCSA Mosaic * * in creating AraMosaic, AraMosaic and LBI Arabic fonts which relate to * * Mosaic Arabic support are intellectual property of LangBox International.* * You are here by granted a license to use AraMosaic within the * * restrictions set forth by the above NCSA Mosaic license. * * AraMosaic may only be redistributed in its original tar format and * * without any alteration to documentation, copyright or binary. * * As previously stated, distribution of AraMosaic tar file will be in * * accordance to guidelines set by NCSA for Mosaic. * * Comments and questions are welcome and can be sent to * * aramosaic@langbox.com * ****************************************************************************/ Dear user, Please find here enclosed the AraMosaic program for UNIX X Window Workstations. The actual release of this product is delivered through FTP. Your media contains the following files in tar format: -rw-r--r-- 1 root other 13046 Jun 29 14:12 README.FIRST -rw-rw-rw- 1 root other 907589 Jun 29 14:09 AraMosaic.xxx.tar.gz The xxx substring depends on your Operating system platform. The package is delivered in this format to provide more flexibility for distant installation or in order to duplicate the total product. INSTALLATION ------------ In order to install it, you must be super-user. Then you must first create your installation directory, (ex. /usr/local/AraMosaic) and enter the following command: su mkdir /usr/local/AraMosaic cp AraMosaic.xxx.tar.gz /usr/local/AraMosaic cd /usr/local/AraMosaic gzip -cd AraMosaic.xxx.tar.gz | tar xvf - At this point, you must run the command : sh install.sh in order to install Arabic AraMosaic fonts to your X font server. Then, you can start a session with aramosaic HTML If upon execution, the following kind of warning messages are displayed: Warning: Could not open font "-lbi-naskhi-r-...-iso8859-6". Using fixed instead. Warning: Could not open font "-lbi-naskhi-r-...-iso8859-6". Using fixed instead. Warning: Could not open font "-lbi-naskhi-r-...-iso8859-6". Using fixed instead. ... this means that the fonts were not installed correctly and you will see European characters instead of Arabic. Check your installation and the install.sh script file. You can check the Arabic fonts availability by running : xlsfonts | grep iso8859-6 In the worse case, you will need to run the command manually: xset +fp /usr/local/AraMosaic/fonts You can then check/see ISO 8859-6 Web pages on the WWW. Like NCSA Mosaic, this assumes direct access to Internet from your station. Remark: For the SunOS version, we also include a file called XKeysymDB. Without this file, many warnings about "unknown keysyms" will be generated when the program starts up, and most keyboard equivalents won't work. This is a general problem with running Motif programs on systems not configured for Motif, and so will be necessary on most Sun systems. This file is included with all packages because some systems have an older version of this file, so you may still get some warnings. AraMosaic tries to load this file according the following sequence : $XKEYSYMDB /usr/lib/X11/XKeysymDB USAGE ----- For General Mosaic browser usage, please refer to the NCSA documentation. For the Arabic support, here is some explanations: This product is not 100% localized for Arabic, and menus/Messages are still in English. The AraMosaic Arabic localization effort has been don on the main HTML widget area, to allow to consult/display Arabic ISO 8859-6 based HTML documents. When you launch aramosaic, the default fonts are set to Arabic, but you can reset them through the Options/fonts menu. By the way, Arabic HTML document are only displayed correctly by using the Arabic font. An other menu dedicated for Arabic support is under "Arabic" in the main menu bar. This menu allows to set/unset some basic Arabic context analysis and display parameters: - Codeset : Allows to select the Arabic codeset used under the current HTML page as follow: - ISO 8859-6 : Default and standard Arabic codeset under UNIX and Arabic Mac operating systems. - MS CP1256 : Arabic Codeset used under Arabic MS Windows. - ISIRI 3342 : Persian Codeset used under Pmosaic. Under this codeset, only the Arabic characters are available. - Autodetect mode : Allow to detect automaticaly between ISO 8859-6 and MS CP1256 according the data contents. Remark: The Autodetect can fail when analysing short Arabic word at the begining of a page. As soon it detects the correct codeset, then all subsequent data streams are converted. Also, the ISIRI is not included in this autodetect mode. - RTL (Arabic) / LTR (Latin) Screen orientation (RTL means Right to Left and LTR means Left to Right) - Data Processing / Word Processing : According if you are displayed Numeric data or text document. The Data Processing mode is strictly conform to the ISO 8859-6 codeset (with only 7 bit digits) and the Word Processing mode is ASMO 449+ compliant and allow to manage both 7 bit and 8 bits numerals. - Hindi/ Arabic (Latin) digit shapes. Hindi shape are used in Middle East countries. - Arabic Diacritic on / off. Normally, Arabic diacritics are activated and displayed. When disabled, this function just displays Arabic text without vowels (this is the case in general). Of course, to be displayed when enabled, diacritics must be present in the HTML source file. - Neutral Space Character : This function redefine the Latin space (0x20) as a neutral character. This means that it will get an intrinsic writing direction RTL when the global orientation is RTL. This has an effect only when you display Latin text in RTL orientation mode. All theses setting can be initially configured by using the following environment variables: o AR_DIRECTION = latin|arabic (set the display direction) o AR_DATA_PROC = on|off (enable disable DataProc mode) o AR_HINDI = on|off (enable disable Hindi numerals) o AR_TASHKIL = on|off (enable disable Arabic tashkil) o AR_NEUTRAL = string (Neutral character list) P.S.: be careful when AR_DATA_PROC=on, you will obtain only one type of numerals (Hindi or Arabic) according the AR_HINDI variable value. If these variables are not defined, they are supposed to have the following value : AR_DIRECTION=latin AR_DATA_PROC=off AR_HINDI=on AR_TASHKIL=on AR_NEUTRAL="" Please add the desired value in your .profile and export them. PRINTING -------- The printing of Arabic document is also possible. Select File/Print and select Postscript type of document (plain text or formatted text is not possible except in the case you are using an Arabized line printer. KNOWN BUGS OR LIMITATIONS ------------------------- - International Markup such as CHARSET or DIR are not yet implemented. This is mainly due to a lack of time and also that there are still under discussion. However, we are open to any feedback. - Automatic right alignment detection may not correctly in some situations, mainly in line of English only text that includes several type of element. (for example: Text1, Link, Text2, in RTL, element should not be correctly read due to an individual presentation from Right to left) - Input widgets (such as or ) are not supported These widgets are just OS MOTIF library based and without an Arabic support of this OS MOTIF library itself, it cannot be handled only at the AraMosaic level. In order to have the Arabic support for these widgets too, On UNIX, you must use a package such as ALM on SGI or XLANGBOX-ARA on Sun Solaris. This is equivalent to the use of an Arabic version of the OS on PCs or Mac. You can address your comments or suggestions to LangBox International. It will help us to providing better services and product in next issues. LangBox International Technical team: support@langbox.com AraMosaic project : aramosaic@langbox.com **************************************************************************** * LANGBOX INTERNATIONAL L.B.I. * * * * Immeuble SPACE - Bat B Tel : +33 (0) 4 9371 1410 * * 208/212 Route de Grenoble Fax : +33 (0) 4 9371 1560 * * 06200 Nice - France E-Mail : contact@langbox.com * ****************************************************************************