summaryrefslogtreecommitdiffstats
path: root/projects/ssic/index.mdwn
blob: 97783956a394d440bae2787bbacd5f98b1527f64 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
<!--#set var="title" value="ssic (Server Side Includes Compiler)" -->
<!--#include virtual="/includes/header.html" -->

This is ssic, a Server Side Includes Compiler.

ssic processes HTML documents with SSI directives formatted as SGML comments.
It can be used to process documents without an HTTP server for local browsing or
to generate static HTML documents to be efficiently served by an HTTP server.
Documents could even be preprocessed, e.g. by a Markdown processor, before being
parsed with ssic.

The set of commands, tags, and variables supported by ssic is mostly a superset
of those supported by the old [NCSA HTTPd][ncsa-httpd-ssi] and a subset of those
supported by [Apache HTTPd's `mod_include`][mod-include-ssi].

ssic uses the `CGI::SSI` Perl module for directive processing.

[ncsa-httpd-ssi]: http://web.archive.org/web/19971210170837/http://hoohoo.ncsa.uiuc.edu/docs/tutorials/includes.html
[mod-include-ssi]: http://httpd.apache.org/docs/2.2/mod/mod_include.html


Downloading
===========

ssic can be found on my files site by [HTTP][dl-http] or [FTP][dl-ftp].

ssic is maintained in a [Git repository][repo-http], which can be cloned from
`git://git.pehjota.net/ssic/ssic.git`.

Debian packaging for ssic is maintained in a separate [Git
repository][repo-debian-http], which can be cloned from
`git://git.pehjota.net/ssic/ssic.debian.git`.  Prebuilt packages are not yet
available.

[dl-http]: http://files.pehjota.net/pub/ssic/
[dl-ftp]: ftp://files.pehjota.net/pub/ssic/
[repo-http]: http://git.pehjota.net/ssic/ssic.git/
[repo-debian-http]: http://git.pehjota.net/ssic/ssic.debian.git/


Examples
========

[This Web site][www-git] is preprocessed with a markdown interpreter and
compiled with ssic.  Compilation is directed by [a makefile][www-git-makefile]
that supports environments with (run `make`) or without (run `make local`) a Web
server.

[My résumé][resume-git] is compiled into an HTML file with ssic (and then
rendered into a PDF file by [WeasyPrint][weasyprint]).

[www-git]: http://git.pehjota.net/www/www.git/
[www-git-makefile]: http://git.pehjota.net/www/www.git/tree/Makefile
[resume-git]: http://git.pehjota.net/resume/resume.git/
[weasyprint]: http://weasyprint.org/

<!--#include virtual="/includes/footer.html" -->