improve README (#10)

fix installation instructions, improve usage guide
This commit is contained in:
Norwin 2019-04-12 19:35:06 +02:00 committed by GitHub
parent ec4c0a4690
commit f0a80fb530
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -4,24 +4,32 @@ This project acts as a command line tool for operating one or multiple Gitea ins
the Gitea API implementation.
## Installation
Currently no prebuilt binaries are provided.To install a Go installation is needed.
To install, run:
```sh
go install code.gitea.io/tea
```
go get github.com/go-gitea/tea
go install github.com/go-gitea/tea
If the `tea` executable is not found, you might need to set up your `$GOPATH` and `$PATH` variables:
```sh
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
```
## Usage
First of all, you have to create a token on your personal settings -> application.
```
git clone git@try.gitea.io:gitea/gitea.git
cd gitea
First of all, you have to create a token on your `personal settings -> application` page of your gitea instance.
Use this token to login with `tea`:
```sh
tea login add --name=try --url=https://try.gitea.io --token=xxxxxx
```
Now you can use the `tea` commands:
```sh
tea issues
tea releases
```
If you are inside a git repository hosted on a gitea instance, you don't need to specify the `--login` and `--repo` flags!
## Contributing
Fork -> Patch -> Push -> Pull Request