ci(docs): add support for option flags

source/plugins/activity/metadata.yml

@@ -88,8 +88,10 @@ inputs:
     format: comma-separated
     default: ""
     example: my-repo-1, my-repo-2, owner/repo-3, ...
+    inherits: repositories_skipped
 
   # Ignored actors (useful to ignore bots users)
   plugin_activity_ignored:
     description: Actors to ignore
-    default: github-actions[bot], dependabot[bot], dependabot-preview[bot]
+    default: ""
+    inherits: users_ignored

source/plugins/base/metadata.yml

@@ -29,7 +29,6 @@ inputs:
     default: 100
     min: 0
 
-
   # Number of repositories to load at once by queries
   # If you encounter GitHub queries timeouts, using a lower value here may solve issues
   repositories_batch:
@@ -66,6 +65,16 @@ inputs:
     format: comma-separated
     default: ""
     example: my-repo-1, my-repo-2, owner/repo-3, ...
+    global: yes
+
+  # List of default ignored users
+  # Plugins supporting a "skip users option" will automatically append users listed in this option
+  users_ignored:
+    description: Default users to ignore
+    type: array
+    format: comma-separated
+    default: github-actions[bot], dependabot[bot], dependabot-preview[bot]
+    global: yes
 
   # List of surnames or email addresses you use when authoring commits
   # These are mostly used to perform commits analysis to detect ownership
@@ -75,3 +84,4 @@ inputs:
     format: comma-seperated
     default: .user.login
     example: lowlighter, lowlighter@users.noreply.github.com
+    global: yes

source/plugins/code/metadata.yml

@@ -45,6 +45,7 @@ inputs:
     format: comma-separated
     default: ""
     example: my-repo-1, my-repo-2, owner/repo-3, ...
+    inherits: repositories_skipped
 
   # Restrict code snippet languages
   # These are guessed through linguist

source/plugins/contributors/metadata.yml

@@ -32,6 +32,7 @@ inputs:
     type: array
     format: comma-separated
     default: github-actions[bot], dependabot[bot], dependabot-preview[bot]
+    inherits: users_ignored
 
   # Display total contributions for each contributor
   plugin_contributors_contributions:
@@ -65,3 +66,4 @@ inputs:
         "💻 Code": ["source/**", "src/**"],
         "#️⃣ Others": ["*"]
       }
+    extras: yes

source/plugins/core/examples.yml

@@ -1,4 +1,4 @@
-- name: 📗 Classic template
+- name: Classic template
   uses: lowlighter/metrics@latest
   with:
     filename: metrics.classic.svg
@@ -6,7 +6,7 @@
     base: header, repositories
     plugin_lines: yes
 
-- name: 📘 Repository template
+- name: Repository template
   uses: lowlighter/metrics@latest
   with:
     template: repository
@@ -19,7 +19,7 @@
     plugin_projects: yes
     plugin_projects_repositories: lowlighter/metrics/projects/1
 
-- name: 📙 Terminal template
+- name: Terminal template
   uses: lowlighter/metrics@latest
   with:
     template: terminal
@@ -27,7 +27,7 @@
     token: ${{ secrets.METRICS_TOKEN }}
     base: header, metadata
 
-- name: 📒 Markdown template
+- name: Markdown template
   uses: lowlighter/metrics@latest
   with:
     template: markdown
@@ -36,7 +36,7 @@
     config_output: markdown
     token: ${{ secrets.METRICS_TOKEN }}
 
-- name: 📒 Markdown template (with plugins)
+- name: Markdown template (with plugins)
   uses: lowlighter/metrics@latest
   with:
     template: markdown
@@ -66,7 +66,7 @@
     plugin_languages: yes
     token: ${{ secrets.METRICS_TOKEN }}
 
-- name: 📒 Markdown template (pdf output)
+- name: Markdown template (pdf output)
   uses: lowlighter/metrics@latest
   with:
     template: markdown
@@ -81,7 +81,7 @@
     config_padding: 5%
     token: ${{ secrets.METRICS_TOKEN }}
 
-- name: 📕 Community templates
+- name: Community templates
   uses: lowlighter/metrics@latest
   with:
     token: ${{ secrets.METRICS_TOKEN }}

source/plugins/core/metadata.yml

@@ -124,6 +124,7 @@ inputs:
       - comma-separated
       - /(?<user>[-a-z0-9]+)[/](?<repo>[-a-z0-9]+)@(?<branch>[-a-z0-9]+):(?<template>[-a-z0-9]+)/
     default: ""
+    extras: yes
 
   # Template to use
   # To use community template, prefix its name with "@"
@@ -150,6 +151,7 @@ inputs:
     description: Extra CSS
     type: string
     default: ""
+    extras: yes
 
   # Timezone used by metrics
   # See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
@@ -157,6 +159,7 @@ inputs:
     description: Timezone used
     type: string
     default: ""
+    global: yes
 
   # Specify in which order metrics content will be displayed
   # If you omit some partials, they'll be appended at the end in default order
@@ -167,6 +170,7 @@ inputs:
     format: comma-separated
     default: ""
     example: base.header, base.repositories
+    global: yes
 
   # Use twemojis instead of emojis
   # May increase filesize but emojis will be rendered the same across all platforms
@@ -174,6 +178,7 @@ inputs:
     description: Use twemojis instead of emojis
     type: boolean
     default: no
+    global: yes
 
   # Render GitHub custom emojis (like ":octocat:", see full list at https://api.github.com/emojis)
   # May increase filesize
@@ -181,6 +186,7 @@ inputs:
     description: Use GitHub custom emojis
     type: boolean
     default: yes
+    global: yes
 
   # Render display width
   config_display:
@@ -191,12 +197,14 @@ inputs:
       - regular  # 480px width
       - large    # 960px width (may not be supported by all templates)
       - columns  # Full width with two columns on desktop / One column on mobile
+    global: yes
 
   # Enable SVG CSS animations
   config_animations:
     description: SVG CSS animations
     type: boolean
     default: yes
+    global: yes
 
   # Encode images links into base64 data
   # Advised to be true when generating images and false when generating texts or JSON
@@ -204,6 +212,7 @@ inputs:
     description: Encode images links into base64 data
     type: boolean
     default: yes
+    global: yes
 
   # Configure padding for output image (percentage value)
   # It can be used to add padding to generated metrics if rendering is cropped or has too much empty space
@@ -260,6 +269,23 @@ inputs:
     min: 0
     max: 3600
 
+  # Time to wait (in seconds) at the end of job
+  # Use this to avoid triggering abuse mechanics on large workflows
+  delay:
+    description: Use this to avoid triggering abuse mechanics on large workflows
+    type: number
+    default: 0
+    min: 0
+    max: 3600
+
+  # Use a pre-built image from GitHub registry when using unreleased versions of "lowlighter/metrics"
+  # This option has no effect on forks (images will always be rebuilt from Dockerfile)
+  # See https://github.com/users/lowlighter/packages/container/package/metrics for more information
+  use_prebuilt_image:
+    description: Use pre-built image from GitHub registry
+    type: boolean
+    default: yes
+
   # ====================================================================================
   # 🚧 Options below are mostly used for testing
 
@@ -269,6 +295,7 @@ inputs:
     description: Die on plugins errors
     type: boolean
     default: no
+    testing: yes
 
   # Debug mode
   # Note that this will automatically be enabled if job fails
@@ -276,12 +303,14 @@ inputs:
     description: Debug logs
     type: boolean
     default: no
+    testing: yes
 
   # Ensure SVG can be correctly parsed after generation
   verify:
     description: Verify SVG
     type: boolean
     default: no
+    testing: yes
 
   # Debug flags
   debug_flags:
@@ -294,6 +323,7 @@ inputs:
       - --hireable
       - --halloween
       - --error
+    testing: yes
 
   # Dry-run mode (perform generation without output)
   # Unlike "output_action" set to "none", output file won't be available in "/metrics_renders"
@@ -301,6 +331,7 @@ inputs:
     description: Enable dry-run
     type: boolean
     default: no
+    testing: yes
 
   # Experimental features
   # Note that no backward compatibility are guaranteed for these features
@@ -311,26 +342,11 @@ inputs:
     default: ""
     values:
       - --optimize-svg
+    testing: yes
 
   # Use mocked data to bypass external APIs
   use_mocked_data:
     description: Use mocked data instead of live APIs
     type: boolean
     default: no
-
-  # Use a pre-built image from GitHub registry when using unreleased versions of "lowlighter/metrics"
-  # This option has no effect on forks (images will always be rebuilt from Dockerfile)
-  # See https://github.com/users/lowlighter/packages/container/package/metrics for more information
-  use_prebuilt_image:
-    description: Use pre-built image from GitHub registry
-    type: boolean
-    default: yes
-
-  # Time to wait (in seconds) at the end of job
-  # Use this to avoid triggering abuse mechanics on large workflows
-  delay:
-    description: Use this to avoid triggering abuse mechanics on large workflows
-    type: number
-    default: 0
-    min: 0
-    max: 3600
+    testing: yes

source/plugins/followup/metadata.yml

@@ -29,4 +29,5 @@ inputs:
   plugin_followup_indepth:
     description: Indepth follow-up processing
     type: boolean
-    default: no
+    default: no
+    extras: yes

source/plugins/habits/metadata.yml

@@ -44,6 +44,7 @@ inputs:
     description: Display coding habits charts based on recent activity
     type: boolean
     default: no
+    extras: yes
 
   # Trim unused hours on daily chart
   plugin_habits_trim:

source/plugins/languages/metadata.yml

@@ -50,6 +50,7 @@ inputs:
     values:
       - most-used      # Most used languages
       - recently-used  # Recently used languages
+    extras: yes
 
   # 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)
@@ -98,6 +99,7 @@ inputs:
     description: Indepth languages processing (see documentation before enabling)
     type: boolean
     default: false
+    extras: yes
 
   # Analysis timeout (in minutes)
   # In case of timeout, it'll automatically fallback to default algorithm
@@ -109,6 +111,7 @@ inputs:
     default: 15
     min: 1
     max: 30
+    extras: yes
 
   # GitHub language categories to display
   plugin_languages_categories:

source/plugins/licenses/metadata.yml

@@ -12,6 +12,7 @@ inputs:
     description: Display licenses informations
     type: boolean
     default: no
+    extras: yes
 
   # Command to use to setup target repository
   # It is required to install all dependencies that will be analyzed with github/licensed

source/plugins/lines/metadata.yml

@@ -21,4 +21,5 @@ inputs:
     type: array
     format: comma-separated
     default: ""
-    example: my-repo-1, my-repo-2, owner/repo-3, ...
+    example: my-repo-1, my-repo-2, owner/repo-3, ...
+    inherits: repositories_skipped

source/plugins/notable/metadata.yml

@@ -43,4 +43,5 @@ inputs:
   plugin_notable_indepth:
     description: Indepth notable contributions processing
     type: boolean
-    default: no
+    default: no
+    extras: yes

source/plugins/reactions/metadata.yml

@@ -82,4 +82,5 @@ inputs:
     description: Users to ignore
     type: array
     format: comma-separated
-    default: github-actions[bot], dependabot[bot], dependabot-preview[bot]
+    default: ""
+    inherits: users_ignored

source/plugins/traffic/metadata.yml

@@ -21,4 +21,5 @@ inputs:
     type: array
     format: comma-separated
     default: ""
-    example: my-repo-1, my-repo-2, owner/repo-3 ...
+    example: my-repo-1, my-repo-2, owner/repo-3, ...
+    inherits: repositories_skipped