Question 1

How do I use Kilt with a custom template engine in Crystal?

Accepted Answer

You need to create an adapter using the `Kilt.register_engine` macro, as shown in the README. Define an embed macro for your engine and register it, which may require additional coding effort.

Question 2

Is Kilt better than using ECR directly for Crystal web apps?

Accepted Answer

Kilt is ideal if you need flexibility across multiple template languages; for projects only using ECR, direct usage is simpler with no abstraction overhead. Kilt adds value in multi-engine scenarios.

Question 3

How to render a template file with Kilt in Crystal?

Accepted Answer

Use `Kilt.file` for class-based rendering or `Kilt.render` for embedded rendering, as demonstrated in the usage examples. Ensure the required engine shard, like slang or crustache, is included.

Question 4

Does Kilt support template inheritance or partials?

Accepted Answer

Support depends on the underlying engine; Kilt itself doesn't add these features but passes through engine capabilities. Check the specific engine's documentation for details.

Question 5

What are the performance implications of using Kilt?

Accepted Answer

Kilt adds a thin abstraction layer, so performance is generally similar to direct engine usage, though there might be minimal macro expansion overhead. For most use cases, this impact is negligible.

Question 6

How to install Kilt and add template engine dependencies?

Accepted Answer

Add Kilt to your shard.yml, then include shards for desired engines like crustache for Mustache or slang for Slang, as listed in the supported engines table in the README.

Kilt

What is Kilt?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions