This repository contains the source code and content for my personal site, built using Mkdocs.
To run the site locally, you'll need to have a local installation of Python (validated on 3.11) and follow the steps below:
- Clone this repository:
git clone https://github.com/BradyPlanden/bradyplanden.github.io.git
- Change into the project directory:
cd bradyplanden.github.io
- Install the required dependencies:
pip install -e .
- Start the local development server:
mkdocs serve
- Open your browser and visit
http://localhost:8000
to view the site.
The site is organized into different sections, such as TLDR posts, publications, and about me. Each section has its own folder and Markdown files. To make changes to the site, follow these steps:
- Edit the Markdown files in the corresponding section folder.
- Preview the changes locally using
mkdocs serve
. - Once you're satisfied with the changes, commit and push them to the repository / fork.
If you find any issues or have suggestions for improvements, please open an issue or submit a pull request.
This project is licensed under the MIT License.
This site is built with Material for MkDocs, and was inspired from "Why, Scott, Why?!". The 'mkdocs-custom' package was developed by Scott Pierce with the source provided here.