# Commands

Use the command-line interface to run the following commands.

## Prerequisites

To run the following commands, you will need to have installed **Python +3.7** and **PIP** on your local environment.

## Preview current branch

The preview command builds a local instance of the docs site so you can view the rendering in a sandbox environment on your local browser.

To preview the docs:

1. Build the docs.

```console
cd docs
make preview
```

1. Open [http://127.0.0.1:5500/](http://127.0.0.1:5500/) with your preferred browser.

To increase verbosity, use the option `-v`:

```console
make preview SPHINXOPTS=-v
```

To decrease verbosity, use the option `-Q`:

```console
make preview SPHINXOPTS=-Q
```

## Preview multiversion

The multiversionpreview command generates a local instance of the docs site with all [specified versions](https://sphinx-theme.scylladb.com/branch-1.5/configuration/multiversion.md) available for navigation.
You can view the rendering in a sandbox environment on your local browser.
To preview multiple versions:

1. Build the docs.

```console
cd docs
make multiversionpreview
```

1. Open [http://0.0.0.0:5500/](http://0.0.0.0:5500/) with your preferred browser.

## Build HTML for multiple versions

#### NOTE
The command `make multiversion` is aimed to be used by GitHub Actions CI. While documenting new features, it is not advised to run `make multiversion`, but `make preview` instead.

To generate multiple versions of the documentation:

1. Build the docs.

```console
cd docs
make multiversion
```

1. The previous command should generate HTML docs under the `docs/_build/dirhtml` directory.

## Clean all builds

The `make preview` operation creates content in the `_build` directory. When making changes to the docs, it is helpful to delete the contents of this directory before running `make preview`.

```console
cd docs
make clean
```

## Check for broken links

Check for broken links on the documentation site.

```console
cd docs
make dirhtml
make linkcheck
```