Skip to content

Repository files navigation

🚀 PyCora - Static Site Generator

Python • Markdown • YAML • Fast • Minimal • Elegant • Pro

Read Docs: https://pycora.axcora.com/


Support & Donate

If you like this project, please support:


🔀 Choose Your Engine - 2 Versions

Click the image to go to the branch.

Medusa Version Nyi Blorong Version

🐍 MEDUSA - Full Pro

Pycora Python Staitc Site Generator

Advanced PAX Engine - Complete, Powerful, Pro

  • content/posts/*.md AND content/posts/hello/*.md BOTH WORK
  • ✅ Tags ALL formats: - a, ['a','b'], a, b, single
  • layouts/post = layouts/posts (plural/singular auto)
  • ✅ PAX .pax + Aggressive loader + Silent fallback
  • ✅ ChainableUndefined, Slice fix [:3]| limit(3)

Best for: Pro projects, docs, nested content, large blogs

Build: Ready in 0.87s - 41 files

→ Explore Medusa Branch

🐉 NYI BLORONG - Simple

Pycora Python SSG

Simple Jinja Engine - Minimal, Lightweight, Easy

  • ✅ Pure Jinja2 .html - familiar
  • ✅ Markdown + YAML only
  • ✅ Lightweight, zero learning curve
  • ✅ Tags, Pagination, SEO, Sitemap, RSS

Best for: Beginners, personal blog, company profile

Build: Done! 2 posts, 2 tags.

→ Explore Nyi Blorong Branch

Simple explanation: Nyi Blorong = Simple Jinja for quick start without complexity. Medusa = Complete with PAX, nested, Tags ALL, fallback - for power and pro look. Detailed docs are in each branch README.


📋 Requirements

  • Python 3.8+
  • pip install jinja2 markdown pyyaml watchdog
python install.py

🚀 Quick Start

Medusa (Pro - Recommended for main to look PRO)

git clone https://github.com/mesinkasir/pycora.git
cd pycora
git checkout medusa
python ssg.py
# Ready in 0.87s - 41 files - MEDUSA v2.4.6
python dev.py

Nyi Blorong (Simple)

git clone https://github.com/mesinkasir/pycora.git
cd pycora
git checkout nyi-blorong
python ssg.py
python dev.py

📁 Project Structure

pycora/
├── content/posts/
│   ├── first.md
│   └── tutorial/nested.md    # Nested - ONLY Medusa auto includes
├── templates/
│   ├── medusa/               # Medusa: .pax
│   └── layouts/              # Nyi Blorong: .html
├── medusa.webp               # Clickable to medusa branch
├── nyiblorong.webp           # Clickable to nyi-blorong branch
├── ssg.py
└── output/

🌐 Deployment

python ssg.py
# Upload output/ to Netlify, Vercel, GitHub Pages

💖 Support & Donate

If you like this project, please support:


🤔 Which version for main to look PRO?

Use MEDUSA as main to look PRO.

Why?

  • Full features: nested, Tags ALL, PAX, fallback - looks mature and production-ready
  • Nyi Blorong is great for beginners, but keep it in branch
  • Main = Medusa makes your repo look pro on GitHub Explore
git checkout main
git merge medusa --no-ff -m "feat: Medusa v2.4.8 as main PRO engine"
git push origin main
  • Main / Medusa = PRO
  • Nyi Blorong branch = Simple

📄 License

MIT - Axcora Technology

📞 Contact

PyCora - Click image to choose engine
Made with ❤ by Axcora

Releases

Sponsor this project

Packages

Contributors

Languages