CLI

Run CLI myst to build your project.

myst has some options. (See myst --help for details.)

Selecting projects

Using the -p or --project option, you can specify the alternative name of myst.json.

$ myst -p myst2.json

Specifying output directory

Using the -o or --outDir option, you can temporarily overwrite outDir of myst.json.

$ myst -o ./out2

Forcing

The -f or --force to disable any caching and force all render targets to be rerendered.

Watching

When the -w or --watch option is enabled, myst process stays alive and watches the file system.

Once a file in rootDir is updated, myst rerenders the file.

When a file in data or dependency is updated, all render targets are rerendered.

Even if the --watch option is enabled, myst first renders all the target files. To supress this behavior, enable the --nobuild option.

Server

When the -s or --server option is enabled, myst starts a web server using express. You can observe the render results through the server. myst.json has a server field to configure the server:

{
  "server": {
    "port": 8080,       // port to listen.
    "contentBase": "/content/"
  }
}

port can be overwritten using --port option.

By default, outDir is mounted on / by the server. You can change the mount point using contentBase.