1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
|
## about
Go based [`git2html`](https://github.com/Hypercubed/git2html) remake with custom templating support to help when using `git(1)` as an archival tool basically, because an HTML copy of your commit history is just enough in many cases, such as with solo projects for example.
## setup
Download from GitHub directly:
```sh
go install github.com/thewhodidthis/gtx
```
## usage
Calling without any arguments prints out the default settings. At the very least pass it a repo to be parsing through:
```sh
# NOTE: Will save output in the current directory.
gtx -r https://github.com/thewhodidthis/gtx.git
```
Silence the logger:
```sh
gtx -r https://github.com/thewhodidthis/gtx.git -q
```
Export a copy of the default HTML page template and quit:
```sh
gtx -r https://github.com/thewhodidthis/gtx.git -e
```
Templates can reference external files in the target directory. These are left intact across script runs making it easier to theme the output by linking in stylesheets and other assets as required. Use the `-t` flag to specify a custom template:
```sh
gtx -r https://github.com/thewhodidthis/gtx.git -t page.html.tmpl
```
Only process select branches in order of appearance:
```sh
gtx -r https://github.com/thewhodidthis/gtx.git -b main -b develop
```
## requirements
- `git(1)`
## see also
- [git2html](https://github.com/Hypercubed/git2html)
|