This website is built using Docusaurus 3, a modern static website generator built in JavaScript using React.
As the website depends on information and documentation compiled using sbt, we have wrapped the calls to sbt and npm with a Makefile in this directory.
It is difficult to properly capture dependencies handled by sbt or npm in Make, so this Makefile is likely to be buggy.
If things are not behaving as expected, make sure to run make clean or make mrproper.
Building the website requires the usual Chisel installation, in addition to Node.js and npm.
Please follow the official npm instructions for installing Node.js and npm.
You will also need to authenticate with Github as several of the build steps use the Github API.
The easiest way to do this is to install the Github CLI, run gh auth login and follow the prompts.
Unless you are an enterprise user, you will be logging into a Github.com account.
If you already have SSH enabled for your Github account, use SSH as your protocol, otherwise use HTTPS.
It is also usually easiest to login with a web browser.
In the likely event that these instructions become out-of-date, please see the Github Actions workflows for how the website is tested and deployed in CI.
Before running anything else you need to install all website dependencies.
make install
make build
This command generates the static website into the build directory.
It has many steps handled by the Makefile:
- Compile the Chisel Scala source code
- Run mdoc to generate markdown for the website
- Copy the generaeted markdown into
docs/ - Determine contributors to the Chisel project and generate
src/pages/generated/contributors.md - Run docusaurus to generate the website
You can view the built website locally with:
make serve
This will locally host the website so that you can see the impact of any local changes.
Deployment is handled automatically upon push to main by CI.