start.sh

#!/bin/bash

# Clear screen and show banner
clear
echo ""
echo "**********************************************************************"
echo "*                                                                    *"
echo "*       Splunk Observability Cloud Docs :: Docker container          *"
echo "*                                                                    *"
echo "**********************************************************************"
echo ""

branchname=$(git branch --show-current)

echo "docker compose down"
docker compose --ansi=never down

echo "Remove old files"
rm -f _build/.DS_Store
rm -f _build/html/.DS_Store
rm -rf _build/*
rmdir _build/html
rmdir _build

echo "docker compose build"
docker compose --ansi=never build

echo "docker compose up"
docker compose --ansi=never up -d

printf "\rDocker container built.              "
sleep .5
# Show instructions and enter the container's shell
echo ""
echo ""
echo "This Docker container lets you build and test the docs locally."
echo "Do not build the docs outside of the container."
echo ""
printf "${bold}Instructions:\n${normal}"
echo ""
echo " 1. Run 'make clean html' or 'make html' to build the docs."
echo " 2. Open the built documentation from the /_build/html directory."
echo " 3. Browse http://localhost:8888 when using 'make livehtml'."
echo " 4. Enter 'exit' when you're done."
echo ""
printf "${bold}Note: Don't run git commands inside the container.${normal} "
echo "To run git commands while using"
echo "the testing container, open a separate terminal window or tab."
echo ""

echo ""
printf 'BRANCH: %s\n' "$branchname"
echo ""

docker exec -it -e BRANCH=$branchname sphinx bash