]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/web/manuals.itexi
Merge branch 'master' into lilypond/translation
[lilypond.git] / Documentation / web / manuals.itexi
index 0a9a9ce0e41249e694b77cc351a3de909962748a..780ab18d3167e13015e2178aff83293fa309b251 100644 (file)
@@ -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
   @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
 
@@ -34,17 +40,17 @@ first!
 
 @item @ifWebLinks{@manualStableLearningSplitNoName,@rlearningnamed{Top,Learning}}
 a @qq{must-read} gentle introduction to LilyPond.
-(@ref{Learning, details of Learning})
+@details{Learning}
 
 @item @ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossary}}
 @emph{(optional reading)}
 musical terms and translations.
-(@ref{Glossary, details of Glossary})
+@details{Glossary}
 
 @item @ifWebLinks{@manualStableEssaySplitNoName,@ressaynamed{Top,Essay}}
 @emph{(optional reading)}
-background information about engraving and our aesthetics.
-(@ref{Essay, details of Essay})
+background information about computer engraving.
+@details{Essay}
 
 
 @end itemize
@@ -58,15 +64,15 @@ background information about engraving and our aesthetics.
 
 @item @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}}
 syntax reference.
-(@ref{Notation, details of Notation})
+@details{Notation}
 
 @item @ifWebLinks{@manualStableUsageSplitNoName,@rprogramnamed{Top,Usage}}
 running the programs.
-(@ref{Usage, details of Usage})
+@details{Usage}
 
 @item @ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Snippets}}
 short tricks and tips.
-(@ref{Snippets, details of Snippets})
+@details{Snippets}
 
 @end itemize
 
@@ -83,19 +89,19 @@ Frequently Asked Questions.
 
 @item @ref{Top, Web}:
 this document.
-(@ref{Web, details of Web})
+@details{Web}
 
 @item @ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Changes}}
 what's new?
-(@ref{Changes, details of Changes})
+@details{Changes}
 
 @item @ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extending}}
-writing fancy tweaks.
-(@ref{Extending, details of Extending})
+fancy tweaks.
+@details{Extending}
 
 @item @ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Internals}}
-reference for tweaks.
-(@ref{Internals, details of Internals})
+tweaks reference.
+@details{Internals}
 
 @end itemize
 
@@ -111,7 +117,7 @@ reference for 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.
@@ -363,12 +369,23 @@ reporting, and development.
 @divEnd
 
 @divClass{column-right-bottom}
+@subheading Read it
+
+@subsubheading Lastest 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, 1 MB,
+  @manualDevelWebPdf, 2 MB}
 
 @divEnd
 
@@ -454,10 +471,7 @@ generated documentation.
 @divClass{column-center-bottom}
 @subheading Translations status
 
-TODO: prettify and generate in Texinfo.
-@c http://code.google.com/p/lilypond/issues/detail?id=857
-
-@uref{../translations.html}.
+@include translations.itexi
 
 @divEnd
 
@@ -465,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,Extending}}
-programming fancy tweaks.
-
-@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}
@@ -573,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