docs: update config.example.toml with accurate XDG paths

- Add file locations header documenting all XDG paths
- Fix scripts path: $XDG_DATA_HOME not $XDG_CONFIG_HOME
- Document theme location for custom themes
- Document style.css for custom CSS overrides
- Document frecency.json storage location

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
2025-12-29 17:32:05 +01:00
parent 7ca8a1f443
commit d086995399

View File

@@ -1,5 +1,12 @@
# Owlry Configuration
# Copy to ~/.config/owlry/config.toml
#
# File locations (XDG Base Directory compliant):
# Config: $XDG_CONFIG_HOME/owlry/config.toml (~/.config/owlry/)
# Themes: $XDG_CONFIG_HOME/owlry/themes/*.css
# Style: $XDG_CONFIG_HOME/owlry/style.css (custom CSS overrides)
# Scripts: $XDG_DATA_HOME/owlry/scripts/ (~/.local/share/owlry/)
# Data: $XDG_DATA_HOME/owlry/frecency.json
[general]
show_icons = true
@@ -24,8 +31,11 @@ font_size = 14
border_radius = 12
# Theme: "owl" for built-in dark theme, or leave unset for GTK default
# Custom themes: place in $XDG_CONFIG_HOME/owlry/themes/{name}.css
# theme = "owl"
# Custom CSS: create $XDG_CONFIG_HOME/owlry/style.css for additional styling
# Individual color overrides (CSS color values)
# [appearance.colors]
# background = "#1a1b26"
@@ -50,6 +60,7 @@ uuctl = true
calculator = true
# Frecency: boost frequently/recently used items in search results
# Data stored in $XDG_DATA_HOME/owlry/frecency.json
frecency = true
frecency_weight = 0.3 # 0.0 = disabled, 1.0 = strong boost
@@ -74,7 +85,7 @@ bookmarks = true
# Emoji picker (copies to clipboard)
emoji = true
# Custom scripts from ~/.config/owlry/scripts/
# Custom scripts from $XDG_DATA_HOME/owlry/scripts/ (~/.local/share/owlry/scripts/)
scripts = true
# File search (requires fd or locate, trigger with "/ pattern" or "find pattern")