From 25ede96ef891aa093f533cb0de533950b0830078 Mon Sep 17 00:00:00 2001
From: Laan Tungir <laantungir@laantungir.github.io>
Date: Mon, 11 Aug 2025 19:20:33 +0000
Subject: [PATCH] Update README.md

---
 README.md | 119 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 119 insertions(+)

diff --git a/README.md b/README.md
index e69de29..95ccaac 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,119 @@
+# 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