name: "🈷️ Most used languages"
cost: 0 API request
categorie: github
index: 1
supports:
  - user
  - organization
  - repository
inputs:

  # Enable or disable plugin
  plugin_languages:
    description: Display most used languages metrics
    type: boolean
    default: no

  # List of languages that will be ignored
  plugin_languages_ignored:
    description: Languages to ignore
    type: array
    format: comma-separated
    default: ""
    example: html, css, ...

  # List of repositories that will be skipped
  plugin_languages_skipped:
    description: Repositories to skip
    type: array
    format: comma-separated
    default: ""
    example: my-repo-1, my-repo-2, owner/repo-3 ...

  # Number of languages to display
  # Set to 0 to disable limitations
  plugin_languages_limit:
    description: Maximum number of languages to display
    type: number
    default: 8
    min: 0
    max: 8

  # Overrides default languages colors
  # Use `${n}:${color}` to change the color of the n-th most used language (e.g. "0:red" to make your most used language red)
  # Use `${language}:${color}` to change the color of named language (e.g. "javascript:red" to make JavaScript language red, language case is ignored)
  # Use a value from `colorsets.json` to use a predefined set of colors
  # Both hexadecimal and named colors are supported
  # This cannot be used when "plugin_languages_limit" is greater than 8
  plugin_languages_colors:
    description: Custom languages colors
    type: array
    format:
      - comma-separated
      - /((?<index>[0-9])|(?<language>[-+a-z0-9#])):(?<color>#?[-a-z0-9]+)/
    default: github
    example: javascript:red, 0:blue, 1:#ff00aa

  # Languages additional details
  plugin_languages_details:
    description: Additional details
    type: array
    format: comma-separated
    values:
      - bytes-size # Languages total size written in bytes
      - percentage # Languages proportions in %
    default: ""
    example: bytes-size, percentage

  # Minimum threshold (in percentage) to reach for languages to be displayed
  plugin_languages_threshold:
    description: Minimum threshold
    type: string
    default: 0%