]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/web.texi
Doc-es: update Notation/Changing.
[lilypond.git] / Documentation / web.texi
1 \input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
2 @ignore
3     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
4
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..
8 @end ignore
9
10 @setfilename web.info
11 @settitle LilyPond -- Music notation for everyone
12 @documentencoding UTF-8
13 @documentlanguage en
14 @afourpaper
15
16 @set FDL
17 @set web
18 @include macros.itexi
19 @include weblinks.itexi
20
21
22 @c don't remove this comment.
23 @ignore
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
28 @omflanguage English
29 @end ignore
30
31 @c `Web' was born 2003-03-30 with this commit:
32 @c Initial revision
33 @c author: Han-Wen Nienhuys
34 @c commit: d189a2119004c2f75da2020ea2ed36d817582fc5
35
36 @c @macro copyrightDeclare
37 @c Copyright @copyright{} 2003--2015 by the authors.
38 @c @end macro
39
40 @copying
41 Copyright @copyright{} 2003--2015 by the authors.
42
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.
47
48 @quotation
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
54 License''.
55 @end quotation
56 @end copying
57
58
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
62 @direntry
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.
77 @end direntry
78
79
80 @c TITLE PAGE
81 @ifnottex
82 @node Top
83 @top LilyPond... music notation for everyone
84 @end ifnottex
85
86
87 @c hack for texi2html, bleh -gp
88 @ifnothtml
89
90 @finalout
91
92 @titlepage
93 @title LilyPond
94 @subtitle The music typesetter
95 @titlefont{General Information}
96 @author The LilyPond development team
97
98 @vskip 0pt plus 1filll
99 @c @vskip 20pt
100
101 @insertcopying
102
103 For LilyPond version @version{}
104 @end titlepage
105 @end ifnothtml
106 @c end hack for texi2html
107
108
109 @c ************************ WEBSITE START ***************
110
111
112 @divId{pageHeader}
113 @heading LilyPond
114
115 ... music notation for everyone
116 @divEnd
117
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}
121
122 @divId{quickSummary}
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}.
127
128
129 @divClass{align-right}
130 Read more in our @ref{Introduction}!
131
132 @divEnd
133 @divEnd
134
135
136 @divId{homepage-main}
137
138 @divClass{column-center-top}
139
140 @subheading Beautiful Sheet Music
141
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}
147 @divEnd
148
149 @ifclear web_version
150   @c no anchor links, just text
151
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.
157
158 @end ifclear
159 @ifset web_version
160   @c anchor links, link to individual examples by their <a> tag
161   @c Translators should use the localized anchor name
162   @c (e.g. examples.html#Musica-Antica)
163   @c to be found in out-www/web/examples.LL.html
164
165 LilyPond is a powerful and flexible tool for engraving tasks of
166 all kinds, for example
167 @uref{examples.html#Classical-Music, classical music}
168 (like the example above by J.S. Bach),
169 @uref{examples.html#Complex-Notation, complex notation},
170 @uref{examples.html#Early-Music, early music},
171 @uref{examples.html#Modern-Music, modern music},
172 @uref{examples.html#Tablature, tablature},
173 @uref{examples.html#Vocal-Music, vocal music},
174 @uref{examples.html#Lead-Sheets, lead sheets},
175 @uref{examples.html#Educational-Applications, educational materials},
176 @uref{examples.html#Large-Projects, large orchestral projects},
177 @uref{examples.html#Customized-Output, customized output},
178 and even
179 @uref{examples.html#Schenker-Graphs, Schenker graphs}.
180
181 @end ifset
182
183 Browse our gallery of @ref{Examples} and be inspired!
184
185 @divEnd
186
187 @divClass{column-center-middle-color2}
188 @subheading News
189
190 @c TODO: generate this automatically, including RSS feed.
191 @include web/news-headlines.itexi
192
193 @ref{News, More news...}
194
195 @divEnd
196
197 @divEnd
198
199
200 @ifclear web_version
201   @c do nothing
202 @end ifclear
203 @ifset web_version
204   @c make the side bar:
205 @divId{homepage-sidebar}
206 @subheading Stable Release
207
208 @c TODO: javascript to detect OS and suggest download?
209
210 @ref{Download, Download @versionStable}
211
212 @ref{Manuals, Manuals @versionStable}
213
214 @subheading Unstable Release
215
216 @ref{Development, Download @versionDevel}
217
218 @ref{Development, Manuals @versionDevel}
219
220 @subheading Pondings
221 @divId{pondingsText}
222
223 @divEnd
224
225 @divEnd
226 @end ifset
227
228
229 @html
230
231 <script language="JavaScript" type="text/javascript">
232   function loadXMLDoc(dname)
233     {
234       if (window.XMLHttpRequest)
235         {
236           xhttp=new XMLHttpRequest();
237         }
238       else
239         {
240           xhttp=new ActiveXObject("Microsoft.XMLHTTP");
241         }
242       xhttp.open("GET",dname,false);
243       xhttp.send();
244       return xhttp.responseXML;
245     }
246
247   var xmlDoc = loadXMLDoc("tweets.xml");
248   var tweets = xmlDoc.getElementsByTagName("tweet");
249   var index = Math.floor(Math.random() * tweets.length);
250   var tweet = tweets[index];
251   var text = tweet.childNodes[0];
252   document.getElementById("pondingsText").innerHTML = text.nodeValue;
253 </script>
254
255 @end html
256
257
258 @ifnottex
259
260 @divClass{hide}
261 @menu
262 * Introduction::     Start here to creating sheet music.
263 * Download::         Get LilyPond.
264 * Manuals::          Read The Fine Manuals (RTFM).
265 * Community::        Contact other users.
266 @end menu
267 @divEnd
268
269 @end ifnottex
270
271 @contents
272
273 @allowcodebreaks false
274
275 @c ****************** GENERAL STUFF FOR INFO ************
276 @ignore
277 Distributions will want to install lilypond.info in postinstall, doing:
278
279     install-info --info-dir=/usr/share/info out[-www]/lilypond-web.info
280
281   * Prepend GNU for dir, must be unique.
282
283   * Do not list the `lilypond' node at toplevel, so that `info lilypond'
284     goes to Top.
285
286   * List all commands in direntry.
287
288 @end ignore
289
290 @c FIXME: this still doesn't solve the broken links in pdf and big
291 @c        html; we'll need a bunch of @iftext and stuff in here. -gp
292 @c ****************** SPECIAL MACROS FOR WEB MANUAL ************
293 @macro docLinks{name,base,refLink,split,big,bigsize,pdf,pdfsize}
294 @subheading Read it
295
296 @docLinksBare{\name\,\base\,\refLink\,\split\,\big\,\bigsize\,\pdf\,\pdfsize\}
297
298 @end macro
299
300
301 @macro docLinkSplit{name,base,webLink}
302   @docLink{\name\ (split HTML),\base\/index.html,\webLink\}
303 @end macro
304
305 @macro docLinkBig{name,base,webLink}
306   @docLink{\name\ (big HTML),\base\-big-page.html,\webLink\}
307 @end macro
308
309 @macro docLinkPdf{name,base,webLink}
310   @docLink{\base\.pdf,\base\.pdf,\webLink\}
311 @end macro
312
313
314 @macro docLinksBare{name,base,refLink,split,big,bigsize,pdf,pdfsize}
315
316 @divClass{keep-bullets}
317 @itemize
318
319 @item @docLinkSplit{\name\,\base\,\split\} @minus{}
320   the manual is split between many HTML pages.
321   @*@ @ @emph{(small download for each page)}
322
323 @item @docLinkBig{\name\,\base\,\big\} @minus{}
324   read this manual as one huge HTML page.
325   @*@ @ @emph{(large single download, \bigsize\)}
326
327 @item @docLinkPdf{\name\,\base\,\pdf\} @minus{}
328   download as a PDF file.
329   @*@ @ @emph{(large single download, \pdfsize\)}
330
331 @end itemize
332
333 @divEnd
334
335 @end macro
336
337
338 @c don't add any extra spaces in this macro -gp
339 @macro ifWebLinks{webLink,normalLink}
340 @ifclear web_version
341   \normalLink\:
342 @end ifclear
343 @ifset web_version
344   \webLink\:
345 @end ifset
346 @end macro
347
348
349 @ifhtml
350 @macro contactUsAbout{topic}
351
352 @divClass{heading-center}
353 @divClass{contactBox}
354 If you are aware of any other \topic\ which could be listed here,
355 please let us know by writing a message to the bug-lilypond
356 mailing list. If you're not subscribed yet you can do so on the list's
357 @uref{https://lists.gnu.org/mailman/listinfo/bug-lilypond,info page}
358 or post directly through the
359 @uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs,
360 gmane lilypond.bugs web interface}.
361
362 @divEnd
363 @divEnd
364
365 @end macro
366 @end ifhtml
367
368 @ifnothtml
369 @macro contactUsAbout{topic}
370 @cartouche
371 If you are aware of any other \topic\ which could be listed here,
372 please let us know by following the instructions on
373 @ref{Bug reports}.
374
375 @end cartouche
376
377 @end macro
378 @end ifnothtml
379
380 @include web/introduction.itexi
381 @include web/download.itexi
382 @include web/manuals.itexi
383 @include web/community.itexi
384
385
386 @bye