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