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