Updated hint
[linux_from_scratch_hints.git] / PREVIOUS_FORMAT / lyx.txt
blob6d43cd511ba9994c84c7fbf6a77af644c65f59c5
1 TITLE:          LyX from scratch
2 LFS VERSION:    4.1
3 AUTHOR:         Marnix Kaart <marnix_lfs@mkaart.net>
5 SYNOPSIS:       How to install LyX
7 HINT:
9 Contents:
10  1. Preface
11  2. Requirements
12  3. Installing tetex-2.0.2
13  4. Installing ImageMagick-5.5.6
14  5. Installing Lyx-1.3.2
15  6. Additional settings
16  7. Changelog
18 1. Preface
19 ----------
20 I am not an expert on the area of LaTeX of LyX, I just managed to get it
21 running on my box. This hint describes how I did it. Please send all
22 questions to the blfs mailinglist. Suggestions for improving this hint are
23 welcome.
25 Please refer to the DISCLAIMER at
26 http://hints.linuxfromscratch.org/hints/DISCLAIMER
28 2. Requirements
29 ---------------
30 This hint assumes you have the following installed on your box already:
31         - XFree86-4.3.0
32         - qt-3.1.2
33         (Older versions may work, but above is the setup I have)
35 For viewing or exporting to postscript you need at least:
36         - ghostscript-8.00
37         - gsview-4.3
38         (gsview is not supported in the "view" menu. I tried to make a symlink
39         gv to gsview but this does not work. You probably need gv or ghostview
40         if you insist on previewing your work as postscript. Exporting to ps
41         and later viewing it with gsview DOES work.)
43 For viewing or exporting to pdf you need:
44         - xpdf-2.02
46 For importing older LyX files you need:
47         - python-2.2.2
49 Setup instructions for these packages are in the BLFS book
50 I am not sure if this list is complete, but this is what I have.
51 As far as I know the "reconfigure" option in the "edit" menu can be used when
52 you later install some package that can be used by LyX.
54 3. Installing tetex-2.0.2
55 -------------------------
56 Download the following packages:
58 ftp://sunsite.informatik.rwth-aachen.de/pub/comp/tex/teTeX/2.0/distrib/tetex-src-2.0.2.tar.gz
59 ftp://sunsite.informatik.rwth-aachen.de/pub/comp/tex/teTeX/2.0/distrib/tetex-texmf-2.0.2.tar.gz
60 ftp://sunsite.informatik.rwth-aachen.de/pub/comp/tex/teTeX/2.0/distrib/tetex-texmfsrc-2.0.2.tar.gz
62 I copied these instructions from the BLFS book:
64 TeX is installed slightly differently than a typical GNU package, these
65 instructions will assume /usr/src to be the current working directory,
66 containing the three TeX tarballs.
68 Install TeX by running the following commands:
70 mkdir -p /usr/share/texmf &&
71 tar zxvf tetex-src-2.0.2.tar.gz &&
72 cd tetex-src-2.0.2 &&
73 gzip -dc ../tetex-texmf-2.0.2.tar.gz \
74       | (umask 0; cd /usr/share/texmf; tar xvf -)
76 If the optional texmf source code tarball was downloaded, untar it now:
78 gzip -dc ../tetex-texmfsrc-2.0.2.tar.gz \
79       | (umask 0; cd /usr/share/texmf; tar xvf -)
81 ./configure --prefix=/usr \
82     --without-texinfo   --with-system-ncurses --with-system-zlib \
83     --exec-prefix=/usr --bindir=/usr/bin &&
84 make world &&
85 texconfig dvips paper letter &&
86 texconfig font rw
88 Mind that I left the --with-x=no option out, since I like to have xdvi for
89 previewing my work.
91 4. Installing ImageMagick-5.5.6
92 -------------------------------
93 The convert tool from ImageMagick is used for displaying inline figures.
95 Download ImageMagick at
96 ftp://ftp.imagemagick.net/pub/ImageMagick/ImageMagick-5.5.6.tar.gz
98 Configure and build it with:
99 ./configure --prefix=/usr --sysconfdir=/etc --with-gslib \
100         --with-gs-font-dir=/usr/share/ghostscript/fonts --with-x &&
101 make &&
102 make install
104 To verify the build run:
105 ./utilities/display
107 make check
109 5. Installing Lyx-1.3.2
110 -----------------------
111 Download Lyx at
112 ftp://ftp.lyx.org/pub/lyx/stable/lyx-1.3.2.tar.bz2
114 Configure and build with:
115 ./configure --with-frontend=qt --prefix=/usr -sysconfdir=/etc \
116         --with-qt-dir=/usr/local/qt &&
117 make all &&
118 make install
120 6. Additional settings
121 ----------------------
122 I use the IEEEtran.cls classfile for writing articles, but I had some trouble
123 in setting it up the first time. The IEEE template is already present in lyx,
124 you just need to place the IEEEtran.cls file somewhere latex can find it.
125 Here is how I did it:
127 Download the author kit (IEEEtran.tar.gz) from
128 http://www.ieee.org/organizations/pubs/transactions/stylesheets.htm
130 As root:
131 - Unpack the file and copy IEEEtran.cls into /usr/share/texmf/tex/latex
132 - Run texhash
134 As normal user (inside Lyx):
135 Edit --> Reconfigure and restart LyX
137 Now you should be able to actually create documents using the IEEEtran.lyx
138 template.
140 Enjoy!
142 7. Changelog
143 ------------
144 20030527        Initial document