rstacruz / flatdoc

Build sites fast from Markdown
http://ricostacruz.com/flatdoc
2.68k stars 260 forks source link

Why is this a client-side lib? #9

Closed sgoumaz closed 11 years ago

sgoumaz commented 11 years ago

Am I missing something in not understanding why this isn't a static site generator instead? The client-side generation makes it pretty useless to me…

So… would you consider making it a build-time CLI tool/Grunt task?

ericclemmons commented 11 years ago

I don't see what the big deal is. This is pretty much just progressive enhancement for your existing README.md. Github Pages already has great project generator that would meet all of your needs.

Plus, if you want to make it SEO-friendly or target the non-essential portion of Github users that have Javascript off, you can use PhantomJS to render & capture the output as part of your build script.

sgoumaz commented 11 years ago

Thanks for the clarification. No big deal… I had hopes this was more than a README prettifier, and it definitely could be.

BTW the GH pages generator doesn't seem at all flexible enough for us (single page, no easy theme customization, etc.). Thanks for suggesting PhantomJS though (but then other solutions like DocPad are probably simpler).