Gem Version Ruby

Simple router for your static documentation. Like markdown, or textile, or whatever files. 1

Trifle::Docs is a way too simple router. It maps your folder full of static files into your URLs and allows you to integrate them with same layout as the rest of your app. It supports rendering markdown, textile and serves other static files directly. You can easily extend it to process your own format with a Harvester. Oh yeah.


Static Site Generators are awesome at what they do. I know, I've used them for a long time. Unfortunately they are a bit cumberstone when customisation is necessary. On the other end of a spectrum are Content Management Systems. They are great at managing content. Unfortunately they are a bit overkill when all your content is static (and somewhat technical).

Trifle::Docs lies somewhere in between these two, but slightly on the static side of spectrum. It is a way too simple tool for developers who want to integrate documentation or blog into their Ruby/Rails website without storing content in database or learning custom templating language/structure. This allows them to make UI/UX of their website seamless.

Oh, and did you know that this documentation is build on top of Trifle::Docs? Yup, you can check it out, this source code is public.

  1. TBH only markdown harvester for now 💔.