The Vitess website

This repo houses the assets used to build the website at https://vitess.io.

Running the site locally

First install npm, then fetch dependencies, including Hugo by running these commands:

cd website
npm install

To build a development version of the site, run the following command:

make build

To serve the site locally, run:

make serve

View the locally served site at http://localhost:1313.

Adding a user logo

If you'd like to add your logo to the Who uses Vitess section of the website, add a PNG, JPEG, or SVG of your logo to the static/img/logos/users directory in this repo and submit a pull request with your change. Name the image file something that reflects your company (e.g., if your company is called Acme, name the image acme.png).

Link checking

You can check the site's internal links by running make check-internal-links and all links—internal and external—by running make check-all-links.

CSS/SASS

The Vitess website uses Bulma, a CSS (and SASS) framework that provides all kinds of variables, utilities, and components.

Releasing a new version of the documentation

1. Copy the most recent docs version folder to a new folder named for the new upcoming version (for each language) cp -R content/en/docs/v1.0 content/en/docs/v2.0 cp -R content/zh/docs/v1.0 content/zh/docs/v2.0

2. Update config.toml Set [params.versions] current to the value of the new release number. Set [params.versions] next to the value of the upcoming planned version.

3. (optional) Remove any version of the documentation that is no longer supported git rm -rf content/en/docs/v0.0 git rm -rf content/zh/docs/v0.0