Handle PWP files. This predicate is defined to create a simple
HTTP server from a hierarchy of PWP, HTML and other files. The
interface is kept compatible with the
library(http/http_dispatch). In the typical usage scenario, one
needs to define an http location and a file-search path that is
used as the root of the server. E.g., the following declarations
create a self-contained web-server for files in /web/pwp/.
user:file_search_path(pwp, '/web/pwp').
:- http_handler(root(.), pwp_handler([path_alias(pwp)]), [prefix]).
Options include:
- path_alias(+Alias)
- Search for PWP files as Alias(Path). See absolute_file_name/3.
- index(+Index)
- Name of the directory index (pwp) file. This option may
appear multiple times. If no such option is provided,
pwp_handler/2 looks for
index.pwp.
- view(+Boolean)
- If
true (default is false), allow for ?view=source to serve
PWP file as source.
- index_hook(:Hook)
- If a directory has no index-file, pwp_handler/2 calls
Hook(PhysicalDir, Options, Request). If this semidet
predicate succeeds, the request is considered handled.
- hide_extensions(+List)
- Hide files of the given extensions. The default is to
hide .pl files.
- dtd(?DTD)
- DTD to parse the input file with. If unbound, the generated
DTD is returned
- Errors
- -
permission_error(index, http_location, Location) is
raised if the handler resolves to a directory that has no
index.
- See also
- - reply_pwp_page/3
