]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/topdocs/index.tely
release: 1.3.147
[lilypond.git] / Documentation / topdocs / index.tely
index ce44ea54dda14827a977758832756ac69e14e7c6..93084b449609af7c95f97fad390f611ee7e59c05 100644 (file)
-\input texinfo @c -*-texinfo-*-
+i\input texinfo @c -*-texinfo-*-
 @setfilename index.info
 @settitle LilyPond homepage
 
 @node Top, , , (dir)
 @top
 
-
-@unnumbered LilyPond -- The GNU Project Music Typesetter
-
-
 @html
-<img src="Documentation/pictures/out-www/lelie-logo.png">
+<p align=center>
+<img src="Documentation/pictures/out-www/lelie-logo.png" alt="[logo]">
 @end html
 
-@c something breaks on 3.12 f
 
-LilyPond is a music typesetter.  It produces beautiful sheet music using
-a high level description file as input. It excels at typesetting
+@unnumberedsec What is LilyPond?
+
+@c also use keywords: music notation software
+LilyPond is a music typesetter.  It produces beautiful sheet music
+using a high level description file as input. It excels at typesetting
 classical music, but you can also print pop-songs.  With LilyPond we
 hope to make music publication software available to anyone on the
 internet.
 
-The program also has limited MIDI functionality: you can write MIDI
-files with lilypond, and we have a simple MIDI to lilypond conversion
-tool, @file{midi2ly}.
+@unnumberedsec Why should I use it?
 
-LilyPond is free software. It is licensed under GNU General Public
-License, and it is part of the @uref{http://www.gnu.org/,GNU Project}.
+The input to LilyPond is plain text. So, you can use your favorite text
+editor to enter it, you can put it in mail or embed it in an article like
+this:
 
 
-@quotation
-@mudela[fragment]
-       \relative c'' { \key es; r8 [c16 b] [c8 g] [as c16 b] [c8 d] | g,4 }
-@end mudela 
-@end quotation
+@lilypond[fragment,verbatim]
+\relative c'' { \key c \minor r8 c16 b c8 g as c16 b c8 d | g,4 }
+@end lilypond 
 
-    
+The output looks very good: the font and the layout algorithms were
+inspired by engraved music, so you can expect that same clear and
+elegant look from your LilyPond output.  And if you don't like the
+looks, you can tweak almost everything.
 
-The version numbers are in Linux-kernel style: even unnumbered versions
-are `stable'. The webpages for the stable version reside at GNU, here:
- @uref{http://www.gnu.org/software/lilypond}. Big enhancements go
-into the odd numbered versions, whose webpages are on 
- @uref{http://www.cs.uu.nl/~hanwen/lilypond/,Han-Wen's site}.
+The program also has limited MIDI functionality: you can write MIDI
+files with lilypond. You can also import files in PMX, MUP, MIDI, ABC,
+Finale and Musedata format.
+
+LilyPond is free software. It is licensed under GNU General Public
+License, so you can use, modify and redistribute the program with
+almost no restrictions.  LilyPond is part of the 
+@uref{http://www.gnu.org/,GNU Project}.
+
+The version numbers are in Linux-kernel style: even numbered versions
+are `stable'. The webpages for the stable version (1.2) reside
+@uref{http://www.gnu.org/software/lilypond, on the GNU servers}. Big
+enhancements go into the latest odd numbered version (1.3), whose
+webpages are on @uref{http://www.cs.uu.nl/~hanwen/lilypond/,Han-Wen's
+site}.  Information on the latest and greatest features can be found in
+the @uref{Documentation/out-www/CHANGES.html, Change Log}.
 
 If want more information, you can browse the
 @uref{Documentation/user/out-www/lilypond.html, manual} or other
 @uref{Documentation/out-www/index.html, documentation}.
 
-
-@unnumberedsec News
-
-For the latest and greatest features, check out the
-@uref{Documentation/out-www/CHANGES.txt, Change Log}.
-
+@html
+<a name="music">
+@end html
 @unnumberedsec Sheet music
 
 
 If you are interested in sheet music typeset by LilyPond, have a look at
-the examples included. We have @uref{./input/out-www/index.html,short
-examples} and @uref{./mutopia/out-www/index.html,longer examples}. The
+the examples included. We have @uref{short-examples.html,short
+examples} and @uref{long-examples.html,longer examples}. The
 examples include sound bites  in MIDI, pictures in PNG, printable scores
-in PostScript, and LilyPond input.
-
-Other use LilyPond too.
-@uref{http://www.geocities.com/Vienna/Studio/1714/harpsichord.html,John
-Sankey}, harpsichordist to the internet, is typesetting the complete
-@uref{http://www.geocities.com/Vienna/Studio/1714/scarlattidwn.html/,sonatas
-by Scarlatti}. Jeff Covey, guitar player and overall nice guy, is
-putting @uref{http://www4.smart.net/~jcovey/scores/,guitar music} on the
-net. The @uref{http://sca.uwaterloo.ca/Mutopia/,Mutopia project} is a
-large archive of public domain sheet music under construction.
+in PostScript, and LilyPond input. Others use LilyPond too, and have put
+scores on the web. Head over to @uref{http://appel.lilypond.org/wiki?DownloadLilyPondScores}
 
+@html
+<a name="download-source">
+@end html
 @unnumberedsec Download
 
-If you want to compile LilyPond from sources,  download them here:
+If you want to compile LilyPond from source, download here:
 @itemize @bullet
-@item    Download stable releases at
-@uref{ftp://ftp.gnu.org/gnu/lilypond/}
-@item    Download development releases at
-@uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/development/}
-@item Canadian mirror   @uref{http://sca.uwaterloo.ca/lilypond/} and @uref{ftp://sca.uwaterloo.ca/pub/} 
-@item Another site in Europe
-@uref{ftp://ftp.lilypond.org/pub/LilyPond/}
+@item Download stable releases at
+@uref{ftp://ftp.gnu.org/gnu/lilypond/,GNU}
+@item Download development releases from
+@uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/development/, by FTP} and
+@uref{http://ftp.cs.uu.nl/pub/GNU/LilyPond/development/, by HTTP}.
+@item @uref{ftp://sca.uwaterloo.ca/pub/, ftp (Canadian mirror)} 
+@item @uref{ftp://ftp.lilypond.org/pub/LilyPond/, mirror (Europe)}
 @end itemize
 
 Installing and compiling requires many additional packages, which are
-listed in the  @uref{Documentation/topdocs/out-www/INSTALL.html, installation instructions}.
+listed in the @uref{Documentation/topdocs/out-www/INSTALL.html,
+installation instructions}.
 
-There are binaries available, but alas they are not updated for every version released.
+@html
+<a name="download-binary">
+@end html
+Binaries are available, but are not updated for every version released.
 @itemize @bullet
-@item RedHat i386
-binary RPMs:  @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/RPMS/}  
-
-@item Debian binary @uref{ftp://ftp.debian.org/pub/debian/dists/unstable/main/binary-i386/tex} 
-@item i386 RPM: @uref{http://linux.umbc.edu/software/lilypond/rpms/} 
-@item Windows NT: @uref{http://home.austin.rr.com/jbr/jeff/lilypond/}
+@item @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/RPMS/, RedHat i386}
+@item @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/RPMS/ppc, LinuxPPC}
+@item
+@uref{ftp://ftp.debian.org/debian/pool/main/l/lilypond,
+Debian GNU/Linux Stable} 
+@item
+@uref{ftp://ftp.debian.org/debian/pool/main/l/lilypond1.3,
+Debian GNU/Linux Unstable} 
+@item @uref{http://home.austin.rr.com/jbr/jeff/lilypond/, Windows Stable}
+@item @uref{http://appel.lilypond.org/lilypond/gnu-windows, Windows
+Testing}
 @end itemize
 
-@unnumberedsec Mailing list
 
-If you have questions do write to the mailing lists!
- (but don't forget to read the @uref{Documentation/out-www/faq.html,
-Frequently Asked Questions} first)
+@html
+<a name="mailing-lists">
+@end html
+@unnumberedsec Mailing lists
 
+If you have questions, do write to the mailing lists.  But don't forget
+to read the @uref{Documentation/topdocs/out-www/FAQ.html,Very Frequently
+Asked Questions} and @uref{http://appel.dyndns.org/wiki?LilyPondFaqs,
+Frequently Asked Questions} first.
 
-@table @samp
-@item info-gnu-music@@gnu.org
-        is a moderated list for information on the GNU Music project, to
-    subscribe: send mail with subject "subscribe" to
-    info-gnu-music-request@@gnu.org.  
 
-    As this list is moderated, normal people should ask to
+@itemize @bullet
+@item @uref{http://mail.gnu.org/mailman/listinfo/info-gnu-music,info-gnu-music@@gnu.org}
+is a low-volume list for information on the GNU Music project.
+    This list is moderated; ask 
     @email{drl@@gnu.org, David R. Linn} or
-    @email{hanwen@@cs.uu.nl, Han-Wen} to forward announces instead of
-    sending it to info-gnu-music@@gnu.org
+    @email{hanwen@@cs.uu.nl, Han-Wen} to send announcements for this list.
+@item @uref{http://mail.gnu.org/mailman/listinfo/help-gnu-music,help-gnu-music@@gnu.org}
+    For help with using LilyPond.
+@item @uref{http://mail.gnu.org/mailman/listinfo/bug-gnu-music,bug-gnu-music@@gnu.org}
+If you have bugreports, you should send them to this list.  
 
-   This list is archived at 
-    @uref{http://www.mail-archive.com/info-gnu-music@@gnu.org}
 
-@item help-gnu-music@@gnu.org
-    For help with LilyPond music project. To subscribe: send
-    mail with subject "subscribe" to
-    @email{help-gnu-music-request@@gnu.org} The archive is at 
-  @uref{http://www.mail-archive.com/help-gnu-music@@gnu.org}.
 
-@item bug-gnu-music@@gnu.org
-    If you have bugreports, you should send them to this list.  If you
-want to know about bugs, subscribe: send mail with subject "subscribe" to
-    @email{bug-gnu-music-request@@gnu.org}. The archive is at
-@uref{http://www.mail-archive.com/bug-gnu-music@@gnu.org}
-@item gnu-music-discuss@@gnu.org,
-    For discussions concerning LilyPond, to subscribe: send
-    mail with subject "subscribe" to
-    @email{gnu-music-discuss-request@@gnu.org}
-        The archive is at
-    @uref{http://www.mail-archive.com/gnu-music-discuss@@gnu.org}
-@end table
+        Please include in your bugreport the version of LilyPond that
+you experience the problem with, a description of your system and sample
+input to reproduce the problem. Do not send output files over the list,
+they tend to be very big and don't help with describing the problem.
 
 
+@item @uref{http://mail.gnu.org/mailman/listinfo/gnu-music-discuss,gnu-music-discuss@@gnu.org}
+    For discussions concerning LilyPond.
+@end itemize
 
-@unnumberedsubsec Webmaster's Disclaimer
-
-These pages were entirely created from a @strong{development snapshots}
+These pages were entirely created from a @strong{development snapshot}
 of the LilyPond package.  The version of this webpage is printed at the
-bottom. If you want to volunteer for making more beautiful webpages,
-then please mail us!
-
+bottom.
 
 @bye