101 lines
3.1 KiB
Markdown
101 lines
3.1 KiB
Markdown
# Fell — a Gitea theme
|
|
|
|
A Gitea theme inspired by [dideric.is](https://dideric.is). Parchment body, near-black nav, teal accent, and [IM Fell Type](https://iginomarini.com/fell/) throughout.
|
|
|
|
|
|
|
|
## What's in the box
|
|
|
|
```
|
|
public/
|
|
assets/
|
|
css/
|
|
theme-fell.css ← the theme (all 244 Gitea CSS variables)
|
|
fonts/
|
|
IMFePIrm29P.ttf ← Fell Type regular
|
|
IMFePIit29P.ttf ← Fell Type italic
|
|
IMFeDPsc29P.ttf ← Fell Type small caps (headings/nav)
|
|
```
|
|
|
|
The fonts are served from the same custom directory as the CSS, so no external CDN is needed.
|
|
|
|
---
|
|
|
|
## Installing on TrueNAS Scale
|
|
|
|
TrueNAS Scale runs Gitea as a Docker container via the app catalog. The custom directory (`GITEA_CUSTOM`) is set to `/data/gitea` inside the container. Custom theme files go at:
|
|
|
|
```
|
|
$GITEA_CUSTOM/public/assets/css/theme-fell.css
|
|
$GITEA_CUSTOM/public/assets/fonts/*.ttf
|
|
```
|
|
|
|
### 1. Copy the theme files
|
|
|
|
Open a shell into the Gitea container. In the TrueNAS web UI, go to **Apps → Gitea → ⋮ → Shell**, then:
|
|
|
|
```sh
|
|
# Create directories if they don't exist
|
|
mkdir -p data/public/assets/css
|
|
mkdir -p data/public/assets/fonts
|
|
```
|
|
|
|
Then from your TrueNAS host shell (or via SCP), copy the files from this repo into those paths. If your Gitea data is on a host-path dataset (e.g. `/mnt/tank/gitea`), you can copy directly on the host:
|
|
|
|
```sh
|
|
# On the TrueNAS host — adjust the dataset path to match your setup
|
|
GITEA_DATA=/mnt/tank/gitea
|
|
|
|
mkdir -p "$GITEA_DATA/public/assets/css"
|
|
mkdir -p "$GITEA_DATA/public/assets/fonts"
|
|
|
|
cp public/assets/css/theme-fell.css "$GITEA_DATA/public/assets/css/"
|
|
cp public/assets/fonts/*.ttf "$GITEA_DATA/public/assets/fonts/"
|
|
```
|
|
|
|
> **ixVolume vs host path**: If Gitea is using an ixVolume (the TrueNAS default), the data lives inside the opaque volume store. Use the container shell method in that case, or switch the Gitea app to use a host-path dataset so you can manage files directly.
|
|
|
|
### 2. Register the theme in app.ini
|
|
|
|
Edit `/data/gitea/conf/app.ini` inside the container (or the `conf/app.ini` file in your dataset on the host):
|
|
|
|
```ini
|
|
[ui]
|
|
THEMES = gitea-light,gitea-dark,fell
|
|
DEFAULT_THEME = fell
|
|
```
|
|
|
|
Add `fell` to whatever list of themes you already have — don't remove the built-ins.
|
|
|
|
### 3. Restart Gitea
|
|
|
|
In the TrueNAS web UI: **Apps → Gitea → ⋮ → Restart**.
|
|
|
|
### 4. Select the theme
|
|
|
|
Go to **User Settings → Appearance**, pick **Fell** from the theme dropdown, and click **Update Theme**.
|
|
|
|
---
|
|
|
|
## Installing on a plain Docker / docker-compose instance
|
|
|
|
Mount the `public/` directory from this repo into your container at `$GITEA_CUSTOM/public/`:
|
|
|
|
```yaml
|
|
services:
|
|
gitea:
|
|
image: gitea/gitea:latest
|
|
volumes:
|
|
- ./gitea-data:/data
|
|
- ./public:/data/gitea/public # ← this repo's public/ dir
|
|
environment:
|
|
- GITEA__ui__THEMES=gitea-light,gitea-dark,fell
|
|
- GITEA__ui__DEFAULT_THEME=fell
|
|
```
|
|
|
|
---
|
|
|
|
## Font credit
|
|
|
|
The Fell Types are digitally reproduced by [Igino Marini](https://iginomarini.com/fell/) and are used here under their original license terms.
|