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