]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/web/community.itexi
Web: add news for report 17.
[lilypond.git] / Documentation / web / community.itexi
index 0f55f0046f27363f39e5c641a1cb49fd40efd530..96f083d9a498ea6e733439704e05850445ddf18a 100644 (file)
@@ -3,10 +3,12 @@
     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
 
-@include web/basic-authors.itexi
+@include included/authors.itexi
+@include included/helpus.itexi
 
 @node Community
 @unnumbered Community
@@ -64,14 +66,14 @@ discussing LilyPond.
 
 @divClass{hide}
 @menu
-* Contact::                     
-* Tiny examples::               
-* Bug reports::                 
-* Help us::                     
-* Development::                 
-* Authors::                     
-* Publications::                
-* Old news::                    
+* Contact::
+* Tiny examples::
+* Bug reports::
+* Help us::
+* Development::
+* Authors::
+* Publications::
+* Old news::
 @end menu
 @divEnd
 
@@ -89,10 +91,10 @@ This mailing list is the main place for users to discuss and help
 each other.
 
 @quotation
-@uref{http://mail.gnu.org/mailman/listinfo/lilypond-user,
+@uref{http://lists.gnu.org/mailman/listinfo/lilypond-user,
 lilypond-user subscribe and info}
 
-@uref{http://mail.gnu.org/archive/html/lilypond-user/,
+@uref{http://lists.gnu.org/archive/html/lilypond-user/,
 user archive1}
 @uref{http://www.mail-archive.com/lilypond-user@@gnu.org/,
 archive2}
@@ -115,7 +117,7 @@ Some level of support is provided on our IRC channel,
 @end example
 
 This channel has no public archive, so any question that may
-be useful for others would better be posted to one of the mailing lists. 
+be useful for others would better be posted to one of the mailing lists.
 
 @html
 <form action="http://webchat.freenode.net"
@@ -143,8 +145,8 @@ be useful for others would better be posted to one of the mailing lists.
 @subsubheading Other languages
 
 @quotation
-@uref{http://es.groups.yahoo.com/group/lilypond-es,
-Spanish yahoo group}
+@uref{http://lists.gnu.org/mailman/listinfo/lilypond-es,
+Spanish mailing list}
 
 @uref{http://www.lilypondforum.de/,
 German forum}
@@ -179,7 +181,7 @@ notifications of new releases.
 @uref{http://lists.gnu.org/mailman/listinfo/info-lilypond,
 info-lilypond subscribe and info}
 
-@uref{http://mail.gnu.org/archive/html/info-lilypond/,
+@uref{http://lists.gnu.org/archive/html/info-lilypond/,
 info archive1}
 @uref{http://www.mail-archive.com/info-lilypond@@gnu.org/,
 archive2}
@@ -202,10 +204,10 @@ Most developer discussion takes place on this list.  Patches
 should be sent here.
 
 @quotation
-@uref{http://mail.gnu.org/mailman/listinfo/lilypond-devel,
+@uref{http://lists.gnu.org/mailman/listinfo/lilypond-devel,
 lilypond-devel subscribe and info}
 
-@uref{http://mail.gnu.org/archive/html/lilypond-devel/,
+@uref{http://lists.gnu.org/archive/html/lilypond-devel/,
 devel archive1}
 @uref{http://www.mail-archive.com/lilypond-devel@@gnu.org/,
 archive2}
@@ -222,10 +224,10 @@ send to lilypond-devel with gmane}
 Bug-specific discussion takes place here.
 
 @quotation
-@uref{http://mail.gnu.org/mailman/listinfo/bug-lilypond,
+@uref{http://lists.gnu.org/mailman/listinfo/bug-lilypond,
 bug-lilypond subscribe and info}
 
-@uref{http://mail.gnu.org/archive/html/bug-lilypond/,
+@uref{http://lists.gnu.org/archive/html/bug-lilypond/,
 bug archive1}
 @uref{http://www.mail-archive.com/bug-lilypond@@gnu.org/,
 archive2}
@@ -399,167 +401,35 @@ account.
 @node Help us
 @unnumberedsec Help us
 
- TODO: talk about the Frogs, document suggestions, encourage getting
-@divClass{heading-center}
-@heading We need you!
-
-The LilyPond development team is quite small; we really want to
-get more people involved.  Please consider helping us, even with
-small tasks -- anything that you do will allow an experienced
-developer to work on advanced tasks.
+@divClass{column-center-top}
+@helpusNeed
 
 @divEnd
 
-
 @divClass{column-left-top}
-@subheading Ways of contributing
-
-Many users ask @qq{I can't program; how can I help?}
-
 @divClass{keep-bullets}
-@subsubheading No source, no programming
-
-@sourceimage{logo-linux,,,}
-@sourceimage{logo-freebsd,,,}
-@sourceimage{logo-macosx,,,}
-@sourceimage{logo-windows,,,}
-
-@itemize
-@item
-Mailist support: we have many users asking for him.
-
-@item
-LilyPond Snippet Repository (LSR): create and fix snippets.  See
-@rcontrib{Adding and editing snippets}.
-
-@item
-Bug reporting: our infrastructure for organizing bug reports only
-requires a web browser.  Please do not add bugs directly unless
-you have learned how we like to handle such reports.  See
-@rcontrib{Issues}.
-
-@item
-Discussions, reviews, and testing: the developers often ask for
-feedback about new documentation, potential syntax changes, and
-testing new features.  We rarely receive as much feedback as we
-would like; please consider responding to these requests!  (even
-if your only contribution is @qq{wow, looks great!})
-
-@end itemize
-
-@subsubheading With source, no programming
-
-@sourceimage{logo-linux,,,}
-@sourceimage{logo-freebsd,,,}
-@sourceimage{logo-macosx,,,}
-@sourceimage{logo-windows,,,}
-
-To get the source code, see @rcontrib{Starting with git}.
-
-@itemize
-@item
-Documentation:
-@rcontrib{Building documentation without compiling LilyPond}.
-
-@item
-Website: the website is built from the normal documentation
-source.  See the info about documentation, and also
-@rcontrib{Website work}.
-
-@item
-Translations: see @rcontrib{Translating the documentation}, and
-@rcontrib{Translating the website}.
-
-@end itemize
-
-@subsubheading Programming
-
-@sourceimage{logo-linux,,,}
-@sourceimage{logo-freebsd,,,}
-@sourceimage{logo-macosx,,,}
-
-To the best of our knowledge, nobody has compiled LilyPond on
-Windows.  We have therefore created @emph{lilybuntu}, a custom
-@emph{Ubuntu} variant configured for LilyPond development.  This
-runs inside a virtual machine, without disturbing the Windows
-operating system.  For more information, see
-@rcontrib{Using a Virtual Machine to Compile LilyPond}.
-
-@itemize
-@item
-Bugfixes, new features: the best way to begin is to join the
-Frogs.
-
-@end itemize
+@helpusTasks
 
 @divEnd
 @divEnd
 
-
 @divClass{column-right-top}
-@subheading Projects
-
-@subsubheading Frogs
-
-Website and mailist: @uref{http://frogs.lilynet.net}
-
-The Frogs are simple LilyPond users who have chosen to get
-involved in their favorite software's development.  Fixing bugs,
-implementing new features, documenting the source code: there's a
-lot to be done, but most importantly: this is a chance for
-everyone to learn more about LilyPond, about Free Software, about
-programming... and to have fun.  If you're curious about any of
-it, then the word is: @emph{Join the Frogs!}
-
-
-
-@help{not active yet; either comment out or begin these projects
-before 2.14}
-
-@subsubheading Grand LilyPond Input Syntax Standardization
-
-Website and mailist: TODO
-
-GLISS will stabilize the (non-tweak) input syntax for the upcoming
-LilyPond 3.0.  After updating to 3.0, the input syntax for
-untweaked music will remain stable for the foreseeable future.
-
-We will have an extensive discussion period to determine the final
-input specification.
-
-@subsubheading Grand Organizing Project
-
-Website and mailist: TODO
-
-GOP is our big recruiting drive for new contributors.
-
-@divEnd
-
-@divClass{column-center-bottom}
-@subheading Legalese
-
-@divClass{legal}
-All logos and product images are copyright and trademark
-acknowledged.
-
-@logoLegalLinux
-
-@logoLegalFreeBSD
-
-@logoLegalMacOSX
-
-@logoLegalWindows
+@helpusProjects
 
 @divEnd
 
-@divEnd
 
 @node Development
 @unnumberedsec Development
 
-
 @divClass{heading-center}
-@heading Development materials for LilyPond @versionDevel{}
+@ifclear web_version
+  @heading Development for LilyPond @version
+@end ifclear
+@ifset web_version
+  @heading Development for LilyPond @versionDevel
+@end ifset
+
 
 @warning{These are @emph{unstable development} versions.  If you
 have the slightest doubt about how to use or install LilyPond, we
@@ -580,7 +450,7 @@ Development versions have an odd-numbered @q{minor} version number
 @divEnd
 
 
-@divClass{column-left-bottom}
+@divClass{column-left-top}
 @subheading Download
 
 Instructions for git and compiling are in the Contributor's Guide.
@@ -614,121 +484,168 @@ the latest binary:
 
 @end quotation
 
+@divEnd
 
-@subheading Manuals
-
-@help {these need the automatic symlinks or something.  Maybe even
-a hard-coded url to lilypond.org/docs/2.13 or something??}
-
-Learning:
-@uref{lm-html, html}
-@uref{lm-big-html, big html}
-@uref{lm-pdf, pdf}
 
-Glossary:
-@uref{mg-html, html}
-@uref{mg-big-html, big html}
-@uref{mg-pdf, pdf}
+@divClass{column-right-top}
+@subheading Contributor's Guide
 
-Essay:
-@uref{essay-html, html}
-@uref{essay-big-html, big html}
-@uref{essay-pdf, pdf}
+LilyPond development is a fairly complicated matter.  In order to
+help new contributors, and to keep the whole system (mostly)
+stable, we have written a manual for development tasks.
 
-Notation:
-@uref{notation-html, html}
-@uref{notation-big-html, big html}
-@uref{notation-pdf, pdf}
+@docLinksBare{Contributor's Guide, contributor,
+  @rcontribnamed{Top,Contributor's Guide},
+  @manualDevelContributorSplit,
+  @manualDevelContributorBig, 500 kB,
+  @manualDevelContributorPdf, 2.8 MB}
 
-Usage:
-@uref{usage-html, html}
-@uref{usage-big-html, big html}
-@uref{usage-pdf, pdf}
+@divEnd
 
-Snippets:
-@uref{snippets-html, html}
-@uref{snippets-big-html, big html}
-@uref{snippets-pdf, pdf}
 
-Changes:
-@uref{changes-html, html}
-@uref{changes-big-html, big html}
-@uref{changes-pdf, pdf}
+@divClass{column-center-top}
+@subheading Regression tests
 
-Internals:
-@uref{internals-html, html}
-@uref{internals-big-html, big html}
-@uref{internals-pdf, pdf}
+@divClass{keep-bullets}
+@itemize
 
-@divEnd
+@ifclear web_version
 
+@item
+@uref{../../input/regression/collated-files.html, Regression tests}:
+This release's regtests.
+(@uref{../../input/regression/collated-files.pdf, pdf version})
 
-@divClass{column-right-top}
-@subheading Contributors' Guide
+@item
+@uref{../../input/regression/musicxml/collated-files.html, MusicXML tests}:
+This release's musicXML tests.
+(@uref{../../input/regression/musicxml/collated-files.pdf, pdf version})
+@end ifclear
 
-LilyPond development is a fairly complicated matter.  LilyPond is
-a large, (mostly) stable project.  At any point in time, we have
-between 5 and 25 active contributors.  In order to help new
-contributors, and to keep the whole system (mostly) stable, we
-have written a manual for contributors.
+@ifset web_version
+@item @regtestDevel (@regtestDevelPdf{})
 
-@divClass{keep-bullets}
-@itemize
+@item @regtestDevelXml (@regtestDevelXmlPdf{})
 
-@item @uref{../contributor/index.html, Contributor's guide (split HTML)}:
-the manual is split between many HTML pages.
-@emph{(small download for each page)}
+@item @regtestStable (@regtestStablePdf{})
 
-@item @uref{../contributor-big-page.html, Contributor's guide (big HTML)}:
-read this manual as one huge HTML page.
-@emph{(large single download, around 10? Mb)}
+@item @regtestStableXml (@regtestStableXmlPdf{})
+@end ifset
 
-@item @uref{../contributor.pdf, contributor.pdf}:
-download as a PDF file.
-@emph{(large single download, 2.8 Mb)}
 
-@c @item @uref{TODO, contributor.info}:
-@c GNU info format for documentation.  TODO, link broken.
+@item @uref{http://lilypond.org/test, Archive of regression tests}:
+Comparisons between versions.
 
 @end itemize
 @divEnd
 @divEnd
 
-@divClass{column-right-bottom}
-@subheading Regression tests
 
-@divClass{keep-bullets}
-@itemize
 
-@item @uref{../../input/regression/collated-files.html, Regression tests}:
-This releases' tests.  (also in
-@uref{../input/regression/collated-files.pdf, pdf})
+@divClass{column-center-bottom}
+@subheading Manuals
 
-@item @uref{../../input/regression/musicxml/collated-files.html,
-MusicXML Regression tests}:
-This releases' MusicXML tests.  (also in
-@uref{../input/regression/musicxml/collated-files.pdf, pdf})
+@ifclear web_version
+@warning{These manuals are for LilyPond @version{}; the latest
+manuals can be found at @url{http://lilypond.org}}
+@end ifclear
 
-@item @uref{http://lilypond.org/test, Archive of regression tests}:
-Comparisons beteween versions.
+@divClass{normal-table}
+@multitable @columnfractions .3 .3 .3
+@headitem Introduction
+@item
+@docLinkSplit{Learning,learning,@manualDevelLearningSplit}
+@tab
+@docLinkBig{Learning,learning,@manualDevelLearningBig}
+@tab
+@docLinkPdf{Learning,learning,@manualDevelLearningPdf}
+
+@item
+@docLinkSplit{Glossary,music-glossary,@manualDevelGlossarySplit}
+@tab
+@docLinkBig{Glossary,music-glossary,@manualDevelGlossaryBig}
+@tab
+@docLinkPdf{Glossary,music-glossary,@manualDevelGlossaryPdf}
+
+@item
+@docLinkSplit{Essay,essay,@manualDevelEssaySplit}
+@tab
+@docLinkBig{Essay,essay,@manualDevelEssayBig}
+@tab
+@docLinkPdf{Essay,essay,@manualDevelEssayPdf}
+
+@headitem Regular
+
+@item
+@docLinkSplit{Notation,notation,@manualDevelNotationSplit}
+@tab
+@docLinkBig{Notation,notation,@manualDevelNotationBig}
+@tab
+@docLinkPdf{Notation,notation,@manualDevelNotationPdf}
+
+@item
+@docLinkSplit{Usage,usage,@manualDevelUsageSplit}
+@tab
+@docLinkBig{Usage,usage,@manualDevelUsageBig}
+@tab
+@docLinkPdf{Usage,usage,@manualDevelUsagePdf}
+
+@item
+@docLinkSplit{Snippets,snippets,@manualDevelSnippetsSplit}
+@tab
+@docLinkBig{Snippets,snippets,@manualDevelSnippetsBig}
+@tab
+@docLinkPdf{Snippets,snippets,@manualDevelSnippetsPdf}
+
+@headitem Infrequent
+
+@item
+@docLinkSplit{Web,web,@manualDevelWebSplit}
+@tab
+@docLinkBig{Web,web,@manualDevelWebBig}
+@tab
+@docLinkPdf{Web,web,@manualDevelWebPdf}
+
+@item
+@docLinkSplit{Changes,changes,@manualDevelChangesSplit}
+@tab
+@docLinkBig{Changes,changes,@manualDevelChangesBig}
+@tab
+@docLinkPdf{Changes,changes,@manualDevelChangesPdf}
+
+@item
+@docLinkSplit{Extending,extending,@manualDevelExtendingSplit}
+@tab
+@docLinkBig{Extending,extending,@manualDevelExtendingBig}
+@tab
+@docLinkPdf{Extending,extending,@manualDevelExtendingPdf}
+
+@item
+@docLinkSplit{Internals,internals,@manualDevelInternalsSplit}
+@tab
+@docLinkBig{Internals,internals,@manualDevelInternalsBig}
+@tab
+@docLinkPdf{Internals,internals,@manualDevelInternalsPdf}
+
+@ifset web_version
+@headitem Downloadable
+
+@item
+@doctarballDevel
+@end ifset
+
+@end multitable
 
-@end itemize
 @divEnd
 @divEnd
 
-@node Authors
-@unnumberedsec Authors 
-
-@help{Under construction; this is not an accurate list!}
 
-combo of:
 
-http://lilypond.org/web/about/thanks
 
-Documentation/topdocs/AUTHORS.texi
+@node Authors
+@unnumberedsec Authors
 
-and maybe:
-http://lilypond.org/web/switch/
+@help{Under construction; this is not an accurate list!}
 
 
 @divClass{column-left-top}
@@ -740,7 +657,7 @@ http://lilypond.org/web/switch/
 @divEnd
 
 @divClass{column-right-top}
-@subheading Previous Development Team Positions
+@subheading Previous Development Team
 
 @divClass{keep-bullets}
 @developersPrevious
@@ -748,27 +665,66 @@ http://lilypond.org/web/switch/
 @divEnd
 
 
+@divClass{column-center-top}
+@subheading Current Contributors
+
+@divClass{keep-bullets}
+@subsubheading Programming
+
+@coreCurrent
+
+@subsubheading Font
+
+@fontCurrent
+
+@subsubheading Documentation
+
+@docCurrent
+
+@subsubheading Bug squad
+
+@bugsquadCurrent
+
+@subsubheading Support
+
+@supportCurrent
+
+@subsubheading Translation
+
+@translationsCurrent
+
+@divEnd
+@divEnd
+
+
 @divClass{column-center-bottom}
-@subheading Programming contributors
+@subheading Previous Contributors
 
 @divClass{keep-bullets}
-@contributorsCore
+@subsubheading Programming
 
-@subheading Font contributors
+@corePrevious
 
-@contributorsFont
+@subsubheading Font
 
-@subheading Documentation contributors
+@fontPrevious
 
-@contributorsDoc
+@subsubheading Documentation
 
-@subheading Support contributors
+@docPrevious
 
-@contributorsSupport
+@c    uncomment when we have any previous members -gp
+@c @subsubheading Bug squad
 
-@subheading Translation contributors
+@c @bugsquadCurrent
 
-@contributorsTranslations
+@subsubheading Support
+
+@supportPrevious
+
+@subsubheading Translation
+
+@translationsPrevious
 
 @divEnd
 @divEnd
@@ -795,7 +751,7 @@ Erik Sandberg, @emph{Separating input language and formatter in
 GNU Lilypond}. Master's Thesis, Uppsala University, Department of
 Information Technology March 2006.
 (@uref{http://lilypond.org/web/images/thesis-erik-sandberg.pdf,
-PDF 750k}) 
+PDF 750k})
 
 @item
 Han-Wen Nienhuys and Jan Nieuwenhuizen, @emph{LilyPond, a system
@@ -821,7 +777,7 @@ September 2009
 
 The German LinuxUser magazine wrote an
 @uref{http://www.linux-community.de/Internal/Artikel/Print-Artikel/LinuxUser/2009/10/Digitaler-Notenschluessel,
-article about lilypond}.
+article about LilyPond}.
 
 
 @item
@@ -829,20 +785,30 @@ February 2008
 
 In @uref{http://www.musicbyandrew.ca/finale-lilypond-1.html,
 articles on his personal site}, Andrew Hawryluk compares Finale
-and LilyPond in general terms, and evaluates in detail engraving
-capabilities of both pieces of software.  The second article is an
-instructive analysis of Rachmaninoff's Piano Prelude 6 engraving,
-including comparisons with a reference hand-engraved edition. 
+and LilyPond in general terms, and evaluates engraving
+capabilities of both pieces of software in detail.  The second
+article is an instructive analysis of engraving issues in
+Rachmaninoff's Piano Prelude No. 6, including comparisons with a
+hand-engraved reference edition.
+
+@item
+June 2006
+
+@uref{http://distrowatch.com,DistroWatch} awards LilyPond and
+@uref{http://distrowatch.com/weekly.php?issue=20060605,writes}
+@qq{Ladies and Gentleman, we are pleased to announce that, based
+on readers' requests, the DistroWatch May 2006 donation has been
+awarded to LilyPond (@euro{}190.00) and Lua (US$250.00).}
 
 @item
 December 2005
 
-Linux journal cover Linux Journal publishes an article titled
-@uref{http://www.linuxjournal.com/article/8364, Make Stunning
-Schenker Graphs with GNU LilyPond}.  It is a in-depth but hands-on
-feature article with crisp LilyPond graphics.  Author Kris Shaffer
-remarks “GNU Lilypond generates beautiful graphics that make
-commercial alternatives seem second-rate.”
+@uref{http://linuxjournal.com,Linux Journal} publishes an article
+titled @uref{http://www.linuxjournal.com/article/8364, Make
+Stunning Schenker Graphs with GNU LilyPond}.  It is an in-depth
+but hands-on feature article with crisp LilyPond graphics.  Author
+Kris Shaffer remarks @qq{GNU Lilypond generates beautiful graphics
+that make commercial alternatives seem second-rate.}
 
 @item
 August 20, 2005
@@ -851,10 +817,10 @@ The Belgian newspaper De Standaard investigates what drives Free
 Software authors in an article titled
 @uref{http://www.standaard.be/Artikel/Detail.aspx?artikelId=G42H5GD6,
 Delen van KENNIS zonder WINSTBEJAG} (Non-profit sharing of
-knowlegde) in its `DS2 bijlage'.  LilyPond is used as an example
-and the article is interspersed with quotes from an `email
-interview' with Jan Nieuwenhuizen. This marks LilyPond's first
-appearance in mainstream printed press. 
+knowlegde) in its @q{DS2 bijlage}.  LilyPond is used as an example
+and the article is interspersed with quotes from an email
+interview with Jan Nieuwenhuizen. This marks LilyPond's first
+appearance in mainstream printed press.
 
 @item
 June 2005
@@ -875,7 +841,8 @@ can do almost anything.}
 @item
 July, August 2004
 
-Dave Phillips wrote an introductory article for Linux Journal At
+Dave Phillips wrote an introductory article for
+@uref{http://linuxjournal.com,Linux Journal}: At
 the sounding edge: LilyPond, parts
 @uref{http://www.linuxjournal.com/article/7657, one} and
 @uref{http://www.linuxjournal.com/article/7719, two}.
@@ -883,9 +850,10 @@ the sounding edge: LilyPond, parts
 @item
 March 2004
 
-Chris Cannam interviewed Han-Wen Nienhuys and Jan Nieuwenhuizen on
-linuxmusician.com (site now defunct). This interview was also
-reviewed in a
+Chris Cannam
+@uref{http://www.all-day-breakfast.com/cannam/linux-musician/lilypond.html,interviewed}
+Han-Wen Nienhuys and Jan Nieuwenhuizen on linuxmusician.com
+(original site defunct).  This interview was also reviewed in a
 @uref{http://slashdot.org/article.pl?sid=04/03/13/2054227&tid=,
 slashdot story}.
 
@@ -908,4 +876,8 @@ issue CMS06.
 @node Old news
 @unnumberedsec Old news
 
+@include web/news-front.itexi
+
 @include web/news.itexi
+
+