gmi-web/CONTRIBUTING.md

18 lines
933 B
Markdown
Raw Permalink Normal View History

2021-02-19 20:40:24 +00:00
There are currently three core components to gmi-web.
2021-02-19 21:05:50 +00:00
- `html.js` gmi-to-html implementation
2021-02-20 23:46:07 +00:00
- `gmi.css` and `gmi-web.css` stylesheets consumed by `css.js`
2021-02-19 21:05:50 +00:00
- gmi-web(1) as defined by `cli.js`
2021-02-19 20:40:24 +00:00
2021-02-20 23:46:07 +00:00
You will need [node(1)](https://nodejs.org/en/) and [scdoc(1)](https://git.sr.ht/~sircmpwn/scdoc) to run `cli.js` and build the `gmi-web.1.scd` man page. `npm link` will install gmi-web(1) from the source allowing you to make modifications locally and test them immediately.
2021-02-19 20:40:24 +00:00
```
git clone https://codeberg.org/talon/gmi-web.git
cd gmi-web
npm link
```
2021-02-24 22:13:06 +00:00
Use `npm run test` to compare your changes to the latest snapshots and when you are ready `npm run test:update` to save the current snapshots. `npm run test:watch` will auto-run the tests interactively to streamline this process.
2021-02-19 20:40:24 +00:00
Patches and issues can be submitted to code@talon.computer or expressed through the channels available on [Codeberg](https://codeberg.org/talon/gmi-web).