1
0
Fork 0
mirror of https://github.com/SunRed/theme-dark-arc-gitea.git synced 2024-10-22 15:06:13 +02:00
theme-dark-arc-gitea/README.md
2024-05-03 12:16:19 -07:00

95 lines
3.3 KiB
Markdown

# Dark Arc
A dark theme for gitea with high contrast.
This theme was created by making a copy of theme-arc-green.css and making things darker for better contrast.
If you make improvements/tweaks to this theme please send a pull request, or dump your changes in an issue report.
![dark-arc-dashboard](screenshot.png)
![dark-arc-repository](screenshot2.png)
# Compatibility
This theme has been tested to work without issue with gitea version 1.21.11
It has been reported that there are [issues](https://github.com/Jieiku/theme-dark-arc-gitea/issues/9) with gitea 1.22.0+ which at the time of this notice is currently Pre-Release status.
I plan to wait a little bit for changes to settle down before supporting 1.22.0+ so it is recommended to stick with 1.21.11 for the time being.
## Before install, first you need to identify 3 things:
- Location of $GITEA_CUSTOM
- Location of app.ini ([Example app.ini](https://raw.githubusercontent.com/go-gitea/gitea/main/custom/conf/app.example.ini))
- User the gitea service runs as
Here is a screenshot of my environment and where to find this info:
![gitea-config](install.png)
## Create a public/assets/css directory under your gitea/custom path and download the theme.
Create `/public/assets/css` below your $GITEA_CUSTOM path, MY custom path is `/var/lib/gitea/custom`, as seen in the [install screenshot](install.png).
sudo mkdir -p /var/lib/gitea/custom/public/assets/css
cd /var/lib/gitea/custom/public/assets/css
wget https://raw.githubusercontent.com/Jieiku/theme-dark-arc-gitea/main/theme-dark-arc.css
## Make sure ownership is correct:
Set ownership of your $GITEA_CUSTOM directory and files, I set ownership to git because gitea runs as user git, as seen in the [install screenshot](install.png).
sudo chown -R git:git /var/lib/gitea/custom
## Edit the app.ini config file to include dark-arc theme:
The app.ini file location may differ depending on environment, this matches the location of my file, as seen in the [install screenshot](install.png).
`sudo nano /var/lib/gitea/custom/conf/app.ini`
[ui]
DEFAULT_THEME = dark-arc
THEMES = gitea,dark-arc
## Restart gitea service
sudo systemctl restart gitea
*or*
sudo reboot
The theme may automatically be active now, but if not click your avatar in top right, click settings, click appearance tab, select the theme and click update theme button.
## Notes
### assets:
As of [1.21.0](https://blog.gitea.com/release-of-1.21.0/#%EF%B8%8F-move-public-asset-files-to-the-proper-directory-25907) `/assets` now points to `custom/public/assets/*` instead of `custom/public/*`
So for me my directory structure is:
`/var/lib/gitea/custom/public/assets/css/theme-dark-arc.css`
### You can set `config` and `custom-path` values when running gitea as a service:
```shell
sudo nano /etc/systemd/system/gitea.service
ExecStart=/usr/local/bin/gitea web --custom-path /var/lib/gitea/custom --config /var/lib/gitea/custom/conf/app.ini
```
### Organizations:
I created a feature request for a way to disable organizations because I don't use them.
I was promptly told to use css and my request was closed: https://github.com/go-gitea/gitea/issues/19391
This theme hides Organizations using CSS, you can find it at the bottom of the theme:
```css
#dashboard-repo-list > div > div:first-child {
display: none !important;
}
```