Creating a New Post

Use the provided script to generate a new post template:

ruby ./bin/new_post.rb my-first-post

This creates _posts/YYYY-MM-DD-my-first-post.md with today’s date and a ready-to-edit template.

Post Front Matter

Every post begins with YAML front matter:

---
layout: post
section-type: post
has-comments: true
title: Your Post Title
category: tech
tags: ["jekyll", "tutorial"]
---

Generating Tag Pages

After adding new tags, generate their pages:

ruby ./bin/generate_tags.rb

This scans all posts and creates pages for any new tags in the tags/ directory.

Generating Category Pages

Similarly, generate category pages:

ruby ./bin/generate_categories.rb

Category pages are created in the categories/ directory.

Syntax Highlighting

The theme includes the Everforest Dark syntax theme. Use fenced code blocks with language identifiers:

```python
def hello_world():
    print("Hello, World!")
```

Renders as:

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

Supported languages include: python, javascript, ruby, c, cpp, java, bash, yaml, json, html, css, scss, and many more.

Markdown Features

Your posts support full GitHub-flavored Markdown:

• Bold and italic text
• Links
• Images: ![Alt text](/path/to/image.jpg)
• Lists (ordered and unordered)
• Blockquotes
• Tables
• Task lists

Mermaid Diagrams

Create diagrams directly in your posts using Mermaid syntax. The theme includes the jekyll-spaceship plugin which renders Mermaid diagrams automatically.

Flowcharts

```mermaid
graph LR
    A[Start] --> B[Process]
    B --> C{Decision}
    C -->|Yes| D[Action 1]
    C -->|No| E[Action 2]
    D --> F[End]
    E --> F
```

Sequence Diagrams

```mermaid
sequenceDiagram
    participant User
    participant Server
    participant Database
    User->>Server: Request
    Server->>Database: Query
    Database-->>Server: Results
    Server-->>User: Response
```

Gantt Charts

```mermaid
gantt
    title Project Timeline
    dateFormat  YYYY-MM-DD
    section Phase 1
    Research    :a1, 2024-01-01, 30d
    Design      :a2, after a1, 20d
    section Phase 2
    Development :a3, after a2, 40d
    Testing     :a4, after a3, 15d
```

Class Diagrams

```mermaid
classDiagram
    class User {
        +String name
        +String email
        +login()
        +logout()
    }
    class Post {
        +String title
        +String content
        +publish()
    }
    User "1" --> "*" Post : writes
```

Mermaid supports many more diagram types including pie charts, state diagrams, and entity-relationship diagrams. See the Mermaid documentation for the full syntax reference.

Tips for Great Posts

• Use descriptive, SEO-friendly titles
• Add relevant tags for discoverability
• Include images to break up text
• Keep paragraphs short for readability
• Preview locally before publishing