aboutsummaryrefslogtreecommitdiff
path: root/CONTRIBUTING.md
blob: 9f459b1a1491f84b8dcaf27889abeaacb97a9661 (plain)
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
# Contributing

This repository includes a [GitHub Action][4] that builds the
colorschemes once a week. This keeps the colorschemes up-to-date
automatically.

## Building

### Dependencies

- `>=0.2.0` [base16-builder-go][1]
- golang `>=1.16` to build base16-builder-go

### Usage for template editing

1. Clone [base16-builder-go][1] somewhere on your system.
1. Run `cd /path/to/base-builder-go && go build` to generate a binary:
`/path/to/base-builder-go/base16-builder-go`
1. Now execute the binary you generated while giving the `-template-dir`
arg the path to `base16-vim` repository: `./base16-builder-go
-template-dir ../base16-vim`

Or the above steps represented in shell commands:

```shell 
cd /path/to/base16-vim/../ # This repos parent dir 
git clone git@github.com:base16-project/base16-builder-go.git
cd base16-builder-go
go build ./base16-builder-go/base16-builder-go \
  -template-dir ../base16-vim
```

### Usage for adding or editing a colorscheme

If you want to add or edit a colorscheme but want to test it out, you
simply need to pass in your local [base16-schemes][2] directory when
executing the `base16-builder-go` binary.

```shell
base16-builder-go \
  -schemes-dir /path/to/base16-schemes \
  -template-dir /path/to/base16-vim
```

If you have more questions about [base16-builder-go][1], have a look at
the information on the GitHub page.

## Submitting a PR

- Run the colorscheme generation using [base16-builder-go][1] and commit
  the changes in your PR. Don't make changes directly to the generated
  colorschemes, make changes to the template instead.
- Please abide by what's requested in the [PR template][4].

## Submitting an issue

Please follow the instructions in the issue templates:

- [Issue template for bug reports][5]
- [Issue template for feature requests][6]

[1]: https://github.com/base16-project/base16-builder-go
[2]: https://github.com/base16-project/base16-schemes
[3]: .github/workflows/update.yml
[4]: .github/pull_request_template.md
[5]: .github/ISSUE_TEMPLATE/bug_report.md
[6]: .github/ISSUE_TEMPLATE/feature_request.md