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 @c `Web' was imported 2009-08-05 with git commit b938d71...
  17 @c @macro copyrightDeclare
  18 @c Copyright @copyright{} 2009--2012 by the authors.
  19 @c @end macro
  20
  21 @set FDL
  22 @set web
  23 @include macros.itexi
  24 @include weblinks.itexi
  25
  26
  27 @c don't remove this comment.
  28 @ignore
  29 @omfcreator Graham Percival and Patrick McCarty
  30 @omfdescription General info about the LilyPond music engraving system
  31 @omftype program usage
  32 @omfcategory Applications|Publishing
  33 @omflanguage English
  34 @end ignore
  35
  36 @copying
  37 Copyright @copyright{} 2009--2012 by the authors.
  38
  39 @c next line is necessary for broken pre-4.13 texinfo's
  40 @c install-info, so leave it there until we officially
  41 @c bump the required version.  -gp
  42 This file documents the LilyPond website.
  43
  44 @quotation
  45 Permission is granted to copy, distribute and/or modify this
  46 document under the terms of the GNU Free Documentation License,
  47 Version 1.1 or any later version published by the Free Software
  48 Foundation; with no Invariant Sections.  A copy of the license is
  49 included in the section entitled ``GNU Free Documentation
  50 License''.
  51 @end quotation
  52 @end copying
  53
  54
  55 @c Info files are no longer installed in a subdirectory, images are
  56 @c expected to be found in lilypond/ subdirectory.
  57 @dircategory GNU LilyPond --- the music typesetter
  58 @direntry
  59 * LilyPond Internals Reference: (lilypond-internals).  Definitions for tweaking.
  60 * LilyPond Website: (lilypond-web).    Preview of new website.
  61 @end direntry
  62
  63
  64 @c TITLE PAGE
  65 @ifnottex
  66 @node Top
  67 @top LilyPond... music notation for everyone
  68 @end ifnottex
  69
  70
  71 @c hack for texi2html, bleh -gp
  72 @ifnothtml
  73
  74 @finalout
  75
  76 @titlepage
  77 @title LilyPond
  78 @subtitle The music typesetter
  79 @titlefont{General Information}
  80 @author The LilyPond development team
  81
  82 @vskip 0pt plus 1filll
  83 @c @vskip 20pt
  84
  85 @insertcopying
  86
  87 For LilyPond version @version{}
  88 @end titlepage
  89 @end ifnothtml
  90 @c end hack for texi2html
  91
  92
  93 @c ************************ WEBSITE START ***************
  94
  95
  96 @divId{pageHeader}
  97 @heading LilyPond
  98
  99 ... music notation for everyone
 100 @divEnd
 101
 102 @c @imageId{cmws,web-clef-g-eight-alpha.png,Catchy Musical Web Snippet}
 103 @imageId{lilylogo,double-lily-modified3,png,LilyPond logo}
 104 @c @im ageId{cmws,web-snippet-alpha.png,Catchy Musical Web Snippet}
 105
 106 @divId{quickSummary}
 107 @subheading What is LilyPond?
 108
 109 LilyPond is a music engraving program, devoted to producing the
 110 highest-quality sheet music possible.  It brings the aesthetics of
 111 traditionally engraved music to computer printouts.  LilyPond is free
 112 software and part of the @uref{http://gnu.org,GNU Project}.
 113
 114
 115 @divClass{align-right}
 116 Read more in our @ref{Introduction}!
 117
 118 @divEnd
 119 @divEnd
 120
 121 @divClass{separator}
 122 @divEnd
 123
 124
 125 @divId{news}
 126
 127 @c TODO: generate this automatically, including RSS feed.
 128 @include web/news-front.itexi
 129
 130 @divClass{float-right}
 131 (@ref{Old news})
 132 @divEnd
 133
 134 @divEnd
 135
 136 @ifclear web_version
 137   @c do nothing
 138 @end ifclear
 139 @ifset web_version
 140   @c make the box:
 141 @divId{wildCardBox}
 142 @subheading Pondings
 143 @divId{wildCardText}
 144
 145 @divEnd
 146 @divEnd
 147 @end ifset
 148
 149 @html
 150
 151 <script language="JavaScript" type="text/javascript">
 152   function loadXMLDoc(dname)
 153     {
 154       if (window.XMLHttpRequest)
 155         {
 156           xhttp=new XMLHttpRequest();
 157         }
 158       else
 159         {
 160           xhttp=new ActiveXObject("Microsoft.XMLHTTP");
 161         }
 162       xhttp.open("GET",dname,false);
 163       xhttp.send();
 164       return xhttp.responseXML;
 165     }
 166
 167   var xmlDoc = loadXMLDoc("tweets.xml");
 168   var tweets = xmlDoc.getElementsByTagName("tweet");
 169   var index = Math.floor(Math.random() * tweets.length);
 170   var tweet = tweets[index];
 171   var text = tweet.childNodes[0];
 172   document.getElementById("wildCardText").innerHTML = text.nodeValue;
 173 </script>
 174
 175 @end html
 176
 177 @ifset web_version
 178   @c make the box:
 179 @divId{latestVersion}
 180 @subheading Quick links
 181
 182 @c TODO: javascript to detect OS and suggest download?
 183
 184 @subsubheading Stable
 185
 186 @ref{Download, Download @versionStable}
 187
 188 @ref{Manuals, Manuals @versionStable}
 189
 190 @subsubheading Unstable
 191
 192 @ref{Development, Download @versionDevel}
 193
 194 @ref{Development, Manuals @versionDevel}
 195
 196 @divEnd
 197 @end ifset
 198
 199
 200 @ifnottex
 201
 202 @divClass{hide}
 203 @menu
 204 * Introduction::     Start here to creating sheet music.
 205 * Download::         Get LilyPond.
 206 * Manuals::          Read The Fine Manuals (RTFM).
 207 * Community::        Contact other users.
 208 @end menu
 209 @divEnd
 210
 211 @end ifnottex
 212
 213 @contents
 214
 215 @allowcodebreaks false
 216
 217 @c ****************** GENERAL STUFF FOR INFO ************
 218 @ignore
 219 Distributions will want to install lilypond.info in postinstall, doing:
 220
 221     install-info --info-dir=/usr/share/info out[-www]/lilypond-web.info
 222
 223   * Prepend GNU for dir, must be unique.
 224
 225   * Do not list the `lilypond' node at toplevel, so that `info lilypond'
 226     goes to Top.
 227
 228   * List all commands in direntry.
 229
 230 @end ignore
 231
 232 @c FIXME: this still doesn't solve the broken links in pdf and big
 233 @c        html; we'll need a bunch of @iftext and stuff in here. -gp
 234 @c ****************** SPECIAL MACROS FOR WEB MANUAL ************
 235 @macro docLinks{name,base,refLink,split,big,bigsize,pdf,pdfsize}
 236 @subheading Read it
 237
 238 @docLinksBare{\name\,\base\,\refLink\,\split\,\big\,\bigsize\,\pdf\,\pdfsize\}
 239
 240 @end macro
 241
 242
 243 @macro docLinkSplit{name,base,webLink}
 244   @docLink{\name\ (split HTML),\base\/index.html,\webLink\}
 245 @end macro
 246
 247 @macro docLinkBig{name,base,webLink}
 248   @docLink{\name\ (big HTML),\base\-big-page.html,\webLink\}
 249 @end macro
 250
 251 @macro docLinkPdf{name,base,webLink}
 252   @docLink{\base\.pdf,\base\.pdf,\webLink\}
 253 @end macro
 254
 255
 256 @macro docLinksBare{name,base,refLink,split,big,bigsize,pdf,pdfsize}
 257
 258 @divClass{keep-bullets}
 259 @itemize
 260
 261 @item @docLinkSplit{\name\,\base\,\split\} @minus{}
 262   the manual is split between many HTML pages.
 263   @*@ @ @emph{(small download for each page)}
 264
 265 @item @docLinkBig{\name\,\base\,\big\} @minus{}
 266   read this manual as one huge HTML page.
 267   @*@ @ @emph{(large single download, \bigsize\)}
 268
 269 @item @docLinkPdf{\name\,\base\,\pdf\} @minus{}
 270   download as a PDF file.
 271   @*@ @ @emph{(large single download, \pdfsize\)}
 272
 273 @end itemize
 274
 275 @divEnd
 276
 277 @end macro
 278
 279
 280 @c don't add any extra spaces in this macro -gp
 281 @macro ifWebLinks{webLink,normalLink}
 282 @ifclear web_version
 283   \normalLink\:
 284 @end ifclear
 285 @ifset web_version
 286   \webLink\:
 287 @end ifset
 288 @end macro
 289
 290
 291 @ifhtml
 292 @macro contactUsAbout{topic}
 293
 294 @divClass{heading-center}
 295 @divClass{contactBox}
 296 If you are aware of any other \topic\ which could be listed here,
 297 please let us know by writing a message to the bug-lilypond
 298 mailing list. If you're not subscribed yet you can do so on the list's
 299 @uref{https://lists.gnu.org/mailman/listinfo/bug-lilypond,info page}
 300 or post directly through the
 301 @uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs,
 302 gmane lilypond.bugs web interface}.
 303
 304 @divEnd
 305 @divEnd
 306
 307 @end macro
 308 @end ifhtml
 309
 310 @ifnothtml
 311 @macro contactUsAbout{topic}
 312 @cartouche
 313 If you are aware of any other \topic\ which could be listed here,
 314 please let us know by following the instructions on
 315 @ref{Bug reports}.
 316
 317 @end cartouche
 318
 319 @end macro
 320 @end ifnothtml
 321
 322 @include web/introduction.itexi
 323 @include web/download.itexi
 324 @include web/manuals.itexi
 325 @include web/community.itexi
 326
 327
 328 @bye