#moon-ssg

#Scope

• Markdown headings, paragraphs, thematic breaks, blockquotes, unordered/ordered lists, fenced code blocks, emphasis, strong text, code spans, links, and images.
• Front matter fields: title, date, draft, tags, categories, plus raw metadata retention.
• HTML output with escaped text, escaped attributes, unsafe URL scheme blocking, and slugified output paths.
• Blog index pagination, tag pages, category pages, RSS 2.0, search.json, and sitemap.xml.
• CLI generation from content/, layouts/, and static/ into public/.

• Full CommonMark compliance.
• Theme engines with arbitrary template expressions.
• Incremental builds and file watching.
• Remote deployment.

#Install

moon version --all
moon update

moon add Myytsjj/moon-ssg@0.3.0

#Build And Test

git clone https://github.com/Myytsjj/moon-ssg.git
cd moon-ssg

moon fmt --check
moon check --target all
moon check --deny-warn
moon build
moon test --target all
moon test --deny-warn
moon info
git diff --exit-code

#Quick Start

moon run src/main

moon run src/main -- --help
moon run src/main -- --version
moon run src/main -- --drafts
moon run src/main -- --config site.json
moon run src/main -- --content posts --layouts templates --public dist --static assets
moon run src/main -- --base-url https://example.com/blog

#Library API

import {
  "Myytsjj/moon-ssg/src/ssg"
}

fn main {
  let markdown_source = "# Hello MoonBit\n\nThis is a generated page."
  let post_layout = "<article><h1>{{title}}</h1>{{content}}</article>"
  let index_layout = "<main>{{posts}}{{pagination}}</main>"
  let tag_layout = "<section><h1>{{tag}}</h1>{{posts}}</section>"
  let category_layout = "<section><h1>{{category}}</h1>{{posts}}</section>"
  let config = @ssg.Config::make(
    "Example Site", "Description", "https://example.com", 10,
    "content", "layouts", "public", "static",
  )
  let pages = @ssg.generate_site(
    [("hello moonbit.md", markdown_source)],
    post_layout,
    index_layout,
    tag_layout,
    category_layout,
    config,
    false,
  )
  println("generated pages: " + pages.length().to_string())
}

let parser = @markdown.Parser::new("# Hello")
let html = @markdown.render_html(@markdown.to_events(parser.parse()))

#Examples

moon run examples/basic

moon run examples/showcase

moon run examples/matrix

moon run benchmarks/main

#Architecture

• src/markdown: Markdown AST, inline parser, block parser, event conversion, and HTML renderer.
• src/ssg: front matter parsing, post model, page generation, pagination, taxonomy pages, RSS, search JSON, sitemap, slugging, and output escaping.
• src/main: filesystem CLI and argument parsing.
• examples/basic: minimal downstream usage of the pure API.
• benchmarks/main: repeatable generator workload for sanity checks.
• scripts/verify_acceptance.ps1: local acceptance command runner.

#CI

• moon version --all
• moon update
• moon fmt --check
• moon check --target all
• moon check --deny-warn
• moon build
• moon test --target all
• moon test --deny-warn
• moon info
• git diff --exit-code

#Acceptance Self-Check

powershell -ExecutionPolicy Bypass -File scripts\verify_acceptance.ps1 -SkipPublishDryRun

powershell -ExecutionPolicy Bypass -File scripts\verify_acceptance.ps1

#Release

1. Update moon.mod version and CHANGELOG.md.
2. Run the acceptance script.
3. Confirm moon publish --dry-run.
4. Create a tag and GitHub Release only after checks pass.
5. Publish to Mooncakes only with safe credentials.
6. Sync GitHub and GitLink intentionally.

#License

#References And Acknowledgements