Document Presentation and Highlighting

Typically, a query application allows the user to view the documents returned by a query. The user selects a document from the hitlist and then the application presents the document in some form.

With Oracle Text, you can display a document in different ways. For example, you can present documents with query terms highlighted. Highlighted query terms can be either the words of a word query or the themes of an ABOUT query in English.

You can also obtain gist (document summary) and theme information from documents with the CTX_DOC PL/SQL package.

Table 1-1 describes the different output you can obtain and which procedure to use to obtain each type:

Table 1-1

Output	Procedure
Plain text version, no highlights	CTX_DOC.FILTER
HTML version of document, no highlights	CTX_DOC.FILTER
Highlighted document, plain text version	CTX_DOC.MARKUP
Highlighted document, HTML version	CTX_DOC.MARKUP
Highlight offset information for plain text version	CTX_DOC.HIGHLIGHT
Highlight offset information for HTML version	CTX_DOC.HIGHLIGHT
Theme summaries and gist of document.	CTX_DOC.GIST
List of themes in document.	CTX_DOC.THEMES

See Also: Chapter 4, "Document Presentation"

Highlighting Example

Figure 1-5 is a screen shot of a query application presenting a document with the query terms XSQL and Servlet highlighted.

Figure 1-5 Query Application Presenting Highlighted Document

Text description of the illustration fig4.gif

Document List of Themes Example

Figure 1-6 is a screen shot of a query application presenting a list of themes for a document.

Figure 1-6 Query Application Displaying Document Themes

Text description of the illustration fig5.gif

Gist Example

Figure 1-7 is a screen shot of a query application presenting a gist for a document.

Figure 1-7 Query Application Presenting Document Gist

Text description of the illustration fig6.gif