RidgeStar
About
Locations
Manual
Reference
Notices
Email
HTML
Internet
Passwords
Processes
Results Lists
RidgeStar
Tools
Acrobat Reader
Comparators
Compute Age
Date Differences
Dates and Times
Editing Email
Fragment Fields
IP Mapping
Phone Numbers
Text FormatPrevious
Service
Logon
LogonTwitterfindtranslateGoto
Get Started|Calendar|Locations

Reference: Tools-Text Format

The phrase Text FormatTerm is used within a RidgeStar Site to represent a mechanism of encoding text such that it will display with appropriate HTML tags to create a specific layout.

Background

Specification of direct HTML containers has become increasingly complicated as the Internet has moved from the original HTML specification through and to the currently defined XHTML constructs. Most RidgeStar clients do not spend the time necessary to stay fully aware of the implications of getting this correct for display on their site.

As a result, a few clients have managed to embed incorrect html within their Topics or Text boxes and have successfully caused their Sites to generate HTML that cannot be properly formatted. This, obviously, is not a desirable result.

In an effort to address this and, in fact, eliminate the potential for incorrect formatting, RidgeStar provides a Text Formatter that will accept character strings with embedded key sequences and will convert these sequences to the proper levels of XHTML on output to the Browser. Further, even if the RidgeStar Text Format coding is incorrect, it will be handled by the Browser as standard characters. This means that even when making an error in the Text Format coding, the page that is sent to the Browser will not "break"

A Text Format Token

The Text Formatter syntax makes an effort to avoid the necessity of providing what is commonly known as "end tags". Instead, it utilizes a mechanism we call Token based processing. When formatting a string, it is first split into individual words (as delimited by blanks). Each of these elements is considered a Token and any applicable Text Format instructions will apply to the Token (the Formatter automatically inserts the required end tags on the back of the Token).

You can increase the size of a Token (for the purposes of formatting) by replacing embedded blanks with a tilde (~). This causes strings such as "Sample˜Text" to be handled and formatted as it they were a single Token. However, on output the tilde will be converted to a suitable blank. Thus, think of the Tilde as a "place holder" used simply for the purpose of extending a Text Format instruction across words.

Where can the Text Format mechanism be used?

The Text Format mechanism can be utilized in virtually any data field or form field that you will input at a browser and subsequently display the entered data as HTML based text on a site. It is active in the RIdgeStar Topics mechanism, Events entries (e.g. What's New entries), the Forum, etc.). It is also typically active in any TEXTAREA type input boxes (usually represented as a tall wide input form box (such as Notes, Comments, etc.).

What do Text Format strings look like?

Version 4.2 of the Text Formatter accepts and processes the elements, as described below. Some of them are simple to visualize and use, some less so. Don't worry if some of them seem inapplicable to your situation (they probably are). As always, send your questions along to your RidgeStar Account Representative.

Each Text Element is listed by its Common Name, followed by it's technical specification syntax. Variable information is identified within {braces}. FInally, each element below also demonstrates the formatting that would apply to THIS page (remember, it may format differently on another RidgeStar site, dependent upon that site's applicable Style Sheet).

Bold - [b]

Format the Token bold, as defined by the currently applicable Style Sheet.

Sample[b]Text

SampleText

Break - [br]

Create a HTML Break or new line.

Sample[br]Text

Sample
Text

Color - [color]

Permits the formatting of a string utilizing the standard colors; aqua black blue fuchsia gray green lime maroon navy olive orange purple red silver teal white yellow

Change [red]Red to [teal]Teal~for display

Change Red to Teal for display

Email Hyperlink - [email={email}]

Format and display a hyperlinked Email address

[email=webmaster@ridgestar.com]

webmaster@ridgestar.com

Emoticon - [:{emoticon}]

Provides a mechanism to embed smileys or emoticons (as defined at Reference: Internet-Emoticons)

Smile [:smile] and give the go [:ok] sign

Smile smile and give the go ok sign

Function - [display{function}({$object}]

Invoke a Site defined function.

[DisplayUser(1)]

Hyperlink - [http{URL}]

Causes the Text Formatter to change an embedded URL string into a hyperlinked element

Click to [http://www.referees.biz/documentation] for more information

Click to http://www.referees.biz/documentation for more information

Italics - [i]

Format the Token in Italics, as defined by the currently applicable Style Sheet.

Sample [i]Text

Sample Text

Ordered List - [ol]

Format a simple List of Ordered Items

[ol=Point 1;Point 2;Third]

  1. Point 1
  2. Point 2
  3. Third

Paragraph - [p]

Create a new Paragraph, as defined by the currently applicable Style Sheet.

Sample[p]Text

Sample

Text

Registered - [reg]

Create appropriate HTML coding to dislay a Registered symbol

[reg]

®

Site Information - [cla...]

Provides access to Site specific, but common and fixed definitions.

[claSite]

www.RidgeStar.com

Setting - [cso...]

Permits the formatting of Options Settings values (for Sites utilizing the Settings mechanism

[csoDefaultRows]

10

[csoPassword]

40,2 hours,1 year,5 days

[csoPassword][Strength]

40

[csoPassword][]

  • 40
  • 2 hours
  • 1 year
  • 5 days

[csoPassword][*]

  • Strength=>40
  • ResetPeriod=>2 hours
  • Interval=>1 year
  • Warning=>5 days

Subscript - [sub]

Format the Token as a Subscript, as defined by the currently applicable Style Sheet.

Sample[sub]Text

SampleText

Superscript - [sup]

Format the Token as a Superscript, as defined by the currently applicable Style Sheet.

Sample[sup]Text

SampleText

Table Data - [dus...], [dma...], [dfd...], [dlo...]

For those sites utilizing a Users, Matches, Fields, and/or Locations table (respectively), these elements provide access to the data values that are in storage at the time the text string is formatted.

Your first name is [dusFirstName]

Your first name is Joe

Term - [term]

Create a Reference to obtain the PopUp Term widget

[term=Segment]

SegmentTerm

Trademark - [trade]

Create appropriate HTML coding to dislay a Trademark symbol

[trade]

Unordered List - [ul]

Create a List of elements with Unordered designation

[ul=List Item 1;List Item 2;List Item 3]

  • List Item 1
  • List Item 2
  • List Item 3