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