53 lines
1.5 KiB
Racket
53 lines
1.5 KiB
Racket
#lang scribble/manual
|
|
@(require scribble/eval "utils.rkt" (for-label racket xml unstable/web))
|
|
|
|
@title{XML and CSS}
|
|
|
|
@defmodule[unstable/web]
|
|
|
|
@unstable[@author+email["Carl Eastlund" "cce@racket-lang.org"]]
|
|
|
|
This module provides tools for programmatic creation of static web pages. It is
|
|
based on the XML collection; see documentation for @scheme[xexpr?].
|
|
|
|
@deftogether[(
|
|
@defthing[css/c flat-contract?]
|
|
@defproc[(css? [v any/c]) boolean?]
|
|
)]{
|
|
This contract and predicate pair recognizes CSS-expressions, which are
|
|
described by the following grammar:
|
|
|
|
@schemegrammar*[
|
|
#:literals (cons list)
|
|
[css (list style ...)]
|
|
[style-def (cons selector (list property ...))]
|
|
[property (list name value)]
|
|
[selector text]
|
|
[name text]
|
|
[value text]
|
|
]
|
|
|
|
Here, @scheme[text] is any of the datatypes described in
|
|
@secref["unstable-text"].
|
|
}
|
|
|
|
@defthing[xexpr/c flat-contract?]{
|
|
This flat contract corresponds to @scheme[xexpr?]. It is reprovided from
|
|
@schememodname[xml]. In versions of Racket before the implementation of
|
|
@scheme[xexpr/c], this module provides its own definition.
|
|
}
|
|
|
|
@defproc[(write-css [css css/c] [out output-port? (current-output-port)])
|
|
void?]{
|
|
This function writes CSS-expressions to output ports by its
|
|
canonical text representation.
|
|
}
|
|
|
|
@deftogether[(
|
|
@defproc[(create-stylesheet [file path-string?] [css css/c]) void?]
|
|
@defproc[(create-webpage [file path-string?] [xexpr xexpr/c]) void?]
|
|
)]{
|
|
These functions write style sheets (represented as CSS-expressions) or
|
|
webpages (represented as X-expressions) to files.
|
|
}
|