1 .\" smarc.1 was written by Omar Polo <op@openbsd.org> and is placed in
2 .\" the public domain.  The author hereby disclaims copyright to this
3 .\" source code.
4 .Dd January 10, 2023
5 .Dt SMARC 1
6 .Os
7 .Sh NAME
8 .Nm smarc
9 .Nd mailing list static site generator
10 .Sh SYNOPSIS
11 .Nm
12 .Op Fl c Ar cachedir
13 .Op Fl j Ar n
14 .Op Fl m Ar maildir
15 .Op Fl o Ar outdir
16 .Op Fl t Ar tmpldir
17 .Sh DESCRIPTION
18 .Nm
19 generates a static web archive from a maildir incrementally.
20 .Pp
21 The arguments are as follows:
22 .Bl -tag -width Ds
23 .It Fl c Ar cachedir
24 Cache directory used for keeping track of threads during incremental
25 updates.
26 Defaults to
27 .Pa ~/.cache/smarc
28 .It Fl j Ar n
29 Use
30 .Ar n
31 jobs to export threads.
32 With big mailing lists and on a multiprocessor machine this can save
33 quite some time.
34 .It Fl m Ar maildir
35 Source
36 .Ar maildir .
37 Defaults to
38 .Pa ~/Mail/smarc .
39 .It Fl o Ar outdir
40 The destination directory where the HTML files will be written to, it's
41 .Pa /var/www/smarc
42 by default.
43 .It Fl t Ar tmpldir
44 Path to a directory containing the template files.
45 .Pa /etc/smarc
46 by default.
47 .El
48 .Sh FILES
49 .Bl -tag -width Ds
50 .It Pa /etc/smarc/foot.html
51 Template with the trailing part of the page.
52 .It Pa /etc/smarc/head.html
53 Template with the first part of the page.
54 .Dv TITLE
55 is substituted with the title.
56 .It Pa /etc/smarc/index-header.html
57 Template with the title for index pages.
58 .Dv PAGE
59 is replaced with the page number and
60 .Dv SUBTITLE
61 with the date range.
62 .It Pa /etc/smarc/logo-small.html
63 Small version of the logo, included in the thread header.
64 .It Pa /etc/smarc/search-link.html
65 Template for the search link used in the mail and thread page.
66 .It Pa /etc/smarc/search.html
67 Template for the search form.
68 .Ev QUERY
69 is replaced with the search query.
70 .It Pa /var/www/smarc
71 Default output directory.
72 .It Pa ~/.cache/smarc
73 Default cache directory.
74 .It Pa ~/Mail/smarc
75 Default maildir.
76 .El
77 .Sh SEE ALSO
78 .Xr smarc 7
79 .Sh HISTORY
80 .Nm
81 started as a hacky collection of perl scripts under the name of
82 .Sq gotmarc
83 to generate a web archive for the Game of Trees mailing list.
84 Only later, while still being a hacky collection of perl and shell
85 scripts, was converted to be a generic web mailing list archive tool and
86 the project renamed.
87 .Sh AUTHORS
88 .An -nosplit
89 The
90 .Nm
91 utility was written by
92 .An Omar Polo Aq Mt op@openbsd.org .