iankelling.org Git - iankelling.org/blob - README

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