KubeSphere Website

This project uses Hugo to build the new website for KubeSphere.

Contribute

Contributions of any kind are welcome! Thanks goes to these wonderful contributors, they made our community and product grow fast.

Fork and clone the repo

First, create your own fork of the repository.

Then, clone your fork and enter into it:

git clone https://github.com/<username>/website
cd website

Compiling and preview the website

You will need to build the website in order to publish it as static content.

Install Hugo extended

Go to the Hugo releases place and download the hugo_extended version that better suits your OS (version 0.70+).

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. For example, you place the exe file in the path C:\Hugo\bin. You have to add this path in environment variables. Execute hugo version to view if the installation is successful.

Running the website locally

hugo version: hugo_extended_0.70.0+, you can install Hugo from hugo releases

When you have installed Hugo, then run:

hugo server -D

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

Open a pull request

Open a pull request (PR) to add a localization to the repository. Please use DCO sign-off when you submit a pr. Refer to the command below (add -s):

git commit -s -m "xxx"

Preview a pull request

Click Details as shown in the image below, which will direct you to the website homepage. Navigate to the part you want to preview.

If the button above does not appear, go to Files changed tab. Click the three dots of the md file you want to preview as shown below. Please note that this method can only give you a preview on the GitHub instead of on the website.

Localizing

You are welcome to help the KubeSphere community to support more languages, join us to contribute to the localization, see Localizing the website for the instruction.

Build and Publish the website (Optional)

Config your domain

Edit the file config\_default\config.toml and modify the var baseURL (at the first line) in order to set your own domain. It will be hardcoded in the static files.

baseURL = "https://kubesphere.es"

Build the static content

Just run hugo without parameters.

hugo

                   | EN  | ZH  | TR
-------------------+-----+-----+------
  Pages            |  55 |  65 |  39
  Paginator pages  |   0 |   0 |   0
  Non-page files   |   0 |   0 |   0
  Static files     | 375 | 375 | 375
  Processed images |   0 |   0 |   0
  Aliases          |   1 |   0 |   0
  Sitemaps         |   2 |   1 |   1
  Cleaned          |   0 |   0 |   0

Total in 2396 ms

Get the already built static content

You will find the previously generated content in the public directory.