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--2014 by the authors.
41 Copyright @copyright{} 2003--2014 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 @subheading What is LilyPond?
125 LilyPond is a music engraving program, devoted to producing the
126 highest-quality sheet music possible. It brings the aesthetics of
127 traditionally engraved music to computer printouts. LilyPond is free
128 software and part of the @uref{http://gnu.org,GNU Project}.
131 @divClass{align-right}
132 Read more in our @ref{Introduction}!
143 @c TODO: generate this automatically, including RSS feed.
144 @include web/news-front.itexi
146 @divClass{float-right}
167 <script language="JavaScript" type="text/javascript">
168 function loadXMLDoc(dname)
170 if (window.XMLHttpRequest)
172 xhttp=new XMLHttpRequest();
176 xhttp=new ActiveXObject("Microsoft.XMLHTTP");
178 xhttp.open("GET",dname,false);
180 return xhttp.responseXML;
183 var xmlDoc = loadXMLDoc("tweets.xml");
184 var tweets = xmlDoc.getElementsByTagName("tweet");
185 var index = Math.floor(Math.random() * tweets.length);
186 var tweet = tweets[index];
187 var text = tweet.childNodes[0];
188 document.getElementById("wildCardText").innerHTML = text.nodeValue;
195 @divId{latestVersion}
196 @subheading Quick links
198 @c TODO: javascript to detect OS and suggest download?
200 @subsubheading Stable
202 @ref{Download, Download @versionStable}
204 @ref{Manuals, Manuals @versionStable}
206 @subsubheading Unstable
208 @ref{Development, Download @versionDevel}
210 @ref{Development, Manuals @versionDevel}
220 * Introduction:: Start here to creating sheet music.
221 * Download:: Get LilyPond.
222 * Manuals:: Read The Fine Manuals (RTFM).
223 * Community:: Contact other users.
231 @allowcodebreaks false
233 @c ****************** GENERAL STUFF FOR INFO ************
235 Distributions will want to install lilypond.info in postinstall, doing:
237 install-info --info-dir=/usr/share/info out[-www]/lilypond-web.info
239 * Prepend GNU for dir, must be unique.
241 * Do not list the `lilypond' node at toplevel, so that `info lilypond'
244 * List all commands in direntry.
248 @c FIXME: this still doesn't solve the broken links in pdf and big
249 @c html; we'll need a bunch of @iftext and stuff in here. -gp
250 @c ****************** SPECIAL MACROS FOR WEB MANUAL ************
251 @macro docLinks{name,base,refLink,split,big,bigsize,pdf,pdfsize}
254 @docLinksBare{\name\,\base\,\refLink\,\split\,\big\,\bigsize\,\pdf\,\pdfsize\}
259 @macro docLinkSplit{name,base,webLink}
260 @docLink{\name\ (split HTML),\base\/index.html,\webLink\}
263 @macro docLinkBig{name,base,webLink}
264 @docLink{\name\ (big HTML),\base\-big-page.html,\webLink\}
267 @macro docLinkPdf{name,base,webLink}
268 @docLink{\base\.pdf,\base\.pdf,\webLink\}
272 @macro docLinksBare{name,base,refLink,split,big,bigsize,pdf,pdfsize}
274 @divClass{keep-bullets}
277 @item @docLinkSplit{\name\,\base\,\split\} @minus{}
278 the manual is split between many HTML pages.
279 @*@ @ @emph{(small download for each page)}
281 @item @docLinkBig{\name\,\base\,\big\} @minus{}
282 read this manual as one huge HTML page.
283 @*@ @ @emph{(large single download, \bigsize\)}
285 @item @docLinkPdf{\name\,\base\,\pdf\} @minus{}
286 download as a PDF file.
287 @*@ @ @emph{(large single download, \pdfsize\)}
296 @c don't add any extra spaces in this macro -gp
297 @macro ifWebLinks{webLink,normalLink}
308 @macro contactUsAbout{topic}
310 @divClass{heading-center}
311 @divClass{contactBox}
312 If you are aware of any other \topic\ which could be listed here,
313 please let us know by writing a message to the bug-lilypond
314 mailing list. If you're not subscribed yet you can do so on the list's
315 @uref{https://lists.gnu.org/mailman/listinfo/bug-lilypond,info page}
316 or post directly through the
317 @uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs,
318 gmane lilypond.bugs web interface}.
327 @macro contactUsAbout{topic}
329 If you are aware of any other \topic\ which could be listed here,
330 please let us know by following the instructions on
338 @include web/introduction.itexi
339 @include web/download.itexi
340 @include web/manuals.itexi
341 @include web/community.itexi