X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fweb%2Fmanuals.itexi;h=0484ecab20c621e0bd1edb8c69968b53872fe9ce;hb=8848da24e00c75d7de626b2ecc409fb45e87ce4a;hp=ef207486355980712a61540700eaf98a3101a282;hpb=d9fcd3db46970a4afbc4e073abb2156ecc865981;p=lilypond.git diff --git a/Documentation/web/manuals.itexi b/Documentation/web/manuals.itexi index ef20748635..0484ecab20 100644 --- a/Documentation/web/manuals.itexi +++ b/Documentation/web/manuals.itexi @@ -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 @node Manuals @@ -15,7 +16,6 @@ @spanEnd @end macro - @divClass{heading-center} @ifclear web_version @heading Manuals for LilyPond @version @@ -26,32 +26,32 @@ @divEnd -@c TODO: do we want these links to be in larger text / bold ? CSS. +@divClass{link-headings} @divClass{column-center-top} @subheading Introduction @itemize -@item @ref{Text input}: -LilyPond is a @strong{text-based} music engraver. Read this -first! +@item +@ref{Text input}: +LilyPond is a @strong{text-based} music engraver. Read this first! -@item @ifWebLinks{@manualStableLearningSplitNoName,@rlearningnamed{Top,Learning}} +@item +@ifWebLinks{@manualStableLearningSplitNoName,@rlearningnamed{Top,Learning}} a @qq{must-read} gentle introduction to LilyPond. @details{Learning} -@item @ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossary}} -@emph{(optional reading)} -musical terms and translations. +@item +@ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossary}} +@emph{(optional reading)} musical terms and translations. @details{Glossary} -@item @ifWebLinks{@manualStableEssaySplitNoName,@ressaynamed{Top,Essay}} -@emph{(optional reading)} -background information about computer engraving. +@item +@ifWebLinks{@manualStableEssaySplitNoName,@ressaynamed{Top,Essay}} +@emph{(optional reading)} background information about computer engraving. @details{Essay} - @end itemize @divEnd @@ -61,15 +61,18 @@ background information about computer engraving. @itemize -@item @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}} +@item +@ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}} syntax reference. @details{Notation} -@item @ifWebLinks{@manualStableUsageSplitNoName,@rprogramnamed{Top,Usage}} +@item +@ifWebLinks{@manualStableUsageSplitNoName,@rprogramnamed{Top,Usage}} running the programs. @details{Usage} -@item @ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Snippets}} +@item +@ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Snippets}} short tricks and tips. @details{Snippets} @@ -83,22 +86,27 @@ short tricks and tips. @itemize -@item @ref{FAQ}: +@item +@ref{FAQ}: Frequently Asked Questions. -@item @ref{Top, Web}: +@item +@ref{Top, Web}: this document. @details{Web} -@item @ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Changes}} +@item +@ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Changes}} what's new? @details{Changes} -@item @ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extending}} +@item +@ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extending}} fancy tweaks. @details{Extending} -@item @ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Internals}} +@item +@ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Internals}} tweaks reference. @details{Internals} @@ -112,23 +120,48 @@ tweaks reference. @itemize -@item @ref{Translated}: +@item +@ref{All}: +previous stable versions and current as a compressed archive. + +@item +@ref{Translated}: translation status for non-English readers. -@item @ref{All}: -downloadable and old manuals. +@item +@uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}: +user-created examples, hints and tips. -@item @ref{Development}: +@item +@uref{http://benlemon.me/blog/music/lilypond/operation-lilypond/,Video Tutorials}: +Ben Lemon, a LilyPond user, has created a range of video tutorials on +his blog and which are aimed at new users. + +@item +@ref{Development}: manuals for the unstable version. -@item @ref{FDL}: -these manuals are published under the GNU Free Documentation -License. +@item +@ref{FDL}: +these manuals are published under the GNU Free Documentation License. @end itemize @divEnd +@divClass{column-center-bottom} +@subheading Manual formats + +The LilyPond manuals generally come in three formats: split HTML, big HTML and +PDF. Split HTML is good for reading online. Big HTML (and some of these can be +very big) contains the whole manual in a single page. PDF is available for +downloading and using offline. To get to these 3 formats, follow the links +that read @code{details of} and then the manual name. + +@divEnd + +@divEnd + @divClass{hide} @menu @@ -177,8 +210,8 @@ and follow those cross-references for more information. @docLinks{Learning, learning, @rlearningnamed{Top,Learning}, @manualStableLearningSplit, - @manualStableLearningBig, 1.5 MB, - @manualStableLearningPdf, 3 MB} + @manualStableLearningBig, 3 MB, + @manualStableLearningPdf, 5 MB} @divEnd @@ -227,8 +260,8 @@ in the PDF version due to its higher resolution.} @docLinks{Essay, essay, @ressaynamed{Top,Essay}, @manualStableEssaySplit, - @manualStableEssayBig, 2 MB, - @manualStableEssayPdf, 2.5 MB} + @manualStableEssayBig, 1 MB, + @manualStableEssayPdf, 2 MB} @divEnd @@ -253,8 +286,8 @@ the English musical terms presented in the glossary.} @docLinks{Notation, notation, @rusernamed{Top,Notation}, @manualStableNotationSplit, - @manualStableNotationBig, 7 MB, - @manualStableNotationPdf, 18 MB} + @manualStableNotationBig, 9 MB, + @manualStableNotationPdf, 35 MB} @divEnd @@ -277,8 +310,8 @@ attempting any large projects. @docLinks{Usage, usage, @rprogramnamed{Top,Usage}, @manualStableUsageSplit, - @manualStableUsageBig, 300 KB, - @manualStableUsagePdf, 400 KB} + @manualStableUsageBig, 400 KB, + @manualStableUsagePdf, 650 KB} @divEnd @@ -308,8 +341,8 @@ linked from the @strong{See also} portion. @docLinks{Snippets, snippets, @rlsrnamed{Top,Snippets}, @manualStableSnippetsSplit, - @manualStableSnippetsBig, 2.5 MB, - @manualStableSnippetsPdf, 8 MB} + @manualStableSnippetsBig, 1.5 MB, + @manualStableSnippetsPdf, 12.5 MB} @divEnd @@ -368,12 +401,23 @@ reporting, and development. @divEnd @divClass{column-right-bottom} +@subheading Read it + +@subsubheading Latest manual + +@divClass{keep-bullets} +@itemize +@ref{Top,Web} +@end itemize +@divEnd + +@subsubheading Web manual in @versionDevel -@docLinks{Web, web, - @ref{Top,,,,Web}, - @manualStableWebSplit, - @manualStableWebBig, 1 MB, - @manualStableWebPdf, 2 MB} +@docLinksBare{Web, web, + @ref{Top,Web}, + @manualDevelWebSplit, + @manualDevelWebBig, 2.5 MB, + @manualDevelWebPdf, 3.5 MB} @divEnd @@ -394,8 +438,8 @@ LilyPond since the previous stable version. @docLinks{Changes, changes, @rchangesnamed{Top,Changes}, @manualStableChangesSplit, - @manualStableChangesBig, 6 KB, - @manualStableChangesPdf, 200 KB} + @manualStableChangesBig, 90 KB, + @manualStableChangesPdf, 80 KB} @divEnd @@ -415,8 +459,8 @@ This manual explains how to write extensions to LilyPond. @docLinks{Extending, extending, @rextendnamed{Top,Extending}, @manualStableExtendingSplit, - @manualStableExtendingBig, 200 KB, - @manualStableExtendingPdf, 400 KB} + @manualStableExtendingBig, 300 KB, + @manualStableExtendingPdf, 500 KB} @divEnd @@ -447,8 +491,8 @@ generated documentation. @docLinks{Internals, internals, @rinternalsnamed{Top,Internals}, @manualStableInternalsSplit, - @manualStableInternalsBig, 2.5 MB, - @manualStableInternalsPdf, 2.8 MB} + @manualStableInternalsBig, 3 MB, + @manualStableInternalsPdf, 4 MB} @divEnd @@ -459,8 +503,7 @@ generated documentation. @divClass{column-center-bottom} @subheading Translations status -TODO: fix and generate in Texinfo. -@c http://code.google.com/p/lilypond/issues/detail?id=857 +@include translations.itexi @divEnd @@ -471,26 +514,21 @@ TODO: fix and generate in Texinfo. @divClass{column-left-top} @subheading Downloadable versions -@help{compare tarball vs. zip size, ask about windows users -dealing with tarballs (both gz and bz2), etc.} - -@help{on second thought, wait until the new doc build. write an -apology here for no tarballs} +@ifclear web_version +Downloadable tarballs only available at @uref{http://lilypond.org} +@end ifclear +@ifset web_version @divClass{keep-bullets} @itemize -@item html-split zip - -@item html-big zip - -@item pdf zip - -@item info zip maybe?!?! +@item @doctarballStable @end itemize @divEnd +@end ifset + @divEnd @divClass{column-right-bottom} @@ -499,6 +537,9 @@ apology here for no tarballs} @divClass{keep-bullets} @itemize +@item @uref{http://lilypond.org/doc/v2.14/Documentation/web/manuals, +LilyPond 2.14 Documentation} + @item @uref{http://lilypond.org/doc/v2.12/Documentation/, LilyPond 2.12 Documentation} @@ -508,7 +549,23 @@ LilyPond 2.10 Documentation} @item @uref{http://lilypond.org/doc/v2.8/Documentation/, LilyPond 2.8 Documentation} -@help anybody want to write this stuff? +@item @uref{http://lilypond.org/doc/v2.6/Documentation/, +LilyPond 2.6 Documentation} + +@item @uref{http://lilypond.org/doc/v2.4/Documentation/out-www/, +LilyPond 2.4 Documentation} + +@item @uref{http://lilypond.org/doc/v2.2/Documentation/out-www/, +LilyPond 2.2 Documentation} + +@item @uref{http://lilypond.org/doc/v2.0/Documentation/out-www/, +LilyPond 2.0 Documentation} + +@item @uref{http://lilypond.org/doc/v1.8/Documentation/out-www/, +LilyPond 1.8 Documentation} + +@item @uref{http://lilypond.org/doc/v1.6/Documentation/out-www/, +LilyPond 1.6 Documentation} @end itemize @@ -534,5 +591,3 @@ reasons for choosing it, is given in @ref{Freedom}. @include fdl.itexi @divEnd - -