1 \input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
11 @settitle LilyPond -- Music notation for everyone
12 @documentencoding UTF-8
19 @include weblinks.itexi
22 @c don't remove this comment.
24 @omfcreator Graham Percival and Patrick McCarty
25 @omfdescription General info about the LilyPond music engraving system
26 @omftype program usage
27 @omfcategory Applications|Publishing
31 @c `Web' was born 2003-03-30 with this commit:
33 @c author: Han-Wen Nienhuys
34 @c commit: d189a2119004c2f75da2020ea2ed36d817582fc5
36 @c @macro copyrightDeclare
37 @c Copyright @copyright{} 2003--2015 by the authors.
41 Copyright @copyright{} 2003--2015 by the authors.
43 @c next line is necessary for broken pre-4.13 texinfo's
44 @c install-info, so leave it there until we officially
45 @c bump the required version. -gp
46 This file documents the LilyPond website.
49 Permission is granted to copy, distribute and/or modify this
50 document under the terms of the GNU Free Documentation License,
51 Version 1.1 or any later version published by the Free Software
52 Foundation; with no Invariant Sections. A copy of the license is
53 included in the section entitled ``GNU Free Documentation
59 @c Info files are no longer installed in a subdirectory, images are
60 @c expected to be found in lilypond/ subdirectory.
61 @dircategory GNU LilyPond --- the music typesetter
63 * LilyPond Learning Manual: (lilypond-learning). Start here.
64 * Music Glossary: (music-glossary). For non-English users.
65 * LilyPond: (lilypond-notation). LilyPond Notation Reference.
66 * LilyPond Snippets: (lilypond-snippets). Short tricks, tips, and examples.
67 * LilyPond Internals Reference: (lilypond-internals). Definitions for tweaking.
68 * LilyPond Application Usage: (lilypond-usage). Installing and running applications.
69 * LilyPond Website: (lilypond-web). Preview of new website.
70 * lilypond: (lilypond-usage)Running lilypond. Invoking the LilyPond program.
71 * abc2ly: (lilypond-usage)Invoking abc2ly. Importing ABC.
72 * convert-ly: (lilypond-usage)Updating files with convert-ly. Older LilyPond versions.
73 * etf2ly: (lilypond-usage)Invoking etf2ly. Importing Finale.
74 * lilypond-book: (lilypond-usage)lilypond-book. Integrating text and music.
75 * midi2ly: (lilypond-usage)Invoking midi2ly. Importing MIDI.
76 * musicxml2ly: (lilypond-usage)Invoking musicxml2ly. Importing MusicXML.
83 @top LilyPond... music notation for everyone
87 @c hack for texi2html, bleh -gp
94 @subtitle The music typesetter
95 @titlefont{General Information}
96 @author The LilyPond development team
98 @vskip 0pt plus 1filll
103 For LilyPond version @version{}
106 @c end hack for texi2html
109 @c ************************ WEBSITE START ***************
115 ... music notation for everyone
118 @c @imageId{cmws,web-clef-g-eight-alpha.png,Catchy Musical Web Snippet}
119 @imageId{lilylogo,double-lily-modified3,png,LilyPond logo}
120 @c @im ageId{cmws,web-snippet-alpha.png,Catchy Musical Web Snippet}
123 LilyPond is a music engraving program, devoted to producing the
124 highest-quality sheet music possible. It brings the aesthetics of
125 traditionally engraved music to computer printouts. LilyPond is free
126 software and part of the @uref{http://gnu.org,GNU Project}.
129 @divClass{align-right}
130 Read more in our @ref{Introduction}!
136 @divId{homepage-main}
138 @divClass{column-center-top}
140 @subheading Beautiful Sheet Music
142 @c This example image is the image from the website version of the essay
143 @c manual, downloaded to the pictures directory for use on the home page.
144 @c Large version is generated manually from ly file in pictures directory.
145 @divId{homepage-example-image-wrapper}
146 @imageClickable{bwv861-lilypond,png,,bwv861-lilypond-large,png,center}
150 @c no anchor links, just text
152 LilyPond is a powerful and flexible tool for engraving tasks of
153 all kinds, for example classical music (like the example above by J.S.
154 Bach), complex notation, early music, modern music, tablature,
155 vocal music, lead sheets, educational materials, large
156 orchestral projects, customized output, and even Schenker graphs.
160 @c anchor links, link to individual examples by their <a> tag
162 LilyPond is a powerful and flexible tool for engraving tasks of
163 all kinds, for example
164 @uref{http://lilypond.org/examples.html#Classical-Music, classical music}
165 (like the example above by J.S. Bach),
166 @uref{examples.html#Complex-Notation, complex notation},
167 @uref{examples.html#Early-Music, early music},
168 @uref{examples.html#Modern-Music, modern music},
169 @uref{examples.html#Tablature, tablature},
170 @uref{examples.html#Vocal-Music, vocal music},
171 @uref{examples.html#Lead-Sheets, lead sheets},
172 @uref{examples.html#Educational-Applications, educational materials},
173 @uref{examples.html#Large-Projects, large orchestral projects},
174 @uref{examples.html#Customized-Output, customized output},
176 @uref{examples.html#Schenker-Graphs, Schenker graphs}.
180 Browse our gallery of @ref{Examples} and be inspired!
184 @divClass{column-center-middle-color2}
187 @c TODO: generate this automatically, including RSS feed.
188 @include web/news-headlines.itexi
190 @ref{News, More news...}
201 @c make the side bar:
202 @divId{homepage-sidebar}
203 @subheading Stable Release
205 @c TODO: javascript to detect OS and suggest download?
207 @ref{Download, Download @versionStable}
209 @ref{Manuals, Manuals @versionStable}
211 @subheading Unstable Release
213 @ref{Development, Download @versionDevel}
215 @ref{Development, Manuals @versionDevel}
228 <script language="JavaScript" type="text/javascript">
229 function loadXMLDoc(dname)
231 if (window.XMLHttpRequest)
233 xhttp=new XMLHttpRequest();
237 xhttp=new ActiveXObject("Microsoft.XMLHTTP");
239 xhttp.open("GET",dname,false);
241 return xhttp.responseXML;
244 var xmlDoc = loadXMLDoc("tweets.xml");
245 var tweets = xmlDoc.getElementsByTagName("tweet");
246 var index = Math.floor(Math.random() * tweets.length);
247 var tweet = tweets[index];
248 var text = tweet.childNodes[0];
249 document.getElementById("pondingsText").innerHTML = text.nodeValue;
259 * Introduction:: Start here to creating sheet music.
260 * Download:: Get LilyPond.
261 * Manuals:: Read The Fine Manuals (RTFM).
262 * Community:: Contact other users.
270 @allowcodebreaks false
272 @c ****************** GENERAL STUFF FOR INFO ************
274 Distributions will want to install lilypond.info in postinstall, doing:
276 install-info --info-dir=/usr/share/info out[-www]/lilypond-web.info
278 * Prepend GNU for dir, must be unique.
280 * Do not list the `lilypond' node at toplevel, so that `info lilypond'
283 * List all commands in direntry.
287 @c FIXME: this still doesn't solve the broken links in pdf and big
288 @c html; we'll need a bunch of @iftext and stuff in here. -gp
289 @c ****************** SPECIAL MACROS FOR WEB MANUAL ************
290 @macro docLinks{name,base,refLink,split,big,bigsize,pdf,pdfsize}
293 @docLinksBare{\name\,\base\,\refLink\,\split\,\big\,\bigsize\,\pdf\,\pdfsize\}
298 @macro docLinkSplit{name,base,webLink}
299 @docLink{\name\ (split HTML),\base\/index.html,\webLink\}
302 @macro docLinkBig{name,base,webLink}
303 @docLink{\name\ (big HTML),\base\-big-page.html,\webLink\}
306 @macro docLinkPdf{name,base,webLink}
307 @docLink{\base\.pdf,\base\.pdf,\webLink\}
311 @macro docLinksBare{name,base,refLink,split,big,bigsize,pdf,pdfsize}
313 @divClass{keep-bullets}
316 @item @docLinkSplit{\name\,\base\,\split\} @minus{}
317 the manual is split between many HTML pages.
318 @*@ @ @emph{(small download for each page)}
320 @item @docLinkBig{\name\,\base\,\big\} @minus{}
321 read this manual as one huge HTML page.
322 @*@ @ @emph{(large single download, \bigsize\)}
324 @item @docLinkPdf{\name\,\base\,\pdf\} @minus{}
325 download as a PDF file.
326 @*@ @ @emph{(large single download, \pdfsize\)}
335 @c don't add any extra spaces in this macro -gp
336 @macro ifWebLinks{webLink,normalLink}
347 @macro contactUsAbout{topic}
349 @divClass{heading-center}
350 @divClass{contactBox}
351 If you are aware of any other \topic\ which could be listed here,
352 please let us know by writing a message to the bug-lilypond
353 mailing list. If you're not subscribed yet you can do so on the list's
354 @uref{https://lists.gnu.org/mailman/listinfo/bug-lilypond,info page}
355 or post directly through the
356 @uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs,
357 gmane lilypond.bugs web interface}.
366 @macro contactUsAbout{topic}
368 If you are aware of any other \topic\ which could be listed here,
369 please let us know by following the instructions on
377 @include web/introduction.itexi
378 @include web/download.itexi
379 @include web/manuals.itexi
380 @include web/community.itexi