README

   1 This is a LyX development release
   2 ---------------------------------
   3
   4 The LyX Team has adopted a new development model and
   5 tries to keep the development version stable as far
   6 as possible, but since the program is changing, the
   7 development version will be less stable than the
   8 stable releases.
   9
  10 So, don't use this development version on your production
  11 documents without testing everything in depth first.
  12
  13
  14 What is LyX?
  15
  16         LyX is an advanced open-source "document processor". Unlike
  17         standard word processors, LyX encourages writing based on the
  18         structure of your documents, not their appearance. It lets you
  19         concentrate on writing, leaving details of visual layout to the
  20         software.
  21
  22         You can read more about this concept in the documentation,
  23         which you'll find under the Help menu.  If you plan to use LyX,
  24         you really should read about it to be able to make the best of
  25         it.
  26
  27 What is LyX not?
  28
  29         LyX is not just another word processor that claims to be a
  30         Desktop Publishing program.  It's a more modern way of
  31         creating documents that look much nicer, but without wasting
  32         time with layout-fiddling.  For these reasons you might need
  33         little time to get used to the differences.
  34         If you are looking for a free Desktop Publishing program for
  35         Unix, you will be disappointed.
  36
  37 What do I need to run LyX?
  38
  39         A Unix-like system or OS/2 with XFree
  40         At least X11 Release 5
  41         A decent LaTeX2e installation (e.g. teTeX or NTeX) not older
  42            than 1995/12/01
  43         Optionally ghostscript and ghostview (or compatible)
  44         Perl5.002 or later to import LaTeX files into LyX
  45
  46 What's new?
  47
  48         Read NEWS.
  49
  50 How do I install a binary distribution of LyX?
  51
  52         Unpack it and run it.  We recommend unpacking it in /usr/local,
  53         but it should work anywhere.  In particular, you can try LyX
  54         in a temporary directory before installing permanently by
  55         typing "bin/lyx".
  56
  57         We recommend that you configure LyX system-wide by copying the
  58         file share/lyx/lyxrc.example to share/lyx/lyxrc, and then
  59         reading and modifying it.
  60
  61         You should read the notes regarding this particular build in
  62         the file README.bin.
  63
  64 How do I upgrade from an earlier LyX version?
  65
  66         Read the file UPGRADING for info on this subject.
  67         If you are upgrading from version 0.12.0 or later, you don't
  68         need to do anything special.
  69
  70 What do I need to compile LyX from the source distribution?
  71
  72         1. A good c++ compiler.  Development is being done mainly on
  73            gcc/g++, but many others work.
  74         2. The Xforms library version 0.88 (recommended) or 0.89.
  75         3. LibXpm version 4.7 (or newer).
  76
  77         Read the file "INSTALL" for more information on compiling.
  78
  79 Okay, I've installed LyX. What now?
  80
  81         Once you've installed it, and everything looks fine, go read
  82         the "Introduction" item under the Help menu.  You should follow
  83         the instructions there, which tell you to read (or at least skim)
  84         the Tutorial. After that, you should also read "Help/LaTeX
  85         configuration" which provides info on your LaTeX configuration
  86         as LyX sees it.  You might be missing a package or two that you'd
  87         like to have.
  88
  89         User-level configuration is possible with a file "~/.lyx/lyxrc".
  90         You can use the system-wide lyxrc file (which should be somewhere
  91         like /usr/local/share/lyx/lyxrc) as a template for your personal
  92         lyxrc file.  Remember that a personal configuration file will be
  93         used instead of, not in addition to, any system-wide file.
  94
  95 Does LyX have support for non-English speakers/writers/readers?
  96
  97         Yes. LyX supports writing in many languages.
  98
  99         Menus and error messages have been translated to the following
 100         languages (* means there are language-specific keyboard menu
 101         bindings as well):
 102
 103         Catalan     (ca)
 104         Czech       (cs)
 105         Danish      (da)
 106         German      (de)    *
 107         Spanish     (es)
 108         Finnish     (fi)
 109         French      (fr)    *
 110         Hungarian   (hu)    *
 111         Italian     (it)
 112         Dutch       (nl)
 113         Norwegian   (no)
 114         Polish      (pl)
 115         Portuguese  (pt)    *
 116         Russian     (ru)
 117         Slovenian   (sl)
 118         Swedish     (sv)    *
 119         Turkish     (tr)
 120         Walloon     (wa)
 121
 122         Keymaps can ease typing in one or more of the following languages:
 123
 124         Czech
 125         French, Swiss French
 126         German, Swiss German
 127         Greek
 128         Hungarian (Magyar)
 129         Polish
 130         Portugese
 131         Romanian
 132         Slovenian
 133         Turkish
 134
 135 Internet resources of relevance to LyX
 136
 137         The LyX homepage contains valuable information about LyX and the
 138         various LyX mailing lists, as well as links to mirrors and other
 139         LyX homepages around the world:
 140         http://www.lyx.org/
 141
 142         Main LyX archive site:
 143         ftp://ftp.lyx.org/pub/lyx/
 144
 145         The LyX Development page has information about the development
 146         effort. LyX is now under CVS control, so you can get the very
 147         latest sources from there at any time.
 148         http://www.devel.lyx.org/
 149         ftp://www.devel.lyx.org/pub/lyx/
 150
 151 How do I submit a bug report?
 152
 153         If possible, read the "Known Bugs" document found under the
 154         Help menu.  You'll find detailed info on submitting bug reports
 155         there.
 156
 157         You should also check the BUGS file in this directory.
 158
 159         If you can't do that, send details to the LyX Developers mailing
 160         list.  Don't forget to mention which version you are having
 161         problems with!
 162
 163 How can I participate in the development of LyX?
 164
 165         Any help with the development of LyX is greatly appreciated--
 166         after all LyX wouldn't be what it is today without the help
 167         of volunteers. We need your help!
 168
 169         If you want to work on LyX, you should contact the developer's
 170         mailing list for discussion on how to do your stuff.  LyX is being
 171         cleaned up, and therefore it's important to follow some rules.
 172         Read about those rules in development/Code_rules/.
 173
 174         If you don't know C++, there are many other ways to contribute.
 175         Write documentation. Help to internationalize LyX by translating
 176         documentation or menus/error messages, or by writing a new keymap.
 177         Write a new textclass.  Work on reLyX (Perl). Find bugs (but please
 178         read the list of known bugs first). Contribute money. Or just offer
 179         feature suggestions (but please read the online TODO list first).
 180
 181 Thank you for trying LyX, and we appreciate your feedback in the mailing
 182 lists.
 183
 184 The LyX Team.