Static sites are making a comeback, and for good reason. Here's why you should consider using PyCora for your blog.

Speed

Static sites are incredibly fast. There's no database queries, no server-side processing, just pure HTML files served instantly.

Performance comparison: - Static site: 50-100ms load time - WordPress: 500-2000ms load time

Security

With no database, there are no SQL injection vulnerabilities. Static sites are inherently secure.

Cost

Static sites can be hosted for free or very cheaply on: - GitHub Pages (free) - Netlify (free tier) - Vercel (free tier) - Cloudflare Pages (free)

Scalability

Static sites handle traffic spikes effortlessly. There's no database to overload.

Version Control

Static sites work perfectly with Git: - Track all changes - Easy rollbacks - Collaborative workflow

Developer Experience

Static site generators like PyCora offer: - Markdown writing - Live reload - Easy customization - Clean code

Content Longevity

Your content remains accessible forever. No CMS updates, no compatibility issues.

Make the switch to static sites with PyCora! 🌟

PyCora is designed to be easily customizable. You can change the look and feel of your site by modifying the templates and CSS.

CSS Customization

Place your custom CSS in static/css/main.css:

/* Custom colors */
:root {
  --primary-color: #6C63FF;
  --secondary-color: #FF6584;
}

/* Custom fonts */
body {
  font-family: 'Inter', sans-serif;
}

/* Custom styling */
.blog-card {
  border-radius: 20px;
  box-shadow: 0 10px 30px rgba(0,0,0,0.1);
}

Template Customization

PyCora uses Jinja2 templates located in the templates/ directory:

• base.html - Main layout with navbar, footer, SEO
• landing.html - Homepage design
• blog.html - Blog listing page
• post.html - Single post layout
• page.html - Static page layout

Changing Colors

Edit config.yaml or directly in base.html:

<style>
  .text-gradient {
    background: linear-gradient(135deg, #your-color-1, #your-color-2);
    -webkit-background-clip: text;
    -webkit-text-fill-color: transparent;
  }
</style>

Adding Fonts

Add custom fonts in base.html:

<link href="https://fonts.googleapis.com/css2?family=Your+Font&display=swap" rel="stylesheet">

Create your unique look with PyCora! 🎨

One of the biggest advantages of static sites is the ability to deploy them anywhere. Here's how to deploy your PyCora site to various hosting platforms.

Netlify

1. Build your site: python ssg.py
2. Drag and drop the output/ folder to Netlify dashboard
3. Or connect your GitHub repository for automatic deployments

Vercel

# Install Vercel CLI
npm i -g vercel

# Deploy
cd output
vercel --prod

GitHub Pages

# Build your site
python ssg.py

# Deploy to gh-pages branch
git subtree push --prefix output origin gh-pages

Cloudflare Pages

1. Build your site: python ssg.py
2. Connect your GitHub repository to Cloudflare Pages
3. Set build command: python ssg.py
4. Set output directory: output

Any Static Hosting

Just upload the output/ directory to: - Hostinger - Namecheap - Bluehost - AWS S3 - Firebase Hosting - Any web hosting provider

Deploy your PyCora site anywhere! 🚀

Search Engine Optimization (SEO) is crucial for getting your content discovered. PyCora comes with built-in SEO features to help your site rank better.

Meta Tags

PyCora automatically generates essential meta tags:

<title>Your Page Title | PyCora</title>
<meta name="description" content="Your page description">
<meta name="keywords" content="seo, static, site">

Open Graph Tags

For better social media sharing, PyCora includes Open Graph tags:

<meta property="og:title" content="Your Page Title">
<meta property="og:description" content="Your description">
<meta property="og:image" content="/images/og-image.jpg">
<meta property="og:url" content="https://yoursite.com/page">

Twitter Cards

<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Your Title">
<meta name="twitter:description" content="Your description">

Sitemap & RSS

PyCora automatically generates: - sitemap.xml - For search engine crawling - feed.xml - For RSS subscribers

Best Practices

1. Use descriptive titles (50-60 characters)
2. Write compelling meta descriptions (150-160 characters)
3. Use proper heading structure (H1, H2, H3)
4. Add alt text to images
5. Use clean URLs (slug-based)
6. Link to related content

Optimize your static site for search engines with PyCora! 🔍

Markdown is a lightweight markup language that makes writing for the web simple and intuitive. Here are some essential tips to improve your blogging workflow with PyCora.

Headings Structure

Use headings to organize your content hierarchy:

# Main Title (H1)
## Section (H2)
### Subsection (H3)

Formatting Text

**Bold text** - Use for emphasis
*Italic text* - Use for subtle emphasis
~~Strikethrough~~ - Use for deleted content

Lists

Unordered lists:

- Item 1
- Item 2
  - Sub-item 2.1
  - Sub-item 2.2

Ordered lists:

1. First item
2. Second item
3. Third item

Links and Images

[Link Text](https://example.com)
![Image Alt Text](/images/photo.jpg)

Code Blocks

def hello_world():
    print("Hello, PyCora!")

Blockquotes

"Markdown makes writing for the web accessible to everyone."

Master Markdown and create beautiful content with PyCora! 📝

PyCora is a lightweight, fast, and elegant static site generator built with Python. In this tutorial, we'll walk through the process of setting up your first PyCora site.

Why Choose PyCora?

• ⚡ Blazing Fast - Pure static HTML, no database queries
• 📝 Markdown Support - Write content in Markdown with YAML frontmatter
• 🎨 Beautiful Design - Clean typography with Bootstrap 5
• 🔍 SEO Ready - Built-in meta tags, Open Graph, Twitter Cards

Installation

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

Create Your First Post

Create a new Markdown file in content/posts/ with YAML frontmatter:

---
title: My First Post
date: 2024-01-15
tags:
  - hello
  - world
---

# Welcome to My Blog

This is my first post using PyCora.

Build Your Site

python ssg.py

Your static site will be generated in the output/ directory!

Development Server

For local development with auto-rebuild and live reload:

python dev.py

Start building your static site with PyCora today! 🚀