Documentation/windows/installing.texi

   1 \input texinfo @c -*-texinfo-*-
   2 @setfilename installing.info
   3 @settitle LilyPond on Windows
   4
   5 @node Top
   6 @top
   7
   8 @chapter WINDOWS - Installing GNU LilyPond on Windows
   9
  10 This document explains how to install the binary release for windows
  11 on a Microsoft Windows 95, 98, NT or 2000 machine.
  12
  13 This release is a free extra service of the developers to assist windows
  14 users.  Please remember that we (the developers) rather dislike windows,
  15 and none of us use it.  Don't complain to us that installing LilyPond is
  16 too difficult; rather, send us code that works better.
  17
  18 You need the following software (but read on):
  19
  20 @c list these first, because lilypond install scripts look for these
  21 @c packages
  22 @table @asis
  23 @item A full TeX installation.
  24
  25 Currently, only MikTeX is supported.  Download and install
  26 @uref{http://downloads.sourceforge.net/miktex/miktex-2.0-lvl-1.zip,MikTeX},
  27 or visit @uref{http://www.miktex.org,www.miktex.org}.
  28 @c See @file{/usr/doc/cygwin/tetex-beta-20001218.README} for details.
  29
  30 @item Ghostview.
  31
  32 You can use GSView-2.6.  This old package has two advantages.  It has
  33 gsview and ghostscript bundeled, and it doesn't popup @emph{Register
  34 Now|Cancel} windows all the time.  It doesn't work together with Yap to
  35 display PostScript specials.
  36
  37 Click @uref{ftp://ftp.cs.wisc.edu/ghost/ghostgum/gsv26w32.exe,here} to
  38 install GSView-2.6 (GhostView for Windows), or visit
  39 @uref{ftp://ftp.cs.wisc.edu/ghost/ghostgum,ftp.cs.wisc.edu}.
  40
  41 You can also use the newer versions GSView-3.6 and GhostScript-6.50 If
  42 you install both these packages, Yap will display PostScript specials.
  43 You get annoying @emph{Register Now|Cancel} popups, though.
  44
  45 Click @uref{ftp://ftp.cs.wisc.edu/ghost/ghostgum/gsv36w32.exe,here} for
  46 GSview and
  47 Click @uref{ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/AFPL/gs650/gs650w32.exe
  48 ,here} for GhostScript.
  49 @uref{ftp://ftp.cs.wisc.edu/ghost/ghostgum,ftp.cs.wisc.edu}.
  50 or visit the
  51 @uref{http://www.cs.wisc.edu/~ghost/,Ghostscript, Ghostview and GSview site}.
  52
  53 @item Python
  54 Click @uref{http://www.python.org/ftp/python/win32/py152.exe,here} to
  55 install Python-1.5.2, or visit
  56 @uref{http://www.python.org,www.python.org}.
  57
  58 We have not tried using newer versions than 1.5.2.
  59
  60 @item LilyPond
  61 Download and run
  62 @c let's do http, so that people read the README
  63 @uref{http://www.lilypond.org/gnu-windows/setup.exe, setup.exe}
  64 to install LilyPond.
  65
  66 This will install the minimal set of cygwin tools needed to run
  67 LilyPond.
  68
  69 As of version 1.3.150, you also have the option to install MiKTeX,
  70 Python and GSView from this installer, but that's still somewhat
  71 experimental.  If you choose to install these by hand (see above), make
  72 sure to install them @strong{before} you install LilyPond.
  73
  74 If you already have cygwin installed, don't worry: nothing will be
  75 installed twice.  To expand on this minimal set, click
  76 @uref{http://sources.redhat.com/cygwin/setup.exe,here}, or visit a
  77 Cygwin @uref{http://sources.redhat.com/cygwin/mirrors.html,mirror site}.
  78 @end table
  79
  80
  81
  82 @section Windows running setup
  83
  84 If you're lucky, after running @file{setup.exe} you're all set up.
  85
  86 Open a LilyPond shell (or any bash shell), and type
  87 @example
  88 lilypond --help
  89 @end example
  90
  91 If you don't see something similar to
  92 @example
  93 Usage: lilypond [OPTION]... [FILE]...
  94
  95 Typeset music and or play MIDI from FILE
  96
  97 LilyPond is a music typesetter.  It produces beautiful sheet music
  98 using a high level description file as input.  LilyPond is part of
  99 the GNU Project.
 100
 101 Options:
 102   -h,--help             this help
 103 [..]
 104 @end example
 105
 106 you should try adding @file{/usr/lilypond-x.y.z/bin} to your @var{PATH},
 107 do:
 108 @example
 109 PATH=/usr/lilypond-1.3.147/bin:$PATH
 110 @end example
 111
 112 and try again.
 113
 114 [TODO:
 115
 116
 117 * emacs-mode installation, figure out and describe proper
 118 emacs-on-cygwin setup.
 119
 120 * talk about /etc/profile.d/lilypond-profile.sh
 121
 122 * GUILE errors, simple guile test
 123
 124 * (La)TEX errors, simple tex test
 125
 126
 127 ]
 128 @ignore
 129
 130   guile -v
 131   Guile 1.4.1
 132
 133   guile -e %load-path
 134   ERROR: Wrong type to apply: ("/usr/share/guile/site" /usr/share/guile/1.4.1")
 135
 136
 137
 138 Mats?
 139
 140 Let's take this step by step.
 141
 142 It should not be critical which MikTeX version you use.
 143 Let's first verify that your MikTeX works as it should.
 144 Open a DOS window. Run the commands
 145 >> latex sample2e
 146  Should produce some lines of output
 147 >> yap sample2e
 148  Should display a three page document.
 149
 150 Next step; verify that the geometry package is in place.
 151 Save the attached file to the directory where you run
 152 your DOS window. Run the commands
 153 >> latex geometrytest
 154 >> yap geometrytest
 155 This one you should get a single page document with some text
 156 in each corner.
 157 ]
 158
 159 @end ignore
 160
 161