Template Syntax Tags
A raw list of supported tags:
%resource("")%
title
content
footer
site_title
email
mailto
site_slogan
toolbar
navigation
top_navigation
sub_navigation
breadcrumb
sidebar
sidebar_title
plugin_sidebar
ogTitle
ogDescription
ogURL
ogImage
header
plugin_header
style_variations
user_styles
user_javascript
user_header
last_published
alignment
footer_alignment
bgimage
base_url
website_address
page_path
banner_path
banner_alternate_text
banner_image

Header Syntax

###%header% This outputs the meta information for each page. It should be placed between the <head> tags in your template file.
###%title% Outputs the title of the current page.
###%user_header% Allows the user to place any custom code into the header of the page.
###%style_variations% Outputs a series of style sheets into the head of the page, as selected by the user via theme styles tab of the Page Inspector.
###%user_styles% Outputs the users custom CSS into the head of the users page.
###%user_javascript% Outputs the users custom javascript code into the head of the users page.
###%plugin_header% Outputs code generated by the selected page type into the header area. Typically it will be javascript and/or css.
###%navigation% Outputs the site navigation as an unordered list. Replaces %toolbar%, which is deprecated in RapidWeaver 6.0.
###%top_navigation% New in RapidWeaver 6.0 Outputs an unordered list of just the top-level of the page hierarchy.
###%sub_navigation% New in RapidWeaver 6.0 Outputs an unordered list of the remaining sub-navigation of the hierarchy, and respects the RWAlwaysDisplayFullNavigation key.
###%toolbar% Deprecated in RapidWeaver 6.0 You should move to using %navigation% in its place.

Body Syntax

###%site_title% Outputs the site title
###%site_slogan% Outputs the site slogan entered in the Site Setup area.
###%logo% Outputs a user definable site wide image. This is set via the Site Setup area, and RapidWeaver does not pre-flight the images the customer may select for their size. Depending on how you’re using this tag, you may want to apply some sensible maximum size for the image via CSS.
###%content% Outputs the content of the current page.
###%sidebar_title% Outputs the sidebar title as entered in the Page Inspector.
###%sidebar% Outputs the sidebar content as entered in the Page Inspector.
###%plugin_sidebar% Outputs content specific to the current page style. For example, the blog archives.
###%breadcrumb% Generates an unordered list of links from the home page to the current page following the menu hierarchy in the Page List.
###%footer% Outputs the site’s footer as entered in the Site Setup area.

Extras

###%pathto(file.extension)% The %pathto()% syntax should be used to refer to any global assets in the theme. This will generate the appropriate relative, absolute or relative to DOCROOT link to the relevant file. Its primary use is to refer to stylesheets and javascript files that are used across the site.
%pathto()% can be used for any file (styles.css for example), however the file must be added to the RWCopyFiles array in the theme.plist file.
###%base_url% Outputs the web address of the website, as entered in the Site Setup area.
###%last_published% Outputs the last published date - this is not currently customisable in its appearance.
###%email% Outputs the user’s e-mail address.

Colourtags

Colourtags allow customers to customise a particular colour value in your theme using the OS X colour picker. The colour values from a colourtag must currently be set via a separate stylesheet (normally called colours.css or colourtags.css) This style sheet must be included in the RWColourTagCSSFiles array in the theme.plist, to indicate to RapidWeaver that the colours should be substituted.
###%colour...% eg. %colour_header_background% Each tag used be replaced by a colour specified in the theme.plist There are no restrictions placed on the number of colour tags you can use, and you may also use the same tag multiple times. As noted above, all colourtags need to be placed in a specific stylesheet, and explicitly referenced in your theme’s PLIST.

Rapidweaver 8

The Syntax Tags found in html template files will be replaced with actual content when the page is published or exported by RapidWeaver. The tags can be placed anywhere within the template html file. A RapidWeaver Syntax Tag looks like this:
%content%
For example, this is the tag for the main content of the page anything in the main window in RapidWeaver will be inserted here.
%sidebar%
This tag refers to the Sidebar area in the Page Inspector, again any text or images entered into the Sidebar in RapidWeaver will be converted to HTML and will replace this tag in the template html file.

The %pathto(...)% Tag

All RapidWeaver Syntax Tags, with one exception, look exactly the same. The exception is the %pathto(file.extension)% tag. This tag is used for site consolidation, essentially meaning that RapidWeaver will automatically generate links to files located in the theme folder. When exporting a site RapidWeaver places all of the theme files in a folder called rw_common and gener- ates the links to the files in this folder. This should be used when linking to any file in your theme file including stylesheets, javascript files and images. Examples:Linking to the styles.css file in your theme directory.
%pathto(styles.css)%
the published code will look something like this:
../rw_common/themes/theme_name/styles.css
Folders can be included before the image name eg.
%pathto(images/image_name.jpg)%
The published code will look something like this:
../rw_common/themes/theme_name/images/image_name.jpg



Header Syntax

%header%
This outputs the meta information. It should be placed between the <head> tags in your template file.
%title%
Outputs the title of the current page.
%user_header%
Allows the user to place any custom code into the header of the page.
%style_variations%
Outputs a series of style sheets into the head of the page, as selected by the user via theme styles tab of the Page Inspector.
%user_styles%
Outputs the users custom CSS into the head of the users page.
%user_javascript%
Outputs the users custom javascript code into the head of the users page.
%plugin_header%
Outputs code generated by the selected page type into the header area. Typically it will be javascript and/or css.
%navigation%
Outputs the site navigation as an unordered list. Replaces `%toolbar%`, which is deprecated in RapidWeaver 6.0
%top_navigation%
Outputs an unordered list of just the top-level of the page hierarchy.
%sub_navigation%
Outputs an unordered list of the remaining sub-navigation of the hierarchy, and respects the RWAlwaysDisplayFullNavigation key.

Body Syntax

%site_title%
Outputs the site title.
%site_slogan%
Outputs the site slogan.
%logo%
Outputs a user definable site wide image. This is set via the Site Setup area, and RapidWeaver does not pre-flight the images. Depending on how you’re using this tag, you may want to apply a sensible maximum size for the image via CSS.
%content%
Outputs the content of the current page.
%sidebar_title%
Outputs the sidebar title as entered in the Page Inspector.
%sidebar%
Outputs the sidebar content as entered in the Page Inspector.
%plugin_sidebar%
Outputs content specific to the current page style. For example, the blog archives.
%breadcrumb%
Generates an unordered list of links from the home page to the current page following the menu hierarchy in the Page List.
%footer%
Outputs the site’s footer as entered in the Site Setup area.

Extras

%pathto(file.extension)%
The %pathto()% syntax should be used to refer to any global assets in the theme. This will generate the appropriate relative, absolute or relative to DOCROOT link to the relevant file. Its pri- mary use is to refer to stylesheets and javascript files that are used across the site. %pathto()% can be used for any file (styles.css for example), however the file must be added to the RWCopyFiles array in the theme.plist file.
%base_url%
Outputs the web address of the website, as entered in the Site Setup area.
%last_published%
Outputs the last published date - this is not currently customis- able in its appearance.
%email%
Outputs the user’s e-mail address.

Colourtags

Colourtags allow customers to customise a particular colour value in your theme using the OS X colour picker. The colour values from a colourtag must currently be set via a separate stylesheet (normally called colours.css or colourtags.css) This style sheet must be included in the RWColourTagCSSFiles ar- ray in the theme.plist, to indicate to RapidWeaver that the col- ours should be substituted.
%colour...%
eg. %colour_header_background%Each tag used be replaced by a colour specified in the theme.plist There are no restrictions placed on the number of colour tags you can use, and you may also use the same tag multiple times. As noted above, all colourtags need to be placed in a specific stylesheet, and explicitly referenced in your theme’s PLIST.

Theme Styles: Colour Maths

Colour tags will be replaced by a colour specified in the theme.plist. This should be placed in an external style sheet. The style sheet should be included in the RWColourT- agCSSFiles array in the theme.plist. There is no restriction on how many colour tags you can use. You may also use the same tag multiple times. This tag also supports the Americanized spelling of colour, color. Colour tags support the following mathematical operators: +, – and *.EXAMPLE 1: %COLOUR1 + #112233% EXAMPLE 3: %COLOUR1 * 0.3% EXAMPLE 4: %COLOUR1 + #112233 * 0.3 + #445566% EXAMPLE 5: %COLOUR1 + R(0.9) G(0.1) B(0.5)%
Copy link
On this page
Header Syntax
Navigation Syntax
Body Syntax
Extras
Colourtags
Rapidweaver 8
The %pathto(...)% Tag
Header Syntax
Navigation Syntax
Body Syntax
Extras
Colourtags
Theme Styles: Colour Maths