docs: add Carbon ads (react-bootstrap#6195)

* docs: add Carbon ads

* add a cleanup for the ad

Author: kyletsang

www/src/components/CarbonAds.js

@@ -0,0 +1,28 @@
+import React, { useEffect, useRef } from 'react';
+
+const CarbonAds = () => {
+  const ref = useRef();
+
+  useEffect(() => {
+    if (typeof document !== 'undefined') {
+      const script = document.createElement('script');
+      script.async = true;
+      script.id = '_carbonads_js';
+      script.type = 'text/javascript';
+      script.src =
+        '//cdn.carbonads.com/carbon.js?serve=CE7IP2QY&placement=react-bootstrapgithubio';
+
+      ref.current.appendChild(script);
+    }
+
+    return () => {
+      while (ref.current?.firstChild) {
+        ref.current.removeChild(ref.current.firstChild);
+      }
+    };
+  }, []);
+
+  return <div ref={ref} />;
+};
+
+export default CarbonAds;

www/src/components/NavMain.js

@@ -13,28 +13,28 @@ import { faGithub } from '@fortawesome/free-brands-svg-icons/faGithub';
 
 import logo from '../assets/logo.svg';
 
-const Banner = styled(Navbar).attrs({
-  as: 'header',
-  variant: 'dark',
-  role: 'banner',
-})`
-  @import '../css/theme.scss';
-
-  composes: text-light justify-content-center from global;
-  min-height: 4rem;
-  background-color: $darker;
-  filter: none;
-  -webkit-filter: none;
-
-  a {
-    margin-left: 1em;
-    color: $brand;
-  }
-
-  @include media-breakpoint-up(md) {
-    z-index: 1040;
-  }
-`;
+// const Banner = styled(Navbar).attrs({
+//   as: 'header',
+//   variant: 'dark',
+//   role: 'banner',
+// })`
+//   @import '../css/theme.scss';
+
+//   composes: text-light justify-content-center from global;
+//   min-height: 4rem;
+//   background-color: $darker;
+//   filter: none;
+//   -webkit-filter: none;
+
+//   a {
+//     margin-left: 1em;
+//     color: $brand;
+//   }
+
+//   @include media-breakpoint-up(md) {
+//     z-index: 1040;
+//   }
+// `;
 
 const StyledNavbar = styled(Navbar).attrs({
   as: 'header',
@@ -99,16 +99,6 @@ const propTypes = {
 function NavMain({ activePage }) {
   return (
     <>
-      <Banner>
-        <span className="text-light">Black Lives Matter.</span>
-        <a
-          target="_blank"
-          rel="noreferrer"
-          href="https://support.eji.org/give/153413/#!/donation/checkout"
-        >
-          Support the Equal Justice Initiative.
-        </a>
-      </Banner>
       <StyledNavbar expand collapseOnSelect>
         <Container fluid>
           <SkipToContentLink href="#rb-docs-content" tabIndex="0">

www/src/components/SideNav.js

@@ -7,6 +7,7 @@ import FormControl from 'react-bootstrap/FormControl';
 import styled from 'astroturf';
 import Button from 'react-bootstrap/Button';
 import Collapse from 'react-bootstrap/Collapse';
+import CarbonAds from './CarbonAds';
 
 const MenuButton = styled(Button).attrs({ variant: 'link' })`
   composes: p-0 d-md-none ms-3 from global;
@@ -42,8 +43,10 @@ const OverflowWrapper = styled('div')`
   @import '../css/theme';
 
   @include media-breakpoint-up(md) {
-    display: block !important;
+    display: flex !important;
     height: 100% !important;
+    flex-direction: column;
+    max-height: calc(100vh - 8.5rem);
   }
 `;
 
@@ -282,6 +285,7 @@ class SideNav extends React.Component {
               />
               <NavSection heading="About" location={location} path="/about" />
             </TableOfContents>
+            <CarbonAds />
           </OverflowWrapper>
         </Collapse>
       </SidePanel>

www/src/css/carbonads.scss

@@ -0,0 +1,61 @@
+#carbonads * {
+  margin: initial;
+  padding: initial;
+}
+#carbonads {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto,
+    Oxygen-Sans, Ubuntu, Cantarell, 'Helvetica Neue', Helvetica, Arial,
+    sans-serif;
+}
+#carbonads {
+  display: flex;
+  max-width: 330px;
+  background-color: hsl(0, 0%, 98%);
+  box-shadow: 0 1px 4px 1px hsla(0, 0%, 0%, 0.1);
+  z-index: 100;
+}
+#carbonads a {
+  color: #1a1a1a;
+  text-decoration: none;
+}
+#carbonads a:hover {
+  color: #1a1a1a;
+}
+#carbonads span {
+  position: relative;
+  display: block;
+  overflow: hidden;
+}
+#carbonads .carbon-wrap {
+  display: flex;
+}
+#carbonads .carbon-img {
+  display: block;
+  margin: 0;
+  line-height: 1;
+}
+#carbonads .carbon-img img {
+  display: block;
+}
+#carbonads .carbon-text {
+  font-size: 13px;
+  padding: 10px;
+  margin-bottom: 16px;
+  line-height: 1.5;
+  text-align: left;
+}
+#carbonads .carbon-poweredby {
+  display: block;
+  padding: 6px 8px;
+  background: #f1f1f2;
+  text-align: center;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  font-weight: 600;
+  font-size: 8px;
+  line-height: 1;
+  border-top-left-radius: 3px;
+  position: absolute;
+  bottom: 0;
+  right: 0;
+}

www/src/css/global.scss

@@ -1,5 +1,6 @@
 @import './theme.scss';
 @import './angolia.scss';
+@import './carbonads.scss';
 
 html {
   -webkit-font-smoothing: antialiased;

www/src/layouts/ApiLayout.js

@@ -9,7 +9,7 @@ const propTypes = {
 
 function ComponentsLayout({ children, ...props }) {
   return (
-    <Default {...props} grayscale={false}>
+    <Default {...props}>
       <Main location={props.location}>{children}</Main>
     </Default>
   );

www/src/layouts/index.js

@@ -2,7 +2,6 @@ import { MDXProvider } from '@mdx-js/react';
 import PropTypes from 'prop-types';
 import * as React from 'react';
 
-import { css } from 'astroturf';
 import NavMain from '../components/NavMain';
 import Heading from '../components/Heading';
 import CodeBlock from '../components/CodeBlock';
@@ -11,13 +10,6 @@ import DocsAlert from '../components/DocsAlert';
 import SEO from '../seo';
 import ThemeProvider from '../../../src/ThemeProvider';
 
-const styles = css`
-  .gray > :not(:first-child) {
-    filter: grayscale(100%);
-    -webkit-filter: grayscale(100%);
-  }
-`;
-
 const getMode = (className = '') => {
   const [, mode] = className.match(/language-(\w+)/) || [];
   return mode;
@@ -45,11 +37,11 @@ const propTypes = {
   location: PropTypes.object.isRequired,
 };
 
-function DefaultLayout({ children, location, grayscale = true }) {
+function DefaultLayout({ children, location }) {
   return (
     /* Change dir to "rtl" for RTL dev */
     <ThemeProvider dir="ltr">
-      <div className={grayscale ? styles.gray : undefined}>
+      <div>
         <SEO pathname={location.pathname} />
         <NavMain activePage={location.pathname} />
         <DocsAlert />

www/src/pages/index.js

@@ -7,6 +7,7 @@ import styled from 'astroturf';
 import pkg from '../../../package.json';
 
 import withLayout from '../withLayout';
+import CarbonAds from '../components/CarbonAds';
 
 const MastHead = styled('div')`
   @import '../css/theme';
@@ -126,6 +127,9 @@ export default withLayout(
               <div className="text-muted mt-3">
                 Current version: {pkg.version}
               </div>
+              <div className="py-3">
+                <CarbonAds />
+              </div>
             </Content>
           </MastHead>