**************************************************************************
*                                                                        *
* LangBox International                                                  *
* Immeuble SPACE, bat. B                                                 *
* 208/212, Route de Grenoble - 06200 Nice - France                       *
* Tel +33 (0) 4 9371 1410 - Fax +33 (0) 4 9371 1560                      *
* Email: arazilla@langbox.com                                            *
*                                                                        *
**************************************************************************
Fri Aug  4 19:11:49 MDT 2000


                   --   ARAZILLA SETUP ON LINUX   --


**************************************************************************
INITIAL INSTALLATION (ON A NEW SYSTEM)
**************************************************************************

Step1:
-----

Download the XLANGBOX-ARA Font package for Linux from 
http://www.langbox.com/AraZilla/linux/arafontfull-1.2-4.i386.rpm  


Install it with the command:


	rpm -r arafontfull-1.2-4.i386.rpm


Check if the LangBox fonts are installed on the X Server after the installation 
with the command:


	xlsfonts | grep lbi-


Otherwise the XLANGBOX-ARA Arabic fonts will not be loaded and have to be
manually loaded by: 


	xset fp+ /usr/lib/X11/fonts/arabic/misc 


Step2:
------
- get the AraZilla distribution from:

  http://www.langbox.com/AraZilla/linux/arazilla-i686-pc-linux-build20001010.tar.gz

- install AraZilla as root as follow:

        create a directory (ex. AraZilla)
        cd AraZilla
        gzip -cd arazilla-i686-pc-linux-build20001010.tar.gz | tar xvf -


- Edit ./arazilla script and edit the MOZILLA_FIVE_HOME variable setting
  to reflect your installation arazilla directory.
  Then save ./arazilla in /usr/local/bin or somewhere else which appears
  in $PATH

- Run the following script as root at least once :
     ./arazilla -selectprofile
  in order to register all the components and create the "component.reg" file.
  You will be prompted to create a user profile, you have to create a default User
  profile.  Then click exit.

- From this point, any user may just call arazilla to launch the
  browser, with or without parameters:

  arazilla http://www.arabvista.com

  arazilla -mail

  arazilla -chat

  Then you can browse in Arabic.


***************************************************************************
UPDATE A BETA1 INSTALLATION (on a BETA 0531 or 0622 installation)
***************************************************************************

STEP1 - Install the new AraZilla 0804 distribution

The procedure is as follow:

- Be root

- Remove the old /.mozilla/ directory and the ~username/.mozilla/ if exists.

- get the AraZilla binary distribution from:

  http://www.langbox.com/AraZilla/linux/arazilla-i686-pc-linux-build20001010.tar.gz

- install AraZilla as root as follow:

        create a directory (ex. AraZilla)
        cd AraZilla
        gzip -cd arazilla-i686-pc-linux-build20001010.tar.gz | tar xvf -


- Edit ./arazilla script and edit the MOZILLA_FIVE_HOME variable setting
  to reflect your installation arazilla directory.
  Then save ./arazilla in /usr/local/bin or somewhere else which appears
  in $PATH

- Run the following script as root at least once :
     ./arazilla -selectprofile
  in order to register all the components and create the "component.reg" file.
  You will be prompted to create a user profile, you have to create a default User
  profile.  Then click exit.

- From this point, any user may just call arazilla to launch the
  browser, with or without parameters:

  arazilla http://www.arabvista.com

  arazilla -mail

  arazilla -chat

  Then you can browse in Arabic.



***************************************************************************
WORKING WITH MULTIPLE DISPLAY WORKSTATIONS AS CLIENT
***************************************************************************

In order to run AraZilla from a remote worstation or an X terminal display,
the Arabic fonts package has to be installed on this specific terminal.

This operation is very simple and straight forward:

- Get the Arabic font package :

Download the XLANGBOX-ARA Font package for Linux from 
http://www.langbox.com/AraZilla/linux/arafontfull-1.2-4.i386.rpm  


Be root and install it with the command:


	rpm -r arafontfull-1.2-4.i386.rpm


Check if the LangBox fonts are installed on the X Server after the installation 
with the command:


	xlsfonts | grep lbi-


Otherwise the XLANGBOX-ARA Arabic fonts will not be loaded and have to be
manually loaded by: 


	xset fp+ /usr/lib/X11/fonts/arabic/misc 
 

You can now log on the Linux server, set the DISPLAY variable to reflect your
workstation X display and export it, then run arazilla as on the server.

***************************************************************************
Basic Usage:
***************************************************************************

Screen direction
----------------
The Default screen direction is Left to Right - You may select the Right-to-Left
duynamicaly by the view menu or permanentely by editing the preference file:
        $HOME/.mozilla/your_profile_name/prefs.js

and replace the line:

        user_pref("browser.display.direction", 0);  
with
        user_pref("browser.display.direction", 1);  

Keyboard switch
---------------
By default, the English Keyboard (EN) layout is active. The user can swicth to
a virtual Arabic Keyboard (AR) layout and come back to the English one.
The Keyboard switch (from EN to AR or from AR to EN) can be done by either :
        <CTRL>t
        <Compose_Key>
        <Alt_Left>

The default layout is the "Microsoft" one (because most of Engraved PC keyboard
are just following this layout), however, the layout mapping is customizable (See 
AR_KBDMAPFILE variable setting) 

A virtual Keyboard interface is available in the icon bar menu "Arabic KBD" :
This interface open a popup window which allows to make input with the mouse.

Arabic codesets
---------------
While browsing, the browser read the HTML charset meta value so set its
codeset :
These values could be either:

<META HTTP-EQUIV="Content-Type" content="text/html; charset=windows-1256">
<META HTTP-EQUIV="Content-Type" content="text/html; charset=ISO-8859-6"> 
<META HTTP-EQUIV="Content-Type" content="text/html; charset=UTF-8">

according the codeset use to create the HTML page content.

Remark: Some Arabic sites are not followed this HTML compliance and just
define and charset=ISO-8859-1 or not charset definition at all.
You may verify this by the view source option menu.
If this Meta definition is missing, you may anyway force the input
codeset using the menu:
        --> View --> Character Coding --> Arabic LBI Add --> Windows-1256
        --> View --> Character Coding --> Arabic LBI Add --> ISO-8859-6
        --> View --> Character Coding --> Multibyte --> UTF-8

Some sites (like www.ahram.org.eg for instance) that use Dynamic Fonts
(PFRs) and then don't follow any Arabic charset. These site are not supported
since PFR are not supported by Mozilla.

Font selection:
---------------

The Arabic fonts are normally selected by default to diplay Arabic text,
however, you may adapt this for permanent environment:
You go to :
        -> Edit -> Preference -> fonts
           -> Select Fonts for "Arabic"  (last entry in the list)
           ---> Serif: lbi-naskhi-iso8859-6
           ---> Sans Serif: lbi-naskhi-iso8859-6
           ---> Monospace:  lbi-arabic8x-iso8859-6
           ---> select the sizes you want
           ---> Check "always use my font setting"
           -> OK



0804 Release Limitations:
-------------------------

- The compose new mail windows crashes when in RTL mode due to a Mozilla bug.

- Postscript Printing support is under development.

The LangBox team is still working on the project - Please send your comments
to : arazilla@langbox.com