Version:   2.4
Location:  http://www.yudit.org/
Author:    Gaspar Sinai <gsinai@yudit.org>
Copyright: Freely distributable. Please read the file COPYING. (GNU)


Features
========
-Unicode text editor with experimental bi-directional support.
-Composing character support.
-Multi Language GUI
-Conversions between character encodings
-DOS/Unix/Mac fileformat support.
-Transliterating keyboard input
-True Type and X11 font supprt
-Multiple True Type and X11 fonts can be mixed to make a virtual font. 
-Postscript printing support with True Type fonts and bitmap X11 fonts.
-Unlimited undo/redo.
-Key accelerators
-On-line help 
-Cut and Paste
-Find/Replace text
-Goto line,column
-UCS-4 support
-Drag and drop (xdnd) support

How to Install
==============
Prerequisites:
--needed: egcs-2.91.66 or better  http://gcc.gnu.org/
--needed: gmake 3.75 or greater ftp://prep.ai.mit.edu/
--needed: X11R5 or greater (www.xfree86.org)
--recommended gettext 0.10 or better for multi-language message support
--optional: a lot of True Type fonts are available for free:
  From www.microsoft.com you can get gulim (Hangul), msgothic (Japanese) for IE.
  From www.bitstream.com you can get cyberbit that contains a lot of glyphs.
  From ftp://ftp.cs.indiana.edu/pub/fidel/fonts/ 
      you can get Ethiopic fonts (gfzemenu).
--recommended:
  Several UCS fonts:
    http://www.cl.cam.ac.uk/~mgk25/ucs-fonts.html
  Unifont:
    http://www.czyborra.com/unifont/
--recommened literature:
  http://www.cl.cam.ac.uk/~mgk25/unicode.html

Installation Process
====================
Linux:

1. configure
2. make
3. make install

FreeBSD:

1. ./configure --prefix=/usr/local
2. gmake
3. gmake install


How to make an rpm package form yudit sources
=============================================
1. rpm -ba yudit-2.4.spec
  This will tell you where to put the compresed source code.Put it there.
  Most likely:
  Suse: /usr/src/packages/SOURCES/yudit-2.4.tar.gz
  or
  Redat: /usr/src/redhat/SOURCES/yudit-2.4.tar.gz
2. rpm -ba yudit-2.4.spec
  It will build a source rpm and binary . It will print out where they are.
4. rpm -i [binary rpm]

Does the gui speak my language?
==============================
As of 2.4  you can use the following languages
if you put 

   yudit.default.language=country_and_variant

in your ~/.yudit/yudit.properties file.

Tag Country/Language      Contributed by 
=== ===================   ==============
az  Azerbaijani Turkish   Vasif İsmailoglu <azerb_linux@hotmail.com>
bg  Bulgaria/Bulgarian    Alexander Shopov <al_shopov@web.bg>
de  Germany/German        Thomas Wohlfarth <thomas.wohlfarth@usa.net>
en  US/English            Gáspár Sinai <gsinai@yudit.org>
es  Spain/Spanish         Juan Rafael Fernández García <jrfern@bigfoot.com>
fr  France/French         Olivier Faucheux <olivier.faucheux@etu.enseeiht.fr>
hu  Hungary/Hungarian     Gáspár Sinai <gsinai@yudit.org>
ja  Japan/Japanese        Inui Yuko /Gaspar Sinai <yuko@yudit.org>
sl  Slovenia/Slovenian    Roman Maurer <roman.maurer@amis.net>
sr  Yugoslavia/Serbian    Slobodan Markovi=C4~G <twiddle@eunet.yu> 
yi  Israel/Yiddish        Raphael Finkel <rfinkel@mail.csse.monash.edu.au>


How to translate yudit messages to my language
==============================================

1. cd gui
2. mkdir -p locale/country_and_variant/LC_MESSAGES/
3. make messages
4. yudit -e utf-8 locale/country_and_variant/LC_MESSAGES/messages.po
5. make messages
6. make install
7. mail -s locale/country_and_variant \
     gsinai@yudit.org < locale/country_and_variant/LC_MESSAGES/messages.po
8. add 
    yudit.default.language=country_and_variant
   to ~/.yudit/yudit.properties
   you may wan to add:
    yudit.defualt.font=yourfont
    yudit.defualt.fontsize=yourfontsize
  A good result can be achieved if you download and install the 

   http://www.cl.cam.ac.uk/~mgk25/download/ucs-fonts.tar.gz

  - mkdir x11fonts   (or re-use .yudit/fonts)
  - cd x11fonts
  - wget http://www.cl.cam.ac.uk/~mgk25/download/ucs-fonts.tar.gz
  - tar xfz ucs-fonts.tar.gz
  - xset fp+ ~/x11fonts 
  - (optional) put the line above into ~/.Xinitrc
  - change ~/.yudit/yudit.properties

         yudit.defualt.font=Misc
         yudit.defualt.fontsze=15

9. Somtimes you may have a translation but it does not appear.
  Possible and not obvious reasons:
  - if the original message has \n at the end the translation should
    have it too.
  - if you see the fuzzy keyword in a comment preceeding the message
    it wont be included. Remove the fuzzy comment.
   
     
Japanese Input
==============
If you have built the Motif version you can also use Kinput2 to input Japanese.

If you want to use free packages and you have an English environment
you need to do the following:

o Get a conversion server, 'canna' from X11 contrib directory.
  This server can be built in Linux. It is usually started when the machine
  boots and keeps running. Make sure it uses its own wide text library.
  No Japanese environment is needed.

o Get a 'kinput2' X front-end for X11 from the same place you got canna.
  If you don not have Japanese environment, make sure it links with libcanna16.
  Kinput is started after X in .xinitrc and it provides the input windows
  for the applications.

  The current version of kinput2 has a bug - it thinks that long is 32 bit,
  which is true on a pentium machine. On an alpha machine you should make
  sure you have a version number set to less than 2.02 in your .yuditrc so
  that yudit knows that it should deal with a buggy kinput2. If you have a
  value of zero, yudit tries to determine the version number itself.

Hangul Input
============
Yudit comes with kmap files for Roman transliteration, 2-set and 3-set
keyboards. I expect yudit to improve on this area.

Adding New Mappings
===================
Please read the man page for mytool. FAQ.TXT also has some information.

Acknowledgements
================
乾優子 <yuko@yudit.org> for her support.
Andrew Weeks at the University of Bath for releasing his True Type 
  to postscript (ttf2pfa) program.
Markus Kuhn <Markus.Kuhn@cl.cam.ac.uk> for the unicode FAQ and the good
  advise.
Roman Czyborra <czyborra@dds.nl> kmap files, web-page, unifont
Jungshik Shin <jshin@pantheon.yale.edu> Korean support
Jim Breen <jwb@dgs.monash.edu.au> for the extensive tests and
 bug reports.
Thomas Wohlfarth <thomas.wohlfart@usa.net> - translations, tests
Ričardas Čepas <rch@richard.eu.org> - FreeBSD port
(Raphael Finkel) rfinkel@mail.csse.monash.edu.au - extensive debugging
Tony Laszlo <laszlo@gol.com> - extensive debugging 
...
and many many others.

Useful Links
============
+Unicode
*Unicode Consortium *http://www.unicode.org/
*Unicode FAQ *http://www.cl.cam.ac.uk/~mgk25/unicode.html
*Linux HOWTO *http://howto.tucows.com/LDP/HOWTO/Unicode-HOWTO.html
*Czyborra.com *http://www.czyborra.com/
*TERENA *http://www.terena.nl/projects/multiling/index.html
*ICU*http://oss.software.ibm.com/icu/overview.html
*QEmacs*http://www-stud.enst.fr/~bellard/qemacs/
 
+X11 Fonts
*HOW-TO*http://www.linuxdoc.org/HOWTO/mini/FDU/
*Unifont *http://www.czyborra.com/unifont/
*UCS fonts *http://www.cl.cam.ac.uk/~mgk25/ucs-fonts.html
*ETL Unicode *ftp://ftp.x.org/contrib/fonts/

+TTF Fonts
*Freetype Library *http://freetype.org/
*Unicode TTF *http://www.ccss.de/slovo/unifonts.htm
*Cyberbit font *http://jefferson.village.virginia.edu/babble/download/cyberbit.html
*MS TTF*http://www.microsoft.com/typography/fontpack/
*TTF Archive*http://hopi.dtcc.edu/~berlin/fonts.html
*True Type Library*http://www.brockmeiers.de/fonts/
*TheFreeSite.com*http://www.thefreesite.com/Free_Fonts/
 
+Postscript
*First Guide*http://www.cs.indiana.edu/docproject/programming/postscript/postscript.html
*WPrint*http://ttt.esperanto.org.uy/programoj/angle/wprint.html
*Type1 sampler*http://www.squirrel.nl/people/jvromans/software.html 

==============================================================================
Gáspár Sinai <gsinai@yudit.org>
Tokyo 2001-02-25

