X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fweb.texi;fp=Documentation%2Fweb.texi;h=90d9f79251a326c12c8dba68bdb9cc829ca48e5a;hb=e90f0536f9be39ada0bef0aeb0d275dec3b2fb5b;hp=0000000000000000000000000000000000000000;hpb=a8c9e8a7ca320ab0df5fd32e717fd62cd7635ce6;p=lilypond.git diff --git a/Documentation/web.texi b/Documentation/web.texi new file mode 100644 index 0000000000..90d9f79251 --- /dev/null +++ b/Documentation/web.texi @@ -0,0 +1,313 @@ +\input texinfo @c -*- coding: utf-8; mode: texinfo; -*- +@ignore + Translation of GIT committish: FILL-IN-HEAD-COMMITTISH + + When revising a translation, copy the HEAD committish of the + version that you are working on. For details, see the Contributors' + Guide, node Updating translation committishes.. +@end ignore + +@setfilename web.info +@settitle LilyPond -- Music notation for everyone +@documentencoding UTF-8 +@documentlanguage en +@afourpaper + +@c `Web' was imported 2009-08-05 with git commit b938d71... +@c @macro copyrightDeclare +@c Copyright @copyright{} 2009--2011 by the authors. +@c @end macro + +@set FDL +@set web +@include macros.itexi +@include weblinks.itexi + + +@c don't remove this comment. +@ignore +@omfcreator Graham Percival and Patrick McCarty +@omfdescription General info about the LilyPond music engraving system +@omftype program usage +@omfcategory Applications|Publishing +@omflanguage English +@end ignore + +@copying +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 +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 +@top LilyPond... music notation for everyone +@end ifnottex + + +@c hack for texi2html, bleh -gp +@ifnothtml + +@finalout + +@titlepage +@title LilyPond +@subtitle The music typesetter +@titlefont{General Information} +@author The LilyPond development team + +@vskip 0pt plus 1filll +@c @vskip 20pt + +@insertcopying + +For LilyPond version @version{} +@end titlepage +@end ifnothtml +@c end hack for texi2html + + +@c ************************ WEBSITE START *************** + + +@divId{pageHeader} +@heading LilyPond + +... music notation for everyone +@divEnd + +@c @imageId{cmws,web-clef-g-eight-alpha.png,Catchy Musical Web Snippet} +@imageId{lilylogo,double-lily-modified3,png,LilyPond logo} +@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}. + + +@divClass{align-right} +Read more in our @ref{Introduction}! + +@divEnd +@divEnd + +@divClass{separator} +@divEnd + + +@divId{news} + +@c TODO: generate this automatically, including RSS feed. +@include web/news-front.itexi + +@divClass{float-right} +(@ref{Old news}) +@divEnd + +@divEnd + +@ifclear web_version + @c do nothing +@end ifclear +@ifset web_version + @c make the box: +@divId{latestVersion} +@subheading Quick links + +@c TODO: javascript to detect OS and suggest download? + +@subsubheading Stable + +@ref{Download, Download @versionStable} + +@ref{Manuals, Manuals @versionStable} + +@subsubheading Unstable + +@ref{Development, Download @versionDevel} + +@ref{Development, Manuals @versionDevel} + +@divEnd +@end ifset + + +@ifnottex + +@divClass{hide} +@menu +* Introduction:: Start here to creating sheet music. +* Download:: Get LilyPond. +* Manuals:: Read The Fine Manuals (RTFM). +* Community:: Contact other users. +@end menu +@divEnd + +@end ifnottex + +@contents + +@allowcodebreaks false + +@c ****************** GENERAL STUFF FOR INFO ************ +@ignore +Distributions will want to install lilypond.info in postinstall, doing: + + install-info --info-dir=/usr/share/info out[-www]/lilypond-web.info + + * Prepend GNU for dir, must be unique. + + * Do not list the `lilypond' node at toplevel, so that `info lilypond' + goes to Top. + + * List all commands in direntry. + +@end ignore + +@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 + +@docLinksBare{\name\,\base\,\refLink\,\split\,\big\,\bigsize\,\pdf\,\pdfsize\} + +@end macro + + +@macro docLinkSplit{name,base,webLink} +@ifclear web_version + @uref{../\base\/index.html, \name\ (split HTML)} +@end ifclear +@ifset web_version + \webLink\ +@end ifset +@end macro + +@macro docLinkBig{name,base,webLink} +@ifclear web_version + @uref{../\base\-big-page.html, \name\ (big HTML)} +@end ifclear +@ifset web_version + \webLink\ +@end ifset +@end macro + +@macro docLinkPdf{name,base,webLink} +@ifclear web_version + @uref{../\base\.pdf, \base\.pdf} +@end ifclear +@ifset web_version + \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\)} + +@end itemize + +@divEnd + +@end macro + + +@c don't add any extra spaces in this macro -gp +@macro ifWebLinks{webLink,normalLink} +@ifclear web_version + \normalLink\: +@end ifclear +@ifset web_version + \webLink\: +@end ifset +@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 +@include web/community.itexi + + +@bye