summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/user/eq.skb4
-rw-r--r--doc/user/prgm.skb1
-rw-r--r--web/.gitignore2
-rw-r--r--web/GNUmakefile10
-rw-r--r--web/index.skb36
5 files changed, 36 insertions, 17 deletions
diff --git a/doc/user/eq.skb b/doc/user/eq.skb
index ff46b5c..8a49a42 100644
--- a/doc/user/eq.skb
+++ b/doc/user/eq.skb
@@ -1,6 +1,6 @@
;;; eq.skb -- Equation formatting.
;;;
-;;; Copyright 2006, 2007 Ludovic Courtès <ludovic.courtes@laas.fr>
+;;; Copyright 2006, 2007, 2008 Ludovic Courtès <ludo@gnu.org>
;;;
;;;
;;; This program is free software; you can redistribute it and/or modify
@@ -20,7 +20,7 @@
;;; FIXME: This is a stub and must be completed!
-(chapter :title [Equation Formatting]
+(chapter :title [Equation Formatting] :ident "equations"
(p [Skribilo comes with an equation formatting package. This package
may be loaded by adding the following form at the top of your document:]
diff --git a/doc/user/prgm.skb b/doc/user/prgm.skb
index 5c681f8..1ad8814 100644
--- a/doc/user/prgm.skb
+++ b/doc/user/prgm.skb
@@ -31,6 +31,7 @@
;* Computer programs */
;*---------------------------------------------------------------------*/
(chapter :title "Computer Programs"
+ :ident "programs"
(p [In a document describing a computer programming language, it is
common to include excerpt of programs. Program code is typically
diff --git a/web/.gitignore b/web/.gitignore
index dcaf716..97690cf 100644
--- a/web/.gitignore
+++ b/web/.gitignore
@@ -1 +1,3 @@
index.html
+doc
++*
diff --git a/web/GNUmakefile b/web/GNUmakefile
index 37b2a5e..7affa5b 100644
--- a/web/GNUmakefile
+++ b/web/GNUmakefile
@@ -1,11 +1,17 @@
-SKRIBILO := skribilo -v2
+top_srcdir = ..
+
+SKRIBILO := $(top_srcdir)/src/pre-inst-skribilo -v2
docs := index.skb
-products := $(docs:%.skb=%.html)
+products := doc $(docs:%.skb=%.html)
all: $(products)
+# We need this dummy directory to have correct SUI references.
+doc:
+ ln -s $(top_srcdir)/doc/user doc
+
%.html: %.skb
$(SKRIBILO) --target=html -o $@ $^
diff --git a/web/index.skb b/web/index.skb
index bbe09bd..829c06a 100644
--- a/web/index.skb
+++ b/web/index.skb
@@ -90,6 +90,10 @@
(define (stklos . body)
(ref :url "http://www.stklos.org/" :text body))
+
+(define %user-sui
+ ;; Location of the User Manual's SUI file.
+ "doc/user.sui")
;;;
@@ -128,17 +132,23 @@ the underlying Scheme implementation.])
(chapter :title [Features] :number #f :file #f
(itemize
- (item [Output in a variety of formats: HTML, XML, ,(lout
-[Lout]), ,(latex [LaTeX]), ,(context [ConTeXt]).])
- (item [Input using ,(skribe* [Skribe])'s markup (see
-,(ref :mark "self" :text [this example])) or using free form,
-markup-less text and conventions similar to those used in
-,(emacs/outline [Emacs' outline mode]).])
- (item [Packages are available to produce: slides (overhead
-transparencies), pie charts, equation formatting, syntax highlighting of
-computer programs, and others.])
- (item [Bibliography management, i.e., BibTeX on steroids thanks
-to the programmability brought by ,(scheme [Scheme]).])
+ (item [Output in a ,(ref :skribe %user-sui :ident "engines"
+:text [variety of formats]): HTML, XML, ,(lout [Lout]), ,(latex
+[LaTeX]), ,(context [ConTeXt]).])
+ (item [Input using ,(skribe* [Skribe])'s ,(ref :skribe
+%user-sui :ident "skribe-syntax" :text [markup]) (see ,(ref :mark "self"
+:text [this example])) or using free form, markup-less text and
+conventions similar to those used in ,(ref :skribe %user-sui :ident
+"outline-syntax" :text [Emacs' outline mode]).])
+ (item [Packages are available to produce: ,(ref :skribe
+%user-sui :ident "slides" :text [slides]) (overhead transparencies),
+,(ref :skribe %user-sui :ident "pie-charts" :text [pie charts]), ,(ref
+:skribe %user-sui :ident "equations" :text [equation formatting]), ,(ref
+:skribe %user-sui :ident "programs" :text [syntax highlighting of
+computer programs]), and others.])
+ (item [,(ref :skribe %user-sui :chapter "Bibliographies" :text
+[Bibliography management]), i.e., BibTeX on steroids thanks to the
+programmability brought by ,(scheme [Scheme]).])
(item [Use of a proper module system (currently that of ,(guile
[Guile])) rather than ,(tt [load])-style interactions.])
(item [And much more! :-)])))
@@ -156,8 +166,8 @@ you need the following pieces of software:
(item [,(guile [GNU Guile]) 1.8.3 or later;])
(item [,(ref :url "http://www.nongnu.org/guile-reader/"
:text [Guile-Reader]) 0.3 or later;])
- (item [either ,(lout [Lout]) (3.31 or later) or ,(latex [LaTeX]) to produce
-hard copies (PostScript/PDF);])
+ (item [either ,(lout [Lout]) (3.31 or later), ,(latex [LaTeX]) or
+,(context [ConTeXt]) to produce hard copies (PostScript/PDF);])
(item [optionally, ,(ploticus [Ploticus]) to produce pie charts
(alternatively, ,(lout [Lout]) can be used for that purpose).]))]))