Merge branch 'master' into translation

[lilypond.git] / Documentation / web / manuals.itexi

diff --git a/Documentation/web/manuals.itexi b/Documentation/web/manuals.itexi
index 320ae3937c4fb2ac02d412178699c76f11a54e30..07ccb42aa963ae2b0490ede8a34cb9c6bf6e0c91 100644 (file)
--- a/Documentation/web/manuals.itexi
+++ b/Documentation/web/manuals.itexi
@@ -16,7 +16,6 @@
 @spanEnd
 @end macro
 
 @spanEnd
 @end macro
 

-

 @divClass{heading-center}
 @ifclear web_version
   @heading Manuals for LilyPond @version
 @divClass{heading-center}
 @ifclear web_version
   @heading Manuals for LilyPond @version


@@ -27,32 +26,32 @@
 
 @divEnd
 
 
 @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
 
 
 @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}
 
 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}
 
 @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}
 
 @details{Essay}
 

-

 @end itemize
 
 @divEnd
 @end itemize
 
 @divEnd


@@ -62,15 +61,18 @@ background information about computer engraving.
 
 @itemize
 
 
 @itemize
 

-@item @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}}
+@item
+@ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}}

 syntax reference.
 @details{Notation}
 
 syntax reference.
 @details{Notation}
 

-@item @ifWebLinks{@manualStableUsageSplitNoName,@rprogramnamed{Top,Usage}}
+@item
+@ifWebLinks{@manualStableUsageSplitNoName,@rprogramnamed{Top,Usage}}

 running the programs.
 @details{Usage}
 
 running the programs.
 @details{Usage}
 

-@item @ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Snippets}}
+@item
+@ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Snippets}}

 short tricks and tips.
 @details{Snippets}
 
 short tricks and tips.
 @details{Snippets}
 


@@ -84,22 +86,27 @@ short tricks and tips.
 
 @itemize
 
 
 @itemize
 

-@item @ref{FAQ}:
+@item
+@ref{FAQ}:

 Frequently Asked Questions.
 
 Frequently Asked Questions.
 

-@item @ref{Top, Web}:
+@item
+@ref{Top, Web}:

 this document.
 @details{Web}
 
 this document.
 @details{Web}
 

-@item @ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Changes}}
+@item
+@ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Changes}}

 what's new?
 @details{Changes}
 
 what's new?
 @details{Changes}
 

-@item @ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extending}}
+@item
+@ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extending}}

 fancy tweaks.
 @details{Extending}
 
 fancy tweaks.
 @details{Extending}
 

-@item @ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Internals}}
+@item
+@ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Internals}}

 tweaks reference.
 @details{Internals}
 
 tweaks reference.
 @details{Internals}
 


@@ -113,23 +120,48 @@ tweaks reference.
 
 @itemize
 
 
 @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.
 
 translation status for non-English readers.
 

-@item @ref{All}:
-downloadable and old manuals.
+@item
+@uref{http://lsr@/.di@/.unimi@/.it,LilyPond Snippet Repository}:
+user-created examples, hints and tips.
+
+@item
+@uref{http://bit.ly/LilyPondBeginners,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}:
+@item
+@ref{Development}:

 manuals for the unstable version.
 
 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
 
 
 @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
 
 @divClass{hide}
 @menu


@@ -178,8 +210,8 @@ and follow those cross-references for more information.
 @docLinks{Learning, learning,
   @rlearningnamed{Top,Learning},
   @manualStableLearningSplit,
 @docLinks{Learning, learning,
   @rlearningnamed{Top,Learning},
   @manualStableLearningSplit,

-  @manualStableLearningBig, 1.5 MB,
-  @manualStableLearningPdf, 3 MB}
+  @manualStableLearningBig, 3 MB,
+  @manualStableLearningPdf, 5 MB}

 
 @divEnd
 
 
 @divEnd
 


@@ -228,8 +260,8 @@ in the PDF version due to its higher resolution.}
 @docLinks{Essay, essay,
   @ressaynamed{Top,Essay},
   @manualStableEssaySplit,
 @docLinks{Essay, essay,
   @ressaynamed{Top,Essay},
   @manualStableEssaySplit,

-  @manualStableEssayBig, 2 MB,
-  @manualStableEssayPdf, 2.5 MB}
+  @manualStableEssayBig, 1 MB,
+  @manualStableEssayPdf, 2 MB}

 
 @divEnd
 
 
 @divEnd
 


@@ -254,8 +286,8 @@ the English musical terms presented in the glossary.}
 @docLinks{Notation, notation,
   @rusernamed{Top,Notation},
   @manualStableNotationSplit,
 @docLinks{Notation, notation,
   @rusernamed{Top,Notation},
   @manualStableNotationSplit,

-  @manualStableNotationBig, 7 MB,
-  @manualStableNotationPdf, 18 MB}
+  @manualStableNotationBig, 9 MB,
+  @manualStableNotationPdf, 35 MB}

 
 @divEnd
 
 
 @divEnd
 


@@ -278,8 +310,8 @@ attempting any large projects.
 @docLinks{Usage, usage,
   @rprogramnamed{Top,Usage},
   @manualStableUsageSplit,
 @docLinks{Usage, usage,
   @rprogramnamed{Top,Usage},
   @manualStableUsageSplit,

-  @manualStableUsageBig, 300 KB,
-  @manualStableUsagePdf, 400 KB}
+  @manualStableUsageBig, 400 KB,
+  @manualStableUsagePdf, 650 KB}

 
 @divEnd
 
 
 @divEnd
 


@@ -291,7 +323,7 @@ attempting any large projects.
 @subheading Snippets
 
 This shows a selected set of LilyPond snippets from the
 @subheading Snippets
 
 This shows a selected set of LilyPond snippets from the

-@uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}
+@uref{http://lsr@/.di@/.unimi@/.it,LilyPond Snippet Repository}

 (LSR).  All the snippets are in the public domain.
 
 Please note that this document is not an exact subset of LSR.  LSR
 (LSR).  All the snippets are in the public domain.
 
 Please note that this document is not an exact subset of LSR.  LSR


@@ -309,8 +341,8 @@ linked from the @strong{See also} portion.
 @docLinks{Snippets, snippets,
   @rlsrnamed{Top,Snippets},
   @manualStableSnippetsSplit,
 @docLinks{Snippets, snippets,
   @rlsrnamed{Top,Snippets},
   @manualStableSnippetsSplit,

-  @manualStableSnippetsBig, 2.5 MB,
-  @manualStableSnippetsPdf, 8 MB}
+  @manualStableSnippetsBig, 1.5 MB,
+  @manualStableSnippetsPdf, 12.5 MB}

 
 @divEnd
 
 
 @divEnd
 


@@ -371,7 +403,7 @@ reporting, and development.
 @divClass{column-right-bottom}
 @subheading Read it
 
 @divClass{column-right-bottom}
 @subheading Read it
 

-@subsubheading Lastest manual
+@subsubheading Latest manual

 
 @divClass{keep-bullets}
 @itemize
 
 @divClass{keep-bullets}
 @itemize


@@ -384,8 +416,8 @@ reporting, and development.
 @docLinksBare{Web, web,
   @ref{Top,Web},
   @manualDevelWebSplit,
 @docLinksBare{Web, web,
   @ref{Top,Web},
   @manualDevelWebSplit,

-  @manualDevelWebBig, 1 MB,
-  @manualDevelWebPdf, 2 MB}
+  @manualDevelWebBig, 2.5 MB,
+  @manualDevelWebPdf, 3.5 MB}

 
 @divEnd
 
 
 @divEnd
 


@@ -406,8 +438,8 @@ LilyPond since the previous stable version.
 @docLinks{Changes, changes,
   @rchangesnamed{Top,Changes},
   @manualStableChangesSplit,
 @docLinks{Changes, changes,
   @rchangesnamed{Top,Changes},
   @manualStableChangesSplit,

-  @manualStableChangesBig, 6 KB,
-  @manualStableChangesPdf, 200 KB}
+  @manualStableChangesBig, 90 KB,
+  @manualStableChangesPdf, 80 KB}

 
 @divEnd
 
 
 @divEnd
 


@@ -427,8 +459,8 @@ This manual explains how to write extensions to LilyPond.
 @docLinks{Extending, extending,
   @rextendnamed{Top,Extending},
   @manualStableExtendingSplit,
 @docLinks{Extending, extending,
   @rextendnamed{Top,Extending},
   @manualStableExtendingSplit,

-  @manualStableExtendingBig, 200 KB,
-  @manualStableExtendingPdf, 400 KB}
+  @manualStableExtendingBig, 300 KB,
+  @manualStableExtendingPdf, 500 KB}

 
 @divEnd
 
 
 @divEnd
 


@@ -459,8 +491,8 @@ generated documentation.
 @docLinks{Internals, internals,
   @rinternalsnamed{Top,Internals},
   @manualStableInternalsSplit,
 @docLinks{Internals, internals,
   @rinternalsnamed{Top,Internals},
   @manualStableInternalsSplit,

-  @manualStableInternalsBig, 2.5 MB,
-  @manualStableInternalsPdf, 2.8 MB}
+  @manualStableInternalsBig, 3 MB,
+  @manualStableInternalsPdf, 4 MB}

 
 @divEnd
 
 
 @divEnd
 


@@ -471,8 +503,7 @@ generated documentation.
 @divClass{column-center-bottom}
 @subheading Translations status
 
 @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
 
 
 @divEnd
 


@@ -506,12 +537,15 @@ Downloadable tarballs only available at @uref{http://lilypond.org}
 @divClass{keep-bullets}
 @itemize
 
 @divClass{keep-bullets}
 @itemize
 

+@item @uref{http://lilypond.org/doc/v2.16/Documentation/web/manuals,
+LilyPond 2.16 Documentation}
+
+@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}
 
 @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.10/Documentation/,
 LilyPond 2.10 Documentation}
 


@@ -560,5 +594,3 @@ reasons for choosing it, is given in @ref{Freedom}.
 @include fdl.itexi
 
 @divEnd
 @include fdl.itexi
 
 @divEnd

-
-