Personal academic website for Qi Tang, built with MkDocs
and a custom theme (in template/) derived from the MFEM webpage template.
Use a recent Python (3.9+). With a virtual environment:
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirement.txtOr with conda:
conda create -n web python=3.12
conda activate web
pip install -r requirement.txt- Clone this repo.
- Edit or add
.mdfiles insrc/(and update thenavsection ofmkdocs.ymlif you add a new page). - Preview locally with
mkdocs serve(defaults to http://127.0.0.1:8000). - Publish with
mkdocs gh-deploy.
- Content lives in
src/; the site is configured viamkdocs.yml. - The custom theme (HTML/CSS/JS) lives in
template/. - Pinned dependencies are in
requirement.txt. This site was modernized off the original MkDocs 1.0.4 pin; if a build issue appears after upgrading, checkmkdocs --versionand the MkDocs release notes for template API changes.