Module: Roda::RodaPlugins::PrecompileTemplates

Defined in:
lib/roda/plugins/precompile_templates.rb

Overview

The precompile_templates plugin adds support for precompiling template code. This can result in a large memory savings for applications that have large templates or a large number of small templates if the application uses a forking webserver. By default, template compilation is lazy, so all the child processes in a forking webserver will have their own copy of the compiled template. By using the precompile_templates plugin, you can precompile the templates in the parent process before forking, and then all of the child processes can use the same precompiled templates, which saves memory.

After loading the plugin, you can call precompile_templates with the pattern of templates you would like to precompile:

plugin :precompile_templates
precompile_templates "views/\*\*/*.erb"

That will precompile all erb template files in the views directory or any subdirectory.

If the templates use local variables, you need to specify which local variables to precompile, which should be an array of symbols:

precompile_templates 'views/users/_*.erb', locals: [:user]

Note that you should use Tilt 2.0.1+ if you are using this plugin, so that locals are handled in the same order.

You can specify other render options when calling precompile_templates, including :cache_key, :template_class, and :template_opts. If you are passing any of those options to render/view for the template, you should pass the same options when precompiling the template.

To compile inline templates, just pass a single hash containing an :inline to precompile_templates:

precompile_templates inline: some_template_string

Defined Under Namespace

Modules: ClassMethods

Class Method Summary collapse

Class Method Details

.load_dependencies(app, opts = OPTS) ⇒ Object

Load the render plugin as precompile_templates depends on it.



44
45
46
 
# File 'lib/roda/plugins/precompile_templates.rb', line 44

def self.load_dependencies(app, opts=OPTS)
  app.plugin :render
end