warbo-utilities: cece29ba6490089d202e0bf1c8ef0b33e188bc54

     1: From: Chris Warburton
     2: Date: Mon, 12 Jun 2017 14:48:42 +0100
     3: State: resolved
     4: Subject: New Git-to-HTML command
     5: Message-Id: <e01430ff396e157e-0-artemis@nixos>
     6: resolution: fixed
     7: 
     8: We need a nice way to turn a (bare) git repo into a set of static HTML
     9: files. Currently, the git2html script can do this, but there are
    10: problems:
    11: 
    12:  - git2html pages require a lot of disk space, since they contain the
    13:    content of every file, formatted contents (e.g. including line
    14:    numbers), diffs with parents, etc. for every commit on every
    15:    branch. This is not sustainable.
    16:  - It's straightforward enough to limit git2html to the top commit,
    17:    which we've already done.
    18:  - Another change is to splice the contents of any README into the
    19:    resulting git2html index page.
    20:  - It would be nice to have a browseable archive of Artemis
    21:    issues. These are stored in .issues, and are in maildir format.
    22:  - MHonArc can create a set of HTML pages from maildir.
    23:  - Artemis issues are tracked in the repo (that's the point), but we
    24:    don't need to provide the full history as HTML; since we only append
    25:    to the issues (or mutate them to closed), we only need those from
    26:    HEAD.
    27:  - Resulting combination of git2html and mhonarc's artemis pages should
    28:    be standalone and relativised, so it'll work e.g. via file:// or IPFS