aboutsummaryrefslogtreecommitdiffstats
path: root/doc/src/manual/cowboy_static.asciidoc
diff options
context:
space:
mode:
authorLoïc Hoguin <[email protected]>2016-01-14 13:35:25 +0100
committerLoïc Hoguin <[email protected]>2016-01-14 13:37:20 +0100
commit4023e7f4e429179fd9c2cce4487c33646c6bd327 (patch)
tree3c4e26d1b5592958e35297c82ad3069bdb642594 /doc/src/manual/cowboy_static.asciidoc
parentb7d666cfc746f55b0a72ef8d37f703885099daf7 (diff)
downloadcowboy-4023e7f4e429179fd9c2cce4487c33646c6bd327.tar.gz
cowboy-4023e7f4e429179fd9c2cce4487c33646c6bd327.tar.bz2
cowboy-4023e7f4e429179fd9c2cce4487c33646c6bd327.zip
Convert the documentation to Asciidoc
A few small revisions were made, and Erlang.mk has been updated.
Diffstat (limited to 'doc/src/manual/cowboy_static.asciidoc')
-rw-r--r--doc/src/manual/cowboy_static.asciidoc41
1 files changed, 41 insertions, 0 deletions
diff --git a/doc/src/manual/cowboy_static.asciidoc b/doc/src/manual/cowboy_static.asciidoc
new file mode 100644
index 0000000..658d93b
--- /dev/null
+++ b/doc/src/manual/cowboy_static.asciidoc
@@ -0,0 +1,41 @@
+= cowboy_static(3)
+
+== Name
+
+cowboy_static - static file handler
+
+== Description
+
+The `cowboy_static` module implements file serving capabilities
+by using the REST semantics provided by `cowboy_rest`.
+
+== Types
+
+=== opts() = [Option]
+
+[source,erlang]
+----
+Option = {priv_file, atom(), string() | binary()}
+ | {priv_file, atom(), string() | binary(), Extra}
+ | {file, string() | binary()}
+ | {file, string() | binary(), Extra}
+ | {priv_dir, atom(), string() | binary()}
+ | {priv_dir, atom(), string() | binary(), Extra}
+ | {dir, string() | binary()}
+ | {dir, string() | binary(), Extra}
+
+Extra = [ETag | Mimetypes]
+
+ETag = {etag, module(), function()} | {etag, false}
+
+Mimetypes = {mimetypes, module(), function()}
+ | {mimetypes, binary() | {binary(), binary(), [{binary(), binary()}]}}
+----
+
+Configuration for the static handler.
+
+The handler can be configured for sending either one file or
+a directory (including its subdirectories).
+
+Extra options allow you to define how the etag should be calculated
+and how the mimetype of files should be detected.