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