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