# evo-sonic-theme

**Repository Path**: evolee/evo-sonic-theme

## Basic Information

- **Project Name**: evo-sonic-theme
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-11
- **Last Updated**: 2026-05-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Evo Sonic Theme

A warm, typography-focused theme for [Evo Sonic](https://github.com/go-sonic/sonic) blogging platform.

## Features

- 🌓 **Light/Dark mode** with system preference detection
- 🌐 **Chinese/English language toggle** for UI elements
- 📱 **Fully responsive design** for all screen sizes
- 🎨 **Warm color palette** with paper texture overlay
- ✨ **Beautiful typography** using Lora serif + DM Sans sans-serif + DM Mono monospace
- 🔍 **Search support** with clean results layout
- 📝 **Full blog features**: posts, pages, journals, archives, categories, tags, links, photos

## Installation

### Remote Fetch (Recommended)

1. Go to Evo Sonic Admin Panel
2. Navigate to **Themes** → **Fetch Remote**
3. Enter: `https://github.com/evo-lee/evo-sonic-theme`
4. Click Fetch
5. Activate the theme

### Manual Install

```bash
cd /path/to/evo-sonic/resources/template/theme/
git clone https://github.com/evo-lee/evo-sonic-theme.git
```

Then activate in admin panel.

### Upload ZIP

1. Download the repository as ZIP
2. Go to Admin Panel → Themes → Upload
3. Select the downloaded ZIP file
4. Activate the theme

## Configuration

Theme settings available in **Admin → Theme → Settings**:

| Setting | Type | Default | Description |
|---------|------|---------|-------------|
| Color Mode | Select | Light | Light/Dark/Follow System |
| Accent Color | Color | #8B6F47 | Primary accent color |
| Show Ticker | Radio | Yes | Show/hide information ticker bar |
| Ticker Text | Textarea | - | Content for the ticker (one item per line) |
| GitHub | Text | - | GitHub username |
| Twitter | Text | - | Twitter username |
| Email | Text | - | Email address |

## Language Support

The theme supports Chinese and English. Users can toggle between languages using the EN/中 button in the navigation bar. The preference is saved in localStorage.

**Note**: Blog content (posts, pages) keeps its original language. Only UI elements (navigation, buttons, labels) are translated.

## Customization

### CSS Variables

The theme uses CSS custom properties for easy customization:

```css
--bg: Background color
--fg: Text color
--fg-muted: Muted text color
--fg-faint: Faint text color
--accent: Accent color
--border: Border color
--tag-bg: Tag background
--tag-fg: Tag text
```

### Override Styles

You can override styles by editing the theme files directly in the admin panel (Theme → Files).

## File Structure

```
evo-sonic-theme/
├── theme.yaml          # Theme metadata
├── settings.yaml       # Theme configuration
├── index.tmpl          # Homepage
├── post.tmpl           # Post detail
├── archives.tmpl       # Archives page
├── categories.tmpl     # Categories list
├── category.tmpl       # Single category
├── tags.tmpl           # Tags list
├── tag.tmpl            # Single tag
├── journals.tmpl       # Journals page
├── links.tmpl          # Links page
├── photos.tmpl         # Photos page
├── sheet.tmpl          # Standalone page
├── search.tmpl         # Search results
├── assets/
│   ├── css/style.css   # Main stylesheet
│   └── js/main.js      # Main JavaScript
└── module/
    ├── head.tmpl       # HTML head
    ├── nav.tmpl        # Navigation
    ├── footer.tmpl     # Footer
    ├── ticker.tmpl     # Ticker bar
    └── post-card.tmpl  # Post card component
```

## Credits

- Typography: [Lora](https://fonts.google.com/specimen/Lora), [DM Sans](https://fonts.google.com/specimen/DM+Sans), [DM Mono](https://fonts.google.com/specimen/DM+Mono)
- Inspired by modern minimalist blog designs

## License

MIT License - see [LICENSE](LICENSE) for details