From 6ee01bf30534cbf7847fe8c94fbf23efd9637f68 Mon Sep 17 00:00:00 2001
From: Eric Fennis <eric.fennis@gmail.com>
Date: Sun, 3 May 2026 13:19:02 +0200
Subject: [PATCH] feat: add support for `format` option in Carbon options
 (#5188)

---------

Co-authored-by: Copilot <copilot@github.com>
---
 docs/en/reference/default-theme-carbon-ads.md       | 7 +++++--
 docs/en/reference/default-theme-config.md           | 2 ++
 docs/es/reference/default-theme-carbon-ads.md       | 7 +++++--
 docs/es/reference/default-theme-config.md           | 6 +++++-
 docs/fa/reference/default-theme-carbon-ads.md       | 7 +++++--
 docs/fa/reference/default-theme-config.md           | 6 +++++-
 docs/ja/reference/default-theme-carbon-ads.md       | 7 +++++--
 docs/ja/reference/default-theme-config.md           | 6 +++++-
 docs/ko/reference/default-theme-carbon-ads.md       | 7 +++++--
 docs/ko/reference/default-theme-config.md           | 6 +++++-
 docs/pt/reference/default-theme-carbon-ads.md       | 7 +++++--
 docs/pt/reference/default-theme-config.md           | 6 +++++-
 docs/ru/reference/default-theme-carbon-ads.md       | 7 +++++--
 docs/ru/reference/default-theme-config.md           | 6 +++++-
 docs/zh/reference/default-theme-carbon-ads.md       | 7 +++++--
 docs/zh/reference/default-theme-config.md           | 6 +++++-
 src/client/theme-default/components/VPCarbonAds.vue | 7 ++++++-
 types/default-theme.d.ts                            | 1 +
 18 files changed, 84 insertions(+), 24 deletions(-)

diff --git a/docs/en/reference/default-theme-carbon-ads.md b/docs/en/reference/default-theme-carbon-ads.md
index c19ead68..e12f6b12 100644
--- a/docs/en/reference/default-theme-carbon-ads.md
+++ b/docs/en/reference/default-theme-carbon-ads.md
@@ -11,7 +11,8 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'your-carbon-code',
-      placement: 'your-carbon-placement'
+      placement: 'your-carbon-placement',
+      format: 'classic'
     }
   }
 }
@@ -19,8 +20,10 @@ export default {
 
 These values are used to call carbon CDN script as shown below.
 
+The `format` option supports `classic`, `responsive`, and `cover`.
+
 ```js
-`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}`
+`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}&format=${format}`
 ```
 
 To learn more about Carbon Ads configuration, please visit [Carbon Ads website](https://www.carbonads.net/).
diff --git a/docs/en/reference/default-theme-config.md b/docs/en/reference/default-theme-config.md
index 5b4b0fba..08596552 100644
--- a/docs/en/reference/default-theme-config.md
+++ b/docs/en/reference/default-theme-config.md
@@ -368,6 +368,7 @@ export default {
     carbonAds: {
       code: 'your-carbon-code',
       placement: 'your-carbon-placement'
+      format: 'classic'
     }
   }
 }
@@ -377,6 +378,7 @@ export default {
 export interface CarbonAdsOptions {
   code: string
   placement: string
+  format?: 'classic' | 'responsive' | 'cover'
 }
 ```
 
diff --git a/docs/es/reference/default-theme-carbon-ads.md b/docs/es/reference/default-theme-carbon-ads.md
index 41da600e..a665c611 100644
--- a/docs/es/reference/default-theme-carbon-ads.md
+++ b/docs/es/reference/default-theme-carbon-ads.md
@@ -11,7 +11,8 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'tu-código-carbon',
-      placement: 'tu-vinculación-carbon'
+      placement: 'tu-vinculación-carbon',
+      format: 'classic'
     }
   }
 }
@@ -19,8 +20,10 @@ export default {
 
 Estos valores se utilizan para llamar al script en CDN de carbon como se muestra a continuación.
 
+La opción `format` admite `classic`, `responsive` y `cover`.
+
 ```js
-`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}`
+`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}&format=${format}`
 ```
 
 Para obtener más información de la configuración de Carbono Ads, por favor visite [Site Carbon Ads](https://www.carbonads.net/).
diff --git a/docs/es/reference/default-theme-config.md b/docs/es/reference/default-theme-config.md
index a15608ff..0c86e1f7 100644
--- a/docs/es/reference/default-theme-config.md
+++ b/docs/es/reference/default-theme-config.md
@@ -353,16 +353,20 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'su-código-carbon',
-      placement: 'su-colocación-carbon'
+      placement: 'su-colocación-carbon',
+      format: 'classic'
     }
   }
 }
 ```
 
+La opción `format` admite `classic`, `responsive` y `cover`.
+
 ```ts
 export interface CarbonAdsOptions {
   code: string
   placement: string
+  format?: 'classic' | 'responsive' | 'cover'
 }
 ```
 
diff --git a/docs/fa/reference/default-theme-carbon-ads.md b/docs/fa/reference/default-theme-carbon-ads.md
index 6533d51b..6b9309c1 100644
--- a/docs/fa/reference/default-theme-carbon-ads.md
+++ b/docs/fa/reference/default-theme-carbon-ads.md
@@ -11,7 +11,8 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'your-carbon-code',
-      placement: 'your-carbon-placement'
+      placement: 'your-carbon-placement',
+      format: 'classic'
     }
   }
 }
@@ -19,8 +20,10 @@ export default {
 
 این مقادیر برای فراخوانی اسکریپت CDN Carbon به شکل زیر استفاده می‌شوند.
 
+گزینه `format` از مقادیر `classic`، `responsive` و `cover` پشتیبانی می‌کند.
+
 ```js
-`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}`
+`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}&format=${format}`
 ```
 
 برای یادگیری بیشتر درباره پیکربندی تبلیغات Carbon، لطفاً به [وب‌سایت Carbon Ads](https://www.carbonads.net/) مراجعه کنید.
diff --git a/docs/fa/reference/default-theme-config.md b/docs/fa/reference/default-theme-config.md
index 391422a2..aaa21b28 100644
--- a/docs/fa/reference/default-theme-config.md
+++ b/docs/fa/reference/default-theme-config.md
@@ -382,16 +382,20 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'your-carbon-code',
-      placement: 'your-carbon-placement'
+      placement: 'your-carbon-placement',
+      format: 'classic'
     }
   }
 }
 ```
 
+گزینه `format` از مقادیر `classic`، `responsive` و `cover` پشتیبانی می‌کند.
+
 ```ts
 export interface CarbonAdsOptions {
   code: string
   placement: string
+  format?: 'classic' | 'responsive' | 'cover'
 }
 ```
 
diff --git a/docs/ja/reference/default-theme-carbon-ads.md b/docs/ja/reference/default-theme-carbon-ads.md
index 77383ce7..db0e76f7 100644
--- a/docs/ja/reference/default-theme-carbon-ads.md
+++ b/docs/ja/reference/default-theme-carbon-ads.md
@@ -11,7 +11,8 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'your-carbon-code',
-      placement: 'your-carbon-placement'
+      placement: 'your-carbon-placement',
+      format: 'classic'
     }
   }
 }
@@ -19,8 +20,10 @@ export default {
 
 これらの値は、次のように Carbon の CDN スクリプトを呼び出すために使用されます。
 
+`format` オプションには `classic`、`responsive`、`cover` を指定できます。
+
 ```js
-`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}`
+`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}&format=${format}`
 ```
 
 Carbon Ads の設定について詳しくは、[Carbon Ads のウェブサイト](https://www.carbonads.net/)を参照してください。
diff --git a/docs/ja/reference/default-theme-config.md b/docs/ja/reference/default-theme-config.md
index cc0770a4..9da3db10 100644
--- a/docs/ja/reference/default-theme-config.md
+++ b/docs/ja/reference/default-theme-config.md
@@ -367,16 +367,20 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'your-carbon-code',
-      placement: 'your-carbon-placement'
+      placement: 'your-carbon-placement',
+      format: 'classic'
     }
   }
 }
 ```
 
+`format` オプションには `classic`、`responsive`、`cover` を指定できます。
+
 ```ts
 export interface CarbonAdsOptions {
   code: string
   placement: string
+  format?: 'classic' | 'responsive' | 'cover'
 }
 ```
 
diff --git a/docs/ko/reference/default-theme-carbon-ads.md b/docs/ko/reference/default-theme-carbon-ads.md
index 4dcdf832..d6e7150a 100644
--- a/docs/ko/reference/default-theme-carbon-ads.md
+++ b/docs/ko/reference/default-theme-carbon-ads.md
@@ -11,7 +11,8 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'your-carbon-code',
-      placement: 'your-carbon-placement'
+      placement: 'your-carbon-placement',
+      format: 'classic'
     }
   }
 }
@@ -19,8 +20,10 @@ export default {
 
 이 값들은 아래와 같이 카본 CDN 스크립트를 호출하는 데 사용됩니다.
 
+`format` 옵션에는 `classic`, `responsive`, `cover`를 사용할 수 있습니다.
+
 ```js
-`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}`
+`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}&format=${format}`
 ```
 
 카본 광고 구성에 대해 더 알고 싶다면 [카본 광고 웹사이트](https://www.carbonads.net/)를 방문하세요.
diff --git a/docs/ko/reference/default-theme-config.md b/docs/ko/reference/default-theme-config.md
index c61833e1..181febd5 100644
--- a/docs/ko/reference/default-theme-config.md
+++ b/docs/ko/reference/default-theme-config.md
@@ -366,16 +366,20 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'your-carbon-code',
-      placement: 'your-carbon-placement'
+      placement: 'your-carbon-placement',
+      format: 'classic'
     }
   }
 }
 ```
 
+`format` 옵션에는 `classic`, `responsive`, `cover`를 사용할 수 있습니다.
+
 ```ts
 export interface CarbonAdsOptions {
   code: string
   placement: string
+  format?: 'classic' | 'responsive' | 'cover'
 }
 ```
 
diff --git a/docs/pt/reference/default-theme-carbon-ads.md b/docs/pt/reference/default-theme-carbon-ads.md
index da7738ac..67c5f26e 100644
--- a/docs/pt/reference/default-theme-carbon-ads.md
+++ b/docs/pt/reference/default-theme-carbon-ads.md
@@ -11,7 +11,8 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'seu-código-carbon',
-      placement: 'sua-veiculação-carbon'
+      placement: 'sua-veiculação-carbon',
+      format: 'classic'
     }
   }
 }
@@ -19,8 +20,10 @@ export default {
 
 Esses valores são usados para chamar o sript em CDN do carbon como mostrado abaixo.
 
+A opção `format` aceita `classic`, `responsive` e `cover`.
+
 ```js
-`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}`
+`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}&format=${format}`
 ```
 
 Para aprender mais sobre a configuração Carbon Ads, por favor visite [Site Carbon Ads](https://www.carbonads.net/).
diff --git a/docs/pt/reference/default-theme-config.md b/docs/pt/reference/default-theme-config.md
index 516ab87a..b0c6b699 100644
--- a/docs/pt/reference/default-theme-config.md
+++ b/docs/pt/reference/default-theme-config.md
@@ -353,16 +353,20 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'seu-código-carbon',
-      placement: 'sua-veiculação-carbon'
+      placement: 'sua-veiculação-carbon',
+      format: 'classic'
     }
   }
 }
 ```
 
+A opção `format` aceita `classic`, `responsive` e `cover`.
+
 ```ts
 export interface CarbonAdsOptions {
   code: string
   placement: string
+  format?: 'classic' | 'responsive' | 'cover'
 }
 ```
 
diff --git a/docs/ru/reference/default-theme-carbon-ads.md b/docs/ru/reference/default-theme-carbon-ads.md
index bf923bd3..f8720a64 100644
--- a/docs/ru/reference/default-theme-carbon-ads.md
+++ b/docs/ru/reference/default-theme-carbon-ads.md
@@ -11,7 +11,8 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'код-рекламы',
-      placement: 'место-размещения-рекламы'
+      placement: 'место-размещения-рекламы',
+      format: 'classic'
     }
   }
 }
@@ -19,8 +20,10 @@ export default {
 
 Эти значения используются для вызова сценария Carbon CDN, как показано ниже:
 
+Параметр `format` поддерживает значения `classic`, `responsive` и `cover`.
+
 ```js
-;`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}`
+`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}&format=${format}`
 ```
 
 Чтобы узнать больше о настройке Carbon Ads, посетите [веб-сайт Carbon Ads](https://www.carbonads.net/).
diff --git a/docs/ru/reference/default-theme-config.md b/docs/ru/reference/default-theme-config.md
index 827b77e9..99689bd1 100644
--- a/docs/ru/reference/default-theme-config.md
+++ b/docs/ru/reference/default-theme-config.md
@@ -367,16 +367,20 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'код-рекламы',
-      placement: 'место-размещения-рекламы'
+      placement: 'место-размещения-рекламы',
+      format: 'classic'
     }
   }
 }
 ```
 
+Параметр `format` поддерживает значения `classic`, `responsive` и `cover`.
+
 ```ts
 export interface CarbonAdsOptions {
   code: string
   placement: string
+  format?: 'classic' | 'responsive' | 'cover'
 }
 ```
 
diff --git a/docs/zh/reference/default-theme-carbon-ads.md b/docs/zh/reference/default-theme-carbon-ads.md
index 851abb28..e64068b0 100644
--- a/docs/zh/reference/default-theme-carbon-ads.md
+++ b/docs/zh/reference/default-theme-carbon-ads.md
@@ -11,7 +11,8 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'your-carbon-code',
-      placement: 'your-carbon-placement'
+      placement: 'your-carbon-placement',
+      format: 'classic'
     }
   }
 }
@@ -19,8 +20,10 @@ export default {
 
 这些值用于调用 carbon CDN 脚本，如下所示。
 
+`format` 选项支持 `classic`、`responsive` 和 `cover`。
+
 ```js
-`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}`
+`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}&format=${format}`
 ```
 
 要了解有关 Carbon Ads 配置的更多信息，请访问 [Carbon Ads 站点](https://www.carbonads.net/)。
diff --git a/docs/zh/reference/default-theme-config.md b/docs/zh/reference/default-theme-config.md
index a69ca3f2..e7fab27a 100644
--- a/docs/zh/reference/default-theme-config.md
+++ b/docs/zh/reference/default-theme-config.md
@@ -353,16 +353,20 @@ export default {
   themeConfig: {
     carbonAds: {
       code: 'your-carbon-code',
-      placement: 'your-carbon-placement'
+      placement: 'your-carbon-placement',
+      format: 'classic'
     }
   }
 }
 ```
 
+`format` 选项支持 `classic`、`responsive` 和 `cover`。
+
 ```ts
 export interface CarbonAdsOptions {
   code: string
   placement: string
+  format?: 'classic' | 'responsive' | 'cover'
 }
 ```
 
diff --git a/src/client/theme-default/components/VPCarbonAds.vue b/src/client/theme-default/components/VPCarbonAds.vue
index a233d1ef..5b2ed851 100644
--- a/src/client/theme-default/components/VPCarbonAds.vue
+++ b/src/client/theme-default/components/VPCarbonAds.vue
@@ -19,9 +19,14 @@ let isInitialized = false
 function init() {
   if (!isInitialized) {
     isInitialized = true
+    const params = new URLSearchParams({
+      serve: carbonOptions.code,
+      placement: carbonOptions.placement,
+      format: carbonOptions?.format || 'classic',
+    })
     const s = document.createElement('script')
     s.id = '_carbonads_js'
-    s.src = `//cdn.carbonads.com/carbon.js?serve=${carbonOptions.code}&placement=${carbonOptions.placement}`
+    s.src = `//cdn.carbonads.com/carbon.js?${params.toString()}`
     s.async = true
     container.value.appendChild(s)
   }
diff --git a/types/default-theme.d.ts b/types/default-theme.d.ts
index 919f9d1f..7f648ca0 100644
--- a/types/default-theme.d.ts
+++ b/types/default-theme.d.ts
@@ -410,6 +410,7 @@ export namespace DefaultTheme {
   export interface CarbonAdsOptions {
     code: string
     placement: string
+    format?: 'classic' | 'responsive' | 'cover'
   }
 
   // last updated --------------------------------------------------------------