Example of build flow customization

[kirillsalykin]

Hi, thanks a lot for your work and this great project.
It would help a lot if you can add example of build process customization, for example css files fingerprinting (adding md5 to filename).

[mbuczko]

Hi,
Sorry for a late answer, I've just came back from vacations.

CSS fingerprinting is definitely something on my todo list. The only thing I still didn't clearly figure out is how transform HTML files/templates, so they could point to valid (fingerprinted) resources. I guess I would need to provide kind of additional templating. Any suggestions?

[kirillsalykin]

No problems, hope your rest was good :)

I've been thinking about having another task which will copy index.hml and replace links. but my approach is a bit different from what currently used - I treat index.html as static file (similar to css/js) - thus no selmer used.

[mbuczko]

a new built-in task has been added - assets which hopfully solves that issue.

assets task takes :source-paths and tries to fingerprint every file inside (along with everything that already has been already created in target/assets directory, used eg. by sasstask). it's possible to exclude some paths with :exlcude-paths (which usually makes sense for scss/sass files which should not be fingerprinted and included into final artifact). the tricky part is to find all assets which refer to fingerprinted ones (like htmls referring to styles/scripts or css-es referring to images) and replace occurences.

to do so a :assets-holders option has added which configures a collection of extensions of static assets in classpath to scan, like ["js" "css" "html"]. All fingerprinted assets found in there will be updated accordingly.

I suggest to take a look at sample revolt-edge in case of any problems.