# nanoc/nanoc

A powerful web publishing system

Repository: https://github.com/nanoc/nanoc
Canonical: https://ross.abutalabs.com/products/nanoc
Homepage: http://nanoc.app
Language: Ruby
License: MIT
License Family: permissive
Topics: nanoc, ruby, static-site-generator
Last push: 2026-08-26T19:16:13+00:00

## Health v2 (maintenance only)
Score: 90/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 74, longevity 100
- inputs: {"age_days": 6256, "days_push": 7, "days_rel": 179, "gap_med": 12.5, "n_releases_24m": 13}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2157, forks 250 (observed 2026-08-28T04:06:19.747706+00:00)

## What it is
Nanoc is a flexible static-site generator written in Ruby that transforms content in formats like Markdown or AsciiDoc into HTML sites. It is a programmable command-line tool suitable for building anything from small personal blogs to large corporate websites.

## Use cases
- generate a static website from markdown content
- build a personal blog with a ruby static site generator
- create a corporate website with consistent layouts
- compile asciidoc content into html pages
- build a multilingual static site
- deploy a fast, secure static site to any web server

## When to choose
- you know Ruby and want a highly programmable static-site generator
- you need flexible rules, filters, and helpers for complex site builds
- you want a mature tool with strong backwards compatibility guarantees
- you prefer local development with static output deployable anywhere

## When to avoid
- you need a CMS with content management and a web UI
- you want a zero-code, batteries-included generator like Hugo or Jekyll with a huge theme ecosystem
- your team does not know Ruby, since Nanoc sites are configured in Ruby

## Facets
- artifact type: cli-tool
- maturity: active
- function: static-site-generator, templating, cli
- domain: web-development, developer-tools, documentation
- platform: ruby, cli, cross-platform
- tags: ssg, markdown, ruby-gem, static-websites, blogging

## Member repositories
- nanoc/nanoc (main) score 90

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:19.747706+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:50:25.377813+00:00, confidence not recorded.
  - readme: https://github.com/nanoc/nanoc (fetched 2026-08-28T04:06:19.747706+00:00, sha b5903fb6968d)
  - homepage: http://nanoc.app (fetched 2026-08-29T10:30:31.093576+00:00, sha d1b18a1fac1a)
  - site_page: https://nanoc.app/doc/installation (fetched 2026-08-29T10:30:31.095803+00:00, sha d80473397a80)
  - site_page: https://nanoc.app/about (fetched 2026-08-29T10:30:31.097858+00:00, sha 37cf98d1291e)
- Data as of 2026-08-30T08:39:29.467469+00:00.