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
 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},
 175 and even
 176 @uref{examples.html#Schenker-Graphs, Schenker graphs}.
 177
 178 @end ifset
 179
 180 Browse our gallery of @ref{Examples} and be inspired!
 181
 182 @divEnd
 183
 184 @divClass{column-center-middle-color2}
 185 @subheading News
 186
 187 @c TODO: generate this automatically, including RSS feed.
 188 @include web/news-headlines.itexi
 189
 190 @ref{News, More news...}
 191
 192 @divEnd
 193
 194 @divEnd
 195
 196
 197 @ifclear web_version
 198   @c do nothing
 199 @end ifclear
 200 @ifset web_version
 201   @c make the side bar:
 202 @divId{homepage-sidebar}
 203 @subheading Stable Release
 204
 205 @c TODO: javascript to detect OS and suggest download?
 206
 207 @ref{Download, Download @versionStable}
 208
 209 @ref{Manuals, Manuals @versionStable}
 210
 211 @subheading Unstable Release
 212
 213 @ref{Development, Download @versionDevel}
 214
 215 @ref{Development, Manuals @versionDevel}
 216
 217 @subheading Pondings
 218 @divId{pondingsText}
 219
 220 @divEnd
 221
 222 @divEnd
 223 @end ifset
 224
 225
 226 @html
 227
 228 <script language="JavaScript" type="text/javascript">
 229   function loadXMLDoc(dname)
 230     {
 231       if (window.XMLHttpRequest)
 232         {
 233           xhttp=new XMLHttpRequest();
 234         }
 235       else
 236         {
 237           xhttp=new ActiveXObject("Microsoft.XMLHTTP");
 238         }
 239       xhttp.open("GET",dname,false);
 240       xhttp.send();
 241       return xhttp.responseXML;
 242     }
 243
 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;
 250 </script>
 251
 252 @end html
 253
 254
 255 @ifnottex
 256
 257 @divClass{hide}
 258 @menu
 259 * Introduction::     Start here to creating sheet music.
 260 * Download::         Get LilyPond.
 261 * Manuals::          Read The Fine Manuals (RTFM).
 262 * Community::        Contact other users.
 263 @end menu
 264 @divEnd
 265
 266 @end ifnottex
 267
 268 @contents
 269
 270 @allowcodebreaks false
 271
 272 @c ****************** GENERAL STUFF FOR INFO ************
 273 @ignore
 274 Distributions will want to install lilypond.info in postinstall, doing:
 275
 276     install-info --info-dir=/usr/share/info out[-www]/lilypond-web.info
 277
 278   * Prepend GNU for dir, must be unique.
 279
 280   * Do not list the `lilypond' node at toplevel, so that `info lilypond'
 281     goes to Top.
 282
 283   * List all commands in direntry.
 284
 285 @end ignore
 286
 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}
 291 @subheading Read it
 292
 293 @docLinksBare{\name\,\base\,\refLink\,\split\,\big\,\bigsize\,\pdf\,\pdfsize\}
 294
 295 @end macro
 296
 297
 298 @macro docLinkSplit{name,base,webLink}
 299   @docLink{\name\ (split HTML),\base\/index.html,\webLink\}
 300 @end macro
 301
 302 @macro docLinkBig{name,base,webLink}
 303   @docLink{\name\ (big HTML),\base\-big-page.html,\webLink\}
 304 @end macro
 305
 306 @macro docLinkPdf{name,base,webLink}
 307   @docLink{\base\.pdf,\base\.pdf,\webLink\}
 308 @end macro
 309
 310
 311 @macro docLinksBare{name,base,refLink,split,big,bigsize,pdf,pdfsize}
 312
 313 @divClass{keep-bullets}
 314 @itemize
 315
 316 @item @docLinkSplit{\name\,\base\,\split\} @minus{}
 317   the manual is split between many HTML pages.
 318   @*@ @ @emph{(small download for each page)}
 319
 320 @item @docLinkBig{\name\,\base\,\big\} @minus{}
 321   read this manual as one huge HTML page.
 322   @*@ @ @emph{(large single download, \bigsize\)}
 323
 324 @item @docLinkPdf{\name\,\base\,\pdf\} @minus{}
 325   download as a PDF file.
 326   @*@ @ @emph{(large single download, \pdfsize\)}
 327
 328 @end itemize
 329
 330 @divEnd
 331
 332 @end macro
 333
 334
 335 @c don't add any extra spaces in this macro -gp
 336 @macro ifWebLinks{webLink,normalLink}
 337 @ifclear web_version
 338   \normalLink\:
 339 @end ifclear
 340 @ifset web_version
 341   \webLink\:
 342 @end ifset
 343 @end macro
 344
 345
 346 @ifhtml
 347 @macro contactUsAbout{topic}
 348
 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}.
 358
 359 @divEnd
 360 @divEnd
 361
 362 @end macro
 363 @end ifhtml
 364
 365 @ifnothtml
 366 @macro contactUsAbout{topic}
 367 @cartouche
 368 If you are aware of any other \topic\ which could be listed here,
 369 please let us know by following the instructions on
 370 @ref{Bug reports}.
 371
 372 @end cartouche
 373
 374 @end macro
 375 @end ifnothtml
 376
 377 @include web/introduction.itexi
 378 @include web/download.itexi
 379 @include web/manuals.itexi
 380 @include web/community.itexi
 381
 382
 383 @bye