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 Learning Manual: (lilypond-learning).  Start here.
  60 * Music Glossary: (music-glossary).               For non-English users.
  61 * LilyPond: (lilypond-notation).                           LilyPond Notation Reference.
  62 * LilyPond Snippets: (lilypond-snippets).         Short tricks, tips, and examples.
  63 * LilyPond Internals Reference: (lilypond-internals).  Definitions for tweaking.
  64 * LilyPond Application Usage: (lilypond-usage). Installing and running applications.
  65 * LilyPond Website: (lilypond-web).    Preview of new website.
  66 * lilypond: (lilypond-usage)Running lilypond.      Invoking the LilyPond program.
  67 * abc2ly: (lilypond-usage)Invoking abc2ly.      Importing ABC.
  68 * convert-ly: (lilypond-usage)Updating files with convert-ly. Older LilyPond versions.
  69 * etf2ly: (lilypond-usage)Invoking etf2ly.      Importing Finale.
  70 * lilypond-book: (lilypond-usage)lilypond-book. Integrating text and music.
  71 * midi2ly: (lilypond-usage)Invoking midi2ly.    Importing MIDI.
  72 * musicxml2ly: (lilypond-usage)Invoking musicxml2ly.  Importing MusicXML.
  73 @end direntry
  74
  75
  76 @c TITLE PAGE
  77 @ifnottex
  78 @node Top
  79 @top LilyPond... music notation for everyone
  80 @end ifnottex
  81
  82
  83 @c hack for texi2html, bleh -gp
  84 @ifnothtml
  85
  86 @finalout
  87
  88 @titlepage
  89 @title LilyPond
  90 @subtitle The music typesetter
  91 @titlefont{General Information}
  92 @author The LilyPond development team
  93
  94 @vskip 0pt plus 1filll
  95 @c @vskip 20pt
  96
  97 @insertcopying
  98
  99 For LilyPond version @version{}
 100 @end titlepage
 101 @end ifnothtml
 102 @c end hack for texi2html
 103
 104
 105 @c ************************ WEBSITE START ***************
 106
 107
 108 @divId{pageHeader}
 109 @heading LilyPond
 110
 111 ... music notation for everyone
 112 @divEnd
 113
 114 @c @imageId{cmws,web-clef-g-eight-alpha.png,Catchy Musical Web Snippet}
 115 @imageId{lilylogo,double-lily-modified3,png,LilyPond logo}
 116 @c @im ageId{cmws,web-snippet-alpha.png,Catchy Musical Web Snippet}
 117
 118 @divId{quickSummary}
 119 @subheading What is LilyPond?
 120
 121 LilyPond is a music engraving program, devoted to producing the
 122 highest-quality sheet music possible.  It brings the aesthetics of
 123 traditionally engraved music to computer printouts.  LilyPond is free
 124 software and part of the @uref{http://gnu.org,GNU Project}.
 125
 126
 127 @divClass{align-right}
 128 Read more in our @ref{Introduction}!
 129
 130 @divEnd
 131 @divEnd
 132
 133 @divClass{separator}
 134 @divEnd
 135
 136
 137 @divId{news}
 138
 139 @c TODO: generate this automatically, including RSS feed.
 140 @include web/news-front.itexi
 141
 142 @divClass{float-right}
 143 (@ref{Old news})
 144 @divEnd
 145
 146 @divEnd
 147
 148 @ifclear web_version
 149   @c do nothing
 150 @end ifclear
 151 @ifset web_version
 152   @c make the box:
 153 @divId{latestVersion}
 154 @subheading Quick links
 155
 156 @c TODO: javascript to detect OS and suggest download?
 157
 158 @subsubheading Stable
 159
 160 @ref{Download, Download @versionStable}
 161
 162 @ref{Manuals, Manuals @versionStable}
 163
 164 @subsubheading Unstable
 165
 166 @ref{Development, Download @versionDevel}
 167
 168 @ref{Development, Manuals @versionDevel}
 169
 170 @divEnd
 171 @end ifset
 172
 173
 174 @ifnottex
 175
 176 @divClass{hide}
 177 @menu
 178 * Introduction::     Start here to creating sheet music.
 179 * Download::         Get LilyPond.
 180 * Manuals::          Read The Fine Manuals (RTFM).
 181 * Community::        Contact other users.
 182 @end menu
 183 @divEnd
 184
 185 @end ifnottex
 186
 187 @contents
 188
 189 @allowcodebreaks false
 190
 191 @c ****************** GENERAL STUFF FOR INFO ************
 192 @ignore
 193 Distributions will want to install lilypond.info in postinstall, doing:
 194
 195     install-info --info-dir=/usr/share/info out[-www]/lilypond-web.info
 196
 197   * Prepend GNU for dir, must be unique.
 198
 199   * Do not list the `lilypond' node at toplevel, so that `info lilypond'
 200     goes to Top.
 201
 202   * List all commands in direntry.
 203
 204 @end ignore
 205
 206 @c FIXME: this still doesn't solve the broken links in pdf and big
 207 @c        html; we'll need a bunch of @iftext and stuff in here. -gp
 208 @c ****************** SPECIAL MACROS FOR WEB MANUAL ************
 209 @macro docLinks{name,base,refLink,split,big,bigsize,pdf,pdfsize}
 210 @subheading Read it
 211
 212 @docLinksBare{\name\,\base\,\refLink\,\split\,\big\,\bigsize\,\pdf\,\pdfsize\}
 213
 214 @end macro
 215
 216
 217 @macro docLinkSplit{name,base,webLink}
 218   @docLink{\name\ (split HTML),\base\/index.html,\webLink\}
 219 @end macro
 220
 221 @macro docLinkBig{name,base,webLink}
 222   @docLink{\name\ (big HTML),\base\-big-page.html,\webLink\}
 223 @end macro
 224
 225 @macro docLinkPdf{name,base,webLink}
 226   @docLink{\base\.pdf,\base\.pdf,\webLink\}
 227 @end macro
 228
 229
 230 @macro docLinksBare{name,base,refLink,split,big,bigsize,pdf,pdfsize}
 231
 232 @divClass{keep-bullets}
 233 @itemize
 234
 235 @item @docLinkSplit{\name\,\base\,\split\} @minus{}
 236   the manual is split between many HTML pages.
 237   @*@ @ @emph{(small download for each page)}
 238
 239 @item @docLinkBig{\name\,\base\,\big\} @minus{}
 240   read this manual as one huge HTML page.
 241   @*@ @ @emph{(large single download, \bigsize\)}
 242
 243 @item @docLinkPdf{\name\,\base\,\pdf\} @minus{}
 244   download as a PDF file.
 245   @*@ @ @emph{(large single download, \pdfsize\)}
 246
 247 @end itemize
 248
 249 @divEnd
 250
 251 @end macro
 252
 253
 254 @c don't add any extra spaces in this macro -gp
 255 @macro ifWebLinks{webLink,normalLink}
 256 @ifclear web_version
 257   \normalLink\:
 258 @end ifclear
 259 @ifset web_version
 260   \webLink\:
 261 @end ifset
 262 @end macro
 263
 264
 265 @ifhtml
 266 @macro contactUsAbout{topic}
 267
 268 @divClass{heading-center}
 269 @divClass{contactBox}
 270 If you are aware of any other \topic\ which could be listed here,
 271 please let us know by following the instructions on
 272 @ref{Bug reports}.
 273
 274 @divEnd
 275 @divEnd
 276
 277 @end macro
 278 @end ifhtml
 279
 280 @ifnothtml
 281 @macro contactUsAbout{topic}
 282 @cartouche
 283 If you are aware of any other \topic\ which could be listed here,
 284 please let us know by following the instructions on
 285 @ref{Bug reports}.
 286
 287 @end cartouche
 288
 289 @end macro
 290 @end ifnothtml
 291
 292 @include web/introduction.itexi
 293 @include web/download.itexi
 294 @include web/manuals.itexi
 295 @include web/community.itexi
 296
 297
 298 @bye