]> git.donarmstrong.com Git - lilypond.git/commitdiff
lilypond-0.0.46.jcn1
authorfred <fred>
Sun, 24 Mar 2002 19:37:31 +0000 (19:37 +0000)
committerfred <fred>
Sun, 24 Mar 2002 19:37:31 +0000 (19:37 +0000)
Documentation/examples.pod [new file with mode: 0644]
Documentation/index.pod
bin/make_website

diff --git a/Documentation/examples.pod b/Documentation/examples.pod
new file mode 100644 (file)
index 0000000..cd76ca1
--- /dev/null
@@ -0,0 +1,99 @@
+=head1 NAME
+
+LilyExamples - LilyPond example input
+
+=head1 DESCRIPTION
+
+This file documents the example inputfiles of LilyPond. Information of
+each file: 
+
+       title
+       description (composer, piece)
+       tested LilyPond features.
+       copyright info
+
+=head2 F<cadenza.ly>
+
+A cadenza to Mozart Horn concerto no. 3. 
+
+Features: cadenza mode.
+
+Copyright: public domain
+
+=head2 F<coriolan-alto.ly>
+
+Ludwig van Beethoven (1770-1792), Opus 62 Ouverture zu Collins
+Trauerspiel "Coriolan"
+
+a 5 bar fragment of the alto part
+
+Features: pushgroup, popgroup.
+
+=head2 F<error.ly>
+
+Error messages, context errors.
+
+=head2 F<fugue1.midi.ly>
+
+
+=head2 F<kortjakje.ly>
+
+Ah, vous dirais-je, maman" (Mozart, KV 265), bare 
+bones version.
+
+Features: example with lots of newbie comment.
+
+=head2 F<maartje.ly>
+
+Features: partial measure.
+
+=head2 F<martien.ly>, F<ml*.ly>
+
+Martien Lohman, Viola Quartet. 
+
+Features: n-plets, multi-staff scores.
+
+Copyright:  copyright Martien Lohman 1997. 
+
+=head2 F<midi.ly>
+
+Features: midi output.
+
+=head2 F<plet.ly>
+
+Features: plets.
+
+=head2 F<rhythm.ly>
+
+Features: auto beams, multiple parralel meters.
+
+=head2 F<scales.ly>
+
+Features: plets, accents, beam steepnesses.
+
+=head2 F<scsii-menuetto.ly>
+
+J. S. Bach, Solo Cello Suites. Suite II part v Menuetto I
+
+Features: breaking algorithm, chords, multivoice, accents
+
+=head2 F<standchen.ly> 
+
+St\"andchen (Serenade) "Leise flehen meine
+Lieder" D.957 No.4 Franz Schubert (1797-1828)
+
+Features: multivoice, accents, lyrics, chords, piano music
+
+=head2 F<twinkle.ly>
+
+Features: lyrics
+
+=head2 F<wohltemperirt.ly>
+
+JS Bach, Das Wohltemperirtes Clavier I, Fuga II (c-minor)
+
+a 7 bar fragment. 
+
+Features: stem direction, multivoice.
+
+Copyright: public domain
index d1e05d00e7639117d9b00cc996108a64a04b5a70..d6588acde243c232f0961b724fcc1b4df70bac13 100644 (file)
@@ -2,14 +2,34 @@
 
 LilyPond -- the Webpage
 
+Excuse me for this poor page. I don't really have time for doing this..
+
 =head1 DESCRIPTION
 
-Excuse me for this poor page. I don't really have time for doing this..
+Technically LilyPond is a preprocessor which generates TeX
+(or LaTeX) output which contains information to typeset a musical
+score. Practically it is a typesetter, which only uses TeX as an
+output medium. (this is handy because there exist music fonts for TeX)
 
-[and yes, i write webpages in POD :-]
+As a bonus, you can also output a MIDI file of what you typed.
+
+It translates script files (mudela files or F<*.ly>'s) into TeX input.
+Typesetting music is a complex task, whereas the message that printed
+music conveys is usually a simple one. LilyPond is a try at providing
+a simple interface for setting music.
 
 =head1 DOCUMENTATION
 
+=item *
+<a href=INSTALL.html
+>
+The installation instructions.
+</a
+>
+
+
+
+
 =item *
 <a href=lilypond.html
 >
@@ -46,7 +66,7 @@ errors
 >
 
 =item *
-<a href=lelieblond.png
+<a href=lelieblond.gif
 >
 The lilypond logo (Big)
 </a
@@ -55,36 +75,42 @@ The lilypond logo (Big)
 =item *
 <a href=lelie_logo.gif
 >
-The lilypond logo (in gif format)
+The lilypond logo (in gif format, medium size)
 </a
 >
 
+=item *
+<a href=example_output.html
+>
+examples: MIDI, PS, GIF and input.
+</a
+>
 
 =item *
-<a href=wohltemperirt.ly.txt
+<a href=examples.html
 >
-An example inputfile: from Bach's WTK: c-minor fugue
+info on examples
 </a
 >
 
 =item *
-<a href=wohltemperirt.gif
+<a href=TODO.txt
 >
-A Gif file of the example
+The TODO list.
 </a
 >
 
 =item *
-<a href=wohltemperirt.ps
+<a href=NEWS.txt
 >
-PS output
+The Change log
 </a
 >
 
 =item *
-<a href=wohltemperirt.midi
+<a href=CodingStyle.html
 >
-MIDI output
+The coding standards of the lilypond project.
 </a
 >
 
@@ -100,9 +126,18 @@ The DOC++ documentation of the C++ sources.
 Get it at ftp://pcnov095.win.tue.nl/pub/lilypond !
 =cut
 niet veranderen in expliciete URL. pod2* doet dit automaties.
+
+Should generate auto from POD sources.
+
 =pod
 
 
 =head1 AUTHOR
 
 Han-Wen Nienhuys <hanwen@stack.nl>, for this page
+
+<a href=sconstat/stats.html
+>
+Stats on this page.
+</a
+>
index 5b360b94fbdb5bb5113ec6af568cefde61b1b9cb..e728bf9d2715fd4519e4cbac647c3c4f00811972 100755 (executable)
@@ -1,4 +1,6 @@
 #!/usr/bin/perl -w
+# stuff should be generated in out directory.
+
 sub
        set_hrefs
 {
@@ -22,25 +24,93 @@ sub all_refs
 }
 
 local $base="lilypond/";
-local @examples=("wohltemperirt");
+local @examples=("wohltemperirt" ,"standchen", "scsii-menuetto");
+
+#mkdir "lilypond";
+sub
+    gen_html
+{
+    print "generating HTML";
+    foreach $a (<*.pod>) {
+       $f = $a;
+       $f =~ s/.pod/.html/;
+
+       system "pod2html $a"    if ( ! -f $f ) ;
+    }
+}
+
+sub
+    gen_examples
+{
+    print "generating examples: ";
+    foreach $a (@examples) {
+       print "$a\n";
+       $texfile="test";
+       $tex = "tex $texfile";
+       if ($a eq "standchen" || $a eq "scsii-menuetto") {
+           $tex = "latex input/$a";
+           $texfile = "$a";
+       }
+       if ( ! -f "$a.ly.txt" ) {
+           system "ln ../input/$a.ly ./$a.ly.txt";
+       }
+       if ( ! -f "$a.ps.gz" ) {
+           system "cd ..; lilypond input/$a;$tex;".
+               "dvips -o $a.ps $texfile;";
+       }
+       # generate the pixmap at twice the size, then rescale (for antialiasing)
+       if ( ! -f "$a.gif" ) {
+           system "mv ../$a.ps $a.ps; ".
+               "mv ../lelie.midi ../$a.midi $a.midi; ".
+                   "gs -q -sDEVICE=ppmraw -sOutputFile=- -r200 -dNOPAUSE  $a.ps -c quit |pnmscale 0.5| ppmtogif > $a.gif";
+           system "gzip $a.ps";
+       }   
+    }
+}
 
-system  'pod2html';
 
-print "generating examples";
+sub
+    gen_list
+{
+    open HTMLLIST, ">example_output.html";
+    print HTMLLIST "<title>LilyPond examples</title>\n";
+    foreach $a (@examples) {
+       $name=$a;
+       print HTMLLIST "<h1>example file: $name</h1>\n<XMP>\n";
+       $cmd= "head ../input/$a.ly | grep \^% \| sed \"s/^%/    /\"";
+       $desc = `$cmd`;
+       print HTMLLIST "$desc\n</XMP>";
 
-foreach $a (@examples) {
-    $texfile="test";
-    system "ln ../input/$a.ly ./$a.ly.txt";
-    system "cd ..; lilypond input/$a; tex $texfile;".
-       "dvips -o $texfile.ps $texfile;";
+       $inputf="$a.ly.txt";
+       $giff="$a.gif";
+       $psf="$a.ps.gz";
+       $midif="$a.midi";
+       
+       print HTMLLIST "<ul>
+<li><a href=$inputf> The input file</a>
+<li><a href=$giff>The output (gif)</a>
+<li><a href=$psf>The output (PS)</a>
+<li><a href=$midif>The output (MIDI)</a>
+</ul>";
+    }
+}
+sub
+    copy_files
+{  
+    print `ln -s ../out ./docxx` if ( ! -x "docxx" ) ;
+    system "cp ../TODO ./TODO.txt";
+    system "cp ../NEWS ./NEWS.txt";
+}
 
-    # generate the pixmap at twice the size, then rescale (for antialiasing)
-    if ( ! -f "$a.gif" ) {
-    system "mv ../$texfile.ps $a.ps; ".
-       "mv ../lelie.midi $a.midi; ".
-        "gs -q -sDEVICE=ppmraw -sOutputFile=- -r200 -dNOPAUSE  $a.ps -c quit |pnmscale 0.5| ppmtogif > $a.gif";
-    }   
+sub
+    do_tar
+{
+     system " tar hcf website.tar *.html *.gif lelie_logo.png *.ps.gz *.ly.txt *.midi docxx/*;" .
+    "gzip -f9 website.tar;" if ( ! -f "website.tar" ) ;
 }
 
-system "cd out; tar hcf ../website.tar *.html *.gif lelie_logo.png *.ps *.ly.txt *.midi docxx/;" .
-    "gzip -f9 website.tar;"
+gen_html;
+gen_examples;
+gen_list;
+copy_files;
+do_tar;