Add CSS variables reference documentation and color template files
- Created /templates/ directory with colors_custom_light.css and colors_custom_dark.css - Added comprehensive CSS_VARIABLES.md documentation - Updated README with improved Custom Color Palettes section - Updated docs/README.md to include new resources - Updated CHANGELOG with new additions Co-authored-by: jmiller-moko <230051081+jmiller-moko@users.noreply.github.com>
This commit is contained in:
21
README.md
21
README.md
@@ -205,14 +205,16 @@ Access template configuration via **System → Site Templates → MokoCassiopeia
|
||||
|
||||
MokoCassiopeia supports custom color schemes:
|
||||
|
||||
1. Create `media/templates/site/mokocassiopeia/css/colors/light/colors_custom.css` for light mode
|
||||
2. Create `media/templates/site/mokocassiopeia/css/colors/dark/colors_custom.css` for dark mode
|
||||
3. Define CSS variables (reference `colors_standard.css` for structure)
|
||||
4. Select "Custom" palette in template settings
|
||||
1. **Copy template files** from `/templates/` directory:
|
||||
- `colors_custom_light.css` → `media/templates/site/mokocassiopeia/css/colors/light/colors_custom.css`
|
||||
- `colors_custom_dark.css` → `media/templates/site/mokocassiopeia/css/colors/dark/colors_custom.css`
|
||||
2. **Customize** the CSS variables to match your brand colors
|
||||
3. **Enable in Joomla**: System → Site Templates → MokoCassiopeia → Theme tab → Set palette to "Custom"
|
||||
4. **Save** and view your site with custom colors
|
||||
|
||||
**Note:** Custom color files are excluded from version control (`.gitignore`) to prevent fork-specific customizations from being committed.
|
||||
|
||||
**Example CSS Variables:**
|
||||
**Quick Example:**
|
||||
|
||||
```css
|
||||
:root[data-bs-theme="light"] {
|
||||
@@ -224,6 +226,8 @@ MokoCassiopeia supports custom color schemes:
|
||||
}
|
||||
```
|
||||
|
||||
**Complete Reference:** See [CSS Variables Documentation](./docs/CSS_VARIABLES.md) for all available variables and detailed usage examples.
|
||||
|
||||
### Table of Contents
|
||||
|
||||
Enable automatic TOC for articles:
|
||||
@@ -319,8 +323,15 @@ See [Joomla Development Guide](./docs/JOOMLA_DEVELOPMENT.md) for packaging instr
|
||||
- **[Quick Start](./docs/QUICK_START.md)** - 5-minute developer setup
|
||||
- **[Development Guide](./docs/JOOMLA_DEVELOPMENT.md)** - Comprehensive development guide
|
||||
- **[Workflow Guide](./docs/WORKFLOW_GUIDE.md)** - Git workflow and processes
|
||||
- **[CSS Variables Reference](./docs/CSS_VARIABLES.md)** - Complete CSS customization guide
|
||||
- **[Documentation Index](./docs/README.md)** - All documentation links
|
||||
|
||||
### Customization Resources
|
||||
|
||||
- **[Template Files](./templates/)** - Ready-to-use color palette templates
|
||||
- `colors_custom_light.css` - Light mode template
|
||||
- `colors_custom_dark.css` - Dark mode template
|
||||
|
||||
### Governance
|
||||
|
||||
- **[Contributing](./CONTRIBUTING.md)** - How to contribute
|
||||
|
||||
Reference in New Issue
Block a user