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