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
Generated by git2html.