mirror of
https://github.com/carloscuesta/gitmoji.git
synced 2025-12-08 20:14:12 +00:00
72 lines
2.3 KiB
Markdown
72 lines
2.3 KiB
Markdown
# Contributing to gitmoji
|
|
|
|
Hello!
|
|
|
|
Thanks for contributing on [gitmoji](https://github.com/carloscuesta/gitmoji). Before implementing new features and changes, feel free to [submit an issue](https://github.com/carloscuesta/gitmoji/issues/new). We're going to talk here :stuck_out_tongue_winking_eye:.
|
|
|
|
If you would like to add a new emoji to gitmoji, fill the provided `ISSUE_TEMPLATE` when creating an issue and take a look at the contributing section.
|
|
|
|
## How to submit a pull request?
|
|
|
|
1. Fork [this repository](https://github.com/carloscuesta/gitmoji/fork).
|
|
2. Create a new branch with the feature name. (Eg: add-emoji-deploy, fix-website-header)
|
|
3. Make your changes.
|
|
4. Commit your changes. Don't forget to add a commit title with an emoji and a description.
|
|
5. Push your changes.
|
|
6. Submit your pull request.
|
|
|
|
## How to add a gitmoji
|
|
|
|
1. Open the **gitmojis.json** file located at `src/data/gitmojis.json`.
|
|
2. Add your emoji using the following code inside of the `gitmojis array []`:
|
|
3. Save the file and create a pull request.
|
|
|
|
```json
|
|
{
|
|
"emoji": "",
|
|
"code": ":code:",
|
|
"description": "Enter the description for the gitmoji.",
|
|
"name": "code (same as code but without ':' replace underscores for dashes _ => - )"
|
|
}
|
|
```
|
|
|
|
Then, after that you'll need to add a new color to [the vars.scss](https://github.com/carloscuesta/gitmoji/blob/master/src/styles/_includes/_vars.scss) file.
|
|
|
|
You must follow the convention of adding a new item to the `$gitmojis array`. That matches the name that you added at the json file.
|
|
|
|
## How to start gitmoji and update
|
|
|
|
If you want to make changes to the site, follow the next steps:
|
|
|
|
1. Clone gitmoji
|
|
|
|
```bash
|
|
$ git clone https://github.com/carloscuesta/gitmoji.git
|
|
$ cd gitmoji
|
|
```
|
|
|
|
2. Install the dependencies and start the development task.
|
|
|
|
```bash
|
|
$ npm i && gulp
|
|
```
|
|
|
|
3. Make sure the styles are using a link instead of being inlined.
|
|
|
|
_If you are updating the SCSS files and the styles doesn't get updated, go to the `index.pug` and `about.pug` paste the following code_
|
|
|
|
```jade
|
|
link(href="css/style.css", type="text/css", rel="stylesheet")
|
|
```
|
|
|
|
_Remove this one_
|
|
|
|
```jade
|
|
style
|
|
include ../../dist/css/style.css
|
|
```
|
|
|
|
**After making your changes, inline the styles as before.**
|
|
|
|
The project is built with [Pug](http://pugjs.org) and [SCSS](http://sass-lang.com)
|