]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/web.texi
Doc-es: update Notation/Editorial.
[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{news}
137
138 @c TODO: generate this automatically, including RSS feed.
139 @include web/news-front.itexi
140
141 @divClass{float-right}
142 (@ref{Old news})
143 @divEnd
144
145 @divEnd
146
147
148 @ifclear web_version
149   @c do nothing
150 @end ifclear
151 @ifset web_version
152   @c make the side bar:
153 @divId{homePageSideBar}
154 @subheading Stable Release
155
156 @c TODO: javascript to detect OS and suggest download?
157
158 @ref{Download, Download @versionStable}
159
160 @ref{Manuals, Manuals @versionStable}
161
162 @subheading Unstable Release
163
164 @ref{Development, Download @versionDevel}
165
166 @ref{Development, Manuals @versionDevel}
167
168 @subheading Pondings
169 @divId{pondingsText}
170
171 @divEnd
172
173 @divEnd
174 @end ifset
175
176
177 @html
178
179 <script language="JavaScript" type="text/javascript">
180   function loadXMLDoc(dname)
181     {
182       if (window.XMLHttpRequest)
183         {
184           xhttp=new XMLHttpRequest();
185         }
186       else
187         {
188           xhttp=new ActiveXObject("Microsoft.XMLHTTP");
189         }
190       xhttp.open("GET",dname,false);
191       xhttp.send();
192       return xhttp.responseXML;
193     }
194
195   var xmlDoc = loadXMLDoc("tweets.xml");
196   var tweets = xmlDoc.getElementsByTagName("tweet");
197   var index = Math.floor(Math.random() * tweets.length);
198   var tweet = tweets[index];
199   var text = tweet.childNodes[0];
200   document.getElementById("pondingsText").innerHTML = text.nodeValue;
201 </script>
202
203 @end html
204
205
206 @ifnottex
207
208 @divClass{hide}
209 @menu
210 * Introduction::     Start here to creating sheet music.
211 * Download::         Get LilyPond.
212 * Manuals::          Read The Fine Manuals (RTFM).
213 * Community::        Contact other users.
214 @end menu
215 @divEnd
216
217 @end ifnottex
218
219 @contents
220
221 @allowcodebreaks false
222
223 @c ****************** GENERAL STUFF FOR INFO ************
224 @ignore
225 Distributions will want to install lilypond.info in postinstall, doing:
226
227     install-info --info-dir=/usr/share/info out[-www]/lilypond-web.info
228
229   * Prepend GNU for dir, must be unique.
230
231   * Do not list the `lilypond' node at toplevel, so that `info lilypond'
232     goes to Top.
233
234   * List all commands in direntry.
235
236 @end ignore
237
238 @c FIXME: this still doesn't solve the broken links in pdf and big
239 @c        html; we'll need a bunch of @iftext and stuff in here. -gp
240 @c ****************** SPECIAL MACROS FOR WEB MANUAL ************
241 @macro docLinks{name,base,refLink,split,big,bigsize,pdf,pdfsize}
242 @subheading Read it
243
244 @docLinksBare{\name\,\base\,\refLink\,\split\,\big\,\bigsize\,\pdf\,\pdfsize\}
245
246 @end macro
247
248
249 @macro docLinkSplit{name,base,webLink}
250   @docLink{\name\ (split HTML),\base\/index.html,\webLink\}
251 @end macro
252
253 @macro docLinkBig{name,base,webLink}
254   @docLink{\name\ (big HTML),\base\-big-page.html,\webLink\}
255 @end macro
256
257 @macro docLinkPdf{name,base,webLink}
258   @docLink{\base\.pdf,\base\.pdf,\webLink\}
259 @end macro
260
261
262 @macro docLinksBare{name,base,refLink,split,big,bigsize,pdf,pdfsize}
263
264 @divClass{keep-bullets}
265 @itemize
266
267 @item @docLinkSplit{\name\,\base\,\split\} @minus{}
268   the manual is split between many HTML pages.
269   @*@ @ @emph{(small download for each page)}
270
271 @item @docLinkBig{\name\,\base\,\big\} @minus{}
272   read this manual as one huge HTML page.
273   @*@ @ @emph{(large single download, \bigsize\)}
274
275 @item @docLinkPdf{\name\,\base\,\pdf\} @minus{}
276   download as a PDF file.
277   @*@ @ @emph{(large single download, \pdfsize\)}
278
279 @end itemize
280
281 @divEnd
282
283 @end macro
284
285
286 @c don't add any extra spaces in this macro -gp
287 @macro ifWebLinks{webLink,normalLink}
288 @ifclear web_version
289   \normalLink\:
290 @end ifclear
291 @ifset web_version
292   \webLink\:
293 @end ifset
294 @end macro
295
296
297 @ifhtml
298 @macro contactUsAbout{topic}
299
300 @divClass{heading-center}
301 @divClass{contactBox}
302 If you are aware of any other \topic\ which could be listed here,
303 please let us know by writing a message to the bug-lilypond
304 mailing list. If you're not subscribed yet you can do so on the list's
305 @uref{https://lists.gnu.org/mailman/listinfo/bug-lilypond,info page}
306 or post directly through the
307 @uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs,
308 gmane lilypond.bugs web interface}.
309
310 @divEnd
311 @divEnd
312
313 @end macro
314 @end ifhtml
315
316 @ifnothtml
317 @macro contactUsAbout{topic}
318 @cartouche
319 If you are aware of any other \topic\ which could be listed here,
320 please let us know by following the instructions on
321 @ref{Bug reports}.
322
323 @end cartouche
324
325 @end macro
326 @end ifnothtml
327
328 @include web/introduction.itexi
329 @include web/download.itexi
330 @include web/manuals.itexi
331 @include web/community.itexi
332
333
334 @bye