summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDavid Thompson <dthompson2@worcester.edu>2016-04-02 17:08:23 -0400
committerDavid Thompson <dthompson2@worcester.edu>2016-04-02 17:08:23 -0400
commit4d31eb056c49784aba4b104ab7e75b351cf580af (patch)
tree5e82cf9824e909b795518e0e3e58d527dda5b383 /doc
parent961f061c4b063c2aea81827b3b48a1ba13db59f5 (diff)
doc: Write command-line interface chapter.
Diffstat (limited to 'doc')
-rw-r--r--doc/haunt.texi95
1 files changed, 95 insertions, 0 deletions
diff --git a/doc/haunt.texi b/doc/haunt.texi
index 5c65123..db898d1 100644
--- a/doc/haunt.texi
+++ b/doc/haunt.texi
@@ -277,9 +277,104 @@ programming interfaces.
@node Command-line Interface
@chapter Command-line Interface
+@menu
+* Invoking haunt build:: Build the website.
+* Invoking haunt serve:: Serve the website over HTTP.
+@end menu
+
+The Haunt command-line interface is composed of many subcommands. The
+general syntax for all Haunt commands is:
+
+@example
+haunt @var{subcommand} @var{options}@dots{}
+@end example
+
+@node Invoking haunt build
+@section Invoking @command{haunt build}
+
+The @command{haunt build} command realizes a Haunt site configuration
+file by compiling web pages and copying static assets to the output
+directory. For details on how to configure a Haunt site,
+@pxref{Sites}.
+
+Example:
+
+@example
+haunt build --config=haunt.scm
+@end example
+
+@table @code
+
+@item --config=@var{configuration-file}
+@itemx -c @var{configuration-file}
+Load the Haunt site declaration from @var{configuration-file}.
+
+@end table
+
+@node Invoking haunt serve
+@section Invoking @command{haunt serve}
+
+The @command{haunt serve} command allows one to quickly view a local
+preview of the generated website before publishing the finished
+product to a remote web server. When @command{haunt serve} runs, a
+local HTTP server is spawned. Visit the server using a web browser to
+inspect the results of the build. By default, the web server listens
+on port 8080, so the URL to visit would be
+@url{http://localhost:8080}.
+
+While developing, it is common to rebuild the site frequently to view
+the results of incremental changes. Rather than manually running
+@command{haunt build} (@ref{Invoking haunt build}) each time changes
+are made, the @code{--watch} flag can be used to automatically rebuild
+the site when a source file changes on disk.
+
+@table @code
+
+@item --config=@var{configuration-file}
+@itemx -c @var{configuration-file}
+Load the Haunt site declaration from @var{configuration-file}.
+
+@item --port=@var{port}
+@itemx -p @var{port}
+
+Listen for HTTP requests on @var{port}.
+
+@item --watch
+@itemx -w
+
+Automatically rebuild the site when source files change.
+
+@end table
+
@node Programming Interface
@chapter Programming Interface
+@menu
+* Sites:: Description of the site and how to build it.
+* Posts:: Articles, prose, blog posts, etc.
+* Readers:: Post interpreters.
+* Pages:: HTML/XML pages.
+* Assets:: Images, stylesheets, etc.
+@end menu
+
+Haunt is a fully-programmable system composed of several Guile Scheme
+modules. This section documents the public API.
+
+@node Sites
+@section Sites
+
+@node Posts
+@section Posts
+
+@node Readers
+@section Readers
+
+@node Pages
+@section Pages
+
+@node Assets
+@section Assets
+
@node Contributing
@chapter Contributing