This website is built using Docusaurus 2, a modern static website generator.
npm install
Before we start the development server we will need to fetch some of the docs from Fastify Repo. This requires Github CLI to be installed which can be found here.
After installing GitHub CLI ensure you are logged in by running;
gh auth login
Once Github CLI is setup you can proceed to run the build below command that will setup your project locally.
npm run build:website
The command will:
- Download all the Fastify's releases from GitHub
- Process each release to generate the versioned Docusaurus documentation
- Generate the static website
During this process:
versions.json
is generated when building the website
By running npm run serve
, you will load locally the production build from the /build
folder.
$ npm start
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
Note that only the documentations listed in the versions.json
file will be available.
So, if you have a long version list, your local enviroment will be slowed down.
The website is deployed to GitHub pages using the gh-pages
branch when a merge to main
is done.
- Read here for the specs
- If the markdown file from the main repo has a
# Title
, the title will be used as the sidebar label - The
/docs/latest/
URL is implemented by a named version of the most recent version - The
/docs/master/
URL is implemented by redirecting to the/docs/latest/
URL