Documentation/topdocs/index.tely

   1 i\input texinfo @c -*-texinfo-*-
   2 @setfilename index.info
   3 @settitle LilyPond homepage
   4
   5 @node Top, , , (dir)
   6 @top
   7
   8 @html
   9 <p align=center>
  10 <img src="Documentation/pictures/out-www/lelie-logo.png" alt="[logo]">
  11 @end html
  12
  13
  14 @unnumberedsec What is LilyPond?
  15
  16 @c also use keywords: music notation software
  17 LilyPond is a music typesetter.  It produces beautiful sheet music
  18 using a high level description file as input. It excels at typesetting
  19 classical music, but you can also print pop-songs.  With LilyPond we
  20 hope to make music publication software available to anyone on the
  21 internet.
  22
  23 @unnumberedsec Why should I use it?
  24
  25 The input to LilyPond is plain text. So, you can use your favorite text
  26 editor to enter it, you can put it in mail or embed it in an article like
  27 this:
  28
  29
  30 @lilypond[fragment,verbatim]
  31 \relative c'' { \key c \minor r8 c16 b c8 g as c16 b c8 d | g,4 }
  32 @end lilypond
  33
  34 The output looks very good: the font and the layout algorithms were
  35 inspired by engraved music, so you can expect that same clear and
  36 elegant look from your LilyPond output.  And if you don't like the
  37 looks, you can tweak almost everything.
  38
  39 The program also has limited MIDI functionality: you can write MIDI
  40 files with lilypond. You can also import files in PMX, MUP, MIDI, ABC,
  41 Finale and Musedata format.
  42
  43 LilyPond is free software. It is licensed under GNU General Public
  44 License, so you can use, modify and redistribute the program with
  45 almost no restrictions.  LilyPond is part of the
  46 @uref{http://www.gnu.org/,GNU Project}.
  47
  48 The version numbers are in Linux-kernel style: even numbered versions
  49 are `stable'. The webpages for the stable version (1.2) reside
  50 @uref{http://www.gnu.org/software/lilypond, on the GNU servers}. Big
  51 enhancements go into the latest odd numbered version (1.3), whose
  52 webpages are on @uref{http://www.cs.uu.nl/~hanwen/lilypond/,Han-Wen's
  53 site}.  Information on the latest and greatest features can be found in
  54 the @uref{Documentation/out-www/CHANGES.html, Change Log}.
  55
  56 If want more information, you can browse the
  57 @uref{Documentation/user/out-www/lilypond.html, manual} or other
  58 @uref{Documentation/out-www/index.html, documentation}.
  59
  60 @html
  61 <a name="music">
  62 @end html
  63 @unnumberedsec Sheet music
  64
  65
  66 If you are interested in sheet music typeset by LilyPond, have a look at
  67 the examples included. We have @uref{short-examples.html,short
  68 examples} and @uref{long-examples.html,longer examples}. The
  69 examples include sound bites  in MIDI, pictures in PNG, printable scores
  70 in PostScript, and LilyPond input. Others use LilyPond too, and have put
  71 scores on the web. Head over to @uref{http://appel.lilypond.org/wiki?DownloadLilyPondScores}
  72
  73 @html
  74 <a name="download-source">
  75 @end html
  76 @unnumberedsec Download
  77
  78 If you want to compile LilyPond from source, download here:
  79 @itemize @bullet
  80 @item Download stable releases at
  81 @uref{ftp://ftp.gnu.org/gnu/lilypond/,GNU}
  82 @item Download development releases from
  83 @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/development/, by FTP} and
  84 @uref{http://ftp.cs.uu.nl/pub/GNU/LilyPond/development/, by HTTP}.
  85 @item @uref{ftp://sca.uwaterloo.ca/pub/, ftp (Canadian mirror)}
  86 @item @uref{ftp://ftp.lilypond.org/pub/LilyPond/, mirror (Europe)}
  87 @end itemize
  88
  89 Installing and compiling requires many additional packages, which are
  90 listed in the @uref{Documentation/topdocs/out-www/INSTALL.html,
  91 installation instructions}.
  92
  93 @html
  94 <a name="download-binary">
  95 @end html
  96 Binaries are available, but are not updated for every version released.
  97 @itemize @bullet
  98 @item @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/RPMS/, RedHat i386}
  99 @item @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/RPMS/ppc, LinuxPPC}
 100 @item
 101 @uref{ftp://ftp.debian.org/debian/pool/main/l/lilypond,
 102 Debian GNU/Linux Stable}
 103 @item
 104 @uref{ftp://ftp.debian.org/debian/pool/main/l/lilypond1.3,
 105 Debian GNU/Linux Unstable}
 106 @item @uref{http://home.austin.rr.com/jbr/jeff/lilypond/, Windows Stable}
 107 @item @uref{http://appel.lilypond.org/lilypond/gnu-windows, Windows
 108 Testing}
 109 @end itemize
 110
 111
 112 @html
 113 <a name="mailing-lists">
 114 @end html
 115 @unnumberedsec Mailing lists
 116
 117 If you have questions, do write to the mailing lists.  But don't forget
 118 to read the @uref{Documentation/topdocs/out-www/FAQ.html,Very Frequently
 119 Asked Questions} and @uref{http://appel.dyndns.org/wiki?LilyPondFaqs,
 120 Frequently Asked Questions} first.
 121
 122
 123 @itemize @bullet
 124 @item @uref{http://mail.gnu.org/mailman/listinfo/info-gnu-music,info-gnu-music@@gnu.org}
 125 is a low-volume list for information on the GNU Music project.
 126     This list is moderated; ask
 127     @email{drl@@gnu.org, David R. Linn} or
 128     @email{hanwen@@cs.uu.nl, Han-Wen} to send announcements for this list.
 129 @item @uref{http://mail.gnu.org/mailman/listinfo/help-gnu-music,help-gnu-music@@gnu.org}
 130     For help with using LilyPond.
 131 @item @uref{http://mail.gnu.org/mailman/listinfo/bug-gnu-music,bug-gnu-music@@gnu.org}
 132 If you have bugreports, you should send them to this list.
 133
 134
 135
 136         Please include in your bugreport the version of LilyPond that
 137 you experience the problem with, a description of your system and sample
 138 input to reproduce the problem. Do not send output files over the list,
 139 they tend to be very big and don't help with describing the problem.
 140
 141
 142 @item @uref{http://mail.gnu.org/mailman/listinfo/gnu-music-discuss,gnu-music-discuss@@gnu.org}
 143     For discussions concerning LilyPond.
 144 @end itemize
 145
 146 These pages were entirely created from a @strong{development snapshot}
 147 of the LilyPond package.  The version of this webpage is printed at the
 148 bottom.
 149
 150 @bye