[WIP] Upgrade to Docsy 0.5.1 via NPM module

[chalin]

• Fixes Upgrade to Docsy 0.5.1 #48807
• Contributes to:
  • Align with upstream Docsy #41171
  • Should update theme/docsy step by step to the latest docsy  #44002
• Upgrades to Docsy 0.5.1 as an NPM module.
  • Fetches FontAwesome and Bootstrap via NPM, so I believe (if I understand the intent) that this
    fixes Bootstrap and Font Awesome (as part of Docsy) are deprecated #32905
  • Upgrades FontAwesome to v6, and so upgrades all icon names, and so
    fixes Use canonical FontAwesome v6 icon names, upgrading from v3-v5 #48811
• Drops the git submodule reference to Docsy 0.3.0
• Ensures that container commands continue to work
• Updates the makefile
• Switches to using template "partials/page-description.html" to generate HTML header page meta descriptions. (This template has continued to be improved, with the most recent update being made in Docsy 0.11.0.)
• Drops the static Bootstrap resources, keeping the one needed by the API pages.

Also addresses and closes the following:

• Fixes There are two <script> elements referencing jQuery #48806

  $ curl -s https://deploy-preview-48812--kubernetes-io-main-staging.netlify.app/ | tr '<' '\n' | grep -i '^script' | grep -i 'jquery' 
  script src="/js/jquery-3.6.0.min.js" intregrity="sha384-vtXRMe3mGCbOeY7l30aIg8H9p3GdeSe4IFlP6G8JMa7o7lXvnz3GFKzPxzJdPfGK" crossorigin="anonymous">

• Fixes [style] Named code-block elements show unnecessary block padding #48808
• Fixes Tab panes have formatting issues #48813

Previews

• https://deploy-preview-48812--kubernetes-io-main-staging.netlify.app/ - e.g., check the footer
• https://deploy-preview-48812--kubernetes-io-main-staging.netlify.app/docs/concepts/windows/ for the page-meta icons, including the 3rd-party one
• https://deploy-preview-48812--kubernetes-io-main-staging.netlify.app/docs/concepts/configuration/configmap/#using-configmaps-as-environment-variables - for code-blocks, including named ones with a copy-code button, as well as tooltips
• https://deploy-preview-48812--kubernetes-io-main-staging.netlify.app/docs/tasks/tools/install-kubectl-linux/#install-kubectl-binary-with-curl-on-linux for tabbed panes, e.g.:

  

• https://deploy-preview-48812--kubernetes-io-main-staging.netlify.app/docs/contribute/docs/#getting-started for Mermaid diagrams

Checks I've done

I've checked that the following render correctly, feel free to double check:

• Icons (now that we're using FA v6) render properly in the
  • Footer
  • Doc pages, page-meta-links section
  • Blog pages, page-meta and other links
  • More rarely used icons like the third-party icon (in page-meta), for example see Concepts > Windows
• Mermaid diagrams continue to render correctly
• Tooltips are still working, demonstrating that the new way to fetch and use Bootstrap CSS and JS is working
• Code-blocks and figures render correctly

Followup changes

This PR makes minimal changes. Consider following up with updates to:

• API reference generation code to catch up to the FontAwesome & Bootstrap versions now used by the rest of the website (via Docsy).
• Dockerfile, to switch to docker.io/library/debian:bookworm as @sftim proposed in Bump Docsy to 0.4.x #48722
• Switch to Docsy tabpane shortcode #48814
• Btw, stylistically, I think that we should drop the border on the .mermaid class

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign tengqm for approval. For more information see the Kubernetes Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[netlify]

✅ Pull request preview available for checking

Name	Link
🔨 Latest commit	a65258e
🔍 Latest deploy log	https://app.netlify.com/sites/kubernetes-io-main-staging/deploys/674249352720160008804f0b
😎 Deploy Preview	https://deploy-preview-48812--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[sftim]

Nice

[sftim]

Try running mv node_modules node_modules_moved_aside before trying a local preview in a container. That should show up the snags, if there are any.

[sftim]

Hope this is OK
/retitle [WIP] Upgrade to Docsy 0.5.1 via NPM module

[chalin]

@sftim wrote via #48811 (comment):

You won't like this @chalin but the <i class="fa fa-icon-circle fa-fw"></i> was a bodge to get a correctly-indented second line with no icon.

That's the original presentation intent, so bear that in mind when considering what we'd like to preserve…

Yes, here's the fix I propose: a65258e. It looks like this:

which you can see via https://deploy-preview-48812--kubernetes-io-main-staging.netlify.app/docs/concepts/windows/.