This repo contains the source code of adonisjs.com. Feel free to clone this repo and run docs on your local.
Start by cloning this repo using the following command.
git clone https://github.com/adonisjs/adonisjs.com.git
The docs ( markup files ) are referenced as submodules, so make sure to clone the submodules too.
git submodule init
git submodule update
Next, install the dependencies from npm.
npm install
After that copy the .env.example
file as .env
and make required changes.
The server is started using the adonis serve
command.
adonis serve --dev
The docs are compiled at runtime, which means there is no build process to run the website.
But, a menu file is generated to create the sidebar in the docs view. For that, you have to run following command.
adonis compile:docs -v 4.0
The -v
flag takes the version for which the menu file should be generated.
Also you can watch for changes, so that the menu file is re-generated everytime you change something.
adonis compile:docs -v 4.0 --watch
All of the styles are saved inside resources/sass
folder, make sure do not edit the css files inside public
directory and work sass files only.
npm run compile:styles
# with watcher
npm run styles
The scripts are compiled using webpack, and saved inside resources/scripts
folder.
npm run compile:scripts
# with watcher
npm run scripts
The fonts referenced from Typekit are only to be used when you are developing website on local, deploying the website on different domain will make the fonts fail and is also not recommended.