Advanced Customizations, Overrides, and Extensions » Advanced Format and Target Customizations » Customizing Page Templates (*.asp) » Page Templates Reference » Namespace and Attributes
Namespace and Attributes
ePublisher defines the namespace: wwpage for page templates as follows:
xmlns:wwpage="urn:WebWorks-Page-Template-Schema"
The following shows the page template attributes that can be used along with their purpose.
 
Attribute
Purpose
wwpage:condition
Controls when elements should be preserved in the generated output.
wwpage:content
Use this attribute to replace the innerHTML or innerXML of an element.
wwpage:replace
Use this attribute to replace the innerHTML/innerXML as well as the outerHTML/outerXML.
wwpage:attribute-<name>
Use this attribute to emit a generated attribute value with name: name. In addition, you can specify a value of either: relative-to-output or copy-relative-to-output or wwsetting:<target-setting-name>. Specifying the value using relative-to-output is useful for file type attributes that require a pathname relative to the parent file. If the copy version is used, it additionally copies the file into the correct location within the generated output directory.
wwpage:NoBreak
Use this attribute to collapse all white space between two elements into nothing.
wwpage:Import
Use this attribute to indicate an that an import operation will take place using one of the *-from-* wwpage attributes.
wwpage:content-from-file
Use this attribute to import the contents of the specified file as the innerHTML of an element.
wwpage:replace-from-file
Use this attribute to import the contents of the specified file as the innerHTML as well as the outerHTML of an element.
wwpage:content-from-lookup
Use this attribute to import the contents of the specified item name generated by ePublisher as the innerHTML of an element.
wwpage:replace-from-lookup
Use this attribute to import the contents of the specified item name generated by ePublisher as the innerHTML as well as the outerHTML of an element.
Note: If you are using wwpage:attribute-<name> to express attribute that uses a namespace of its own, you can use a “-” character in place of the “:” character. For example: wwpage:attribute-xml-lang is used to generate the xml:lang attribute in the output.
The following shows a typical usage of wwpage attributes within a Page.asp or Splash.asp page template.
 
Attribute
Example usage in Page.asp page template
wwpage:condition
<hr wwpage:condition="header-exists" align="left" />
wwpage:content
<title wwpage:content="title">Title</title>
wwpage:replace
<div wwpage:replace="content">Page content.</div>
wwpage:attribute-<name>
<link rel="StyleSheet" href="css/print.css" wwpage:attribute-href="copy-relative-to-output" type="text/css" media="print" />
wwpage:NoBreak
<a href="#">
<wwpage:NoBreak />
<img src="myimage.png">
</a>
wwpage:Import
<wwpage:Import wwpage:replace-from-file="scripts/common.js" />
wwpage:content-from-file
<div wwpage:Import wwpage:content-from-file="scripts/common.js"></div>
wwpage:replace-from-file
<wwpage:Import wwpage:replace-from-file="css/webworks.css" />
wwpage:content-from-lookup
<div wwpage:Import wwpage:content-from-lookup="catalog-css"></div>
wwpage:replace-from-lookup
<wwpage:Import wwpage:replace-from-lookup="catalog-css" />
 
Logical AND/OR/NOT in condition attributes
The wwpage:condition attribute supports both logical AND as well as OR to provide for multiple conditions in a single attribute expression. For a logical AND, use white space as a separator between conditions. For a logical OR, use a single comma as a separator between conditions. The following shows a few simple examples of using multiple conditions:
 
Logic Type
Example
AND (use space)
<hr wwpage:condition=”header-exists company-email-exists” />
OR (use “,”)
<hr wwpage:condition=”header-exists,footer-exists” />
NOT (use “!”)
<hr wwpage:condition=”!header-exists” />
AND with OR and NOT
<hr wwpage:condition=”header-exists company-email-exists,footer-exists !company-email-exists” />
Working with URL and File Paths in Page Templates
The wwpage:attribute-<name> attribute can be used to specify several behaviors when working with URL and File paths. The following shows the list of available modifiers for this wwpage:attribute.
 
Attribute Modifier
Example
relative-to-output
<script type="text/javascript" src="scripts/common.js" wwpage:attribute-src="relative-to-output"></script>
copy-relative-to-output
<script type="text/javascript" src="scripts/common.js" wwpage:attribute-src="copy-relative-to-output"></script>
relative-to-output-root
<script type="text/javascript" src="scripts/common.js" wwpage:attribute-src="relative-to-output-root"></script>
copy-relative-to-output-root
<script type="text/javascript" src="scripts/common.js" wwpage:attribute-src="copy-relative-to-output-root"></script>
absolute-to-output
<external-graphic content-height="scale-to-fit" width="1in" height="1in" src="url('{wwformat:Pages/images/Logo.png}')" wwpage:attribute-src="absolute-to-output" />
resolved-uri
<external-graphic src="url({wwformat:Pages/images/rms_doc_logo.png})" wwpage:attribute-src="resolved-uri" content-width="100px" content-height="100px" left="0pt" top="0pt" />
resolved-path
<external-graphic src="{wwformat:Pages/images/rms_doc_logo.png}" wwpage:attribute-src="resolved-path" content-width="100px" content-height="100px" left="0pt" top="0pt" />
Using Replacement Types ({}) in Page Templates
In page templates, you can use the “{}” characters to indicate a parameter to use in an attribute replacement. The “{}” characters are used to embed a path or parameter within an attribute value. For example, the following is a typical replacement for an HTML img tag, demonstrating how “{}” characters can be used to improve the result of the replacement.
<img src="url('{images/logo.png}')" wwpage:attribute-src="copy-relative-to-output" />.
Was this helpful?
Last modified date: 11/30/2021