From 2ade002c5af3103012a7f21812526b607bb9d90f Mon Sep 17 00:00:00 2001 From: Ludovic Courtès Date: Wed, 23 Apr 2008 22:36:17 +0200 Subject: Update web site, with SUI refs to the user manual. --- web/.gitignore | 2 ++ web/GNUmakefile | 10 ++++++++-- web/index.skb | 36 +++++++++++++++++++++++------------- 3 files changed, 33 insertions(+), 15 deletions(-) (limited to 'web') 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).]))])) -- cgit v1.2.3