mdBook

mdBook

If you need an example source code, init a new project (you’ll need git and Rust):

cargo install mdbook
mdbook init myStaticApp --title="my mdBook" --ignore=git

Create a static application

You can create an application in our Console or through Clever Tools:

npm i -g clever-tools
clever login

cd myStaticApp
clever create -t static-apache myStaticApp

To deploy on Clever Cloud, your local folder need to be a git repository (if not, git init) linked to an application. If you already have an application on Clever Cloud and want to link it to the current local folder:

clever link your_app_name_or_ID

Configure environment variables

Next, we configure the application with a medium build instance to quickly generate static files. The host instance is nano-sized, enough for a simple website. As Clever Cloud is based on standards, you only need to define a few variables:

clever scale --build-flavor M
clever scale --flavor nano

clever env set CC_WEBROOT "/book"
clever env set CC_OVERRIDE_BUILDCACHE "/book"
clever env set CC_PRE_BUILD_HOOK "cargo install mdbook"
clever env set CC_POST_BUILD_HOOK "/home/bas/.cargo/bin/mdbook build"

Push your code

Once you complete these steps, commit your content to the local repository and deploy it:

git add .
git commit -m "First deploy"
clever deploy
clever open

You can display your website’s URL or add a custom domain to it (you’ll need to configure DNS):

clever domain
clever domain add your.website.tld
Last updated on

Did this documentation help you ?