Personal Website and Blog

My personal website and blog hosted on GitHub Pages at bistaumanga.com.np.

Built with Pelican (Python static site generator) and Bootstrap.

---

🚀 Quick Start

First-Time Setup

./setup.sh

Preview Locally

cd bistaumanga.github.com
source ../.venv/bin/activate
pelican --listen

Visit: http://localhost:8000

Build Site

./build_pelican.sh

Deploy to GitHub Pages

./deploy.sh

---

📁 Project Structure

bistaumanga.github.com/
├── bistaumanga.github.com/     # Pelican source
│   ├── content/                # Markdown content
│   │   ├── pages/             # Static pages
│   │   ├── *.md               # Blog posts
│   │   ├── images/            # Images
│   │   ├── files/             # Files (PDFs, etc.)
│   │   └── extra/             # CSS, CNAME, etc.
│   ├── pelicanconf.py         # Dev config
│   └── publishconf.py         # Production config
├── output/                     # Generated site
├── build_pelican.sh            # Build script
├── deploy.sh                   # Deploy script
├── setup.sh                    # Setup script
└── requirements.txt            # Python dependencies

---

📝 Adding Content

New Blog Post

Create bistaumanga.github.com/content/my-post.md:

Title: My Post Title
Date: 2024-01-20 10:00
Tags: python, data-science
Slug: my-post-slug

Your content here...

Then build and deploy:

./build_pelican.sh
./deploy.sh

---

📚 Documentation

• QUICK_REF.md - Quick command reference

---

🛠️ Technology Stack

• Pelican - Static site generator (Python)
• Bootstrap - CSS framework
• Font Awesome - Icons
• GitHub Pages - Hosting
• MathJax - Math rendering

---

📜 License

Content is copyrighted. Code is open source.

---