docs/pages/index.tsx

import { GetServerSideProps } from 'next'

import {
  MainContextT,
  MainContext,
  getMainContextFromRequest,
  useMainContext,
} from 'components/context/MainContext'

import { DefaultLayout } from 'components/DefaultLayout'
import { useTranslation } from 'components/hooks/useTranslation'
import { useVersion } from 'components/hooks/useVersion'
import { LinkExternalIcon } from '@primer/octicons-react'
import { useRouter } from 'next/router'
import { OctocatHeader } from 'components/landing/OctocatHeader'
import { ArticleList } from 'components/landing/FeaturedArticles'
import { Search } from 'components/Search'

type FeaturedLink = {
  href: string
  title: string
  intro: string
}

type Props = {
  mainContext: MainContextT
  popularLinks: Array<FeaturedLink>
  gettingStartedLinks: Array<FeaturedLink>
}
export default function MainLanding({ mainContext, gettingStartedLinks, popularLinks }: Props) {
  return (
    <MainContext.Provider value={mainContext}>
      <DefaultLayout>
        <LandingPage gettingStartedLinks={gettingStartedLinks} popularLinks={popularLinks} />
      </DefaultLayout>
    </MainContext.Provider>
  )
}

type LandingPageProps = {
  popularLinks: Array<FeaturedLink>
  gettingStartedLinks: Array<FeaturedLink>
}
function LandingPage(props: LandingPageProps) {
  const router = useRouter()
  const { gettingStartedLinks, popularLinks } = props
  const { activeProducts, isHomepageVersion } = useMainContext()
  const { currentVersion } = useVersion()
  const { t } = useTranslation(['homepage', 'search', 'toc'])
  return (
    <div>
      {/* <!-- Hero --> */}
      <section id="landing" className="color-bg-tertiary">
        <Search isStandalone={true}>
          {({ SearchInput, SearchResults }) => {
            return (
              <div className="container-xl px-3 px-md-6 pb-6 pb-lg-9">
                <div className="gutter gutter-xl-spacious pt-6 pt-lg-0 d-lg-flex flex-row-reverse flex-items-center">
                  <div className="col-lg-7">
                    <OctocatHeader />
                  </div>
                  <div className="col-lg-5 mt-6">
                    <h1 className="h1-mktg mb-3">{t('search:need_help')}</h1>
                    {SearchInput}
                  </div>
                </div>

                <div className="mt-3">{SearchResults}</div>
              </div>
            )
          }}
        </Search>
      </section>

      {/* <!-- Explore by product --> */}
      <section className="container-xl pb-lg-4 my-8 px-3 px-md-6">
        <div className="">
          <h2 className="text-mono f5 text-normal color-text-secondary text-md-center mb-4">
            {t('explore_by_product')}
          </h2>
          <div className="d-flex flex-wrap gutter gutter-xl-spacious">
            {activeProducts.map((product) => {
              if (!product.versions?.includes(currentVersion) && !isHomepageVersion) {
                return null
              }

              const href = `${!product.external ? `/${router.locale}` : ''}${
                product.versions?.includes(currentVersion)
                  ? `/${currentVersion}/${product.id}`
                  : product.href
              }`
              return (
                <div className="d-flex flex-column col-12 col-sm-6 col-lg-3 pb-4" key={product.id}>
                  <a
                    className="btn-mktg flex-auto d-flex flex-items-center btn-outline-mktg btn-large-mktg ws-normal "
                    href={href}
                    target={product.external ? '_blank' : undefined}
                  >
                    {product.name}
                    {product.external && (
                      <span className="ml-1">
                        <LinkExternalIcon />
                      </span>
                    )}
                  </a>
                </div>
              )
            })}
          </div>
        </div>
      </section>

      <div className="px-3 px-md-6 container-xl">
        <div className="featured-links container-xl">
          <div className="gutter gutter-xl-spacious clearfix">
            {/* <!-- Getting Started articles --> */}
            <div className="col-12 col-lg-6 float-left">
              <div className="featured-links-heading pb-4">
                <h3 className="f5 text-normal text-mono underline-dashed color-text-secondary">
                  {t('toc:getting_started')}
                </h3>
              </div>

              <ArticleList maxLines={6} articles={gettingStartedLinks} />
            </div>

            {/* <!-- Popular articles --> */}
            <div className="col-12 col-lg-6 float-left">
              <div className="featured-links-heading pb-4">
                <h3 className="f5 text-normal text-mono underline-dashed color-text-secondary">
                  {t('toc:popular')}
                </h3>
              </div>

              <ArticleList maxLines={6} articles={popularLinks} />
            </div>
          </div>
        </div>
      </div>
    </div>
  )
}

export const getServerSideProps: GetServerSideProps<Props> = async (context) => {
  const req = context.req as any

  return {
    props: {
      mainContext: getMainContextFromRequest(req),
      gettingStartedLinks: req.context.featuredLinks.gettingStarted.map(
        ({ title, href, intro }: any) => ({ title, href, intro })
      ),
      popularLinks: req.context.featuredLinks.popular.map(({ title, href, intro }: any) => ({
        title,
        href,
        intro,
      })),
    },
  }
}