Gitea-Modern/Gitea/readme.md

## Gitea Modern
This style changes the layout of Gitea, and uses Gitea's color variables. It can be used with any theme that changes only colors.
| ![Gitea Modern Repository Page](https://codeberg.org/Freeplay/css-styles/raw/branch/main/images/codeberg-modern_repoPg.png) | ![Gitea Modern Explore Page](https://codeberg.org/Freeplay/css-styles/raw/branch/main/images/codeberg-modern_explorePg.png) | ![Gitea Modern Profile Page](https://codeberg.org/Freeplay/CSS-Styles/raw/branch/main/images/codeberg-modern_profilePg.png)
|---|---|---|

**Note:** The [Stylus browser extension](https://add0n.com/stylus.html) and [Stylus preprocessor](https://stylus-lang.com/) are two different things.

### Usage as Gitea theme
To install the theme for all Gitea users:

0. Make sure you're on the latest version of Gitea! (Working 1.15)
1. Download the [`theme-gitea-modern.css` file][theme-file] and add it to your custom folder in `$GITEA_CUSTOM/public/css/` ([learn how to find that directory][doc-dir]).
  - The path has changed in Gitea 1.15, there the file needs to be placed in `$GITEA_CUSTOM/public/assets/css`
2. Adapt your `app.ini` to make it the default theme or be user-selectable:
    - To change the default theme, change the value of `DEFAULT_THEME` in the [ui section][doc-config] of `app.ini` to `gitea-modern`

    - To make a theme selectable by users in their profile settings, append `,gitea-modern` to the list of `THEMES` in your `app.ini`.
3. Restart Gitea
4. Enjoy :)


### Usage with Stylus
If you use the [Stylus browser extension](https://add0n.com/stylus.html), you can use the [`theme-gitea-modern.user.css`][usertheme-file] file to apply to any Gitea instance.

### Contributing
To make changes, always base them on [`theme-gitea-modern.styl`](theme-gitea-modern.styl), which requires the [Stylus preprocessor](https://stylus-lang.com/).
When making contributions, don't use the compiled version for your changes.

[theme-file]: https://codeberg.org/Freeplay/CSS-Styles/raw/branch/main/Gitea/theme-gitea-modern.css
[usertheme-file]: https://codeberg.org/Freeplay/CSS-Styles/raw/branch/main/Gitea/theme-gitea-modern.user.css
[doc-config]: https://docs.gitea.io/en-us/config-cheat-sheet/#ui-ui
[doc-dir]: https://docs.gitea.io/en-us/faq/#where-does-gitea-store-what-file
Update 'Gitea/readme.md' 2021-07-31 15:59:13 +00:00			`## Gitea Modern`
Update Readme 2021-10-16 15:56:42 +00:00			`This style changes the layout of Gitea, and uses Gitea's color variables. It can be used with any theme that changes only colors.`
Update 'Gitea/readme.md' 2021-07-27 15:29:53 +00:00			`\| ![Gitea Modern Repository Page](https://codeberg.org/Freeplay/css-styles/raw/branch/main/images/codeberg-modern_repoPg.png) \| ![Gitea Modern Explore Page](https://codeberg.org/Freeplay/css-styles/raw/branch/main/images/codeberg-modern_explorePg.png) \| ![Gitea Modern Profile Page](https://codeberg.org/Freeplay/CSS-Styles/raw/branch/main/images/codeberg-modern_profilePg.png)`
			`\|---\|---\|---\|`

Update Readme 2021-10-16 15:56:42 +00:00			`Note: The [Stylus browser extension](https://add0n.com/stylus.html) and [Stylus preprocessor](https://stylus-lang.com/) are two different things.`
Update 'codeberg/readme.md' 2021-07-22 17:33:16 +00:00
document & simplify deployment as gitea theme 2021-07-30 10:10:03 +00:00			`### Usage as Gitea theme`
			`To install the theme for all Gitea users:`
Update 'codeberg/readme.md' 2021-07-05 17:40:57 +00:00
Update 'Gitea/readme.md' 2021-10-27 21:44:54 +00:00			`0. Make sure you're on the latest version of Gitea! (Working 1.15)`
document & simplify deployment as gitea theme 2021-07-30 10:10:03 +00:00			1. Download the [`theme-gitea-modern.css` file][theme-file] and add it to your custom folder in `$GITEA_CUSTOM/public/css/` ([learn how to find that directory][doc-dir]).
			- The path has changed in Gitea 1.15, there the file needs to be placed in `$GITEA_CUSTOM/public/assets/css`
			2. Adapt your `app.ini` to make it the default theme or be user-selectable:
			- To change the default theme, change the value of `DEFAULT_THEME` in the [ui section][doc-config] of `app.ini` to `gitea-modern`
Update 'Gitea/readme.md' 2021-07-27 16:06:44 +00:00
document & simplify deployment as gitea theme 2021-07-30 10:10:03 +00:00			- To make a theme selectable by users in their profile settings, append `,gitea-modern` to the list of `THEMES` in your `app.ini`.
			`3. Restart Gitea`
			`4. Enjoy :)`
Update 'codeberg/readme.md' 2021-07-05 18:00:38 +00:00
document & simplify deployment as gitea theme 2021-07-30 10:10:03 +00:00
			`### Usage with Stylus`
Update 'Gitea/readme.md' 2021-09-02 22:13:11 +00:00			If you use the [Stylus browser extension](https://add0n.com/stylus.html), you can use the [`theme-gitea-modern.user.css`][usertheme-file] file to apply to any Gitea instance.

document & simplify deployment as gitea theme 2021-07-30 10:10:03 +00:00			`### Contributing`
Update 'Gitea/readme.md' 2021-08-31 14:22:35 +00:00			To make changes, always base them on [`theme-gitea-modern.styl`](theme-gitea-modern.styl), which requires the [Stylus preprocessor](https://stylus-lang.com/).
document & simplify deployment as gitea theme 2021-07-30 10:10:03 +00:00			`When making contributions, don't use the compiled version for your changes.`

			`[theme-file]: https://codeberg.org/Freeplay/CSS-Styles/raw/branch/main/Gitea/theme-gitea-modern.css`
			`[usertheme-file]: https://codeberg.org/Freeplay/CSS-Styles/raw/branch/main/Gitea/theme-gitea-modern.user.css`
			`[doc-config]: https://docs.gitea.io/en-us/config-cheat-sheet/#ui-ui`
			`[doc-dir]: https://docs.gitea.io/en-us/faq/#where-does-gitea-store-what-file`