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

   1 Content and automated setup of iankelling.org
   2
   3 * Dependencies
   4
   5 Requires a modern debian based OS, tested on debian 8 & 9.
   6
   7 Some programs need to be in PATH:
   8 https://iankelling.org/git/?p=basic-https-conf;a=summary
   9 chost from
  10 https://iankelling.org/git/?p=fai;a=summary
  11
  12
  13 * Installation
  14
  15 I use a submodule, so git clone --recursive.
  16
  17 ./setup.sh
  18 ./build.rb
  19
  20
  21 * Usage notes
  22
  23 This repo does not include the repos under /git.  In my setup,
  24 under /git are links to the .git dirs of the respective repos under the
  25 hardcoded directory in setup.sh: gitroot=/a/bin/githtml. These
  26 directories are managed separately, mostly by rsyncing them.
  27
  28 Only the latest version of resume is kept in the "r" branch which
  29 gets rebased on master.
  30
  31 ./build.rb is not a generalized site generator, it has some content
  32 files specific to my site that it expects.
  33
  34 Dates in the blog directory can be generated with date +%F
  35
  36
  37 * Blog Comments
  38
  39 New comments are stored in a sqlite database. There is a system for
  40 moderating, rate limiting, and handling comments based on previously
  41 seen ips. See _site/cgi/comment.  Comments that are not spam etc, are
  42 stored to disk for git commit on the next run of build.rb.
  43 get-comments, set-comments, and iank-mod.el are for moderating new
  44 comments. With one emacs command, you get a buffer of the new comments,
  45 with keybinds to mark them for publishing, moderatation, banning, and
  46 execute changes.
  47
  48 * Other sites that are in some way interesting:
  49
  50 http://blog.zorinaq.com/release-of-hablog-and-new-design/?
  51 https://mjg59.dreamwidth.org/
  52 http://bettermotherfuckingwebsite.com
  53 https://eduardoboucas.com/blog/2015/05/11/rethinking-the-commenting-system-for-my-jekyll-site.html
  54 https://chris-lamb.co.uk/posts/concorde
  55
  56 * License
  57
  58 Non-software is cc-by-sa 4 unless stated otherwise.  Software is under
  59 GPLv2 or later unless stated otherwise. I'd use gplv3 or agpl, but it's
  60 simpler to use the same license as the gitweb javascript.
  61
  62 The elisp is GPLv3 because emacs is.