Introducing Tinman, the shiniest blog engine in Oz!
Let's get started
Tinman is a tiny static-ready blog engine inspired by the toto library.
A basic tinman blog looks like this:
example ├── articles │ └── 2014-08-01-the-shiniest-blog-engine-in-oz.md └── public └── style.css
You can grab a copy on npm:
npm install -g tinman
You can also check out the source code, follow issues, and much more over on GitHub.
Create a new blog
$ tinman create Blog title: myblog Your blog is ready! To get started: cd myblog/ tinman server $ tinman create myblog # Generate example templates to play with as well $ tinman create myblog --with-templates
Generate a new article
$ tinman new Title: This is my first blog post Article generated at: articles/2014-07-05-this-is-my-first-blog-post.md
Run your blog on a local webserver
$ tinman server Server listening on port 3000... $ tinman server --port 1337 Server listening on port 1337...
Build your blog as a static site
$ tinman build Blog successfully built to: build/ $ tinman build --output-dir www Blog successfully built to: www
Blogging is weird. Sometimes we run entire web servers just to host a couple words. That's odd, but sometimes it's necessary, Tinman gets that.
Other times we use industrial-grade static site generators to spit out a few files. These tools are really awesome for some things, but they get in the way for others.
Tinman isn't like that. Tinman is small, simple, and opinionated.
Articles are written in Markdown and use YAML Front Matter to set various options.
--- title: Hello, World! date: 2014-06-22 --- Once upon a time...
If you're feeling the need to customize your blog further, you can edit
the default templates that Tinman uses. Just add the
option when calling
Tinman also supports the notion of "plugins," which are just simple helper functions you can call from your templates.
There's some more about this on GitHub.
Tinman will automatically copy static assets (images, stylesheets,
doesn't need to be any more difficult than that.
You can throw images in there, audio files, even complete HTML documents.
Even cooler, any JS or CSS you throw in there will be automatically inserted into your main layout with Tinman.
Not much! Tinman's pretty simple. It takes the same "10 second blog engine for hackers" spirit behind toto and adds a couple nifty features.
Be sure to check us out on GitHub.