search

jonschlinkert / templates

System for creating and managing view collections, rendering, engines, routes and more. See the "dev" branch for most recent updates.
MIT License
60 stars 9 forks source link

Documentation: What is the difference between templates and template? #3

Closed hgoebl closed 9 years ago

hgoebl commented 9 years ago

I'm a quite heavy user of assemble. Maybe there is no reason to change something in assemble, but the project seems to be sleeping for a while and for that reason I was looking for the next big thing in static site generation. I encountered templates and template and they appear to be very similar, not just their names.

Could you please provide some information which project to use, depending on the case?

And I'm asking myself how much value assemble provides compared to templates. Is it much more than a grunt-plugin calling template and selecting a template engine (handlebars)?

Where would templates be used? Typically "offline" site generation or delivering "online", embedded in something like express?

I apologize if the questions are dumb, maybe I'm not deep enough in that business and as a result not able to imagine what to do with the more low-level libraries you provide. BTW thanks for your great work!

jonschlinkert commented 9 years ago

I apologize if the questions are dumb

these are all good questions, no worries at all. I'll start with the heading..

What is the difference between templates and template?

it's nothing complicated. I'm in the process of fixing some things I think I did wrong before. We just received the name templates, so we're moving template over to templates. Then we're going to use templates in assemble and refactor template to be mostly what's in this file. After that's done, templates will use template to handle the View class.

Bottom line, the names will be more semantically correct:

but the project (assemble) seems to be sleeping for a while and for that reason I was looking for the next big thing in static site generation.

If you take a look at assemble's branches, dev specifically, there have been 725 commits to assemble since the last minor version change. https://github.com/assemble/assemble/pull/767

Is it much more than a grunt-plugin calling template and selecting a template engine (handlebars)?

As of 0.6, Assemble is a 100% standalone library. No longer a grunt plugin, but we will continue to provide support for grunt with grunt-assemble.

how much value assemble provides compared to templates.

Value is in the eye of the beholder :) but I'll try to sum up the major differences:

Templates

Main purpose: Template collections and rendering

templates expects you to read and write your own files. There is no concept of src, dest, tasks etc.

Assemble

Main purpose: Building projects (static sites, rapid prototyping)

I was looking for the next big thing in static site generation

Keep watching the dev branch on Assemble :) we're about to release some things that will be game changing.

Does this help?

jonschlinkert commented 9 years ago

btw I'll be sure to get these things clarified on the docs of all related libs as well. I think it will be more obvious when it's all done.

hgoebl commented 9 years ago

Thnx @jonschlinkert, this really helps and I'm looking forward to see assemble 0.6. Do you think it's already time to give it a try for a small "pilot" project? I could migrate one of my static sites or start one of my "backlog" site projects... Would not be a problem when changes occur later :fearful:

jonschlinkert commented 9 years ago

Do you think it's already time to give it a try for a small "pilot" project?

yeah, I think if you use the dev branch it should be okay. Docs are in progress though, so you might need to figure things out until then. We don't anticipate any major API changes happening on 0.6, just bug fixes

hgoebl commented 9 years ago

Thanks again, I'll give it a try soon.