This is the source of the landing page for https://docs.hopsworks.ai

Create a python 3.10 environment, using a python environment manager of your own choosing. For example virtualenv or anaconda.

Clone this repository

git clone https://github.com/logicalclocks/logicalclocks.github.io.git

Install the required dependencies to build the documentation in the python environment created in the previous step.

Note that {PY_ENV} is the path to your python environment.

cd logicalclocks.github.io
{PY_ENV}/bin/pip3 install -r requirements-docs.txt

Use mkdocs to build the documentation and serve it locally

{PY_ENV}/bin/mkdocs serve

The documentation should now be available locally on the following URL: http://127.0.0.1:8000/

The mkdocs.yml file of this repository defines the pages to show in the navigation. After adding your new page in the docs folder, you also need to add it to this file for it to show up in the navigation.

# run the server
mkdocs serve  > /dev/null 2>&1 &
SERVER_PID=$!
echo "mk server in PID $SERVER_PID"
# Give enough time for serving
sleep 30
echo "Launching linkchecker"
linkchecker http://127.0.0.1:8000/

# If ok just kill the server
kill -9 $SERVER_PID