2025-08-29

(sph web shtml)

helpers to create html via sxml

part of sph-lib

module name

(sph web shtml)

exported bindings

procedure: shtml->html shtml port ->

write html from shtml to port, adding a declaration at the beginning

procedure: shtml-alist->options a ->

((content . string:value/false)/string ...) -> sxml:((option _ ...) ...)

create the shtml for multiple

procedure: shtml-heading depth content ... ->

integer sxml -> sxml

create a html heading element, for example

, with the given content

procedure: shtml-hyperlink target title [attributes] ->

string string -> sxml

sxml for an html

procedure: shtml-include-css path ->

create the shtml for including a stylesheet file

procedure: shtml-include-javascript path [is-async] ->

string boolean -> sxml

create the shtml for including a javascript file

variable: shtml-indent

procedure: shtml-indent-create depth ->

integer -> sxml

creates indent with the html entity for the space character so it does not get compressed by the viewer

procedure: shtml-list->list a [ordered?] ->

(sxml/list:sub-list) boolean -> sxml

create the shtml for an unordered or ordered list structure,

procedure: shtml-list->table a ->

((sxml:cell ...) ...) -> sxml

create the shtml for a with content

procedure: shtml-section depth title content attributes ... ->

integer sxml sxml (string/symbol string/symbol) ... -> sxml

create the sxml for an html

tag with attributes, heading and content in a single html tag.
content is put in a

unless it already is contained in single tag or if it is empty.
the single tag is ensured to make accessors for the content area (everything not first heading) simpler

procedure: shtml-text->sxml a ->

replace newlines with (br)