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