lyx_mirror/INSTALL.Win32
Angus Leeming 05dcc03f8c First attempt at completing the Win32 docs.
git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/branches/BRANCH_1_3_X@10187 a592a061-630c-0410-9148-cb99ea01b6c8
2005-07-14 16:51:34 +00:00

142 lines
4.4 KiB
Plaintext

=================
INSTALL for Win32
=================
Building LyX the first time can appear to be a daunting task, but much of
that is knowing which packages to download in the first place.
The instructions below should guide you through the installation of
the MinGW/MinSYS build environment, together with details on how to
grab and build the Qt toolkit and how to grab Aspell and LyX.
Once you've done all that, you should go read the README in
development/Win32/packaging/ The two scripts in the same directory,
build_lyxwin.sh and package_lyxwin.sh should automate the entire
build process. If not and you really can't figure out what to do next,
then please, please drop a mail to lyx-devel@lists.lyx.org.
Enjoy!
The LyX Team
=============================================================================
1 MinGW & MSYS
1.1 Download the following packages from http://www.mingw.org/download.shtml:
MinGW-3.2.0-rc-3.exe
binutils-2.15.94-20050118-1.tar.gz
MSYS-1.0.11-2004.04.30-1.exe
msysDTK-1.0.1.exe
1.2 Install MinGW-3.2.0-rc-3.exe in C:\MinGW
1.3 Install MSYS-1.0.11-2004.04.30-1.exe in C:\msys
1.4 Install msysDTK-1.0.1 in C:\msys
1.5 Extract binutils-2.15.94-20050118-1.tar.gz in C:\MinGW
(i.e., overwrite the existing binutils)
2. Gettext & Libiconv
2.1 Download the following packages from
http://www.gnu.org/software/gettext/gettext.html:
gettext-tools-0.13.1.bin.woe32.zip
gettext-runtime-0.13.1.bin.woe32.zip
libiconv-1.9.1.bin.woe32.zip
2.2 Extract the three packages in C:\MinGW
3 QT/Win Free Edition
http://qtwin.sourceforge.net/index.php/QT/Free_from_CVS_with_Mingw
3.1 Get the latest CVS version
Using the cvs executable that is packaged with MinSYS,
from the MinSYS command prompt:
$ cd ~
$ cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/kde-cygwin login
<return> (no password)
$ cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/kde-cygwin co \
-r QT_WIN32_3_3_BRANCH -d qt3 qt-3
Alternatively, use the TortoiseCVS graphical interface.
3.2 Compile the QT library
Create two .bat files, in the top-level directory of the Qt tree,
my_configure.bat and my_make.bat. Mine are shown below. Obviously,
you'll have to tweak them ;-)
$ cat my_configure.bat
set QTDIR=J:\MinSys\home\Angus\qt3
set MINGW=J:\MinGW
set PATH=J:\MinSys\home\Angus\qt3\bin;J:\MinGW\bin;C:\WINDOWS\system32;C:\WINDOWS
set QMAKESPEC=win32-g++
configure.bat -verbose
$ cat my_make.bat
set QTDIR=J:\MinSys\home\Angus\qt3
set MINGW=J:\MinGW
set PATH=J:\MinSys\home\Angus\qt3\bin;J:\MinGW\bin;C:\WINDOWS\system32;C:\WINDOWS
set QMAKESPEC=win32-g++
mingw32-make symlinks
mingw32-make src-moc
mingw32-make sub-src
The first time that you build the Qt sources, run my_configure.bat.
Thereafter, you should be able to get away with my_make.bat. If it fails,
you should try my_configure.bat again, but this will overwrite all the
Qt header files, so you'll end up rebuilding large chunks of LyX as well.
$ cmd.exe
PROMPT> my_configure.bat
4. Aspell
4.1 Download aspell-0.50.5.tar.gz from ftp://ftp.gnu.org/gnu/aspell/
(note: version 0.60.2 does not compile)
Download dictionaries from ftp://ftp.gnu.org/gnu/aspell/dict/
Eg: en/aspell-en-0.50-2.tar.bz2
de/aspell-de-0.50-2.tar.bz2
4.2 Extract all files in your MSYS home directory. From the
MinSYS command prompt:
$ gunzip aspell-0.50.5.tar.gz
$ bunzip2 aspell-en-0.50-2.tar.bz2
$ tar xvf aspell-0.50.5.tar
$ tar xvf aspell-en-0.50-2.tar
$ rm -f aspell-0.50.5.tar
$ rm -f aspell-en-0.50-2.tar
There's no need to build Aspell now. The script in
development/Win32/packaging should do it for you.
5. LyX
5.1 Get the latest CVS version
Using the cvs executable that is packaged with MinSYS,
from the MinSYS command prompt:
$ cd ~
$ mkdir lyx && cd lyx
$ cvs -d:pserver:anoncvs@anoncvs.us.lyx.org:/cvs/lyx login
(The password is "lyx" (no inverted commas))
$ cvs -d:pserver:anoncvs@anoncvs.us.lyx.org:/cvs/lyx \
checkout -r BRANCH_1_3_X -d 13x lyx-devel
Alternatively, use the TortoiseCVS graphical interface.
There's no need to build LyX now. The script in
development/Win32/packaging should do it for you.
Now go read the README in development/Win32/packaging.
=============================================================================