Rendering static files

Dynamic webpages
The erb method is typically used to render dynamic webpages (which should be placed in the app/views directory):
1
get '/404' do
2
  erb :not_found, layout: false
3
  # Searches for app/views/not_found.erb
4
end
Copied!
Static files
However, static files can also be rendered in a similar way to dynamic webpages, using the render_static method:
1
get '/404' do
2
  render_static '/not_found.html'
3
  # Searches for app/static/public/not_found.html
4
end
Copied!
Alternatively, the static method can be used to define a block. The above can be simplified into:
1
static '/not_found.html', aliases: %w[/404]
Copied!
The static method basically generates a get route for the specified file path, along with its aliases. Aliases are not required though:
1
static '/not_found.html'
Copied!
Block definition
If you wish to define multiple static routes at once, you can use the block format:
1
static do |s|
2
  s.route '/not_found.html'
3
  s.route '/maintenance.html', aliases: %w[/maintenance]
4
  s.route '/robots.txt'
5
end
Copied!
Storage of static files
Static webpages should be stored in the app/static/public directory.
If you wish to access the data stored in any JSON, YAML or XML files in this directory (somewhere within your Ruby code), use the Static data accessor Static.public  - read here for more information on how to use the data stored in these files.

Articles

Maintenance mode

Last modified 2yr ago

Copy link

Contents

Dynamic webpages

Static files