path: root/Documentation/web.texi

\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

@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

@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{} 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''.
@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}
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


@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 side bar:
@divId{homePageSideBar}
@subheading Stable Release

@c TODO: javascript to detect OS and suggest download?

@ref{Download, Download @versionStable}

@ref{Manuals, Manuals @versionStable}

@subheading Unstable Release

@ref{Development, Download @versionDevel}

@ref{Development, Manuals @versionDevel}

@subheading Pondings
@divId{pondingsText}

@divEnd

@divEnd
@end ifset


@html

<script language="JavaScript" type="text/javascript">
  function loadXMLDoc(dname)
    {
      if (window.XMLHttpRequest)
        {
          xhttp=new XMLHttpRequest();
        }
      else
        {
          xhttp=new ActiveXObject("Microsoft.XMLHTTP");
        }
      xhttp.open("GET",dname,false);
      xhttp.send();
      return xhttp.responseXML;
    }

  var xmlDoc = loadXMLDoc("tweets.xml");
  var tweets = xmlDoc.getElementsByTagName("tweet");
  var index = Math.floor(Math.random() * tweets.length);
  var tweet = tweets[index];
  var text = tweet.childNodes[0];
  document.getElementById("pondingsText").innerHTML = text.nodeValue;
</script>

@end html


@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}
  @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

@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 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
@include web/manuals.itexi
@include web/community.itexi


@bye