r3 Reference Guide

r3 template promote location template_name id

Promotes the template template_name towards a more generic level indicated by id. (The id parameter is the index displayed by the r3 template searchpath command. It is the index of the level you wish to promote the template file to.) Promoting a template allows it be used by more locations on the search path. This is useful when you decide a specialized template works for a wider audience. Suppose, for example, that you have already made something local to an intl or a page by specializing the template to that level. If you want to use it for other intls or pages, you can promote the template so that more contexts can see it.

Using the example in r3 template searchpath , the following command will promote index.html.ros to the location cheese/generic/generic:

r3 template promote cheese/ca/index.html index.html.ros 5

The output from r3 template searchpath cheese/ca/index.html index.html.ros now looks like this:

  0         cheese/ca/index.html
  1         cheese/ca/generic
  2         cheese/fr/index.html
  3         cheese/fr/generic
  4         cheese/generic/index.html
  5         cheese/generic/generic           index.html.ros
  6         generic/ca/index.html
  7         generic/ca/generic
  8         generic/fr/index.html
  9         generic/fr/generic
  10       generic/generic/index.html
  11       generic/generic/generic

aliases

flags