cilium/cilium.io

The Cilium website is a dynamic and customizable platform built using Gatsby, a popular static site generator. This project includes comprehensive documentation on how to contribute, get started, and use various features of the website. The table of contents covers topics such as running and building the website, project structure, code style, and creating blog posts.

The website’s structure includes a src folder containing components, hooks, images, pages, styles, templates, and utils. The gatsby-config.js file is the main configuration file, and gatsby-node.js and gatsby-ssr.js files are used for customizing server-side rendering and Node APIs, respectively.

Each component includes a main JavaScript file and an index file, with the option to include a folder with icons and images. The project follows the Airbnb style guide using ESLint and Prettier for code formatting and linting. VS Code extensions for ESLint and Prettier are recommended for simplified usage.

To create a new blog post, create a new .md file in the src/posts/ directory with the desired frontmatter, including path, date, title, and other optional metadata. The blog is configured to dynamically create pages using the gatsby-source-filesystem plugin and gatsby-plugin-mdx. Custom components, such as BlogAuthor, can be used in the blog post with passed props.