Create an Article Page
A How-To Recipe
In general, two types of web pages exist. One type is the navigation page. A navigation page contains summary information and links to direct you to a content page. Thus the content page is the second general type of web page.
Many content pages are similar to a chapter in a book, an article in a magazine or a published paper. The content is organized in sections and subsections. Graphics or tables are displayed within the text. And an outline or table-of-contents is supplied.
Figure 1: Look of an Article page
The issue is how to create an article type page within the knowledgeBase.
SQI refers to this type of general content structure as an Article. Tools, in the form of special marcos, are provided and documented in this recipe. These macros make the creation of good looking, consistent article web pages easy. (Note: This page is in Article format.)
Figure 1 shows the structure of an Article page. The top contains distinctively formated title, sub-title, published date and author. The main body has paragraph width of about 11 to 15 words which makes eye movement from line to line easy. And, a right hand column is created for the automatically generated Table of Contents. This column also hosts an “Also See” reference area.
Steps to create a new article page are:
The Article page look is provide by a set of simple marcos each of which is discusses below.
[[ArticleTop]] and [[ArticleBottom()]]
[[ArticleBottom(seePage1, seePage2, seePage3)]]
Article Style Sheet
The look of an Article page is controlled by a CSS style sheet. Display formatting for the above Article tags is defined. The style sheet also provides for redefining standard CKB "markup" notation. For example the ---+ section markup is redefined to have a different font size within an Article and a left hand offset. Thus, using the Article style sheet the look of long text stream pages can be tightly created.
Indexing and Searching
This article focuses on the formation of a page. However, the real goal is to publish and mature the page content so that the right information is available to staff and clients at the moment of need (see Instant Publish / Instant Access). Access to information on the page is enabled by KnowledgeDex – the Enterprise Search technology.
Text on the page created is captured by KnowledgeDex on every indexing cycle. Thus, all new or changed information contained within the page can be accessed by a world class search capability immediately.