Documentation/topdocs/index.tely

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