From: Carl Sorensen <c_sorensen@byu.edu>
Date: Wed, 18 Aug 2010 14:10:00 +0000 (-0600)
Subject: Build -- Add scripts/auxiliar/doc-section.sh
X-Git-Tag: release/2.13.31-1~47
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=a92f1c53e4748832f5964dae6edfab668f13bf9e;p=lilypond.git

Build -- Add scripts/auxiliar/doc-section.sh
---

diff --git a/scripts/auxiliar/doc-section.sh b/scripts/auxiliar/doc-section.sh
new file mode 100755
index 0000000000..291f600618
--- /dev/null
+++ b/scripts/auxiliar/doc-section.sh
@@ -0,0 +1,99 @@
+#!/bin/sh
+
+#  Build html versions of sections of lilypond documentation
+#
+#  Usage:  doc-section.sh MANUAL SECTION
+#
+#   where MANUAL is the manual and SECTION is the section to be built.
+#
+#   For example, NR 1.2 would be built by
+#       doc-section.sh notation rhythms
+#
+#     and LM 1 would be built by
+#       doc-section.sh learning tutorial
+#
+#   At the end of the run, the user is prompted whether or not to remove files
+#
+#  Before first use, the following must be done:
+#     * Set FROMDIR, DOCDIR, TODIR, LILYPONDBOOK, and TEXI2HTML for your system
+#     * Create $DOCDIR
+#     * Copy version.itexi from somewhere in your Documentation tree
+#         (probably Documentation/out) to $DOCDIR
+#
+#  Known limitations:
+#
+#     * Doesn't use website css files
+#     * bitmap images aren't loaded properly
+#
+
+#
+#  Customize the file here
+#
+FROMDIR="$HOME/lilypond"
+DOCDIR="$HOME/lilypond/tempdocs"
+TODIR=$DOCDIR/$NAME
+LILYPONDBOOK="lilypond-book"
+TEXI2HTML="texi2html"
+REFCHECK="$FROMDIR/scripts/auxiliar/ref_check.py"
+
+DIRECTORY=$1
+NAME=$2
+
+if test ! -d $TODIR; then
+  mkdir $TODIR
+fi
+if test ! -d $TODIR/out; then
+  mkdir $TODIR/out
+fi
+
+cp $FROMDIR/Documentation/common-macros.itexi $TODIR/common-macros.itexi
+cp $FROMDIR/Documentation/macros.itexi $DOCDIR/macros.itexi
+cp $DOCDIR/version.itexi $TODIR/version.itexi
+
+if test -e cp_$NAME.sh; then
+  cp_$NAME.sh $FROMDIR $TODIR
+fi
+
+if test -e $TODIR/$NAME.html; then
+  rm $TODIR/$NAME.html
+fi
+
+if test -e $TODIR/out/$NAME.texi; then
+  rm $TODIR/out/$NAME.texi
+fi
+
+echo "Running lilypond-book"
+$LILYPONDBOOK \
+        -f texi-html \
+        -I $FROMDIR/Documentation/snippets \
+        -I $FROMDIR/Documentation/snippets/new \
+        -I $FROMDIR/input/manual \
+        -I $FROMDIR/Documentation \
+        -I $FROMDIR/Documentation/included  \
+        -o $TODIR/out \
+        $FROMDIR/Documentation/$DIRECTORY/$NAME.itely
+BOOKRC=$?
+if [ $BOOKRC != 0 ]; then
+  echo "Lilypond-book returned code $BOOKRC"
+  exit $BOOKRC
+fi
+
+echo Running RefCheck
+python $REFCHECK
+
+cd $DOCDIR
+if test -f $TODIR/out/$NAME.texi; then
+  echo Running texi2html
+  cat $DOCDIR/macros.itexi $TODIR/out/$NAME.texi > $TODIR/$NAME.texi
+  $TEXI2HTML \
+    --no-validate \
+    --output=$TODIR/out/$NAME.html \
+    --I=$TODIR/out \
+    $TODIR/$NAME.texi
+fi
+
+read -p "delete files? (y/n): "
+if [ "$REPLY" = "y" ]; then
+  echo "deleting files"
+  rm -rf $TODIR
+fi
diff --git a/scripts/auxiliar/ref_check.py b/scripts/auxiliar/ref_check.py
old mode 100644
new mode 100755