doc: Add nice(r) front-page in Lout.

* doc/modules/skribilo/documentation/manual.scm: Set the `on-title-page'
  custom.

* doc/user/Makefile.am (EXTRA_DIST): Add `lout/front-page.lout.in'.
  (BUILT_SOURCES): Add `lout/front-page.lout'.
  (.lout.ps): Update `-I'.
  (lout/front-page.lout): New target.
  (clean-local): Remove the `lout' directory.

* doc/user/lout/book-style.lout (@ChapterStartPages): Set to `Odd'.

5 files changed, 52 insertions, 7 deletions

diff --git a/doc/modules/skribilo/documentation/manual.scm b/doc/modules/skribilo/documentation/manual.scm
index 8e4f121..bc8fc8a 100644
--- a/doc/modules/skribilo/documentation/manual.scm
+++ b/doc/modules/skribilo/documentation/manual.scm
@@ -159,7 +159,8 @@
    (engine-custom-set! le 'document-include
                        "@Include { \"book-style.lout\" }")
    (engine-custom-set! le 'initial-language "English")
-   (engine-custom-set! le 'initial-font "Palatino Base 10p"))
+   (engine-custom-set! le 'initial-font "Palatino Base 10p")
+   (engine-custom-set! le 'on-title-page (! "@Include { \"front-page.lout\" }")))
 
 
 ;*---------------------------------------------------------------------*/
diff --git a/doc/user/.gitignore b/doc/user/.gitignore
index 79b70d4..2807077 100644
--- a/doc/user/.gitignore
+++ b/doc/user/.gitignore
@@ -14,3 +14,4 @@ user.pdf
 *.png
 *.jpg
 *.eps
+lout/front-page.lout
diff --git a/doc/user/Makefile.am b/doc/user/Makefile.am
index 4020dc7..04d6324 100644
--- a/doc/user/Makefile.am
+++ b/doc/user/Makefile.am
@@ -6,7 +6,7 @@ EXTRA_DIST = bib.skb char.skb colframe.skb document.skb emacs.skb	\
   markup.skb ornament.skb package.skb pie.skb prgm.skb sectioning.skb	\
   skribilo-config.skb compiler.skb skribeinfo.skb slide.skb spacing.skb	\
   start.skb syntax.skb table.skb toc.skb user.skb xmle.skb		\
-  lout/book-style.lout
+  lout/book-style.lout lout/front-page.lout.in
 
 # Examples.
 EXTRA_DIST += src/api1.skb						\
@@ -26,6 +26,7 @@ EXTRA_DIST += src/api1.skb						\
 
 html_DATA = user.html
 dist_html_DATA = skribilo.css
+BUILT_SOURCES = lout/front-page.lout
 CLEANFILES = $(BUILT_SOURCES) $(html_DATA)
 
 skribilo = $(top_builddir)/src/pre-inst-skribilo
@@ -61,19 +62,28 @@ CLEANFILES += user.lout user.lout.ld user.li user.lix
 if HAVE_PS2PDF
 pdf_DATA = user.pdf
 CLEANFILES += $(pdf_DATA)
-else
+else !HAVE_PS2PDF
 ps_DATA = user.ps
 CLEANFILES += $(ps_DATA)
-endif
+endif !HAVE_PS2PDF
 
 .skb.lout:
 	GUILE_LOAD_PATH=$(load_path):$$GUILE_LOAD_PATH \
 	$(skribilo) $(skrflags) --target=lout -o $@ $<
 
 .lout.ps:
-	$(LOUT) -r4 -I$(srcdir)/lout -c $(@:%.ps=%) -o $@ $<
+	$(LOUT) -r4 -I$(srcdir)/lout -I$(builddir)/lout \
+	  -c $(@:%.ps=%) -o $@ $<
 
-endif
+# Variable substitution.
+include $(top_srcdir)/substitute.am
+
+lout/front-page.lout: lout/front-page.lout.in
+	test -d "lout" || mkdir "lout"
+	$(substitute) "$^" > "$@.tmp" &&	\
+	mv "$@.tmp" "$@"
+
+endif HAVE_LOUT
 
 if HAVE_PS2PDF
 .ps.pdf:
@@ -94,3 +104,4 @@ uninstall-local:
 # not listed in `CLEANFILES'.
 clean-local:
 	-rm -f user-*.html *.eps *.png
+	-rm -rf "lout"
diff --git a/doc/user/lout/book-style.lout b/doc/user/lout/book-style.lout
index 423abd1..46c4021 100644
--- a/doc/user/lout/book-style.lout
+++ b/doc/user/lout/book-style.lout
@@ -357,7 +357,7 @@
     @TitlePageFont		{ Schoolbook Bold} # title page font (not size)
   # @SeparateIntroNumbering	{ Yes		} # separate intro page numbers
   # @PrefaceAfterContents  	{ No		} # Yes or No
-  # @ChapterStartPages		{ Any		} # Any, Odd, Even, SamePage
+    @ChapterStartPages		{ Odd		} # Any, Odd, Even, SamePage
   # @ReferencesBeforeAppendices	{ No		} # references before appendices
   # @PrefaceWord		{ preface	} # word for "Preface"
   # @ContentsWord		{ contents	} # word for "Contents"
diff --git a/doc/user/lout/front-page.lout.in b/doc/user/lout/front-page.lout.in
new file mode 100644
index 0000000..888b0d1
--- /dev/null
+++ b/doc/user/lout/front-page.lout.in
@@ -0,0 +1,32 @@
+# -*- coding: latin-1 -*-
+#
+# The front page.
+
+# @SysInclude { doc }
+
+# @Document
+#   @InitialFont { Palatino Base 10p }
+# //
+
+# @Text @Begin
+
+{ Palatino Base 12p } @Font {
+
+//13.7c
+
+{ Palatino Italic 35p } @Font { Skribilo }
+//0.1ce
+{ Helvetica Bold 30p } @Font { User Manual }
+//2fe
+@I { for version @PACKAGE_VERSION@ }
+
+@LP
+@VExpand { }
+@LP
+Érick Gallesio, Manuel Serrano, Ludovic Courtès
+//1.3fx
+"http://www.nongnu.org/skribilo/" @ExternalLink { @I "http://www.nongnu.org/skribilo/" }
+
+}
+
+# @End @Text