# Content Configuration
# =====================
# Fine-tunes Bengal's content processing (independent of theme)

# Markdown Parser
# ===============
# Select the markdown parser engine
markdown:
  parser: "patitas"  # Use Patitas parser (modern, thread-safe, typed AST)

content:
  # Default content type for documentation site
  default_type: "doc"

  # Excerpt & Summaries (two-stage pipeline)
  # 1. excerpt_length: Patitas extracts up to N chars from AST (step 1)
  # 2. excerpt_words: card_excerpt_html truncates display to N words (step 2)
  # Override per-article in frontmatter: excerpt_length, excerpt_words
  excerpt_length: 750        # Max chars for Patitas AST extraction (~150 words)
  excerpt_words: 150         # Max words shown in card previews (template filter)
  summary_length: 160        # Characters for page.meta_description (SEO)

  # Reading Time
  reading_speed: 200         # Words per minute for calculation

  # Related Content
  related_count: 5           # Number of related pages to compute
  related_threshold: 0.25    # Minimum tag similarity (0.0-1.0)

  # Table of Contents
  toc_depth: 4               # Maximum heading depth (1-6) - deeper for docs
  toc_min_headings: 2        # Minimum headings before generating TOC
  toc_style: "nested"        # Structure: "nested" or "flat"

  # Content Organization
  sort_pages_by: "weight"    # Options: "weight", "date", "title", "modified"
  sort_order: "asc"          # Options: "asc", "desc"

  # Git-derived metadata (Pridelands #548)
  # Derives "last updated" from git commit dates when frontmatter is absent.
  git_info:
    enabled: true
    lastmod: true
