This website is built using Docusaurus, a modern static website generator.

• Node.js version 18.0 or above

1. Clone the repo to your workspace

mkdir -p /path/to/workspace
cd /path/to/workspace/
git clone https://github.com/fluid-cloudnative/fluid-cloudnative.github.io.git fluid-website
cd fluid-website

2. Download node modules

npm install

npm run start

npm run start --locale=zh

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

npm run build

This command generates static content into the build directory and can be served using any static contents hosting service. This includes multilingual contents so it would work with localeDropdown.

npm run serve

To make changes to the website, add or modify markdown files under docs/ for en version and i18n/zh/docusaurus-plugin-content-docs/ for zh version. Any commits pushed to the repo will trigger a Github workflow to re-deploy the website with the latest changes.

Any markdown files should have a header to control its appearance on the website, Take docs/core-concepts/what-is-fluid.md as an example, the header looks like:

---
sidebar_label: What is Fluid
sidebar_position: 1
slug: /
---

• sidebar_label indicates the label name showed in the sidebar of the website.
• sidebar_position indicates the sequential order under a sidebar folder.
• slug indicates the relative url path to the website.

For each directory under docs/, a special file _category_.json is needed to control the doc folder's appearance on the website:

{
  "label": "Core Concepts",
  "position": 1,
  "link": null
}

• label indicates the doc folder's name to be showed on the website.
• position indicates the sequential order among all the sidecar folders.
• link indicates whether a category page is needed for the sidecar folder.