This repository has been archived by the owner on May 10, 2020. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathREADME.hbs
81 lines (62 loc) · 3.07 KB
/
README.hbs
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
<!-- Do not modify README.md, instead modify README.hbs -->
# api-js
A JavaScript Wrapper for the [GurbaniNow API](https://github.com/GurbaniNow/api)
[![npm](https://img.shields.io/npm/v/gurbaninow.svg?style=flat-square)](https://www.npmjs.com/package/gurbaninow)
[![Travis (.org)](https://img.shields.io/travis/GurbaniNow/api-js.svg?style=flat-square)](https://travis-ci.org/GurbaniNow/api-js)
[![GitHub license](https://img.shields.io/github/license/GurbaniNow/api-js.svg?style=flat-square)](./LICENSE)
[![GitHub issues](https://img.shields.io/github/issues/GurbaniNow/api-js.svg?style=flat-square)](https://github.com/GurbaniNow/api-js/issues)
[![GitHub pull requests](https://img.shields.io/github/issues-pr/GurbaniNow/api-js.svg?style=flat-square)](https://github.com/GurbaniNow/api-js/pulls)
[![jsdelivr](https://data.jsdelivr.com/v1/package/npm/gurbaninow/badge)](https://www.jsdelivr.com/package/npm/gurbaninow)
## Contents
<!-- toc -->
## Usage
Install the library via NPM:
```
npm install gurbaninow
```
The library can be imported into Node as below:
```javascript
const gn = require('gurbaninow')
gn.getShabad('DMP', true)
```
Additionally, the package is available for web use via [unpkg CDN](https://unpkg.com/gurbaninow).
```
<script src="https://unpkg.com/gurbaninow"></script>
```
Or via [jsDelivr](https://www.jsdelivr.com/package/npm/gurbaninow)
```
<script src="https://cdn.jsdelivr.net/npm/gurbaninow/dist/index.min.js"></script>
```
Want a demo?
[![Try on RunKit](https://img.shields.io/badge/Try%20on%20RunKit-gurbaninow-brightgreen.svg?style=flat-square)](https://npm.runkit.com/gurbaninow)
## API
{{#globals}}
### {{>sig-name}}
{{>description~}}
{{>summary~}}
{{>default~}}
{{>returns~}}
{{>params~}}
{{>examples~}}
{{>member-index~}}
{{>separator~}}
{{>members~}}
{{/globals}}
## Contributing
We're happy to accept suggestions and pull requests!
To get started, clone this repo and run `npm install` inside this directory.
This repository follows the **Airbnb's Javascript Style Guide**, with a few minor modifications. Notably, spaces should be included inside parentheses and brackets (weird, right!). An ESLint file is provided,
and your code will automatically be checked on-commit for style.
It is recommended to install an ESLint plugin for your editor (VS Code's `ESLint` plugin works out of the box), so you can receive
linter suggestions as you type.
When writing commit messages, please follow the **[seven rules](https://chris.beams.io/posts/git-commit/#seven-rules)**.
Markdown and HTML JSDoc documentation is generated automatically, on commit,
however if you'd like to preview any changes to documentation, `npm run build-docs` will
update `README.md`. `README.md` should *not* be edited, instead apply modifications to `README.hbs`.
The general workflow for contributing:
- Fork/create a new branch.
- Write or update existing tests with expected results
- Implement functions/changes
- Add JSDoc function documentation and examples.
- Run tests with `npm test` and ensure they all pass. Testing is done with the `mocha` testing framework.
- Create a pull request with the changes.