search

docpad-archive / docpad-plugin-jade

Adds support for the Jade templating engine to DocPad.
Other
17 stars 8 forks source link

Add a warning about jade problems #12

Closed balupton closed 10 years ago

balupton commented 10 years ago

I'm considering adding the following to this plugin:

Awareness

Before you get started with Jade, it is important to be aware of one thing. The majority of support questions that come through with DocPad, aren't actually DocPad issues, but Jade issues. People confusing the syntax, Jade doing it's own templating magic, things like that.

Adding onto this, Jade is one of the slowest templating engines there is source, and will quickly become the bottleneck in large projects.

The DocPad team recommends you try one of the many other amazing templating engines that are available, over trying to use Jade.

If you still insist on using Jade, please be aware, you may be treading down a slippery slope.

Does anyone have a problem with this?

Delapouite commented 10 years ago

Also Jade is one of the slowest templating engine : http://ectjs.com/#benchmark It rapidly becomes the bottleneck during the rendering phase of thousands of documents / layouts.

timaschew commented 10 years ago

The benchmark is about a year ago with really old versions of the template engines, I cloned the project, updated all versions and the result is a different now. For example Jade becomes faster than Eco and for EJS for escaped content. Without the with mode it become also faster for unescaped content. Eco and EJS becomes the slowest!

I can publish the results if you want.

But I'm not sure if the differences of maximum 6 seconds (over all engines) are worth for 100,000 templates?

RobLoach commented 10 years ago

:lock: