# Configuration for badges (https://codeberg.org/cdsoft/badges)
# This file allows customization of badge appearance and definition of dynamic variables.
# Place it in your project root or specify its location with -c.
#
# All these parameters are optional. If omitted, defaults are used.

# =============================================================================
# FILTERS
# =============================================================================

# File patterns to scan for badge references.
# Files matching these patterns will be scanned for badge filenames.
# Examples: ["*.md", "*.rst", "*.html", "*.txt"]
filters = ["*.md"]

# Directory where badges should be generated.
# References in files must point to this directory.
dir = "badges"

# =============================================================================
# BADGE GEOMETRY
# =============================================================================
# Visual parameters applied to ALL generated badges.

[geometry]
# Badge height in pixels.
height = 24

# Font size in pixels.
font_size = 14

# Vertical position of text (y coordinate) in the badge.
text_pos = 13

# Text color (for 1 or 2 text badges).
# Accepted formats: CSS name ("white", "black"), hex code (#RRGGBB), short hex (#RGB).
text_color = "white"

# Text shadow color.
text_shadow = "black"

# Text shadow opacity (0.0 to 1.0).
shadow_opacity = 0.9

# Text shadow width.
shadow_width = 1.0

# Background color of left text (for 2-text badges).
text_bg = "#444"

# Corner radius of the badge.
radius = 6

# Font used for text.
# Specify a list of comma-separated fonts (fallback).
font_family = "Verdana, Geneva, DejaVu Sans, sans-serif"

# =============================================================================
# DYNAMIC VARIABLES
# =============================================================================
# Define variables to use in badge text.
# A variable is referenced in the badge name with @variable_name.
# Example:
#   In badges.toml:
#   [variables]
#   version = "1.0.0"
#   author = "John Doe"
#
#   In your markdown:
#   ![Version](badges/Version-@version-75-45-blue.svg)  -> Displays "Version 1.0.0"
#   ![Author](badges/@author-75-green.svg)              -> Displays "John Doe"
#
# To use a literal @, double it: @@
# Example: badges/Email-@@domain.com-100-grey.svg -> Displays "Email @domain.com"
[variables]
# Examples (uncomment and adapt):
# version = "1.0.0"
# license = "MIT"
# author = "Your Name"
# project = "project-name"
# repo = "user/repository"

# =============================================================================
# COMMAND LINE USAGE
# =============================================================================
# You can also define variables directly from the command line:
#   badges -D version=2.0.0 -D author="Jane Doe" README.md
#
# CLI variables override those defined in this file.
#
# To display default configuration:
#   badges --init
#
# To use a custom configuration file:
#   badges -c my_config.toml
