improve website template

[timaschew]

The gulp task to render the website template (templates.js) isn't really easy to read and I think it will also not scale well with line like
.pipe(replaceStream('<title i18n-title>io.js - JavaScript I/O</title>','<title i18n-title>'+pageTitle+'</title>')

What about using jade to improve this?

[therebelrobot]

We opted for a more complex build task to make sure both the template and the content files have the least amount of learning curve. Jade, while nice, still has a learning curve for new contributors we hope to avoid.

That being said, yes, the gulp file is less than intuitive right now. I'm going to be looking into refactoring it over the weekend to make it asynchronous and easier to read. But ideally, that should never be touched after we know it is working the way we need it to.

[timaschew]

I'm not sure about the learning curve. I'm not familar with gulp for instance and it takes a few minutes until I got everything. IMO it's really to so clear which properties are connected with the json and the html template.

And the good thing, is that you can add logic into the jade template instead put everything into the gulp task template.js For instance if you want to show the blog item in the menu and so on.

https://github.com/timaschew/website/blob/blog-with-jade/source/templates/master.jade

But ideally, that should never be touched after we know it is working the way we need it to.

But this doesn't fit with the argument before: with the learning curve?! If it should not be touched, then only a few people need to understand it, right? ;)

related to #187

[timaschew]

closed due to #195