Documented development workflow

This commit is contained in:
Thomas Boerger 2016-12-09 09:29:30 +01:00
parent 70fb7b67fb
commit e9a6a64e7f
No known key found for this signature in database
GPG Key ID: 5A388F55283960B6
1 changed files with 40 additions and 0 deletions

View File

@ -7,6 +7,46 @@ This is a Hugo theme that gets used within all of our websites like our blog,
documentation and also the redirects. If you commit any changes to the `master`
branch it will trigger rebuilds of all the related websites.
## Install
You need an existing [Hugo](https://github.com/spf13/hugo) website, than you can
just download our prebuilt [theme](https://dl.gitea.io/theme/master.tar.gz), put
it into your `themes/gitea` folder and enable the theme with the
`theme = "gitea"` option of your website.
## Development
We choose [npm](https://www.npmjs.com/) to fetch our dependencies and
[gulp](http://gulpjs.com/) for the pipeline. We won't cover the installation of
nodejs or npm, for that you can find enough guides depending on your operating
system. First of all you have to install the required dependencies:
```
npm install -q
```
After you have successfully installed the required dependencies you should be
able to use these commands to just clean and build generated sources of the
theme:
```
npm run clean
npm run build
npm run release
```
If you want to do more development on the theme we suggest to use the `watch`
task we have defined to get the changes directly built after saving changes to
a file:
```
npm run watch
```
When you are done with your changes just create a pull request, after merging
the pull request the theme will be published to our [download page]
(https://dl.gitea.io/theme) automatically.
## Contributing
Fork -> Patch -> Push -> Pull Request