X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fweb.texi;h=3081e4d3c8c01606492c1abd3a3bed374f991a8d;hb=HEAD;hp=e4058478bbc4c03c54930e6f00e7463f4b6c7b44;hpb=bd7f9b9e91e42e55acaa3f934ea8048ff449dc9f;p=lilypond.git diff --git a/Documentation/web.texi b/Documentation/web.texi index e4058478bb..3081e4d3c8 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 @@ -15,8 +16,8 @@ @set FDL @set web @include macros.itexi +@include weblinks.itexi -@afourpaper @c don't remove this comment. @ignore @@ -27,21 +28,55 @@ @omflanguage English @end ignore -@c `Web' was imported 2009-08-05 with git commit b938d71... +@c `Web' was born 2003-03-30 with this commit: +@c Initial revision +@c author: Han-Wen Nienhuys +@c commit: d189a2119004c2f75da2020ea2ed36d817582fc5 + +@c @macro copyrightDeclare +@c Copyright @copyright{} 2003--2015 by the authors. +@c @end macro + @copying -Copyright @copyright{} 2009 by the authors. +Copyright @copyright{} 2003--2015 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 document -under the terms of the GNU Free Documentation License, Version 1.1 -or any later version published by the Free Software Foundation; -with no Invariant Sections. -A copy of the license is included in the section entitled ``GNU -Free Documentation License''. +Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, +Version 1.1 or any later version published by the Free Software +Foundation; with no Invariant Sections. A copy of the license is +included in the section entitled ``GNU Free Documentation +License''. @end quotation @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 @@ -85,12 +120,11 @@ For LilyPond version @version{} @c @im ageId{cmws,web-snippet-alpha.png,Catchy Musical Web Snippet} @divId{quickSummary} -@subheading What is LilyPond? +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}. -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. @divClass{align-right} Read more in our @ref{Introduction}! @@ -98,41 +132,128 @@ Read more in our @ref{Introduction}! @divEnd @divEnd -@divClass{separator} + +@divId{homepage-main} + +@divClass{column-center-top} + +@subheading Beautiful Sheet Music + +@c This example image is the image from the website version of the essay +@c manual, downloaded to the pictures directory for use on the home page. +@c Large version is generated manually from ly file in pictures directory. +@divId{homepage-example-image-wrapper} +@imageClickable{bwv861-lilypond,png,,bwv861-lilypond-large,png,center} @divEnd +@ifclear web_version + @c no anchor links, just text + +LilyPond is a powerful and flexible tool for engraving tasks of +all kinds, for example classical music (like the example above by J.S. +Bach), complex notation, early music, modern music, tablature, +vocal music, lead sheets, educational materials, large +orchestral projects, customized output, and even Schenker graphs. + +@end ifclear +@ifset web_version + @c anchor links, link to individual examples by their tag + @c Translators should use the localized anchor name + @c (e.g. examples.html#Musica-Antica) + @c to be found in out-www/web/examples.LL.html + +LilyPond is a powerful and flexible tool for engraving tasks of +all kinds, for example +@uref{examples.html#Classical-Music, classical music} +(like the example above by J.S. Bach), +@uref{examples.html#Complex-Notation, complex notation}, +@uref{examples.html#Early-Music, early music}, +@uref{examples.html#Modern-Music, modern music}, +@uref{examples.html#Tablature, tablature}, +@uref{examples.html#Vocal-Music, vocal music}, +@uref{examples.html#Lead-Sheets, lead sheets}, +@uref{examples.html#Educational-Applications, educational materials}, +@uref{examples.html#Large-Projects, large orchestral projects}, +@uref{examples.html#Customized-Output, customized output}, +and even +@uref{examples.html#Schenker-Graphs, Schenker graphs}. + +@end ifset + +Browse our gallery of @ref{Examples} and be inspired! -@divId{news} +@divEnd + +@divClass{column-center-middle-color2} +@subheading News @c TODO: generate this automatically, including RSS feed. -@include web/news-front.itexi +@include web/news-headlines.itexi + +@ref{News, More news...} -@divClass{float-right} -(@ref{Old news}) @divEnd @divEnd -@divId{latestVersion} -@subheading Quick links +@ifclear web_version + @c do nothing +@end ifclear +@ifset web_version + @c make the side bar: +@divId{homepage-sidebar} +@subheading Stable Release @c TODO: javascript to detect OS and suggest download? -@subsubheading Stable - @ref{Download, Download @versionStable} @ref{Manuals, Manuals @versionStable} -@subsubheading Unstable +@subheading Unstable Release @ref{Development, Download @versionDevel} @ref{Development, Manuals @versionDevel} +@subheading Pondings +@divId{pondingsText} + @divEnd +@divEnd +@end ifset + + +@html + + + +@end html + @ifnottex @@ -149,6 +270,7 @@ Read more in our @ref{Introduction}! @contents +@allowcodebreaks false @c ****************** GENERAL STUFF FOR INFO ************ @ignore @@ -163,88 +285,97 @@ 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 ************ @macro docLinks{name,base,refLink,split,big,bigsize,pdf,pdfsize} @subheading Read it -@itemize +@docLinksBare{\name\,\base\,\refLink\,\split\,\big\,\bigsize\,\pdf\,\pdfsize\} -@c normal case, special online case -@ifclear web_version - @item \refLink\: -@end ifclear -@ifset web_version - @c we assume that the online web version will be split html - @item \split\: -@end ifset -read this manual in the same format as this one. +@end macro -@end itemize -@subheading All formats +@macro docLinkSplit{name,base,webLink} + @docLink{\name\ (split HTML),\base\/index.html,\webLink\} +@end macro + +@macro docLinkBig{name,base,webLink} + @docLink{\name\ (big HTML),\base\-big-page.html,\webLink\} +@end macro + +@macro docLinkPdf{name,base,webLink} + @docLink{\base\.pdf,\base\.pdf,\webLink\} +@end macro + + +@macro docLinksBare{name,base,refLink,split,big,bigsize,pdf,pdfsize} @divClass{keep-bullets} @itemize -@ifclear web_version - @item @uref{../\base\/index.html, \name\ (split HTML)}: -@end ifclear -@ifset web_version - @item \split\ -@end ifset +@item @docLinkSplit{\name\,\base\,\split\} @minus{} the manual is split between many HTML pages. @*@ @ @emph{(small download for each page)} -@ifclear web_version - @item @uref{../\base\-big-page.html, \name\ (big HTML)}: -@end ifclear -@ifset web_version - @item \big\ -@end ifset +@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\)} + +@end itemize + +@divEnd + +@end macro + + +@c don't add any extra spaces in this macro -gp +@macro ifWebLinks{webLink,normalLink} @ifclear web_version - @item @uref{../\base\.pdf, \base\.pdf}: + \normalLink\: @end ifclear @ifset web_version - @item \pdf\ + \webLink\: @end ifset - download as a PDF file. - @*@ @ @emph{(large single download, \pdfsize\)} +@end macro -@end itemize + +@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 writing a message to the bug-lilypond +mailing list. If you're not subscribed yet you can do so on the list's +@uref{https://lists.gnu.org/mailman/listinfo/bug-lilypond,info page} +or post directly through the +@uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs, +gmane lilypond.bugs web interface}. +@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