This repository houses the documentation for Hack for LA's website team. The documentation is built using MkDocs and is styled with the Material for MkDocs theme.
Note: Issues related to this wiki are tracked in the hackforla/website repository.
For more information on the current state of the wiki, please refer to the How to Contribute to the Wiki page.
git clone https://github.com/YOUR_USERNAME/website-wiki.git
cd website-wiki
The easiest way to get your local mkdocs server running and see your changes in real-time is by using Docker Compose.
-
Start the mkdocs Server
To serve your site locally, run:
docker-compose up
This launches the mkdocs server, which serves your documentation site and listens for changes. Your site will automatically update as you make changes to the documentation.
If you prefer to run the server in the background, use:
docker-compose up -d
-
View Your Site
Open a web browser and go to
http://localhost:8000
to see your mkdocs site live. -
Stop the Server
To stop the server, if running in the foreground, press
Ctrl+C
in your terminal. For detached mode, use:docker-compose down
Note for Windows Users Installing Python:
During the Python installation process, make sure to select the option "Add Python 3.x to PATH". This step will allow you to run Python and pip commands from the Command Prompt.
-
Create a Virtual Environment:
For macOS/Linux:
python3 -m venv venv
For Windows:
python -m venv venv
-
Activate the Virtual Environment:
For macOS/Linux:
source venv/bin/activate
For Windows:
.\venv\Scripts\activate
-
Install Required Packages:
pip install -r requirements.txt
-
Start the Development Server:
mkdocs serve
Your site will now be accessible at http://localhost:8000.
-
Build the Documentation:
Building the mkdocs site generates static HTML files. This step is typically reserved for testing custom hooks or preparing the documentation for deployment.
mkdocs build
This compiles your Markdown files into static HTML files, placing them in the
site
directory.