diff options
| -rw-r--r-- | doc/user/eq.skb | 4 | ||||
| -rw-r--r-- | doc/user/prgm.skb | 1 | ||||
| -rw-r--r-- | web/.gitignore | 2 | ||||
| -rw-r--r-- | web/GNUmakefile | 10 | ||||
| -rw-r--r-- | web/index.skb | 36 |
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).]))])) |