use cgi dir for better security
[iankelling.org] / README
1 Content and automated setup of iankelling.org
2
3
4 * Setup
5
6 setup.sh sets up apache and gitweb
7 build.rb does static site generation
8
9 Dependencies for running ./setup.sh DOMAIN: A modern debian based system
10 (tested on debian 8, and debian 8 testing).
11
12 Some shell scripts need to be sourced before running setup.sh:
13 https://iankelling.org/git/?p=distro-functions;a=summary
14 And some programs need to be in PATH:
15 https://iankelling.org/git/?p=basic-https-conf;a=summary
16 https://sallymae.club/git/?p=acme-tiny-wrapper;a=summary
17
18 This repo does not include the repos under /git. In my own version, under /git are links to the .git dirs of the respective repos under the
19 hardcoded directory in setup.sh: gitroot=/a/bin/githtml. These
20 directories are managed separately, mostly by rsyncing them.
21
22 Only the latest version of resume is kept in the resume branch which
23 gets rebased on master.
24
25 ./build.rb does have any dependencies, but it's not a generalized site
26 generator, it has some content files specific to my site that it expects.
27
28 Dates in the blog directory can be generated with date +%F
29
30
31 * Comments
32
33 New comments are stored in a sqlite database. Ones that are not
34 moderated for spam etc, are stored to disk for checkin on the next run
35 of build.rb. get-comments, set-comments, and iank-mod.el are for
36 moderating new comments. With one emacs command, you get a buffer of the
37 new comments, with keybinds to mark them for publishing, moderatation,
38 banning, and execute changes.
39
40 * Inspirations
41
42 http://blog.zorinaq.com/release-of-hablog-and-new-design/?
43 https://mjg59.dreamwidth.org/
44 http://bettermotherfuckingwebsite.com
45 https://eduardoboucas.com/blog/2015/05/11/rethinking-the-commenting-system-for-my-jekyll-site.html
46
47 * License
48
49 Non-software is cc-by-sa 4 unless stated otherwise. Software is under
50 GPLv2 or later unless stated otherwise. I'd use gplv3 or agpl, but it's
51 simpler to use the same license as the gitweb javascript.
52
53 The elisp is GPLv3 because emacs is.
54
55 The opensans font is Apache2 licensed, from google fonts,
56 the license is included in the LICENSE file.