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