X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fweb.texi;h=90d9f79251a326c12c8dba68bdb9cc829ca48e5a;hb=1d509b27723ea1c359b51c0f2fe623a32867d6f9;hp=a8e5e0e20212957db8481fdb004d6dfa45b5dce1;hpb=4abaa5a03e2dc9d857ef86c152bd014c76b6139d;p=lilypond.git diff --git a/Documentation/web.texi b/Documentation/web.texi index a8e5e0e202..90d9f79251 100644 --- a/Documentation/web.texi +++ b/Documentation/web.texi @@ -3,7 +3,8 @@ Translation of GIT committish: FILL-IN-HEAD-COMMITTISH When revising a translation, copy the HEAD committish of the - version that you are working on. See TRANSLATION for details. + version that you are working on. For details, see the Contributors' + Guide, node Updating translation committishes.. @end ignore @setfilename web.info @@ -14,14 +15,14 @@ @c `Web' was imported 2009-08-05 with git commit b938d71... @c @macro copyrightDeclare -@c Copyright @copyright{} 2009 by the authors. +@c Copyright @copyright{} 2009--2011 by the authors. @c @end macro @set FDL @set web @include macros.itexi +@include weblinks.itexi -@afourpaper @c don't remove this comment. @ignore @@ -33,7 +34,12 @@ @end ignore @copying -Copyright @copyright{} 2009 by the authors. +Copyright @copyright{} 2009--2011 by the authors. + +@c next line is necessary for broken pre-4.13 texinfo's +@c install-info, so leave it there until we officially +@c bump the required version. -gp +This file documents the LilyPond website. @quotation Permission is granted to copy, distribute and/or modify this @@ -46,6 +52,27 @@ License''. @end copying +@c Info files are no longer installed in a subdirectory, images are +@c expected to be found in lilypond/ subdirectory. +@dircategory GNU LilyPond --- the music typesetter +@direntry +* LilyPond Learning Manual: (lilypond-learning). Start here. +* Music Glossary: (music-glossary). For non-English users. +* LilyPond: (lilypond-notation). LilyPond Notation Reference. +* LilyPond Snippets: (lilypond-snippets). Short tricks, tips, and examples. +* LilyPond Internals Reference: (lilypond-internals). Definitions for tweaking. +* LilyPond Application Usage: (lilypond-usage). Installing and running applications. +* LilyPond Website: (lilypond-web). Preview of new website. +* lilypond: (lilypond-usage)Running lilypond. Invoking the LilyPond program. +* abc2ly: (lilypond-usage)Invoking abc2ly. Importing ABC. +* convert-ly: (lilypond-usage)Updating files with convert-ly. Older LilyPond versions. +* etf2ly: (lilypond-usage)Invoking etf2ly. Importing Finale. +* lilypond-book: (lilypond-usage)lilypond-book. Integrating text and music. +* midi2ly: (lilypond-usage)Invoking midi2ly. Importing MIDI. +* musicxml2ly: (lilypond-usage)Invoking musicxml2ly. Importing MusicXML. +@end direntry + + @c TITLE PAGE @ifnottex @node Top @@ -91,10 +118,11 @@ For LilyPond version @version{} @divId{quickSummary} @subheading What is LilyPond? -LilyPond is an open-source music engraving program, devoted to -producing the highest-quality sheet music possible. This free -software brings the aesthetics of traditionally engraved music to -computer printouts. +LilyPond is a music engraving program, devoted to producing the +highest-quality sheet music possible. It brings the aesthetics of +traditionally engraved music to computer printouts. LilyPond is free +software and part of the @uref{http://gnu.org,GNU Project}. + @divClass{align-right} Read more in our @ref{Introduction}! @@ -158,6 +186,7 @@ Read more in our @ref{Introduction}! @contents +@allowcodebreaks false @c ****************** GENERAL STUFF FOR INFO ************ @ignore @@ -172,30 +201,8 @@ Distributions will want to install lilypond.info in postinstall, doing: * List all commands in direntry. -@c * lilypond: (lilypond-application)Running LilyPond. Invoking the -@c LilyPond program. @end ignore -@c Info files are no longer installed in a subdirectory, images are -@c expected to be found in lilypond/ subdirectory. -@dircategory GNU LilyPond --- the music typesetter -@direntry -* LilyPond Learning Manual: (lilypond-learning). Start here. -* Music Glossary: (music-glossary). For non-English users. -* LilyPond: (lilypond-notation). LilyPond Notation Reference. -* LilyPond Snippets: (lilypond-snippets). Short tricks, tips, and examples. -* LilyPond Internals Reference: (lilypond-internals). Definitions for tweaking. -* LilyPond Application Usage: (lilypond-application). Installing and running applications. -* LilyPond Website: (lilypond-general). Preview of new website. -* abc2ly: (lilypond-application)Invoking abc2ly. Importing ABC. -* convert-ly: (lilypond-application)Updating files with convert-ly. Older LilyPond versions. -* etf2ly: (lilypond-application)Invoking etf2ly. Importing Finale. -* lilypond-book: (lilypond-application)LilyPond-book. Integrating text and music. -* midi2ly: (lilypond-application)Invoking midi2ly. Importing MIDI. -* musicxml2ly: (lilypond-application)Invoking musicxml2ly. Importing MusicXML. -@end direntry - - @c FIXME: this still doesn't solve the broken links in pdf and big @c html; we'll need a bunch of @iftext and stuff in here. -gp @c ****************** SPECIAL MACROS FOR WEB MANUAL ************ @@ -207,35 +214,48 @@ Distributions will want to install lilypond.info in postinstall, doing: @end macro -@macro docLinksBare{name,base,refLink,split,big,bigsize,pdf,pdfsize} - -@divClass{keep-bullets} -@itemize - +@macro docLinkSplit{name,base,webLink} @ifclear web_version - @item @uref{../\base\/index.html, \name\ (split HTML)}: + @uref{../\base\/index.html, \name\ (split HTML)} @end ifclear @ifset web_version - @item \split\: + \webLink\ @end ifset - the manual is split between many HTML pages. - @*@ @ @emph{(small download for each page)} +@end macro +@macro docLinkBig{name,base,webLink} @ifclear web_version - @item @uref{../\base\-big-page.html, \name\ (big HTML)}: + @uref{../\base\-big-page.html, \name\ (big HTML)} @end ifclear @ifset web_version - @item \big\: + \webLink\ @end ifset - read this manual as one huge HTML page. - @*@ @ @emph{(large single download, \bigsize\)} +@end macro +@macro docLinkPdf{name,base,webLink} @ifclear web_version - @item @uref{../\base\.pdf, \base\.pdf}: + @uref{../\base\.pdf, \base\.pdf} @end ifclear @ifset web_version - @item \pdf\: + \webLink\ @end ifset +@end macro + + +@macro docLinksBare{name,base,refLink,split,big,bigsize,pdf,pdfsize} + +@divClass{keep-bullets} +@itemize + +@item @docLinkSplit{\name\,\base\,\split\} @minus{} + the manual is split between many HTML pages. + @*@ @ @emph{(small download for each page)} + +@item @docLinkBig{\name\,\base\,\big\} @minus{} + read this manual as one huge HTML page. + @*@ @ @emph{(large single download, \bigsize\)} + +@item @docLinkPdf{\name\,\base\,\pdf\} @minus{} download as a PDF file. @*@ @ @emph{(large single download, \pdfsize\)} @@ -257,6 +277,33 @@ Distributions will want to install lilypond.info in postinstall, doing: @end macro +@ifhtml +@macro contactUsAbout{topic} + +@divClass{heading-center} +@divClass{contactBox} +If you are aware of any other \topic\ which could be listed here, +please let us know by following the instructions on +@ref{Bug reports}. + +@divEnd +@divEnd + +@end macro +@end ifhtml + +@ifnothtml +@macro contactUsAbout{topic} +@cartouche +If you are aware of any other \topic\ which could be listed here, +please let us know by following the instructions on +@ref{Bug reports}. + +@end cartouche + +@end macro +@end ifnothtml + @include web/introduction.itexi @include web/download.itexi @include web/manuals.itexi