jekyll.yml

source: app
destination: dist
permalink: pretty
timezone: America/San_Francisco
markdown: kramdown
highlighter: none
kramdown:
  syntax_highlighter_opts:
    disable: true
incremental: true
liquid:
  error_mode: strict

keep_files:
  - assets
  - manifests

# Site settings
name: Kong Developer
title: Kong Docs
description: "Documentation for Kong, the Cloud Connectivity Company for APIs and Microservices."

links:
  share: https://developer.konghq.com
  web: https://developer.konghq.com
  direct: https://packages.konghq.com/public

plugins:
  - jekyll-include-cache
  - jekyll/vite

include:
  - _headers

# Collections
collections:
  ai_gateway_entities:
    output: true
  gateway_entities:
    output: true
  how-tos:
    output: true
  references:
    output: false
  support:
    output: true
  cookbooks:
    output: true

defaults:
  - scope:
      path: "_how-tos"
      type: "how-tos"
    values:
      layout: "how-to"
      permalink: "/how-to/:path/"
      breadcrumbs:
        - "/how-to/"
  - scope:
      path: "_ai_gateway_entities"
      type: "ai_gateway_entities"
    values:
      layout: "gateway_entity"
      permalink: "/ai-gateway/entities/:path/"
      products:
        - ai-gateway
      breadcrumbs:
        - "/ai-gateway/"
  - scope:
      path: "_gateway_entities"
      type: "gateway_entities"
    values:
      layout: "gateway_entity"
      permalink: "/gateway/entities/:path/"
      products:
        - gateway
      breadcrumbs:
        - "/gateway/"
        - "/gateway/entities/"
  - scope:
      path: "_references"
      type: "references"
    values:
      layout: "reference"
      auto_generated: true
      content_type: "reference"
      permalink: "/:path/"
  - scope:
      path: "_support"
      type: "support"
    values:
      layout: "support"
      permalink: "/support/:path/"
      breadcrumbs:
        - "/support/"
  - scope:
      path: "_cookbooks"
      type: "cookbooks"
    values:
      layout: "cookbook"
      content_type: "cookbook"
      permalink: "/cookbooks/:path/"
      breadcrumbs:
        - "/cookbooks/"

reference_metadata:
  event-gateway:
    products:
      - event-gateway
    breadcrumbs:
      - /event-gateway/

  inso-cli:
    products:
      - insomnia
    tools:
      - inso-cli

  gateway:
    pdk:
      products:
        - gateway
      works_on:
        - on-prem
        - konnect
    cli:
      products:
        - gateway
      works_on:
        - on-prem
        - konnect

ai_gateway_policies:
  metadata:
    keep:
      - title
      - name
      - description
      - tags
      - icon
      - categories
      - search_aliases
      - publisher
      - third_party
      - premium_partner
      - support_url

insomnia_run: https://insomnia.rest/run/

# product name vars
base_gateway: Kong Gateway
ai_gateway: AI Gateway
ai_gateway_name: Kong AI Gateway
ee_product_name: Kong Gateway Enterprise
ee_product_name_official: Kong API Gateway Enterprise
konnect_short_name: Konnect
konnect_product_name: Kong Konnect
mesh_product_name: Kong Mesh
kic_product_name: Kong Ingress Controller
kic_product_name_short: KIC
konnect_saas: Kong Konnect
gateway_operator_product_name: Kong Gateway Operator
operator_product_name: Kong Operator
operator_product_name_short: KO
event_gateway: Kong Event Gateway
event_gateway_short: Event Gateway
code_mode: Code Mode
konnect_catalog: Catalog
metering_and_billing: Metering & Billing
observability: Observability
dev_portal: Dev Portal
identity: Kong Identity
# Company names
openai: OpenAI
anthropic: Anthropic
google: Google
gemini: Gemini
amazon: Amazon
cohere: Cohere
hugging_face: Hugging Face
mistral: Mistral
xai: xAI
grok: Grok
cerebras: Cerebras
ollama: Ollama
deepseek: DeepSeek
vercel: Vercel
kimi: Kimi
# Product names
google_cloud: Google Cloud
google_analytics: Google Analytics
claude: Claude
claude_code: Claude Code
kimi_code: Kimi Code
gtm: Google Tag Manager


repos:
  developer: https://github.com/Kong/developer.konghq.com
  developer_raw: https://raw.githubusercontent.com/Kong/developer.konghq.com
  docs: https://github.com/Kong/docs.konghq.com
  skills: https://github.com/Kong/ai-marketplace
  skills_raw: https://raw.githubusercontent.com/Kong/ai-marketplace

skills_repo_branch: main
skills_repo_slug: kong/ai-marketplace
skills_repo_path: app/.repos/ai-marketplace


mesh_policy_schemas_path: app/.repos/kuma/app/assets/

sitemap:
  exclude:
    - /robots.txt
    - /404.html
    - /_redirects
    - /sources_urls_mapping.json
    - /sitemap.xml

# Mesh specific config
mesh_namespace: kong-mesh-system
mesh_cp_name: kong-mesh-control-plane
mesh_ignored_links_regex:
  - '\[.*\]\(https:\/\/github\.com\/[kK]ong\/kong-mesh.*\)'
mesh_raw_generated_paths:
  - app/assets/mesh
  - app/.repos/kuma/app/assets
mesh_product_name_path: kong-mesh
mesh_cp_zone_sync_name_prefix: kong-mesh-
mesh_docker_org: kong
# Helm commands
set_flag_values_prefix: kuma.
mesh_helm_repo_url: https://kong.github.io/kong-mesh-charts
mesh_helm_repo_name: kong-mesh
mesh_helm_repo: kong-mesh/kong-mesh
mesh_helm_install_name: kong-mesh
mesh_disabled_versions: []
# binary options
mesh_install_archive_name: kong-mesh

mesh:
  ignored_links_regex:
    - '\[.*\]\(https:\/\/github\.com\/[kK]ong\/kong-mesh.*\)'

# Version vars
latest_gateway_oss_version: "3.9.3"

# Operator vars
operator_gatewayconfiguration_api_version: "v2beta1"
operator_konnectgatewaycontrolplane_api_version: "v1alpha2"
operator_konnectextension_api_version: "v1alpha2"
operator_kongservice_api_version: "v1alpha1"
operator_kongroute_api_version: "v1alpha1"
operator_kongcertificate_api_version: "v1alpha1"
operator_kongreferencegrant_api_version: "v1alpha1"
operator_kongpluginbinding_api_version: "v1alpha1"
gwapi_version: "1.6.1" 
# render_banner: true

# Copy
llm_copy:
  on_prem_snippet: 'On-prem deployments'
  konnect_snippet: 'Konnect deployments'


well-known:
  skills: .well-known/skills