Release Notes Documentation
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 13561 Mar 28 15:09 README.FIRST -rw-rw-rw- 1 root other 919179 Jun 28 15: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.
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.solaris.tar.gz /usr/local/AraMosaic cd /usr/local/AraMosaic gzip -cd AraMosaic.solaris.tar.gz | tar xvf -
At this point, you must run the command :
in order to install Arabic AraMosaic fonts to your X font server. Then, you can start a session with
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.
Note: Starting from March 28th, the AraMosaic 1.1 version allows also to load MS CP1256 Web pages by selecting this codeset under the Arabic menu, as well as ISIRI 3342 (Arabic only) encoding.
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.
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:
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.
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
Feel free to send your comments, feedback, questions and reviews to firstname.lastname@example.org.