README.md

# Octo Gitea

Thème Gitea épuré, disponible en variante claire et sombre.

![preview](/assets/preview.jpg)

## Variantes

| Thème | Style |
|-------|-------|
| **Octo Dark** | Fond noir profond (`#020202` / `#000000`), texte clair, accent bleu |
| **Octo Light** | Fond blanc, texte sombre, accent bleu |
| **Octo Auto** | Bascule automatique selon `prefers-color-scheme` du système |

## Installation

1. Copie les trois fichiers de [`themes/`](themes/) dans `data/gitea/public/assets/css/` :

   ```sh
   cp themes/theme-octo-*.css /chemin/vers/gitea/data/public/assets/css/
   ```

   Le dossier `assets/css` peut ne pas exister par défaut, crée-le si besoin.

2. Édite `data/gitea/conf/app.ini` et ajoute les variantes à la ligne `THEMES` de la section `[ui]` :

   ```ini
   [ui]
   THEMES = gitea-auto, gitea-light, gitea-dark, octo-auto, octo-light, octo-dark
   DEFAULT_THEME = octo-auto
   ```

   Les noms à ajouter sont **sans** le préfixe `theme-` ni le suffixe `.css`.

3. Redémarre Gitea.

4. Choisis le thème dans **Paramètres → Apparence**.

> [!IMPORTANT]
> Le thème `octo-auto` nécessite la présence de `theme-octo-light.css` **et** `theme-octo-dark.css` dans le même dossier — il les `@import` selon le `prefers-color-scheme` du navigateur.

Doc Gitea de référence : [Customizing Gitea](https://docs.gitea.com/administration/customizing-gitea#customizing-the-look-of-gitea).

## Personnalisation

Les couleurs sont définies via les variables CSS standard de Gitea (`--color-primary`, `--color-body`, `--color-syntax-*`, etc.). Pour ajuster un thème, édite directement le fichier CSS correspondant — aucun build n'est nécessaire.
feat(themes): add octo gitea theme with light, dark, and auto variants 2026-04-28 16:03:10 -04:00			`# Octo Gitea`
Initial commit 2026-04-28 15:47:31 -04:00
docs(readme): change theme description 2026-04-29 10:47:11 -04:00			`Thème Gitea épuré, disponible en variante claire et sombre.`
feat(themes): add octo gitea theme with light, dark, and auto variants 2026-04-28 16:03:10 -04:00
docs: add preview image to readme 2026-04-28 20:24:36 -04:00			`![preview](/assets/preview.jpg)`

feat(themes): add octo gitea theme with light, dark, and auto variants 2026-04-28 16:03:10 -04:00			`## Variantes`

			`\| Thème \| Style \|`
			`\|-------\|-------\|`
			\| Octo Dark \| Fond noir profond (`#020202` / `#000000`), texte clair, accent bleu \|
			`\| Octo Light \| Fond blanc, texte sombre, accent bleu \|`
			\| Octo Auto \| Bascule automatique selon `prefers-color-scheme` du système \|

			`## Installation`

			1. Copie les trois fichiers de [`themes/`](themes/) dans `data/gitea/public/assets/css/` :

			```sh
			`cp themes/theme-octo-*.css /chemin/vers/gitea/data/public/assets/css/`
			```

			Le dossier `assets/css` peut ne pas exister par défaut, crée-le si besoin.

			2. Édite `data/gitea/conf/app.ini` et ajoute les variantes à la ligne `THEMES` de la section `[ui]` :

			```ini
			`[ui]`
			`THEMES = gitea-auto, gitea-light, gitea-dark, octo-auto, octo-light, octo-dark`
style(themes): increase text contrast and darken secondary color 2026-04-28 20:03:18 -04:00			`DEFAULT_THEME = octo-auto`
feat(themes): add octo gitea theme with light, dark, and auto variants 2026-04-28 16:03:10 -04:00			```

			Les noms à ajouter sont sans le préfixe `theme-` ni le suffixe `.css`.

			`3. Redémarre Gitea.`

			`4. Choisis le thème dans Paramètres → Apparence.`

			`> [!IMPORTANT]`
			> Le thème `octo-auto` nécessite la présence de `theme-octo-light.css` et `theme-octo-dark.css` dans le même dossier — il les `@import` selon le `prefers-color-scheme` du navigateur.

			`Doc Gitea de référence : [Customizing Gitea](https://docs.gitea.com/administration/customizing-gitea#customizing-the-look-of-gitea).`

			`## Personnalisation`

			Les couleurs sont définies via les variables CSS standard de Gitea (`--color-primary`, `--color-body`, `--color-syntax-*`, etc.). Pour ajuster un thème, édite directement le fichier CSS correspondant — aucun build n'est nécessaire.