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