/dev-guide

A set of development guidelines for KubeSphere developers.

Primary LanguageHTMLApache License 2.0Apache-2.0

KubeSphere Dev Guide

This project uses Hugo and Hugo theme learn to build the website.

Netlify Status

Contribute

Contributions of any kind are welcome!

Fork and clone the repository

  1. Fork the repository.

  2. Run the following commands to clone your fork and enter into it. Make sure you replace <Your GitHub ID> with your GitHub ID.

    git clone https://github.com/<Your GitHub ID>/dev-guide.git
    cd dev-guide
    

Build and preview the website

You have to install Hugo to build the website in order to preview it as static content.

Install Hugo extended

Go to the Hugo releases page and download the hugo_extended version that suits your OS (version 0.75+).

EXTENDED version is MANDATORY to properly build the static content!

Note: If you install Hugo on Windows, you need to add environment variables for the .exe file of Hugo. Run hugo version to check if the installation is successful.

Running the website locally

After you install Hugo, run the following command:

hugo server

Now you can preview the website in your browser at http://localhost:1313/.

Open a pull request

Open a pull request (PR) to contribute to our website. Use DCO sign-off when you submit a PR by running the command below (add -s):

git commit -s -m "xxx"

Contributors

Thanks goes to these wonderful contributors, they made our community and product grow fast.