the_information_nexus/tech_docs/mkdocs-setup.md

MkDocs Project

source venv/bin/activate

deactivate

sudo lsof -i :8000  # For MkDocs

sudo lsof -i :8050  # For Dash

sudo kill -9 <PID>

---

1. Ensure your directory structure is correct:

my-mkdocs-site/
├── dash_app/
│   └── app.py
├── docs/
│   ├── assets/
│   │   └── logo.png
│   ├── css/
│   │   └── custom.css
│   ├── index.md
│   ├── about.md
│   └── contact.md
└── mkdocs.yml

2. Access Both Applications

   • Dash App: Open http://127.0.0.1:8050/ in your browser to see the Dash app with the dark theme.
   • MkDocs Site: Open http://127.0.0.1:8000/ in your browser to see the MkDocs site with the embedded Dash app.

---

#!/bin/bash
# run_servers.sh
mkdocs serve -a 192.168.2.219:8000 &
python dash_app/app.py