about summary refs log tree commit diff
path: root/doc/forge.skb
diff options
context:
space:
mode:
Diffstat (limited to 'doc/forge.skb')
-rw-r--r--doc/forge.skb30
1 files changed, 27 insertions, 3 deletions
diff --git a/doc/forge.skb b/doc/forge.skb
index f63b469..c628fde 100644
--- a/doc/forge.skb
+++ b/doc/forge.skb
@@ -394,10 +394,34 @@ be a ,(record-ref "<forge-host-socket>"), ,(record-ref "<forge-ip-socket>"), or
 [/.well-known/acme-challenge/]) in response to ACME HTTP-01
 challenges])
          (record-field "server-blocks"
-           [List of ,(ref :url
+           [List of ,(ref :ident "<forge-nginx-server-configuration>" :text
+"<forge-nginx-server-configuration>") or ,(ref :url
 "https://guix.gnu.org/manual/en/html_node/Web-Services.html#index-nginx_002dserver_002dconfiguration"
-:text "<nginx-server-configuration>") objects describing server blocks
-to add to the nginx configuration]))))
+:text "<nginx-server-configuration>") objects describing server blocks to add to
+the nginx configuration]))
+       (record-documentation "guix/forge/nginx.scm" '<forge-nginx-server-configuration>
+         (record-field "server-name"
+           [List of server names this server represents. ,(code ['default])
+represents the default server for connections matching no other server.])
+         (record-field "root"
+           [Root of the website nginx will serve])
+         (record-field "locations"
+           [List of ,(ref :url
+"https://guix.gnu.org/manual/devel/en/html_node/Web-Services.html#index-nginx_002dlocation_002dconfiguration"
+:text (code [nginx-location-configuration])) or ,(ref :url
+"https://guix.gnu.org/manual/devel/en/html_node/Web-Services.html#index-nginx_002dnamed_002dlocation_002dconfiguration"
+:text (code [nginx-named-location-configuration])) records to use within this
+server block.])
+         (record-field "index"
+           [List of index files to look for when clients ask for a directory. If it
+cannot be found, nginx will send the list of files in the directory.])
+         (record-field "try-files"
+           [List of files whose existence is checked in the specified order.
+nginx will use the first file it finds to process the request.])
+         (record-field "raw-content"
+           [List of strings or file-like objects to be appended to the server
+block. Each item is prefixed with indentation and suffixed with a new line.
+Nested lists are flattened.]))))
     (section :title [ACME service]
              :ident "section-acme-service"
       (p [,(abbr :short "ACME" :long "Automatic Certificate Management