graphene/docs/README.md

44 lines
1.1 KiB
Markdown
Raw Normal View History

2015-11-21 21:33:29 +03:00
# Graphene Docs
2015-11-30 11:25:18 +03:00
Graphene docs are powered by [gatsby](https://github.com/gatsbyjs/gatsby).
2015-11-21 21:33:29 +03:00
## Installation
For running locally this docs. You have to execute
```bash
npm install -g gatsby && npm install
```
And then
```bash
gatsby develop
2015-11-30 11:25:18 +03:00
```
## Playground
If you want to have the playground running too, just execute
```
./playground/graphene-js/build.sh
```
This command will clone the [pypyjs-release-nojit](https://github.com/pypyjs/pypyjs-release-nojit) repo, update it with the latest graphene, graphql-core and graphql-relay code, and make it available for the `/playground` view in the docs.
## Build
For building the docs into the `public` dir, just run:
```bash
npm run build
```
## Automation
Thanks to [Travis](https://github.com/graphql-python/graphene/blob/master/.travis.yml#L39-L58), we automated the way documentation is updated in the `gh-pages` branch.
Each time we modify the docs in the `master` branch the travis job runs and updates the `gh-pages` branch with the latest code, so [Graphene's website](http://graphene-python.org) have always the latest docs.