|
||
---|---|---|
.gitea/workflows | ||
.github | ||
archetypes | ||
i18n | ||
layouts | ||
src | ||
static/images | ||
.editorconfig | ||
.gitignore | ||
.lgtm | ||
CONTRIBUTING.md | ||
DCO | ||
gulpfile.js | ||
LICENSE | ||
MAINTAINERS | ||
package-lock.json | ||
package.json | ||
README.md | ||
theme.toml |
Gitea: Theme
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 website, than you can just download our prebuilt theme, put it into your themes/gitea
folder and enable the theme with the theme = "gitea"
option of your website.
Development
We choose npm to fetch our dependencies and gulp 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
If you want to do theme development 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
Whenever you make a change to src/main.scss
and save the file, this will trigger a rebuild of static/styles/main.css
.
To see a preview of your changes on the website, do the following:
- Go to gitea.io
- Open the developer tools
- Click the "Sources" tab
- Open the
gitea.io/styles/main.css
file - Paste the entire
main.css
file from your localgitea/theme
repo wherenpm run watch
is running on
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 automatically.
Contributing
Fork -> Patch -> Push -> Pull Request
Authors
License
This project is under the Apache-2.0 License. See the LICENSE file for the full license text.
Copyright
Copyright (c) 2019 The Gitea Authors <https://gitea.io>