New Pycora Python SSG

themestemplate website themes website template blog template template pythonssg freethemes featuredthemes pythonthemes

Introduction .

PyCora is a python static site generator that converts Markdown files with YAML frontmatter into fully functional HTML websites.

If you need python SSG look like jekyll or 11ty - pycora is the best choice for you !!

Get Started .

Need to install

• Python Download Python : https://www.python.org/downloads/
• Optional pip (Python package manager)

Next we need to download this project

• Download via gumroad https://creativitaz.gumroad.com/l/pycora
• Download via github https://github.com/mesinkasir/pycora

Or clone this repo , open terminal and run this command

git clone https://github.com/mesinkasir/pycora.git

Installation .

Open project folder then terminal and run this command.

git clone https://github.com/mesinkasir/pycora.git
cd pycora
python install.py

Test Run Project .

After installation you can run your project

Run build

python ssg.py

Dev mode

python dev.py

Run Python

python run.py

Or you can use node js npm

npm run build   # Build site
npm run dev     # Development server
npm run serve   # Serve output directory
npm run menu    # Menu interface

Project Structures .

Pycora python project structure

pycora/
├── content/
│   ├── posts/           # Blog posts (Markdown + YAML)
│   │   └── 2024-01-01-hello-world.md
│   └── pages/           # Static pages (Markdown + YAML)
│       └── about.md
├── templates/           # Jinja2 templates
│   ├── base.html        # Base layout
│   ├── landing.html     # Homepage
│   ├── blog.html        # Blog listing
│   ├── post.html        # Single post
│   ├── page.html        # Static page
│   ├── tags.html        # Tags index
│   ├── tag.html         # Tag detail
│   ├── 404.html         # 404 page
│   ├── feed.xml         # RSS feed
│   └── sitemap.xml      # Sitemap
├── static/              # Static assets
│   ├── css/
│   │   ├── bs.css
│   │   └── main.css
│   ├── js/
│   └── images/
├── output/              # Generated site (build output)
│   ├── index.html
│   ├── blog/
│   ├── tags/
│   ├── feed.xml
│   └── sitemap.xml
├── ssg.py               # Main builder
├── dev.py               # Development server
├── install.py           # Dependency installer
├── run.py               # Menu interface
├── config.yaml          # Site configuration
├── package.json         # NPM scripts
├── requirements.txt     # Python dependencies
└── README.md            # Documentation

Website Configuration .

For firs you can setup your site open on config.yaml

site:
  name: PyCora
  description: Static Site Generator with Python
  url: http://localhost:8000
  author: Your Name
  twitter_username: yourusername
  image: /static/images/og-image.jpg

  nav:
    list:
      - name: Home
        url: /
      - name: Blog
        url: /blog
      - name: About
        url: /about

  hero:
    title: Write
    sub_title: Content
    title2: in Markdown
    text: "Static Site Generator with Python - Fast, Minimal, Elegant."
    button1:
      text: Read blog
      url: /blog/
    button2:
      text: Learn More
      url: /about/
    terminal:
      title: Quick Start
      info: "Simple. Fast. Elegant."
      list:
        - text: "$ python ssg.py build"
        - text: "$ Building site..."
        - text: "$ Pycora is ready for Deploy !!"

  features:
    title: Why Choose PyCora?
    list:
      - icon: "fas fa-bolt text-primary"
        title: Lightning Fast
        text: "Pure static HTML. No database. No server-side processing."

  footer:
    list:
      - name: Github
        icon: fab fa-github
        url: https://github.com/yourusername

Change with your site configuration.

Site is for you site SEO , nav for update your navbar, hero to update your hero on home page, and others.

Update Static Page .

To update your static page eg: about and others, you can make CRUD , create , update and delete your static page on content/pages

implementation frontmatter format:

---
title: About Me
description: Learn more about me
date: 2024-01-15
author: Your Name
layout: page
---

# About Me

This is the about page.

Update Post Collections .

If you want to update post artilce collections, access on content/posts

implementation frontmatter format:

---
title: My First Post
description: A brief description of my post
date: 2024-01-15
author: Your Name
tags:
  - python
  - ssg
  - markdown
image: /images/post-image.jpg
layout: post
---

# Welcome to My Blog

This is my first post using PyCora.

## Why Static Sites?

- Fast - No database queries
- Secure - No vulnerabilities
- Simple - Write in Markdown

Layouting .

PyCora uses Jinja2 templates located in the templates/ directory:

• base.html - Base layout with navbar, footer, SEO
• landing.html - Homepage with hero and features
• blog.html - Blog listing with pagination
• post.html - Single post with author, tags, next/prev
• page.html - Static page layout
• tags.html - Tags index page
• tag.html - Posts filtered by tag
• 404.html - Custom 404 error page
• feed.xml - RSS feed template
• sitemap.xml - Sitemap template

Deployment .

Need to deploy in to your host, you can run

python ssg.py

and upload your output folder in to your hosting.

Support Pycora .

• Support via PayPal
• Support via Github
• Support via Gumroad