Navigational Tags

The navigational tags relate specifically to directional navigation within your web site. They allow you to add features such as page forward and page back between stories, threading across issues within a specific column, page numbering systems, or hybrids of all of the above. See <dpQuery> for examples of site navigation related to suggested links, such as "more by this author", "recently in this column", or "other Jazz reviews".

<dpColumnURL>

D E F I N I T I O N:

The URL of a specific column being built or queried. This is most often used to point to the first story within a column, which may be a dynamic element, depending on your publication.

<dpColumnURL
  column = "this|column|columnID"
>

A T T R I B U T E S:

column="this|column|columnID"

The <dpColumnURL> tag always defaults to the column the story being built or queried is in, which is notated by column="this". If you want to query the beginning of a different column, you can set the column value to a specific column/columnID. Examples:

<dpColumnURL column="this"> - smith.html
<dpColumnURL column="Jeff Smith"> -
<dpColumnURL column="curr"> - curr.html

E X A M P L E S:

<dpColumnURL>	smith.html
<a href="<dpColumnURL column="curr">">Go to the Currents Features</a>	Go to the Currents Features

<dpPageBackURL>

D E F I N I T I O N:

The URL of the previous page from the story currently being built or queried.

<dpPageBackURL>

A T T R I B U T E S:

Not applicable.

E X A M P L E S:

<dpPageBackURL>	mailbag.html
<a href="<dpPageBackURL>"><img src="../images/pageback.gif"></a>
<dpIf <dpPageBackUrl>>   <a href="<dpPageBackURL>"><img src="../images/pageback.gif"></a> </dpIf>

<dpPageForwardURL>

D E F I N I T I O N:

The URL of the next page from the story currently being built or queried. Page sequence is determined by the order of the stories within pagination.

<dpPageForwardURL>

A T T R I B U T E S:

Not applicable.

E X A M P L E S:

<dpPageForwardURL>	skinny.html
<a href="<dpPageForwardURL>">Page Forward</a>	Page Forward
<dpIf <dpPageForwardURL>>   <a href="<dpPageForwardURL>">Page Forward</a> </dpIf>	Page Forward

<dpPageNumber>

D E F I N I T I O N:

The page number of the story currently being built or queried.

<dpPageNumber
  type = "issue|section"
  position = "this|last|first"
  default="default text"
  style="lower|upper|title|spaced|roman|decimal|identifier|
         noHtml|noHtmlStyle|scriptEncode|uriEncode"
  link="on|off"
  start="#p|#s|#w|#c|begin|end|resume"
  stop="#p|#s|#w|#c|begin|end|resume"
  length="#p|#s|#w|#c|begin|end"
>

A T T R I B U T E S:

type="issue|section"

The <dpPageNumber> tag always defaults to issue page numbering, which numbers pages front to back in the issue. An alternate page numbering type, section numbering, is also available. In section numbering each section begins with page 1.

<dpPageNumber type="issue"> - 2
<dpPageNumber type="section"> - 2

position="this|last|first"

The default page position is always the page you are viewing, known as "this". You may also easily access the first and last page of the issue or section, by using the position attribute. This is frequently used in comparison tests to see if you are currently viewing the last page of an issue or section.

<dpPageNumber type="issue" position="this"> - 2
<dpPageNumber type="issue" position="last"> - 39
<dpPageNumber type="section" position="this"> - 2
<dpPageNumber type="section" position="last"> - 8

Please refer to the common attributes page for the common attribute descriptions.

E X A M P L E S:

<dpPageNumber>	2
Page <dpPageNumber type="section">	Page 2
<dpPageNumber style="roman">	II
The last page in this issue is page <dpPageNumber position="last">	The last page in this issue is page 32

<dpSectionURL>

D E F I N I T I O N:

The URL of a specific section being built or queried. This is most often used to point to the first story within a section, which may be a dynamic element, depending on your publication.

<dpSectionURL
  section = "this|section|sectionID"
>

A T T R I B U T E S:

section="this|section|sectionID"

The <dpSectionURL> tag always defaults to the section the story being built or queried is in, which is notated by section="this". If you want to query a the beginning of a different section, you can set the section value to a specific section/sectionID. Examples:

<dpSectionURL section="this"> - mailbag.html
<dpSectionURL section="City Week"> - cw.html
<dpSectionURL section="cityweek"> - cw.html

E X A M P L E S:

<dpSectionURL>	mailbag.html
The first story in this section is <a href="<dpSectionURL>"><dpSectionURL></a>	The first story in this section is mailbag.html
<a href="<dpSectionURL section="music">">Go to the Music Section</a>	Go to the Music Section
<a href="<dpSectionURL section="Currents">">Currents</a> . <a href="<dpSectionURL section="Music">">Music</a> . <a href="<dpSectionURL section="Cinema">">Cinema</a> . <a href="<dpSectionURL section="Books">">Books</a> . <a href="<dpSectionURL section="Review">">Review</a> . <a href="<dpSectionURL section="City Week">">City Week</a>	Currents . Music . Cinema . Books . Review . City Week

<dpThreadBackURL>

D E F I N I T I O N:

The URL of the previous story in this column's sequence.

<dpThreadBackURL>

A T T R I B U T E S:

Not applicable.

E X A M P L E S:

<dpThreadBackURL>	../1999-05-07/smith.html
<a href="<dpThreadBackURL>">Previously in this column</a>	Previously in this column
<dpIf <dpThreadBackURL>>   <a href="<dpThreadBackURL>">Previously in this column (error checked)</a> </dpIf>	Previously in this column (error checked)

Home: Support: Reference Guide: Navigational Tags

Questions? Comments? Please write support@desert.net.