Welcome to the Tolkien Fan Club website! This project is a statically generated site powered by a custom-built Static Site Generator (SSG). The site celebrates J.R.R. Tolkien and his legendary works.
Check out the live site here: Tolkien Fan Club
This project is a lightweight, markdown-based static site generator built in Python. It takes markdown files, processes them into HTML using a custom template, and outputs a fully static website.
- Converts Markdown (
.md) files into HTML. - Supports hierarchical content structures.
- Includes automatic link generation and base path handling.
- Customizable templates for styling and layout.
Ensure you have Python 3 installed on your machine.
Clone the repository:
git clone https://github.com/jumaochi/staticsite.git
cd staticsiteTo test the site locally before deploying:
chmod +x main.sh # Make the script executable
./main.sh # Build and serve the siteThen, open your browser and go to:
http://localhost:8888
- Push your changes to the
mainbranch. - Ensure GitHub Pages is enabled in your repo settings.
- The site will be available at something like below, varys. Mine was:
https://jumaochi.github.io/staticsite/
staticsite/
│── content/ # Markdown content files
│── static/ # Static assets (CSS, images, etc.)
│── template.html # HTML template
│── docs/ # Generated site output (GitHub Pages deployment)
│── src/ # Static site generator script
│
│── main.sh # Build script
│── README.md # Project documentation
- Python for processing markdown and generating HTML
- GitHub Pages for hosting the site
- Markdown for content writing
- Bash Automation
Developed by Juma Ochi with a passion for static site generation.
If you like the project, feel free to star the repo and contribute!
Got questions or suggestions? Reach out:
- GitHub: jumaochi
- Website: jumaochi.github.io
⚡ “Not all those who wander are lost.” – J.R.R. Tolkien ⚡