]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/topdocs/index.tely
release: 1.3.52
[lilypond.git] / Documentation / topdocs / index.tely
index fcc04fa8d01a6944ab6acf27ba6cd1718abe12a9..86cd87f159509e1d1bfaf952c6219ff3bb65054c 100644 (file)
 \input texinfo @c -*-texinfo-*-
 @setfilename index.info
-@settitle index
+@settitle LilyPond homepage
 
 @node Top, , , (dir)
 @top
 
+@html
+<p align=center>
+[
+    <a href="#download">Download</a>
+    |
+    <a href="Documentation/out-www/faq.html">FAQ</a>
+    |
+    <a href="Documentation/out-www/index.html">Documentation</a>
+    |
+    <a href="#music">Music archives</a>
+    |
+    <a href="#mailing-lists">Mailing lists</a>
+    |
+    <a href="Documentation/out-www/CHANGES.txt">News</a>
+]
+@end html
+
+@html
+<p align=center>
+<img src="Documentation/pictures/out-www/lelie-logo.png" alt="[logo]">
+@end html
+@unnumberedsec LilyPond -- The GNU Project Music Typesetter
+
+@c something breaks on 3.12 f
+
+@unnumberedsec What is LilyPond?
+
+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.
+
+@unnumberedsec Why should I use it?
+
+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:
 
-
-@unnumbered LilyPond -- The @uref{http://www.fsf.org/gnu/gnu-history.html,GNU Project} Music Typesetter
-
-@center
 @quotation
-@mudela[fragment]
+@mudela[fragment,verbatim]
        \relative c'' { \key es; r8 [c16 b] [c8 g] [as c16 b] [c8 d] | g,4 }
 @end mudela 
 @end quotation
-@end center
 
-@c include BLURB?
+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.
 
-LilyPond is a music typesetter.  It produces beautiful sheet music
-using a high level description file as input.  LilyPond is part of 
-the GNU Project.
+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}.
 
-@c include screenshot
+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 at GNU,
+here: @uref{http://www.gnu.org/software/lilypond}. 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}.
 
+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 Sheet music
-    
 
-@itemize @bullet
+@unnumberedsec News
 
-@item @uref{./input/out-www/index.html,Examples}:
+For the latest and greatest features, check out the
+@uref{Documentation/out-www/CHANGES.txt, Change Log}.
 
-simple pieces, tests and bugs.  MIDI, PNG, PostScript, and Source.
 
-@item @uref{./mutopia/out-www/index.html,Music in Mutopia}:
+@html
+<a name="music">
+@end html
+@unnumberedsec Sheet music
 
-LilyPond handling real music.  MIDI, view PNG, PostScript, and Source.
-@end itemize
 
-@unnumberedsec Documentation
-    
+If you are interested in sheet music typeset by LilyPond, have a look at
+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.
+
+Others 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. Dirk
+Lattermann also put some works
+@uref{http://www.alqualonde.de/lilypond.html,on the web}.
+
+@html
+<a name="download">
+@end html
+@unnumberedsec Download
 
+If you want to compile LilyPond from source, download here:
 @itemize @bullet
-@item @uref{Documentation/tex/out-www/tutorial.html,Tutorial}
-@item @uref{Documentation/tex/out-www/reference-manual.html,Tutorial}
-@item @uref{Documentation/out-www/faq.html,FAQ}
-@item @uref{Documentation/out-www/mail.html,Mailing Lists}
-@item @uref{Documentation/out-www/index.html,All of the LilyPond documentation}
-@item @uref{./docxx/index.html,The DOC++ documentation of the C++ sources.}
-@item @uref{Documentation/topdocs/out-www/INSTALL.html,The installation instructions}
+@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/}
 @end itemize
 
-@unnumberedsec Sites
-    
+Installing and compiling requires many additional packages, which are
+listed in the @uref{Documentation/topdocs/out-www/INSTALL.html,
+installation instructions}.
 
+Binaries are available, but are not updated for every version released.
 @itemize @bullet
-@item @uref{http://www.gnu.org/software/...}  LilyPond is part of the GNU
-project.  The webpages for the stable version reside at GNU.
-
-@item @uref{http://www.cs.uu.nl/people/hanwen/lilypond/} Han-Wen's site
-has the development pages.
-@item @uref{http://sca.uwaterloo.ca/lilypond/} Eric's mirror
-@item @uref{http://home.austin.rr.com/jbr/jeff/lilypond/} Jeff's Windows NT Distribution site
+@item RedHat-i386 and Linuxppc 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 Windows NT: @uref{http://home.austin.rr.com/jbr/jeff/lilypond/}
 @end itemize
 
-@unnumberedsec NEWS
-    
 
-This is what the latest version brings:
-@example 
+@html
+<a name="mailing-lists">
+@end html
+@unnumberedsec Mailing list
 
-top_of_NEWS
-@end example 
+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.)
 
-@unnumberedsec Download
 
-@itemize @bullet
-@item @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/development/}
-@item @uref{http://sca.uwaterloo.ca/lilypond/}
-    Eric Praetzel was kind enough to provide a mirror of both the website
-    and the ftp site.
-@item  @uref{ftp://ftp.lilypond.org/pub/LilyPond/}
-       A mirror of the FTP site.  Updated at 0:00 MET daily. 
-@item @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/RPMS/} RedHat binary
-@item @uref{ftp://ftp.debian.org/pub/debian/dists/unstable/main/binary-i386/tex} Debian binary
-@item @uref{http://home.austin.rr.com/jbr/jeff/lilypond/} Windows NT binary
-@item @uref{http://linux.umbc.edu/software/lilypond/rpms/} i386 RPM.
-@item @uref{ftp://freshmeat.net/pub/rpms/lilypond/} i386 RPM.
-@end itemize
+@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.  
 
-@unnumberedsubsec Webmaster's Disclaimer
+    This list is moderated; ask 
+    @email{drl@@gnu.org, David R. Linn} or
+    @email{hanwen@@cs.uu.nl, Han-Wen} to send announcements for 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}
 
-These pages were entirely created from the LilyPond package-sources.
-Sorry for poor look they have: we want to be hacking at LilyPond, and
-not at the webpages.  If you want to volunteer for making shazzy
-webpages, then please mail us!
+        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.
 
-Note: These pages are created from the latest @strong{development snapshots}
-of LilyPond, specifically, this page was made from LilyPond
-(fixme-version).tar.gz
 
-Note: the pages may have been created from an unreleased development
-version.  Please have patience, all changes will appear in the
-official version.
+@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
+
+If you want to unsubscribe use the same procedure as subscribing, but
+substitute @code{unsubscribe} where you would put @code{subscribe}.
+
+@unnumberedsubsec Webmaster's Disclaimer
+
+These pages were entirely created from a @strong{development snapshots}
+of the LilyPond package.  The version of this webpage is printed at the
+bottom.
+
+@html
+<p align=center>
+[
+    <a href="#download">Download</a>
+    |
+    <a href="Documentation/out-www/faq.html">FAQ</a>
+    |
+    <a href="Documentation/out-www/index.html">Documentation</a>
+    |
+    <a href="#music">Music archives</a>
+    |
+    <a href="#mailing-lists">Mailing lists</a>
+    |
+    <a href="Documentation/out-www/CHANGES.txt">News</a>
+]
+@end html
 
 @bye