fixup gitignore
[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 chost from
18 https://iankelling.org/git/?p=fai;a=summary
19
20 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
21 hardcoded directory in setup.sh: gitroot=/a/bin/githtml. These
22 directories are managed separately, mostly by rsyncing them.
23
24 Only the latest version of resume is kept in the resume branch which
25 gets rebased on master.
26
27 ./build.rb does have any dependencies, but it's not a generalized site
28 generator, it has some content files specific to my site that it expects.
29
30 Dates in the blog directory can be generated with date +%F
31
32
33 * Comments
34
35 New comments are stored in a sqlite database. Ones that are not
36 moderated for spam etc, are stored to disk for checkin on the next run
37 of build.rb. get-comments, set-comments, and iank-mod.el are for
38 moderating new comments. With one emacs command, you get a buffer of the
39 new comments, with keybinds to mark them for publishing, moderatation,
40 banning, and execute changes.
41
42 * Inspirations
43
44 http://blog.zorinaq.com/release-of-hablog-and-new-design/?
45 https://mjg59.dreamwidth.org/
46 http://bettermotherfuckingwebsite.com
47 https://eduardoboucas.com/blog/2015/05/11/rethinking-the-commenting-system-for-my-jekyll-site.html
48
49 * License
50
51 Non-software is cc-by-sa 4 unless stated otherwise. Software is under
52 GPLv2 or later unless stated otherwise. I'd use gplv3 or agpl, but it's
53 simpler to use the same license as the gitweb javascript.
54
55 The elisp is GPLv3 because emacs is.
56
57 The opensans font is Apache2 licensed, from google fonts,
58 the license is included in the LICENSE file.