How to Build the Documentation
A guide on how to build the PyKraken Documentation locally.
This documentation site is built using Aria Docs and requires Node.js and pnpm to be installed on your system.
Prerequisites
Before you begin, make sure you have the following installed:
-
Node.js v18.12.0 or newer You can verify your Node.js version with:
node --versionOr install it from here
-
pnpm (recommended package manager) If you don't have
pnpmin your system, you can install it from hereYou can verify the installation of
pnpmby-pnpm --versionOther package managers like
npm,yarnorbuncan also be used but it is recommended to usepnpm.
Clone the Repository
After setting up the prerequisites, clone the documentation repository-
git clone https://github.com/Kraken-Engine/PyKraken-Docs.git
Then cd into it-
cd PyKraken-Docs
Install Dependencies
Install all required dependencies using pnpm:
pnpm install
Start the Development Server
To start the local development server, run:
pnpm dev
Once the server starts, you can view the documentation in your browser at:
http://localhost:3000
(If a different port is shown in the terminal, use that instead.)
Troubleshooting
-
Node version issues: Ensure your Node.js version is at least v18.12.0. Using tools like nvm is recommended for managing Node versions.
-
Dependency errors: If you're facing any dependancy issues, use
pnpmand delete thenode_modulesfolder, then reinstall:rm -rf node_modules pnpm install