refactor: migrate docs from sphinx to hugo

[Xunzhuo]

What type of PR is this?

What this PR does / why we need it:

Which issue(s) this PR fixes:

Preview: https://gateway.xunzhuo.cafe

Fixes: #1752

• Set up Hugo framework
• Remove Sphinx framework
• Set up Hugo Build and Publish GitHub Workflow
• Convert existed rst to markdown
• Add missing Hugo headings to markdown header
• Migrate all docs to Hugo
• Support versioned docs https://gateway.xunzhuo.cafe/latest/
• Update docs build & serve make targets
• Update versioned docs release make targets
• Add missing descriptions to all top level groups
• Update helm-gen make targets
• Update docs-api make targets
• Update Working on Envoy Gateway Docs Docs: https://gateway.xunzhuo.cafe/latest/contributions/docs/
• Design/Support new Home Page: https://gateway.xunzhuo.cafe/
• Design/Support new About Page: https://gateway.xunzhuo.cafe/about/
• Design/Support Blogs / RSS: https://gateway.xunzhuo.cafe/blog/
• Design/Support Presentations: https://gateway.xunzhuo.cafe/blog/2022/10/28/kubecon-north-america-2022/
• Write a Blog to introduce it: https://gateway.xunzhuo.cafe/blog/2023/10/08/welcome-to-new-website/
• Write new post: Install with Helm: https://gateway.xunzhuo.cafe/latest/install/install-helm/
• Write new post: install with YAML: https://gateway.xunzhuo.cafe/latest/install/install-yaml/
• Write new post: install egctl: https://gateway.xunzhuo.cafe/latest/install/install-egctl/
• Resolve tons of broken links 😢

[codecov]

Codecov Report

Merging #1872 (dc22c43) into main (d4d1073) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main    #1872   +/-   ##
=======================================
  Coverage   65.42%   65.42%           
=======================================
  Files          90       90           
  Lines       13362    13362           
=======================================
  Hits         8742     8742           
  Misses       4082     4082           
  Partials      538      538           

[zirain]

docy?

[arkodg]

hey @Xunzhuo can you update https://gateway.xunzhuo.cafe/, its pointing to the older docs

[arkodg]

thanks for adding this @Xunzhuo !
im a +1 on this, its also recommended by CNCF https://www.cncf.io/blog/2023/01/19/fast-and-effective-tools-for-cncf-and-open-source-project-websites/

[Alice-Lilith]

+1 I really like the preview link you shared. My only nit right now would be that I'd love to see us replace the blue colour in the docs pages with more of the Envoy pink that you have on the homepage. That should help us both stand out a bit more from other CNCF projects, and look a little more like the main Envoy Proxy docs.

[haq204]

This is awesome!

[qicz]

great job!

[Xunzhuo]

Hi forks! Checkout latest preview : )

Website: https://gateway.xunzhuo.cafe

Blog: https://gateway.xunzhuo.cafe/blog/2023/10/08/welcome-to-new-website/

Presentations: https://gateway.xunzhuo.cafe/blog/2022/10/28/kubecon-north-america-2022/

Versioned Docs: https://gateway.xunzhuo.cafe/latest/

cc @envoyproxy/gateway-reviewers @envoyproxy/gateway-maintainers @envoyproxy/gateway-steering-committee

[arkodg]

Thanks for adding this upgrade ! this will tremendously benefit end users

some small non blocking nits

1. we may need to play around with the color palette a little more to be closer to https://www.envoyproxy.io (I'll raise a GH issue for this once this merges)
2. the Compatibility Matrix lives under Blog which may not be the best home for it.
   I'd move it to #ready-to-get-started
3. By default the website points to latest instead of the last stable version (v0.5.0) , it should instead point to the last stable version (v0.5.0)

[Xunzhuo]

Will work on a follow up PR : )

[zirain]

Good job!