DOCS: Added Gitbook filenames to JSON code snippets. (#2119)

documentation/ci-cd-gitlab.md

@@ -13,31 +13,34 @@ This is based on:
 
 For convenience, both configuration files are shown below.
 
-- `dnsconfig.js`
-  ```javascript
-  var PROVIDER_NONE = NewRegistrar('none');
-  var PROVIDER_TRANSIP = NewDnsProvider('transip', '-');
+{% code title="dnsconfig.js" %}
+```javascript
+var PROVIDER_NONE = NewRegistrar('none');
+var PROVIDER_TRANSIP = NewDnsProvider('transip', '-');
 
-  D('cafferata.dev',
-      PROVIDER_NONE,
-      DnsProvider(PROVIDER_TRANSIP),
-      DefaultTTL('1d'),
-      TXT('spf', [
-          'v=spf1',
-          '-all'
-      ].join(' '))
-  );
-  ```
-- `creds.json`
-  ```json
-  {
-      "transip": {
-          "TYPE": "TRANSIP",
-          "AccountName": "cafferatax",
-          "PrivateKey": "$TRANSIP_PRIVATE_KEY"
-      }
-  }
-  ```
+D('cafferata.dev',
+    PROVIDER_NONE,
+    DnsProvider(PROVIDER_TRANSIP),
+    DefaultTTL('1d'),
+    TXT('spf', [
+        'v=spf1',
+        '-all'
+    ].join(' '))
+);
+```
+{% endcode %}
+
+{% code title="creds.json" %}
+```json
+{
+    "transip": {
+        "TYPE": "TRANSIP",
+        "AccountName": "cafferatax",
+        "PrivateKey": "$TRANSIP_PRIVATE_KEY"
+    }
+}
+```
+{% endcode %}
 
 ## Gitlab CI - Preparation
 

documentation/creds-json.md

@@ -5,6 +5,7 @@ configuration parameters required are stored in `creds.json`.   The file contain
 
 Here's a sample file:
 
+{% code title="creds.json" %}
 ```json
 {
   "cloudflare_tal": {
@@ -26,6 +27,7 @@ Here's a sample file:
   }
 }
 ```
+{% endcode %}
 
 ## Format
 
@@ -79,6 +81,7 @@ For a smooth transition, please update your `creds.json` file now.
 
 Here is the minimal entry required:
 
+{% code title="creds.json" %}
 ```json
 {
   "entryName": {
@@ -86,6 +89,7 @@ Here is the minimal entry required:
   }
 }
 ```
+{% endcode %}
 
 ### cleanup
 
@@ -203,6 +207,7 @@ In this case, the 1Password CLI is used to inject the secrets from
 a 1Password vault, rather than storing them in environment variables.
 An example of a template file containing Linode and Cloudflare API credentials is available here: [creds.json](https://github.com/StackExchange/dnscontrol/blob/master/documentation/assets/1password/creds.json).
 
+{% code title="creds.json" %}
 ```json
 {
   "bind": {
@@ -219,6 +224,7 @@ An example of a template file containing Linode and Cloudflare API credentials i
   }
 }
 ```
+{% endcode %}
 
 ## Don't store secrets in a Git repo!
 

documentation/get-certs.md

@@ -53,6 +53,7 @@ specify any number of certificates, with up to 100 SAN entries each. Subject nam
 
 The format of the file is a simple JSON array of objects:
 
+{% code title="certs.json" %}
 ```json
 [
     {
@@ -74,6 +75,7 @@ The format of the file is a simple JSON array of objects:
     }
 ]
 ```
+{% endcode %}
 
 `dnscontrol get-certs` will attempt to issue any certificates referenced by this file, and will renew or re-issue if the certificate we already have is
 close to expiry or if the set of subject names changes for a cert.

documentation/getting-started.md

@@ -102,6 +102,7 @@ Modify this file to match your particular providers and domains. See [the DNSCon
 Create a file called `creds.json` for storing provider configurations (API tokens and other account information).
 For example, to use both name.com and Cloudflare, you would have:
 
+{% code title="creds.json" %}
 ```json
 {
   "cloudflare": {                               // The provider name used in dnsconfig.js
@@ -117,6 +118,7 @@ For example, to use both name.com and Cloudflare, you would have:
   "none": { "TYPE": "NONE" }                    // The no-op provider
 }
 ```
+{% endcode %}
 
 Note: Do **not** store your `creds.json` file in Git unencrypted.
 That is unsafe. Add `creds.json` to your
@@ -150,6 +152,7 @@ and renaming it.
 
 The file looks like:
 
+{% code title="creds.json" %}
 ```json
 {
   "bind": {
@@ -162,6 +165,7 @@ The file looks like:
   }
 }
 ```
+{% endcode %}
 
 Ignore the `r53_accountname` section.  It is a placeholder and will be ignored. You
 can use it later when you define your first set of API credentials.
@@ -183,11 +187,13 @@ jq . < creds.json
 
 FYI: `creds.json` fields can be read from an environment variable. The field must begin with a `$` followed by the variable name. No other text. For example:
 
+{% code title="creds.json" %}
 ```json
 {
     "apikey": "$GANDI_V5_APIKEY"
 }
 ```
+{% endcode %}
 
 ## 5. Test the sample files
 

documentation/notifications.md

@@ -9,6 +9,7 @@ new types or destinations.
 
 Notifications are set up in your credentials JSON file. They will use the `notifications` key to look for keys or configuration needed for various notification types.
 
+{% code title="creds.json" %}
 ```json
   "r53": {
       ...
@@ -21,6 +22,7 @@ Notifications are set up in your credentials JSON file. They will use the `notif
       "teams_url": "https://outlook.office.com/webhook/00000000-0000-0000-0000-000000000000@00000000-0000-0000-0000-000000000000/IncomingWebhook/00000000000000000000000000000000/00000000-0000-0000-0000-000000000000"
   }
 ```
+{% endcode %}
 
 You also must run `dnscontrol preview` or `dnscontrol push` with the `-notify` flag to enable notification sending at all.
 

documentation/providers/akamaiedgedns.md

@@ -19,6 +19,7 @@ To use this provider, add an entry to `creds.json` with `TYPE` set to `AKAMAIEDG
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 "akamaiedgedns": {
     "TYPE": "AKAMAIEDGEDNS",
@@ -30,6 +31,7 @@ Example:
     "group_id": "NNNNNN"
 }
 ```
+{% endcode %}
 
 ## Usage
 

documentation/providers/autodns.md

@@ -5,6 +5,7 @@ To use this provider, add an entry to `creds.json` with `TYPE` set to `AUTODNS`
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "autodns": {
@@ -15,6 +16,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Usage
 

documentation/providers/axfrddns.md

@@ -33,6 +33,7 @@ the provider:
 
 For instance, your `creds.json` might looks like:
 
+{% code title="creds.json" %}
 ```json
 {
   "axfrddns": {
@@ -42,6 +43,7 @@ For instance, your `creds.json` might looks like:
   }
 }
 ```
+{% endcode %}
 
 If either key is missing, DNSControl defaults to IP-based ACL
 authentication for that function. Including both keys is the most
@@ -58,6 +60,7 @@ var DSP_AXFRDDNS_B = NewDnsProvider("axfrddns-b");
 
 And update `creds.json` accordingly:
 
+{% code title="creds.json" %}
 ```json
 {
     "axfrddns-a": {
@@ -70,6 +73,7 @@ And update `creds.json` accordingly:
     }
 }
 ```
+{% endcode %}
 
 ### Default nameservers
 

documentation/providers/azure_dns.md

@@ -5,6 +5,7 @@ along with the API credentials.
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "azuredns_main": {
@@ -17,6 +18,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 You can also use environment variables:
 
@@ -28,6 +30,7 @@ export AZURE_CLIENT_ID=AAAAAAAAA
 export AZURE_CLIENT_SECRET=BBBBBBBBB
 ```
 
+{% code title="creds.json" %}
 ```json
 {
   "azuredns_main": {
@@ -40,6 +43,7 @@ export AZURE_CLIENT_SECRET=BBBBBBBBB
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to Azure DNS.

documentation/providers/bind.md

@@ -17,6 +17,7 @@ Optional fields include:
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "bind": {
@@ -25,7 +26,7 @@ Example:
   }
 }
 ```
-
+{% endcode %}
 
 ## Meta configuration
 

documentation/providers/cloudflareapi.md

@@ -16,6 +16,7 @@ Optional fields include:
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "cloudflare": {
@@ -25,6 +26,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 # Authentication
 
@@ -39,6 +41,7 @@ provide a [Cloudflare API token](https://dash.cloudflare.com/profile/api-tokens)
 
 This method is enabled by setting the `apitoken` value in `creds.json`:
 
+{% code title="creds.json" %}
 ```json
 {
   "cloudflare": {
@@ -48,6 +51,7 @@ This method is enabled by setting the `apitoken` value in `creds.json`:
   }
 }
 ```
+{% endcode %}
 
 * `accountid` is found in the Cloudflare portal ("Account ID") on any "Website" page.  Click on any site and you'll see the "Account ID" on the lower right side of the page.
 * `apitoken` is something you must create. See [Cloudflare's documentation](https://support.cloudflare.com/hc/en-us/articles/200167836-Managing-API-Tokens-and-Keys) for instructions on how to generate and configure permissions on API tokens.  (Spoiler alert: [link](https://dash.cloudflare.com/profile/api-tokens). The token must be granted rights (authorization to do certain tasks) at a very granular level.
@@ -74,6 +78,7 @@ This method is not recommended because these credentials give DNSControl access
 
 This method is enabled by setting the `apikey` and `apiuser` values in `creds.json`:
 
+{% code title="creds.json" %}
 ```json
 {
   "cloudflare": {
@@ -84,6 +89,8 @@ This method is enabled by setting the `apikey` and `apiuser` values in `creds.js
   }
 }
 ```
+{% endcode %}
+
 * `accountid` (see above)
 * `apiuser` is the email address associated with the account.
 * `apikey` is found on [My Profile / API Tokens](https://dash.cloudflare.com/profile/api-tokens).

documentation/providers/cloudns.md

@@ -5,6 +5,7 @@ along with your [Api user ID and password](https://www.cloudns.net/wiki/article/
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "cloudns": {
@@ -15,6 +16,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 Current version of provider doesn't support `sub-auth-user`.
 

documentation/providers/cscglobal.md

@@ -15,6 +15,7 @@ In your `creds.json` file, you must provide your API key and user/client token.
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "cscglobal": {
@@ -25,6 +26,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Usage
 An example `dnsconfig.js` configuration:

documentation/providers/desec.md

@@ -5,6 +5,7 @@ along with a deSEC account auth token.
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "desec": {
@@ -13,6 +14,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to deSEC.

documentation/providers/digitalocean.md

@@ -5,6 +5,7 @@ along with your [DigitalOcean OAuth Token](https://cloud.digitalocean.com/settin
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "mydigitalocean": {
@@ -13,6 +14,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to DigitalOcean.

documentation/providers/dnsimple.md

@@ -7,6 +7,7 @@ You can also set the `baseurl` to use [DNSimple's free sandbox](https://develope
 
 Examples:
 
+{% code title="creds.json" %}
 ```json
 {
   "dnsimple": {
@@ -20,6 +21,7 @@ Examples:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to DNSimple.

documentation/providers/dnsmadeeasy.md

@@ -5,6 +5,7 @@ along with your `api_key` and `secret_key`. More info about authentication can b
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "dnsmadeeasy": {
@@ -14,6 +15,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Records
 

documentation/providers/dnsoverhttps.md

@@ -4,6 +4,7 @@ This is a read-only/monitoring "registrar". It does a DNS NS lookup to confirm t
 
 To use this provider, add an entry to `creds.json` with `TYPE` set to `DNSOVERHTTPS`.
 
+{% code title="creds.json" %}
 ```json
 {
   "dohdefault": {
@@ -11,11 +12,13 @@ To use this provider, add an entry to `creds.json` with `TYPE` set to `DNSOVERHT
   }
 }
 ```
+{% endcode %}
 
 The DNS-over-HTTPS provider defaults to using Google Public DNS however you may configure an alternative RFC 8484 DoH provider using the `host` parameter.
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "dohcloudflare": {
@@ -24,6 +27,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 Some common DoH providers are:
 

documentation/providers/domainnameshop.md

@@ -5,6 +5,7 @@ along with your [Domainnameshop Token and Secret](https://www.domeneshop.no/admi
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "mydomainnameshop": {
@@ -14,6 +15,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to Domainnameshop.

documentation/providers/easyname.md

@@ -7,6 +7,7 @@ along with [API-Access](https://my.easyname.com/en/account/api) information
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "easyname": {
@@ -19,6 +20,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to easyname.

documentation/providers/gandi_v5.md

@@ -28,6 +28,7 @@ https://admin.gandi.net/organizations/[not this hex string]/PLTS/[sharing id]/pr
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "gandi": {
@@ -37,6 +38,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to Gandi.

documentation/providers/gcloud.md

@@ -9,6 +9,7 @@ Copy the full JSON object into your `creds.json`. Newlines in the private key ne
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "gcloud": {
@@ -27,6 +28,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 **Note**:
 

documentation/providers/gcore.md

@@ -5,6 +5,7 @@ along with a Gcore account API token.
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "gcore": {
@@ -13,6 +14,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to Gcore.

documentation/providers/hedns.md

@@ -10,6 +10,7 @@ along with
 your `dns.he.net` account username and password. These are the same username
 and password used to login to the [web interface](https://dns.he.net).
 
+{% code title="creds.json" %}
 ```json
 {
   "hedns": {
@@ -19,12 +20,14 @@ and password used to login to the [web interface](https://dns.he.net).
   }
 }
 ```
+{% endcode %}
 
 ### Two factor authentication
 
 If two-factor authentication has been enabled on your account you will also need to provide a valid TOTP code.
 This can also be done via an environment variable:
 
+{% code title="creds.json" %}
 ```json
 {
   "hedns": {
@@ -35,6 +38,7 @@ This can also be done via an environment variable:
   }
 }
 ```
+{% endcode %}
 
 and then you can run
 
@@ -51,6 +55,7 @@ only available when first enabling two-factor authentication.
 * Storing the shared secret together with the password weakens two factor authentication because both factors are stored
   in a single place.
 
+{% code title="creds.json" %}
 ```json
 {
   "hedns":{
@@ -60,6 +65,7 @@ only available when first enabling two-factor authentication.
   }
 }
 ```
+{% endcode %}
 
 ### Persistent Sessions
 
@@ -78,6 +84,7 @@ This option is disabled by default when this key is not present,
   *full* access to your Hurrican Electric account and will be able to modify and delete your DNS entries.
 * It should be stored in a location only trusted users can access.
 
+{% code title="creds.json" %}
 ```json
 {
   "hedns":{
@@ -88,7 +95,7 @@ This option is disabled by default when this key is not present,
   }
 }
 ```
-
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to Hurricane Electric DNS.

documentation/providers/hetzner.md

@@ -5,6 +5,7 @@ along with a [Hetzner API Key](https://dns.hetzner.com/settings/api-token).
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "hetzner": {
@@ -13,6 +14,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 
@@ -81,6 +83,7 @@ Example: Your per minute quota is 60 requests and in your settings you
 
 In your `creds.json` for all `HETZNER` provider entries:
 
+{% code title="creds.json" %}
 ```json
 {
   "hetzner": {
@@ -90,6 +93,7 @@ In your `creds.json` for all `HETZNER` provider entries:
   }
 }
 ```
+{% endcode %}
 
 Every response from the Hetzner DNS Console API includes your limits:
 
@@ -114,6 +118,7 @@ With `start_with_default_rate_limit` DNSControl uses a quota equivalent to
 
 In your `creds.json` for all `HETZNER` provider entries:
 
+{% code title="creds.json" %}
 ```json
 {
   "hetzner": {
@@ -123,3 +128,4 @@ In your `creds.json` for all `HETZNER` provider entries:
   }
 }
 ```
+{% endcode %}

documentation/providers/hexonet.md

@@ -14,6 +14,7 @@ along with your HEXONET login data.
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "hexonet": {
@@ -26,9 +27,11 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 Here a working example for our OT&E System:
 
+{% code title="creds.json" %}
 ```json
 {
   "hexonet": {
@@ -40,6 +43,7 @@ Here a working example for our OT&E System:
   }
 }
 ```
+{% endcode %}
 
 {% hint style="info" %}
 **NOTE**: The above credentials are known to the public.

documentation/providers/hostingde.md

@@ -5,6 +5,7 @@ along with your [`authToken` and optionally an `ownerAccountId`](https://www.hos
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "hosting.de": {
@@ -13,6 +14,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Usage
 
@@ -36,6 +38,7 @@ Using them requires setting the `baseURL` and (optionally) overriding the defaul
 
 An example `creds.json` configuration:
 
+{% code title="creds.json" %}
 ```json
 {
   "http.net": {
@@ -45,6 +48,7 @@ An example `creds.json` configuration:
   }
 }
 ```
+{% endcode %}
 
 An example `dnsconfig.js` configuration:
 

documentation/providers/internetbs.md

@@ -7,6 +7,7 @@ along with an API key and account password.
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "internetbs": {
@@ -16,6 +17,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to Internet.bs.

documentation/providers/inwx.md

@@ -7,6 +7,7 @@ along with your INWX username and password.
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "inwx": {
@@ -16,6 +17,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ### Two factor authentication
 
@@ -31,6 +33,7 @@ See issue [issue 848](https://github.com/StackExchange/dnscontrol/issues/848#iss
 If two factor authentication has been enabled you will also need to provide a valid TOTP number.
 This can also be done via an environment variable:
 
+{% code title="creds.json" %}
 ```json
 {
   "inwx": {
@@ -41,6 +44,7 @@ This can also be done via an environment variable:
   }
 }
 ```
+{% endcode %}
 
 and then you can run
 
@@ -55,6 +59,7 @@ This secret is only shown once when two factor authentication is enabled and you
 * Anyone with access to this `creds.json` file will have *full* access to your INWX account and will be able to transfer and/or delete your domains
 * Storing the shared secret together with the password weakens two factor authentication because both factors are stored in a single place.
 
+{% code title="creds.json" %}
 ```json
 {
   "inwx": {
@@ -65,12 +70,13 @@ This secret is only shown once when two factor authentication is enabled and you
   }
 }
 ```
-
+{% endcode %}
 
 ### Sandbox
 You can optionally also specify sandbox with a value of 1 to
 redirect all requests to the sandbox API instead:
 
+{% code title="creds.json" %}
 ```json
 {
   "inwx":{
@@ -80,6 +86,7 @@ redirect all requests to the sandbox API instead:
   }
 }
 ```
+{% endcode %}
 
 If sandbox is omitted or set to any other value the production
 API will be used.

documentation/providers/linode.md

@@ -5,6 +5,7 @@ along with your [Linode Personal Access Token](https://cloud.linode.com/profile/
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "linode": {
@@ -13,6 +14,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to Linode.

documentation/providers/msdns.md

@@ -34,6 +34,7 @@ along with other settings:
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "msdns": {
@@ -43,6 +44,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 An example DNS configuration:
 

documentation/providers/namecheap.md

@@ -7,6 +7,7 @@ along with your Namecheap API username and key:
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "namecheap": {
@@ -16,10 +17,12 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 You can optionally specify BaseURL to use a different endpoint - typically the
 sandbox:
 
+{% code title="creds.json" %}
 ```json
 {
   "namecheapSandbox": {
@@ -30,6 +33,7 @@ sandbox:
   }
 }
 ```
+{% endcode %}
 
 if BaseURL is omitted, the production namecheap URL is assumed.
 

documentation/providers/namedotcom.md

@@ -11,6 +11,7 @@ along with your name.com API username and access token:
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "name.com": {
@@ -20,6 +21,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 There is another key name `apiurl` but it is optional and defaults to the correct value. If you want to use the test environment ("OT&E"), then add this:
 

documentation/providers/netcup.md

@@ -5,6 +5,7 @@ along with your [api key, password and your customer number](https://www.netcup-
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "netcup": {
@@ -15,6 +16,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Usage
 An example `dnsconfig.js` configuration:

documentation/providers/netlify.md

@@ -6,6 +6,7 @@ account slug. This is _typically_ your username on Netlify.
 
 Examples:
 
+{% code title="creds.json" %}
 ```json
 {
   "netlify": {
@@ -15,6 +16,7 @@ Examples:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to Netlify.

documentation/providers/ns1.md

@@ -5,6 +5,7 @@ along with your NS1 api key.
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "ns1": {
@@ -13,6 +14,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to NS1.

documentation/providers/oracle.md

@@ -8,6 +8,7 @@ The OCID of the compartment DNS resources should be put in can also optionally b
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "oracle": {
@@ -21,6 +22,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to Oracle Cloud.

documentation/providers/ovh.md

@@ -5,6 +5,7 @@ along with a OVH app-key, app-secret-key and consumer-key.
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "ovh": {
@@ -15,6 +16,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 See [the Activation section](#activation) for details on obtaining these credentials.
 
@@ -95,6 +97,7 @@ curl -XPOST -H"X-Ovh-Application: <you-app-key>" -H "Content-type: application/j
 
 It should return something akin to:
 
+{% code title="creds.json" %}
 ```json
 {
   "validationUrl": "https://eu.api.ovh.com/auth/?credentialToken=<long-token>",
@@ -102,6 +105,7 @@ It should return something akin to:
   "state": "pendingValidation"
 }
 ```
+{% endcode %}
 
 Open the "validationUrl" in a browser and log in with your OVH account. This will link the app with your account,
 authorizing it to access your zones and domains.

documentation/providers/packetframe.md

@@ -5,6 +5,7 @@ along with your Packetframe Token which can be extracted from the `token` cookie
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "packetframe": {
@@ -13,6 +14,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to Packetframe.

documentation/providers/porkbun.md

@@ -5,6 +5,7 @@ along with your `api_key` and `secret_key`. More info about authentication can b
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "porkbun": {
@@ -14,6 +15,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 

documentation/providers/powerdns.md

@@ -6,6 +6,7 @@ In most cases the Server id is `localhost`.
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "powerdns": {
@@ -16,6 +17,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 Following metadata are available:

documentation/providers/route53.md

@@ -5,6 +5,7 @@ along with API credentials.
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "r53_main": {
@@ -16,6 +17,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 Alternatively you can also use environment variables.  This is discouraged unless your environment provides them already.
 
@@ -25,6 +27,7 @@ export AWS_SECRET_ACCESS_KEY=YYYYYYYYY
 export AWS_SESSION_TOKEN=ZZZZZZZZ
 ```
 
+{% code title="creds.json" %}
 ```json
 {
   "r53_main": {
@@ -34,6 +37,7 @@ export AWS_SESSION_TOKEN=ZZZZZZZZ
   }
 }
 ```
+{% endcode %}
 
 Alternatively, this provider supports [named profiles](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html). In that case export the following variable:
 
@@ -45,6 +49,7 @@ and provide a minimal entry in `creds.json`:
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "r53_main": {
@@ -52,6 +57,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 You can find some other ways to authenticate to Route53 in the [go sdk configuration](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html).
 

documentation/providers/rwth.md

@@ -5,6 +5,7 @@ along with your [API Token](https://noc-portal.rz.rwth-aachen.de/dns-admin/en/ap
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "rwth": {
@@ -13,6 +14,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ## Metadata
 This provider does not recognize any special metadata fields unique to it.

documentation/providers/softlayer.md

@@ -12,6 +12,7 @@ Authenticating with SoftLayer requires at least a `username` and `api_key` for a
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "softlayer": {
@@ -21,6 +22,7 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 To maintain compatibility with existing softlayer CLI services these can also be provided by the `SL_USERNAME` and `SL_API_KEY` environment variables or specified in the `~/.softlayer`, but this is discouraged. More information about these methods can be found at [the softlayer-go library documentation](https://github.com/softlayer/softlayer-go#sessions).
 

documentation/providers/transip.md

@@ -9,6 +9,7 @@ You can login with your `AccountName` and a `PrivateKey` which can be generated
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "transip": {
@@ -18,12 +19,13 @@ Example:
   }
 }
 ```
+{% endcode %}
 
 ### Access tokens
 
 Or you can choose to have an `AccessToken` as credential. These can be generated in the [TransIP control panel](https://www.transip.nl/cp/account/api/) and have a limited lifetime
 
-
+{% code title="creds.json" %}
 ```json
 {
   "transip": {
@@ -32,7 +34,7 @@ Or you can choose to have an `AccessToken` as credential. These can be generated
   }
 }
 ```
-
+{% endcode %}
 
 
 ## Metadata

documentation/providers/vultr.md

@@ -5,6 +5,7 @@ along with a Vultr personal access token.
 
 Example:
 
+{% code title="creds.json" %}
 ```json
 {
   "vultr": {
@@ -13,6 +14,7 @@ Example:
   }
 }
 ```
+{% endcode %}`
 
 ## Metadata