mirror of
https://github.com/yazanammar/obsidian-theme-engine.git
synced 2026-07-22 06:44:37 +00:00
173 lines
2.8 KiB
Markdown
173 lines
2.8 KiB
Markdown
# Theme Engine FAQ
|
|
|
|
Frequently asked questions and solutions for common issues.
|
|
|
|
## Why are my colors not changing after activating a profile?
|
|
|
|
This is the most common issue.
|
|
|
|
Usually this happens because a Community Theme (such as Minimal or other installed themes) is overriding the variables managed by Theme Engine.
|
|
|
|
### Recommended Solution
|
|
|
|
1. Open:
|
|
|
|
`Settings → Appearance → Themes`
|
|
|
|
2. Select:
|
|
|
|
`Default`
|
|
|
|
3. Return to Theme Engine.
|
|
|
|
Your profile colors should now apply correctly.
|
|
|
|
### Alternative Solution (Customize Existing Themes)
|
|
|
|
If you want to continue using another community theme:
|
|
|
|
1. Switch Obsidian temporarily to the Default theme.
|
|
2. Open Theme Engine.
|
|
3. Click:
|
|
|
|
`Import / Paste (.css)`
|
|
|
|
4. Select:
|
|
|
|
`Import from installed theme`
|
|
|
|
5. Choose the desired theme.
|
|
|
|
Theme Engine creates an editable profile based on that theme.
|
|
|
|
## Why is my background visible but parts of the UI remain dark?
|
|
|
|
Theme Engine uses automatic transparency handling.
|
|
|
|
When a background is active, important variables are automatically adjusted, including:
|
|
|
|
- `--background-primary`
|
|
- `--sidebar-background`
|
|
- `--background-secondary`
|
|
|
|
This allows your image or video background to become visible through the interface.
|
|
|
|
## What is the difference between Profile Snippets and Global Snippets?
|
|
|
|
### Profile Snippets
|
|
|
|
Profile snippets belong to one profile only.
|
|
|
|
Characteristics:
|
|
|
|
- Activate only with their profile
|
|
- Included when exporting profiles
|
|
- Useful for profile-specific styles
|
|
|
|
Example:
|
|
|
|
```css
|
|
h1 {
|
|
color: red;
|
|
}
|
|
```
|
|
|
|
### Global Snippets
|
|
|
|
Global snippets remain active across all profiles.
|
|
|
|
Characteristics:
|
|
|
|
- Always active
|
|
- Not tied to a specific profile
|
|
- Useful for universal customization
|
|
|
|
Example:
|
|
|
|
```css
|
|
body {
|
|
font-family: Inter;
|
|
}
|
|
```
|
|
|
|
## What are Snapshots?
|
|
|
|
Snapshots are a safety mechanism.
|
|
|
|
When using:
|
|
|
|
```txt
|
|
Pin
|
|
```
|
|
|
|
Theme Engine saves:
|
|
|
|
- Colors
|
|
- Snippets
|
|
- CSS
|
|
- Rules
|
|
- Related settings
|
|
|
|
If you later dislike your changes:
|
|
|
|
```txt
|
|
Reset to Pinned
|
|
```
|
|
|
|
restores the previous saved state instantly.
|
|
|
|
## I used the old Color Master beta. How can I keep my profiles?
|
|
|
|
Automatic migration was removed to comply with Obsidian plugin guidelines.
|
|
|
|
To migrate manually:
|
|
|
|
1. Close Obsidian.
|
|
2. Open:
|
|
|
|
```txt
|
|
.obsidian/plugins/obsidian-color-master/
|
|
```
|
|
|
|
3. Copy:
|
|
|
|
```txt
|
|
data.json
|
|
```
|
|
|
|
4. Paste into:
|
|
|
|
```txt
|
|
.obsidian/plugins/theme-engine/
|
|
```
|
|
|
|
5. Restart Obsidian.
|
|
|
|
## Still having problems?
|
|
|
|
If you encounter unexpected behavior:
|
|
|
|
1. Export your important profiles first.
|
|
2. Open:
|
|
|
|
```txt
|
|
Theme Engine → Advanced Settings
|
|
```
|
|
|
|
3. Use:
|
|
|
|
```txt
|
|
Reset Plugin
|
|
```
|
|
|
|
If problems continue:
|
|
|
|
- Open a GitHub issue
|
|
- Include screenshots if possible
|
|
- Mention your Obsidian version and plugin version
|
|
|
|
## Related Documentation
|
|
|
|
- [Usage Guide](./guide.md)
|
|
- [Variable Reference](./variables.md)
|
|
- [Main README](../README.md)
|