X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fweb%2Fmanuals.itexi;h=9676aff04968ad21173d06ddfa489aeeb88d0801;hb=0945e7219a3995158d76267d26f77f57659c8578;hp=d945903d6cbe34449203358e6d2e018cd4484c79;hpb=74b336b3cab541e5f57c11c33ff52475eb655414;p=lilypond.git diff --git a/Documentation/web/manuals.itexi b/Documentation/web/manuals.itexi index d945903d6c..9676aff049 100644 --- a/Documentation/web/manuals.itexi +++ b/Documentation/web/manuals.itexi @@ -3,12 +3,20 @@ 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 @unnumbered Manuals +@macro details{reference} +@spanClass{detail} +(@ref{\reference\, details of \reference\}) +@spanEnd +@end macro + + @divClass{heading-center} @ifclear web_version @heading Manuals for LilyPond @version @@ -17,33 +25,32 @@ @heading Manuals for LilyPond @versionStable @end ifset - @divEnd @c TODO: do we want these links to be in larger text / bold ? CSS. -@c if you change this page, also change All. @divClass{column-center-top} @subheading Introduction @itemize @item @ref{Text input}: -LilyPond is a @strong{text-based} music engraver. If you are not -familiar with this concept, please read this now! +LilyPond is a @strong{text-based} music engraver. Read this +first! -@item @ref{Learning}: +@item @ifWebLinks{@manualStableLearningSplitNoName,@rlearningnamed{Top,Learning}} a @qq{must-read} gentle introduction to LilyPond. +@details{Learning} -@item @ref{Glossary}: +@item @ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossary}} @emph{(optional reading)} -explains musical terms and gives translations for users unfamiliar -with English musical terms. +musical terms and translations. +@details{Glossary} -@item @ref{Essay}: +@item @ifWebLinks{@manualStableEssaySplitNoName,@ressaynamed{Top,Essay}} @emph{(optional reading)} -background information about the engraving process and the -aesthetics of 19th century music engraving. +background information about computer engraving. +@details{Essay} @end itemize @@ -55,16 +62,17 @@ aesthetics of 19th century music engraving. @itemize -@item @ref{Notation}: -the main portion of the documentation; provides detailed -information about creating notation. +@item @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}} +syntax reference. +@details{Notation} -@item @ref{Usage}: -discusses the actual programs and operating system-specific -issues. +@item @ifWebLinks{@manualStableUsageSplitNoName,@rprogramnamed{Top,Usage}} +running the programs. +@details{Usage} -@item @ref{Snippets}: -short tricks, tips, and examples. +@item @ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Snippets}} +short tricks and tips. +@details{Snippets} @end itemize @@ -76,21 +84,24 @@ short tricks, tips, and examples. @itemize -@item @ref{Web}: -this document. - @item @ref{FAQ}: -links to the answers of Frequently Asked Questions. +Frequently Asked Questions. + +@item @ref{Top, Web}: +this document. +@details{Web} -@item @ref{Changes}: -updates since the last major version. +@item @ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Changes}} +what's new? +@details{Changes} -@item @ref{Extend}: -programming fancy tweaks in LilyPond. +@item @ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extending}} +fancy tweaks. +@details{Extending} -@item @ref{Internals}: -information about LilyPond's internal structures, which is -required for constructing tweaks. +@item @ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Internals}} +tweaks reference. +@details{Internals} @end itemize @@ -106,7 +117,7 @@ required for constructing tweaks. translation status for non-English readers. @item @ref{All}: -quick links, downloadable manuals, and old manuals. +downloadable and old manuals. @item @ref{Development}: manuals for the unstable version. @@ -128,10 +139,10 @@ License. * Notation:: Reference. * Usage:: Usage. * Snippets:: Snippets. -* Web:: Web. * FAQ:: FAQ. +* Web:: Web. * Changes:: NEWS. -* Extend:: Programming. +* Extending:: Programming. * Internals:: Internals. * Translated:: Translation. * All:: All manuals. @@ -304,29 +315,6 @@ linked from the @strong{See also} portion. @divEnd -@node Web -@unnumberedsec Web - -@divClass{column-left-top} -@subheading Web - -This manual supplies general information about LilyPond. It also -contains information about various community forums, bug -reporting, and development. - -@divEnd - -@divClass{column-right-bottom} - -@docLinks{Web, web, - @ref{Top,,,,Web}, - @manualStableWebSplit, - @manualStableWebBig, 1 MB, - @manualStableWebPdf, 2 MB} - -@divEnd - - @node FAQ @unnumberedsec FAQ @@ -368,6 +356,40 @@ This is explained in @rprogram{Why does the syntax change?}. @divEnd +@node Web +@unnumberedsec Web + +@divClass{column-left-top} +@subheading Web + +This manual supplies general information about LilyPond. It also +contains information about various community forums, bug +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 + +@docLinksBare{Web, web, + @ref{Top,Web}, + @manualDevelWebSplit, + @manualDevelWebBig, 1 MB, + @manualDevelWebPdf, 2 MB} + +@divEnd + + @node Changes @unnumberedsec Changes @@ -390,11 +412,11 @@ LilyPond since the previous stable version. @divEnd -@node Extend -@unnumberedsec Extend +@node Extending +@unnumberedsec Extending @divClass{column-left-top} -@subheading Extend LilyPond +@subheading Extending LilyPond This manual explains how to write extensions to LilyPond. @@ -402,8 +424,8 @@ This manual explains how to write extensions to LilyPond. @divClass{column-right-bottom} -@docLinks{Extend, extend, - @rextendnamed{Top,Extend}, +@docLinks{Extending, extending, + @rextendnamed{Top,Extending}, @manualStableExtendingSplit, @manualStableExtendingBig, 200 KB, @manualStableExtendingPdf, 400 KB} @@ -449,9 +471,7 @@ generated documentation. @divClass{column-center-bottom} @subheading Translations status -TODO: prettify and generate in Texinfo. - -@uref{../translations.html}. +@include translations.itexi @divEnd @@ -459,106 +479,27 @@ TODO: prettify and generate in Texinfo. @node All @unnumberedsec All -@divClass{heading-center} -@heading Documentation quick links - -Links to other formats of these manuals can be found in -@ref{Manuals}. - -@divEnd - -@c this should match the (main) manual page. -@divClass{column-center-top} -@subheading Introduction - -@itemize - -@c no colon : needed in this section -@item @ifWebLinks{@manualStableLearningSplit,@rlearningnamed{Top,Learning}} -a @qq{must-read} gentle introduction to LilyPond. - -@item @ifWebLinks{@manualStableGlossarySplit,@rglosnamed{Top,Glossary}} -@emph{(optional reading)} -explains musical terms and gives translations for users unfamiliar -with English musical terms. - -@item @ifWebLinks{@manualStableEssaySplit,@ressaynamed{Top,Essay}} -@emph{(optional reading)} -background information about the engraving process and the -aesthetics of 19th century music engraving. - -@end itemize - -@divEnd - @divClass{column-left-top} -@subheading Regular use - -@itemize - -@item @ifWebLinks{@manualStableNotationSplit,@rusernamed{Top,Notation}} -the main portion of the documentation; provides detailed -information about creating notation. - -@item @ifWebLinks{@manualStableUsageSplit,@rprogramnamed{Top,Usage}} -discusses the actual programs and operation system-specific -issues. - -@item @ifWebLinks{@manualStableSnippetsSplit,@rlsrnamed{Top,Snippets}} -short tricks, tips, and examples. - -@end itemize - -@divEnd - - -@divClass{column-right-top} -@subheading Infrequent Use - -@itemize - -@item @ref{FAQ}: -links to answers of Frequently Asked Questions. - -@item @ifWebLinks{@manualStableChangesSplit,@rchangesnamed{Top,Changes}} -updates since the last major version. - -@item @ifWebLinks{@manualStableExtendingSplit,@rextendnamed{Top,Extend}} -programming fancy tweaks in LilyPond. - -@item @ifWebLinks{@manualStableInternalsSplit,@rinternalsnamed{Top,Internals}} -information about LilyPond's internal structures, which is -required for constructing tweaks. - -@end itemize - -@divEnd - - -@divClass{column-center-bottom} @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} @subheading Previous stable versions @divClass{keep-bullets} @@ -567,13 +508,32 @@ apology here for no tarballs} @item @uref{http://lilypond.org/doc/v2.12/Documentation/, LilyPond 2.12 Documentation} +@item @uref{http://lilypond.org/doc/v2.11/Documentation/, +LilyPond 2.11 Documentation} + @item @uref{http://lilypond.org/doc/v2.10/Documentation/, 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