obli-ssg

Satellite SSG (Static Site Generator) implementation in the hyperpolymath ecosystem.

Table of Contents

• Overview
  • What This Is
  • What This Is Not
• Supported Static Site Generators
• Installation
• Usage
• Project Structure
• Security
• Contributing
• License
• Related Projects
• Status

Overview

obli-ssg is a satellite project that provides MCP (Model Context Protocol) compatible adapters for 28 static site generators. It integrates with the poly-ssg-mcp hub.

What This Is

• A satellite SSG implementation using the poly-ssg-mcp hub

• MCP-compatible adapters for multiple static site generators

• Part of the hyperpolymath ecosystem following RSR guidelines

What This Is Not

• NOT the main SSG hub (that’s poly-ssg-mcp)

• NOT exempt from RSR compliance

Supported Static Site Generators

The adapters support 28 SSGs across multiple programming languages:

Language	SSG	Description
Ada	StaticWebPages	Ada-based static site generator
Clojure	Babashka, Cryogen, Perun	Clojure-based SSGs
Crystal	Marmot	Crystal-based static site generator
D	Reggae	D language static site generator
Elixir	NimblePublisher, Serum, Tableau	Elixir-based SSGs
Erlang	Zotonic	Erlang CMS/SSG
F#	Fornax, Franklin	F# static site generators
Haskell	Ema, Hakyll	Haskell-based SSGs
Julia	Documenter	Julia documentation generator
Kotlin	Orchid	Kotlin static site generator
Nim	Nimrod	Nim static site generator
OCaml	Yocaml	OCaml static site generator
Racket	Frog, Pollen	Racket-based SSGs
Rust	Cobalt, mdBook, Zola	Rust-based SSGs
Scala	Laika, ScalaTex	Scala static site generators
Scheme	Coleslaw	Scheme-based SSG
Swift	Publish	Swift static site generator
Tcl	Tclssg	Tcl static site generator

Installation

# Clone the repository
git clone https://github.com/hyperpolymath/obli-ssg.git
cd obli-ssg

# The adapters are Deno-compatible JavaScript modules
# Each adapter can be imported and used with the MCP protocol

Usage

Each adapter exports a standard interface:

import * as zola from './adapters/zola.js';

// Connect to the SSG
await zola.connect();

// Check connection status
if (zola.isConnected()) {
  // Use the available tools
  const result = await zola.tools[0].execute({ path: './my-site' });
}

// Disconnect when done
await zola.disconnect();

Project Structure

obli-ssg/
├── adapters/           # SSG adapter implementations (28 adapters)
├── .github/            # GitHub workflows and templates
│   ├── workflows/      # CI/CD workflows (CodeQL)
│   ├── ISSUE_TEMPLATE/ # Issue templates
│   └── dependabot.yml  # Dependency updates
├── ECOSYSTEM.scm       # Ecosystem positioning
├── META.scm            # Architecture decisions
├── STATE.scm           # Project state tracking
├── SECURITY.md         # Security policy
├── CODE_OF_CONDUCT.md  # Community guidelines
├── CONTRIBUTING.md     # Contribution guidelines
└── LICENSE.txt         # Dual MIT/AGPL-3.0 license

Security

This project takes security seriously:

• CodeQL static analysis enabled

• SHA-pinned GitHub Actions

• Dependabot for automated dependency updates

• Comprehensive .gitignore for secrets protection

See SECURITY.md for reporting vulnerabilities.

Contributing

See CONTRIBUTING.md for contribution guidelines.

License

Dual licensed under MIT OR AGPL-3.0-or-later. See LICENSE.txt for details.

Related Projects

• poly-ssg-mcp - Hub with all SSG adapters via MCP

• rhodium-standard-repositories - RSR compliance standard

Status

Version	0.1.0
Phase	Initial Setup
Completion	35%
RSR Compliance	100%