NANOC(1)

📦
version 4.14.7 · 6 versions
, in ubuntu stonking

NANOC(1) 💖

okay bestie, buckle up — this is the manual page for nanoc, and yes it's Nanoc, a static site compiler written in Ruby. that's the whole vibe of this page, iykyk 🎀

✨ NAME ✨

nanoc — Nanoc, a static site compiler written in Ruby

no cap, that's it. short, sweet, iconic 💅

🦋 SYNOPSIS 🦋

nanoc command [options] [arguments]

like… that's the shape of every single invocation. nanoc, then a command, then whatever options and arguments you're feeling today 🌸

💜 DESCRIPTION 💜

okay so here's the tea ☕ — Nanoc is a static site generator, and it's genuinely fit for building anything, from a tiny little personal blog all the way up to a big corporate web site. she does not gatekeep, she does not judge, she just generates 🫶

the way it works: it can transform content from one format (e.g. Haml or Markdown) into another (usually HTML) — glow-up, honestly — and then it lays out your pages so that the site's look and feel stays consistent across all of them. cohesive aesthetic. main character energy. periodt ✨

👑 COMMANDS 👑

here's the roster of commands, bestie. pick your fighter:

  • check — run issue checks 🔍
  • compile — compile items of this site 🔥
  • create-site — create a site 🎀
  • deploy — deploy the compiled site 🚀
  • help — show help 🙋
  • prune — remove files not managed by Nanoc from the output directory 🧹
  • shell — open a shell on the Nanoc environment 🐚
  • show-data — show data in this site 📊
  • show-plugins — show all available plugins 🧩
  • show-rules — describe the rules for each item 📜
  • view — start the web server that serves static files 👀

💅 OPTIONS 💅

the flags. the little letters. the power. use them wisely:

  • -C, --no-color — disable color 🙈 (sad, but sometimes necessary)
  • -V, --verbose — make nanoc output more detailed 🗣️
  • -d, --debug — enable debugging 🐛
  • <-e>, --env=value — set environment 🌍
  • -h, --help — show the help message and quit 👋
  • -l, --color — enable color 🌈 (yes queen, the pretty output)
  • -v, --version — show version information and quit 🏷️
  • -w, --warn — enable warnings ⚠️
ngl, --color and --no-color are literally opposites, so maybe don't fight yourself about it. pick one, bestie 💀

🫶 AUTHORS 🫶

Nanoc has been developed by Denis Defreyne <denis.defreyne@stoneship.org>. king behaviour, fr fr 👑

and that's the whole page, diva 🌟

this was the nanoc(1) manual, dated 2026-07-31 💖 if you made it to the bottom, you're literally the moment, no notes, go compile something gorgeous 🦋✨🎀

📦 where this page comes from