%CSP.Documatic

class %CSP.Documatic extends %CSP.Page

This class generates an HTML page that describes the requested class. You can include HTML markup within your descriptions. Note that the description of the class is contained within the <body> element on the page, so your markup should not include the tags <html>, <body>, <head>, <title>, <meta>, or any other tags normally contained within <head>. Also, the class name is displayed as a <h1> heading, so if you use headings, use only <h2> and lower headings.

If you use HTML to enhance the display, take care to follow the HTML standard and insert as little markup as necessary. The class documentation may be viewed on many different browsers. The closer the HTML is to the standard, the better the chance that the information will appear the same on all displays.

Documatic also supports several additional tags (which it converts to standard HTML):

<CLASS>Classname</CLASS> produces a link to the documentation for the given class.
<METHOD>Method</METHOD> produces a link to the given method in the current class.
<PROPERTY>Property</PROPERTY> produces a link to the given property in the current class.
<QUERY>Query</QUERY> produces a link to the given query in the current class.
<PARAMETER>Parameter</PARAMETER> produces a link to the given parameter in the current class.
<EXAMPLE>Set A="Test</EXAMPLE> formats the enclosed text as a formatted code example, which will include syntax colorizing if possible (using %Library.SyntaxColor).
By default, the syntax colorizer treats the example as ObjectScript. To specify another language, include the LANGUAGE attribute. Other languages include SQL, JAVA, and XML. To list the languages currently supported, call the Languages() instance method of %Library.SyntaxColor:
```
  set colorizer=##class(%Library.SyntaxColor).%New()
  set status=colorizer.Languages(.langlist)
  zw langlist
  
```
To suppress syntax colorizing, use <EXAMPLE LANGUAGE=NONE>.

NOTE: You can include the other special tags inside <EXAMPLE>, but other HTML tags are ignored in this context.

Method Inventory

RenderCode()

Parameters

parameter CSPURL = /csp/documatic/%CSP.Documatic.cls;

Inherited description: This parameter is used to make sure that if multiple CSP applications are mapped to the same namespace that the CSP engine can correctly identify which class corresponds with which URL. If 'LockCSPName' is true (the default, defined in the CSP application) then you can only access this page if the url exactly matches this 'CSPURL'. You can set this parameter to "" if you wish to disable this check for this class. This check is applied for all CSP urls (cls/csp/zen).
If this page was compiled from a .csp file, then this parameter is automatically set to contain the url of this file used for compilation.

parameter DEFAULTNS = %SYS;

parameter DOCUMATICCENTRALCSSFILE = https://docs.intersystems.com/irislatest/csp/documatic/classrefstyles.min.css;

parameter DOCUMATICCERTCSS = cert-classrefstyles.css;

parameter DOCUMATICCERTJS = cert-documatic.js;

parameter DOCUMATICDEFAULTJSFILE = https://docs.intersystems.com/irislatest/csp/documatic/documatic.min.js;

parameter DOCUMATICFEEDBACKURL = ../docbook/Doc.Feedback.cls;

parameter DOCUMATICLOCALCSSFILE = classrefstyles.min.css;

parameter DOCUMATICLOCALDEFAULTJS = documatic.min.js;

parameter DOMAIN = %Utility;

Default Localization Domain

parameter EMPTYNS = -EMPTY NAMESPACE-;

parameter URL = %25CSP.Documatic.cls;

Methods

classmethod RenderCode(streamIn As %CharacterStream, lang As %String, Output streamOut As %AbstractStream)

Arguments

streamIn: Stream that contains code to be colorized
lang: Name of the language in which the code is written. If no syntax colorizing is needed, use "NONE"
streamOut: Stream that contains the colorized code, returned as Output

Queries

query DefinedBy(type As %String, member As %String)

Selects ClassName As %String

Arguments

type: Specifies the type of member, e.g., "method"
member: Specifies the name of the member

Return Value

List of class names that define the given member.

query ImplementedBy(type As %String, member As %String)

Selects ClassName As %String

Arguments

type: Specifies the type of member, e.g., "method"
member: Specifies the name of the member

Return Value

List of class names that implement the given member.

query ReferencedBy(refclass As %String)

Selects ClassName As %String, Property As %String

Arguments

refclass: A classname

Return Value

List of class names that have properties of the type of the given class.

%CSP.Documatic

Method Inventory

Parameters

Methods

Arguments

Queries

Arguments

Return Value

Arguments

Return Value

Arguments

Return Value

Inherited Members

Inherited Methods

Subclasses