This repo contains the source code of Karmada website and all of the docs for Karmada. It's built by Docusaurus, a modern static website generator.

• Karmada website
• Karmada docs
• Karmada Blog

Welcome to join us and you are more than appreciated to contribute!

If you only update the docs, you do not need to preview the website locally. We will create a preview link for you when you submit a pull request (PR). In an open PR, you can find the preview link in the comment of the PR. Check Open PRs List.

If you have the Node.js environment, you can run the website locally.

# Clone the repo, or your own fork
git clone https://github.com/<YOUR_GITHUB_USERNAME>/karmada-website.git

# Install dependencies
cd karmada-website
npm install

# Start the site
yarn run start

If you do not want to install the Node.js environment, you can consider using Docker instead.

make serve

With just one command, you can run it locally and then access https://localhost:3000 to preview the website.

If you want to contribute to the website, firstly, it is essential to learn some basic knowledge of Docusaurus.

To start a local development server, please run:

yarn run start

This command starts a local development server and opens a browser window at https://localhost:3000. Most changes are automatically reflected live without the need to restart the server.

yarn run build

This command generates static content into the build directory and can be served using any static contents hosting service.

GIT_USER=<Your GitHub username> USE_SSH=true yarn deploy

If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.