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