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

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