120 lines
3.8 KiB
Markdown
120 lines
3.8 KiB
Markdown
# Gitea Custom Themes Setup Instructions
|
|
|
|
## Theme Files Created
|
|
|
|
Three custom themes have been created:
|
|
|
|
1. **theme-black-on-white.css** - Clean black text on white backgrounds
|
|
2. **theme-white-on-black.css** - Clean white text on black backgrounds
|
|
3. **theme-green-on-black.css** - Terminal-style green text on black backgrounds
|
|
|
|
## Installation Steps
|
|
|
|
### 1. Copy Theme Files to Your Gitea Installation
|
|
|
|
```bash
|
|
# Copy the theme files to your Gitea custom directory
|
|
cp theme-*.css ./gitea/gitea/public/assets/css/
|
|
```
|
|
|
|
### 2. Update Your app.ini Configuration
|
|
|
|
Edit your `./gitea/gitea/conf/app.ini` file and add/update the UI section:
|
|
|
|
```ini
|
|
[ui]
|
|
# Add your custom themes to the THEMES list
|
|
THEMES = gitea-light,gitea-dark,gitea-auto,black-on-white,white-on-black,green-on-black
|
|
|
|
# Set the default theme that new users will see (OPTIONAL)
|
|
DEFAULT_THEME = black-on-white
|
|
```
|
|
|
|
**Default Theme Options:**
|
|
- `gitea-light` - Original Gitea light theme
|
|
- `gitea-dark` - Original Gitea dark theme
|
|
- `gitea-auto` - Auto-switching theme
|
|
- `black-on-white` - Your custom black on white theme
|
|
- `white-on-black` - Your custom white on black theme
|
|
- `green-on-black` - Your custom green on black theme
|
|
|
|
### 3. Restart Your Gitea Container
|
|
|
|
```bash
|
|
docker-compose restart gitea
|
|
```
|
|
|
|
### 4. Verify Installation
|
|
|
|
1. Go to your Gitea site
|
|
2. Log in to your account
|
|
3. Go to **Settings** → **Appearance**
|
|
4. Check that the new themes appear in the **Theme** dropdown:
|
|
- "Black on White"
|
|
- "White on Black"
|
|
- "Green on Black"
|
|
|
|
## Theme Features
|
|
|
|
### Black on White Theme
|
|
- Pure black text on white backgrounds
|
|
- Grayscale accent colors (no green highlights)
|
|
- Clean, high-contrast appearance
|
|
- Light theme with proper syntax highlighting
|
|
|
|
### White on Black Theme
|
|
- Pure white text on black backgrounds
|
|
- Grayscale accent colors (no green highlights)
|
|
- Inverted color scheme
|
|
- Dark theme with emoji inversions for readability
|
|
|
|
### Green on Black Theme
|
|
- Bright green text on black backgrounds
|
|
- Terminal/hacker aesthetic
|
|
- Dark theme optimized for green visibility
|
|
- Classic computer terminal look
|
|
|
|
## Troubleshooting
|
|
|
|
### Themes Not Appearing
|
|
- Ensure files are in the correct directory: `./gitea/gitea/public/assets/css/`
|
|
- Check that file permissions allow reading by the Gitea process
|
|
- Verify the THEMES setting in app.ini includes your theme names
|
|
- Restart the Gitea container after making changes
|
|
|
|
### Default Theme Not Working
|
|
- Make sure DEFAULT_THEME matches exactly one of the theme names in THEMES
|
|
- The theme name should match the filename without `theme-` prefix and `.css` suffix
|
|
- Example: `theme-black-on-white.css` → `DEFAULT_THEME = black-on-white`
|
|
|
|
### Colors Still Show Green
|
|
- The themes have been updated to remove green highlights
|
|
- Clear your browser cache or hard refresh (Ctrl+F5) to see changes
|
|
- Some diff views may still show green for added lines (this is normal Git behavior)
|
|
|
|
## File Structure
|
|
|
|
Your final directory structure should look like:
|
|
|
|
```
|
|
./gitea/
|
|
├── gitea/
|
|
│ ├── conf/
|
|
│ │ └── app.ini # Contains THEMES and DEFAULT_THEME settings
|
|
│ └── public/
|
|
│ └── assets/
|
|
│ └── css/
|
|
│ ├── theme-black-on-white.css # Your custom theme
|
|
│ ├── theme-white-on-black.css # Your custom theme
|
|
│ └── theme-green-on-black.css # Your custom theme
|
|
└── data/ # Gitea data directory
|
|
```
|
|
|
|
## Notes
|
|
|
|
- All themes follow Gitea's standard theming structure
|
|
- Themes include proper syntax highlighting for code
|
|
- Dark themes include emoji inversions for better readability
|
|
- The green highlights have been removed from black-on-white and white-on-black themes
|
|
- Users can still individually select their preferred theme in their settings
|