121 lines
4.7 KiB
Markdown
Raw Normal View History

2019-05-06 07:24:44 +00:00
# notify.moe
2017-06-11 09:51:31 +00:00
2019-05-06 07:24:44 +00:00
[![Godoc][godoc-image]][godoc-url]
[![Report][report-image]][report-url]
2019-04-28 15:56:58 +00:00
[![Tests][tests-image]][tests-url]
2019-05-06 07:24:44 +00:00
[![Coverage][coverage-image]][coverage-url]
2019-05-24 05:06:40 +00:00
[![Sponsor][sponsor-image]][sponsor-url]
2019-04-19 10:24:53 +00:00
## How to
### Prerequisites
2018-04-10 10:54:48 +00:00
2019-04-25 00:26:03 +00:00
* Install [Docker](https://www.docker.com/get-started)
* Install [Docker Compose](https://docs.docker.com/compose/install/)
2018-04-10 10:54:48 +00:00
2019-04-19 10:24:53 +00:00
### Installation
2018-04-10 10:54:48 +00:00
2019-04-25 00:26:03 +00:00
Download the source code:
2019-04-18 11:19:15 +00:00
2019-04-23 22:57:48 +00:00
```shell
2019-04-18 11:19:15 +00:00
git clone https://github.com/animenotifier/notify.moe.git && cd notify.moe
```
2019-04-25 00:26:03 +00:00
Download the developer tools:
2019-04-14 07:28:30 +00:00
2019-04-23 22:57:48 +00:00
```shell
2019-04-14 07:28:30 +00:00
docker pull animenotifier/notify.moe
```
2019-04-25 00:26:03 +00:00
Start the developer tools:
2019-04-14 07:28:30 +00:00
2019-04-23 22:57:48 +00:00
```shell
2019-04-25 00:00:53 +00:00
docker-compose up -d
2018-04-10 10:54:48 +00:00
```
2019-04-25 00:26:03 +00:00
Attach to a terminal:
2019-04-18 10:29:33 +00:00
2019-04-25 00:00:53 +00:00
```shell
docker attach notify.moe
```
2018-04-10 10:54:48 +00:00
2019-04-25 00:00:53 +00:00
### Start the server
2019-04-23 22:57:48 +00:00
2019-04-25 00:26:03 +00:00
* Enter the notify.moe directory: `cd notify.moe`
* Download dependencies: `go mod download`
2019-04-25 00:26:03 +00:00
* Compile TypeScript files using: `tsc`
* Start the web server using: `run`
2019-04-18 10:29:33 +00:00
2019-04-19 10:24:53 +00:00
### Networking
2019-04-18 10:34:46 +00:00
2019-04-25 00:26:03 +00:00
* Add `beta.notify.moe 127.0.0.1` to your `hosts` file
2019-04-18 10:34:46 +00:00
2019-04-19 10:24:53 +00:00
### In your browser
2019-04-18 10:29:33 +00:00
2019-04-25 00:26:03 +00:00
* Open the settings, search for certificates
* Import the file `security/default/root.crt` as a trusted Root authority
* Open `https://beta.notify.moe`
2019-04-25 00:00:53 +00:00
### Tips
* You can detach from the terminal using `Ctrl P -> Ctrl Q`.
2019-04-25 00:12:10 +00:00
* If you need to shutdown everything, use `docker-compose down`.
2019-04-25 00:00:53 +00:00
* Your home directory is mounted as `/my` inside Docker.
* Fork the notify.moe repository and upload your changes to the fork.
* Clone all the repositories you use into a `projects` directory inside your home files.
2019-04-25 00:26:03 +00:00
* The `run` binary is a file watcher that will restart the web server when it detects code changes.
* File modification events [don't work](https://github.com/docker/for-win/issues/56) on Docker for Windows.
2019-04-25 00:00:53 +00:00
* Use an editor like [Visual Studio Code](http://code.visualstudio.com) to access the source code on the host.
2019-04-25 00:26:03 +00:00
* To automatically compile TypeScript files in VS Code, press `Ctrl Shift B` and select `tsc: watch`.
* Use a Linux system for maximum performance.
2019-04-25 00:00:53 +00:00
2019-04-28 22:40:02 +00:00
### What now?
* Try the [example task for newcomers](docs/new-contributor-task.md).
* Install Pug/Jade and Stylus extensions for your editor.
* If you're **not** using VS Code, map Pug/Jade to `.pixy` and Stylus to `.scarlet` files (they're similar).
2019-04-28 22:41:42 +00:00
* Make some changes and upload them to your fork.
* Create a pull request on this repository (with the diffs of your fork).
2019-04-28 22:40:02 +00:00
2019-04-19 12:10:58 +00:00
## Find us
2019-04-19 10:24:53 +00:00
* [Discord](https://discord.gg/0kimAmMCeXGXuzNF)
* [Facebook](https://www.facebook.com/animenotifier)
* [Twitter](https://twitter.com/animenotifier)
2019-04-25 00:00:53 +00:00
* [Docker](https://hub.docker.com/r/animenotifier/notify.moe)
2019-04-19 10:24:53 +00:00
* [GitHub](https://github.com/animenotifier/notify.moe)
## Contributing
Please read [CONTRIBUTING.md](https://github.com/animenotifier/notify.moe/blob/go/CONTRIBUTING.md) for details on how to contribute to this project.
2019-05-06 12:17:07 +00:00
## Statistics
![Uptime (30 days)](https://img.shields.io/uptimerobot/ratio/m777678498-177cb6b2990056768877bc2a.svg)
![Mozilla Observatory](https://img.shields.io/mozilla-observatory/grade/notify.moe.svg?publish)
![Chrome Extension](https://img.shields.io/chrome-web-store/users/hajchfikckiofgilinkpifobdbiajfch.svg?label=chrome%20users)
![Firefox Extension](https://img.shields.io/amo/users/anime-notifier.svg?label=firefox%20users)
2019-05-06 10:40:36 +00:00
## Style
2019-05-06 07:24:44 +00:00
Please take a look at the [style guidelines](https://github.com/akyoto/quality/blob/master/STYLE.md) if you'd like to make a pull request.
2019-05-06 10:40:36 +00:00
## Sponsors
2019-05-06 07:24:44 +00:00
2019-06-05 06:50:10 +00:00
| [![Max Räche](https://avatars3.githubusercontent.com/u/39157397?s=70&v=4)](https://github.com/yukinamida) | [![Cedric Fung](https://avatars3.githubusercontent.com/u/2269238?s=70&v=4)](https://github.com/cedricfung) | [![Scott Rayapoullé](https://avatars3.githubusercontent.com/u/11772084?s=70&v=4)](https://github.com/soulcramer) | [![Eduard Urbach](https://avatars3.githubusercontent.com/u/438936?s=70&v=4)](https://eduardurbach.com) |
| --- | --- | --- | --- |
| [Max Räche](https://github.com/yukinamida) | [Cedric Fung](https://github.com/cedricfung) | [Scott Rayapoullé](https://github.com/soulcramer) | [Eduard Urbach](https://eduardurbach.com) |
2018-06-30 05:16:29 +00:00
2019-05-24 05:06:40 +00:00
Want to see [your own name here?](https://github.com/users/akyoto/sponsorship)
2018-06-30 05:16:29 +00:00
2019-05-06 10:40:36 +00:00
[godoc-image]: https://godoc.org/github.com/animenotifier/notify.moe?status.svg
[godoc-url]: https://godoc.org/github.com/animenotifier/notify.moe
[report-image]: https://goreportcard.com/badge/github.com/animenotifier/notify.moe
[report-url]: https://goreportcard.com/report/github.com/animenotifier/notify.moe
[tests-image]: https://cloud.drone.io/api/badges/animenotifier/notify.moe/status.svg
[tests-url]: https://cloud.drone.io/animenotifier/notify.moe
[coverage-image]: https://codecov.io/gh/animenotifier/notify.moe/graph/badge.svg
[coverage-url]: https://codecov.io/gh/animenotifier/notify.moe
2019-05-24 05:06:40 +00:00
[sponsor-image]: https://img.shields.io/badge/github-donate-green.svg
[sponsor-url]: https://github.com/users/akyoto/sponsorship