+ 
+
+ ),
+ },
+ {
+ title: 'Badge-Maker NPM library',
+ description: (
+ <>
+ Render badges in your own application using our{' '}
+
+ NPM library
+
+ npm install badge-maker
+
+ ),
+ },
+ {
+ title: 'Host your own instance',
+ description: (
+ <>
+ Host a shields instance behind your firewall with our{' '}
+
+ docker image
+
+ docker pull shieldsio/shields
+
+ ),
+ },
+ {
+ title: 'Love Shields?',
+ description: (
+ <>
+ Please consider{' '}
+
+ donating
+ {' '}
+ to sustain our activities
+
+ ),
+ },
+]
+
+function Feature({ title, description }) {
+ return (
+ {description}
++ +
+ +## Backers + +💵 Thank you to all our backers who help keep shields running by donating on OpenCollective. You can support this project by becoming a backer. + ++ +
+ +## Contributors + +🙏 This project exists thanks to all the nice people who contribute their time to work on the project. + ++ +
+ +✨ Shields is helped by these companies which provide a free plan for their product or service: + +{siteConfig.tagline}
+ block.
+ This behaviour is
+ a) mostly unhelpful and
+ b) non-configurable
+
+ This plugin removes tags which appear inside a block.
+ */
+ return tree => {
+ visit(tree, ['mdxJsxTextElement', 'mdxJsxFlowElement', 'element'], node => {
+ if (node.name === 'code' || node.tagName === 'code') {
+ const links = node.children.filter(child => child.tagName === 'a')
+ links.forEach(link => {
+ const linkText = link.children.map(child => child.value).join('')
+ const linkIndex = node.children.indexOf(link)
+ node.children.splice(linkIndex, 1, { type: 'text', value: linkText })
+ })
+ }
+ })
+ }
+}
+
+module.exports = stripCodeBlockLinks
diff --git a/src/theme/ApiDemoPanel/Curl/index.js b/src/theme/ApiDemoPanel/Curl/index.js
new file mode 100644
index 0000000..ee6afd2
--- /dev/null
+++ b/src/theme/ApiDemoPanel/Curl/index.js
@@ -0,0 +1,300 @@
+import React, { useRef, useState, useEffect } from 'react'
+import useDocusaurusContext from '@docusaurus/useDocusaurusContext'
+import clsx from 'clsx'
+import codegen from 'postman-code-generators'
+import { Highlight } from 'prism-react-renderer'
+import { useTypedSelector } from '@theme/ApiDemoPanel/hooks'
+import buildPostmanRequest from '@theme/ApiDemoPanel/buildPostmanRequest'
+import FloatingButton from '@theme/ApiDemoPanel/FloatingButton'
+import styles from 'docusaurus-theme-openapi/lib/theme/ApiDemoPanel/Curl/styles.module.css'
+
+const languageSet = [
+ {
+ tabName: 'cURL',
+ highlight: 'bash',
+ language: 'curl',
+ variant: 'curl',
+ options: {
+ longFormat: false,
+ followRedirect: true,
+ trimRequestBody: true,
+ },
+ },
+ {
+ tabName: 'Node',
+ highlight: 'javascript',
+ language: 'nodejs',
+ variant: 'axios',
+ options: {
+ ES6_enabled: true,
+ followRedirect: true,
+ trimRequestBody: true,
+ },
+ },
+ {
+ tabName: 'Go',
+ highlight: 'go',
+ language: 'go',
+ variant: 'native',
+ options: {
+ followRedirect: true,
+ trimRequestBody: true,
+ },
+ },
+ {
+ tabName: 'Python',
+ highlight: 'python',
+ language: 'python',
+ variant: 'requests',
+ options: {
+ followRedirect: true,
+ trimRequestBody: true,
+ },
+ },
+]
+const languageTheme = {
+ plain: {
+ color: 'var(--ifm-code-color)',
+ },
+ styles: [
+ {
+ types: ['inserted', 'attr-name'],
+ style: {
+ color: 'var(--openapi-code-green)',
+ },
+ },
+ {
+ types: ['string', 'url'],
+ style: {
+ color: 'var(--openapi-code-green)',
+ },
+ },
+ {
+ types: ['builtin', 'char', 'constant', 'function'],
+ style: {
+ color: 'var(--openapi-code-blue)',
+ },
+ },
+ {
+ types: ['punctuation', 'operator'],
+ style: {
+ color: 'var(--openapi-code-dim)',
+ },
+ },
+ {
+ types: ['class-name'],
+ style: {
+ color: 'var(--openapi-code-orange)',
+ },
+ },
+ {
+ types: ['tag', 'arrow', 'keyword'],
+ style: {
+ color: 'var(--openapi-code-purple)',
+ },
+ },
+ {
+ types: ['boolean'],
+ style: {
+ color: 'var(--openapi-code-red)',
+ },
+ },
+ ],
+}
+
+function getBaseUrl() {
+ /*
+ This is a special case for production.
+
+ We want to be able to build the front end with no value set for
+ `BASE_URL` so that staging, prod and self hosting users
+ can all use the same docker image.
+
+ When deployed to staging, we want the frontend on
+ https://staging.shields.io/ to generate badges with the base
+ https://staging.shields.io/
+ (and we want similar behaviour for users hosting their own instance)
+
+ When we promote to production we want https://shields.io/ and
+ https://www.shields.io/ to both generate badges with the base
+ https://img.shields.io/
+
+ For local dev, we can deal with setting the api and front-end
+ being on different ports using the BASE_URL env var
+ */
+ const { protocol, hostname, port } = window.location
+ if (['shields.io', 'www.shields.io'].includes(hostname)) {
+ return 'https://img.shields.io'
+ }
+ if (!port) {
+ return `${protocol}//${hostname}`
+ }
+ return `${protocol}//${hostname}:${port}`
+}
+
+function getServer() {
+ return {
+ url: getBaseUrl(),
+ variables: {},
+ }
+}
+
+function Curl({ postman, codeSamples }) {
+ // TODO: match theme for vscode.
+ const { siteConfig } = useDocusaurusContext()
+ const [copyText, setCopyText] = useState('Copy')
+ const contentType = useTypedSelector(state => state.contentType.value)
+ const accept = useTypedSelector(state => state.accept.value)
+ const server = useTypedSelector(state => state.server.value) || getServer()
+ const body = useTypedSelector(state => state.body)
+ const pathParams = useTypedSelector(state => state.params.path)
+ const queryParams = useTypedSelector(state => state.params.query)
+ const cookieParams = useTypedSelector(state => state.params.cookie)
+ const headerParams = useTypedSelector(state => state.params.header)
+ const auth = useTypedSelector(state => state.auth)
+
+ const langs = [
+ ...(siteConfig?.themeConfig?.languageTabs ?? languageSet),
+ ...codeSamples,
+ ]
+ const [language, setLanguage] = useState(langs[0])
+ const [codeText, setCodeText] = useState('')
+ useEffect(() => {
+ const postmanRequest = buildPostmanRequest(postman, {
+ queryParams,
+ pathParams,
+ cookieParams,
+ contentType,
+ accept,
+ headerParams,
+ body,
+ server,
+ auth,
+ })
+ if (language && !!language.options) {
+ codegen.convert(
+ language.language,
+ language.variant,
+ postmanRequest,
+ language.options,
+ (error, snippet) => {
+ if (error) {
+ return
+ }
+
+ setCodeText(snippet)
+ },
+ )
+ } else if (language && !!language.source) {
+ setCodeText(
+ language.source.replace('$url', postmanRequest.url.toString()),
+ )
+ } else {
+ setCodeText('')
+ }
+ }, [
+ accept,
+ body,
+ contentType,
+ cookieParams,
+ headerParams,
+ language,
+ pathParams,
+ postman,
+ queryParams,
+ server,
+ auth,
+ ])
+ const ref = useRef(null)
+
+ const handleCurlCopy = () => {
+ setCopyText('Copied')
+ setTimeout(() => {
+ setCopyText('Copy')
+ }, 2000)
+
+ if (ref.current?.innerText) {
+ navigator.clipboard.writeText(ref.current.innerText)
+ }
+ }
+
+ if (language === undefined) {
+ return null
+ }
+
+ return (
+ <>
+
+ {langs.map(lang => (
+
+ ))}
+
+
+
+ {({ className, tokens, getLineProps, getTokenProps }) => (
+
+
+
+ {tokens.map((line, i) => (
+ // this does have a key but eslint fails
+ // to detect it because it is an arg to getLineProps()
+ // eslint-disable-next-line react/jsx-key
+
+ {line.map((token, key) => {
+ if (token.types.includes('arrow')) {
+ token.types = ['arrow']
+ }
+
+ return (
+ // this does have a key but eslint fails
+ // to detect it because it is an arg to getLineProps()
+ // eslint-disable-next-line react/jsx-key
+
+ )
+ })}
+ {'\n'}
+
+ ))}
+
+
+
+ )}
+
+
+ )
+}
+
+export default Curl
diff --git a/src/theme/ApiDemoPanel/Response/index.js b/src/theme/ApiDemoPanel/Response/index.js
new file mode 100644
index 0000000..898e657
--- /dev/null
+++ b/src/theme/ApiDemoPanel/Response/index.js
@@ -0,0 +1,66 @@
+import React from 'react'
+import { useTypedDispatch, useTypedSelector } from '@theme/ApiDemoPanel/hooks'
+import FloatingButton from '@theme/ApiDemoPanel/FloatingButton'
+import { clearResponse } from 'docusaurus-theme-openapi/lib/theme/ApiDemoPanel/Response/slice'
+
+function formatXml(xml) {
+ const tab = ' '
+ let formatted = ''
+ let indent = ''
+ xml.split(/>\s* {
+ if (node.match(/^\/\w/)) {
+ // decrease indent by one 'tab'
+ indent = indent.substring(tab.length)
+ }
+
+ formatted += `${indent}<${node}>\r\n`
+
+ if (node.match(/^]*[^/]$/)) {
+ // increase indent
+ indent += tab
+ }
+ })
+ return formatted.substring(1, formatted.length - 3)
+}
+
+function Response() {
+ const response = useTypedSelector(state => state.response.value)
+ const dispatch = useTypedDispatch()
+
+ if (response === undefined) {
+ return null
+ }
+
+ let prettyResponse = response
+
+ try {
+ prettyResponse = JSON.stringify(JSON.parse(response), null, 2)
+ } catch {
+ if (response.startsWith(' dispatch(clearResponse())}>
+ {(response.startsWith('
+ )) || (
+
+ {prettyResponse || 'No Response'}
+
+ )}
+
+ )
+}
+
+export default Response
diff --git a/src/theme/DocPaginator/index.js b/src/theme/DocPaginator/index.js
new file mode 100644
index 0000000..7096842
--- /dev/null
+++ b/src/theme/DocPaginator/index.js
@@ -0,0 +1,3 @@
+export default function DocPaginator(props) {
+ return ''
+}
diff --git a/static/.nojekyll b/static/.nojekyll
new file mode 100644
index 0000000..473a0f4
diff --git a/static/img/builder.png b/static/img/builder.png
new file mode 100644
index 0000000..4316ba2
Binary files /dev/null and b/static/img/builder.png differ
diff --git a/static/img/favicon.ico b/static/img/favicon.ico
new file mode 100644
index 0000000..cf73624
Binary files /dev/null and b/static/img/favicon.ico differ
diff --git a/static/img/logo.png b/static/img/logo.png
new file mode 100644
index 0000000..0e33bbd
Binary files /dev/null and b/static/img/logo.png differ