Chapter 2. Reference For html.xml

Table of Contents

@acronym(ID, [EXPANDED], [ATTRS], [SHOW])
@addFontControls(ID, [PARAMS], [FITMODE], [FILENAMETITLE])
@bodyBegin([ATTRS], [DELAY_HEADER])
@bodyEnd()
@bodyHeader(TYPE, ID, TEXT, [ATTRS])
@bs()
@cautionMessage(TEXT, [Caution Title])
@centerBegin()
@centerEnd()
@claRef(TEXT)
@collapsibleHeaderBegin(ID, [TITLE], [Hn], [INITSTATE], [ImgScale], [ANCHOR])
@collapsibleHeaderEnd()
@collapsibleHeaderBeginXsl(ID, [TITLE], [Hn], [INITSTATE])
@collapsibleHeaderEndXsl()
@cssBottomMargin()
@cssIndentedRegion(COLOR, BACKGROUND_COLOR, BORDER_COLOR, BORDER_WIDTH)
@cssInsetBorderStyle()
@cssLeftMargin()
@cssOutsetBorderStyle()
@cssRightMargin()
@cssTopMargin()
@cvsSourceFile(REL_FILE_PATH, [DISP])
@documentLink(TITLE, URL, [SHOW], [ATTRS])
@dq()
@exampleImage(IMG, [TITLE])
@fileNameFormat(FILENAME, [ATTRS])
@flaggedText([INDICATOR], [COLOR])
@footNoteDomTT(TOOLTIP, SUPER)
@footNoteRef(URL, SUPER)
@footNoteTableBegin()
@footNoteTableEnd()
@footNoteTableRow(ANAME, LABEL, TEXT)
@formBegin(ACTION, [ID], [ATTRS], FORCE_METHOD)
@formEnd()
@formFieldRef(TEXT)
@formRowRef(TEXT)
@headBegin([TITLE], [ADD_STD_INCLUDES], [SOURCE_FILE], [ATTRS], [HTML_ATTRS])
@headEnd()
@htmlAttr(NAME, [VALUE])
@htmlEntity(ENTITY, [TEXT], [ATTR])
@httpdContentType([MIME_TYPE], [RFC_2822_DATE])
@insertExitButtonBlock(ID)
@ipToMapHoverEnhance([IP])
@ipToMapSpan(IP, [ATTRS])
@ipToMapUrl(IP)
@javascript(CODE)
@javascriptButton(CODE, LABEL, [TITLE], [ATTRS])
@javascriptButtonAttr(CODE, LABEL, [TITLE], [ATTRS])
@javascriptBegin()
@javascriptEnd()
@dtm()
@dtmj()
@jsq(TEXT)
@jsqh(TEXT, [COLOR])
@jsdh(TEXT, [COLOR])
@jstc(TEXT, COLOR)
@jsex(TEXT, [COLOR], [ID])
@jsc(TEXT)
@jsw(TEXT)
@jsn(TEXT)
@jsLine1px(TEXT)
@jsSpanClass(TEXT, CLASS)
@jsTabWindow()
@labeledField()
@labeledFieldRight()
@lp()
@manPageButton(PROGRAM, [LABEL], [TITLE], [ATTRS])
@manPageLink(PROGRAM, [LABEL], [PAGESECTION], [MANSECTION])
@meterBar(ID, HEIGHT_PIXELS)
@nbsp()
@noteHeader(TYPE, ID, TEXT)
@noteMessage(TEXT, [Note Title], [Note Title Space], [Fieldset Attrs])
@htmlHeader(TEXT, [HEADERTAG])
@networkInterface(INTERFACE, [SHOW], [ATTRS])
@networkInterfaceImage(INTERFACE, ID)
@newUserIcon(URL, TITLE)
@nstFavIcon([MODE])
@nstLinkHeader([ANAME], [TEXT])
@nstNavLink(URL, IMGSRC, TEXT, [WIDTH], [HEIGHT])
@nstScriptLink(NAME, [TEXT])
@nstScriptUrl(NAME)
@nstScriptsHtmlUrl()
@nstWikiButton(PAGE_NAME, SHOW, ATTRS)
@nstWikiPage(PAGE_NAME, SHOW, ATTRS, CLASS)
@nstWUIHeader([ANAME], [TEXT])
@nstWUILine()
@openNewWindowAttr(URL)
@refButton(TEXT, [URL])
@refInput(TEXT, [URL])
@refKey(TEXT, [URL])
@refPage(TEXT, [URL])
@refValue(TEXT, [URL])
@releaseWUI()
@rp()
@snortNavigation([RETURNLABEL])
@snortNavigationSection([RETURNLABEL])
@snortUscNavigation([RETURNLABEL])
@snortUscNavigationSection([RETURNLABEL])
@sourceFile(ABS_FILE_PATH, [DISP])
@statEntry(FSNAME, [SHOW], [ATTRS])
@stress(TEXT)
@nstproUrl()
@subscriptionLink([LABEL], [ATTRS])
@svnSourceFile(REL_FILE_PATH, [DISP])
@tailLink(FILE, [LINES], [LABEL], [RETURN], [RETURN_LABEL], [TEXT_MODE], [DISPLAY_WIDTH], [LINE_NUMBER])
@tipPara(TEXT, [TIPTITLE])
@thEvenOdd(HEADER, [ATTRIBUTES])
@thEvenOddState()
@thEvenOddToggle()
@tdEvenOdd(DATA, [ATTRIBUTES])
@tdEvenOddState()
@tdEvenOddToggle()
@trEvenOdd(HEADER, DATA, [HEADER_ATTR], [DATA_ATTR])
@trEvenOddH(HEADER, DATA, [HEADER_ATTR], [DATA_ATTR])
@thLabeled(HEADER, [ATTRIBUTES])
@tableLabeledBegin([ATTRIBUTES])
@tableLabeledEnd()
@tdLabeled(DATA, [ATTRIBUTES])
@trLabeled(HEADER, DATA, [HEADER_ATTR], [DATA_ATTR])
@trLabeledH(HEADER, DATA, [HEADER_ATTR], [DATA_ATTR])
@toolTipAttr([TITLE], [WIDTH])
@tableTTBegin()
@tableTTRow(TH_TEXT, TD_TEXT, [TD_TEXT_QUOTE])
@tableTTRowPFont(TH_TEXT, TD_TEXT, [TD_TEXT_QUOTE])
@tableTTEnd()
@ttLine1px(TEXT)
@ttAcronym(ACRONYM)
@ttAction(ACTION, [SINGLE_QUOTE])
@ttCommand(CMD, [AFTER_COLON])
@ttEmphasis(TEXT, [SINGLE_QUOTE])
@ttEmphasisPFont(TEXT, [SINGLE_QUOTE])
@ttNote(TEXT, [SINGLE_QUOTE])
@ttNormal(TEXT, [SINGLE_QUOTE])
@ttNormalPFont(TEXT, [SINGLE_QUOTE])
@ttNormalFFont(TEXT, [SINGLE_QUOTE])
@ttNotePFont(TEXT, [SINGLE_QUOTE])
@ttNav(PAGE)
@ttNST()
@ttSite(SITE)
@ttValue(VALUE, [DOUBLE_QUOTE])
@ttValuePFont(VALUE, [DOUBLE_QUOTE])
@ttValueFFont(VALUE, [DOUBLE_QUOTE])
@ttValueWB(VALUE, [DOUBLE_QUOTE])
@ttCaution(TEXT, [DOUBLE_QUOTE])
@ttWarning(TEXT, [DOUBLE_QUOTE])
@setEvenOddRowLight()
@setEvenOddRowDark()
@versionFancy([VERSION])
@verticalGap()
@verticalGapBig()
@verticalGapSmall()
@tableRowSeparatorGap(COLSPAN, [LINEHEIGHT], [SEPARATORCOLOR], [TEXTLABEL])
@vmwareUrl()
@vmwareLink([TEXT])
@warningMessage(TEXT, [Warning Title])
@wuiButtonSubmit([ID], [LABEL], [TITLE], [ATTRS], [CONFIRM])
@wuiButtonSubmitRandomConfirm([ID], [LABEL], [TITLE], [ATTRS], [RANDOMCONFIRM])
@wuiContinueButton([URL], [LABEL], [HIDDEN], [TITLE], [ATTRS])
@wuiDownloadButton(FILE, [LABEL], [TITLE], [MIMETYPE], [NAME], [BUTTONATTRS])
@wuiExampleLoad(FORM ID, FIELD, LOAD, [DISPLAY], [URL], [TITLE], [VALIDATE])
@wuiExampleAppend(FORM ID, FIELD, APPEND, [DISPLAY], [URL], [TITLE], [VALIDATE])
@wuiExitButtonFields()
@wuiGenerateButton(CMD, FILENAME, LABEL, [MIME], [TITLE])
@wuiHtmlHeader([ANCHOR], [TEXT], [Hn], [ImgScale], [ANCHOR])
@wuiHtmlHeaderXsl([ANCHOR], [TEXT], [Hn])
@wuiHeadIncludes([MODE])
@wuiIframePage(TITLE, URL, SRC, [HEADER])
@wuiIpWizardLink(IP, [LABEL], [RETURN], [TITLE])
@wuiJumpButton(JUMP_TO_URL, RETURN_TO_URL, LABEL, [HIDDEN])
@wuiLinkButton(URL, [LABEL], [ATTRBUTES])
@wuiLinkButtonDark(URL, [LABEL], [ATTRBUTES], [WIDTH])
@wuiInputButton(NAME, [VALUE], [TITLE], [ATTRS])
@wuiInputButtonAttr(NAME, [VALUE], [TITLE], [ATTRS])
@wuiButton(ONCLICKHANDLER, [VALUE], [TITLE], [ATTRS])
@wuiInputCheckbox(NAME, [VALUE], [DISPLAY], [checked], [TITLE])
@wuiInputCheckboxAttr(NAME, [VALUE], [TITLE])
@wuiInputFile(NAME, [SIZE], [ATTRS])
@wuiInputHidden(NAME, VALUE, [ATTRS])
@wuiInputNote(TEXT, [LABEL], LABELWIDTH, TEXTWIDTH)
@wuiInputPassword(NAME, [VALUE], [MAXLENGTH], [SIZE], [TITLE])
@wuiInputPasswordAttr(NAME, [VALUE], [MAXLENGTH], [SIZE], [TITLE], [CLASS])
@wuiInputRadio(NAME, [VALUE], [DISPLAY], [checked], [TITLE])
@wuiInputRadioLabeledRight(NAME, [VALUE], [LABEL], [RATTRS])
@wuiInputRadioAttr(NAME, [VALUE], [TITLE])
@wuiInputRadioText(TEXT, [TITLE], [ATTRS])
@wuiInputReset([LABEL], [TITLE], [ATTRS])
@wuiInputText(NAME, [VALUE], [MAXLENGTH], [SIZE], [TITLE])
@wuiInputTextArea(NAME, [VALUE], [ROWS], [COLS], [TITLE], [CLASS], [ATTRIBUTES])
@wuiInputTextAttr(NAME, [VALUE], [MAXLENGTH], [SIZE], [TITLE], [CLASS])
@wuiOnclickButton(JAVASCRIPT, LABEL, [TITLE], [ATAGATTRS], [STYLEATTRS])
@wuiNavBarBottom(ISO_DISTRO_VER, [SRCNAME], [SRCURL], [XML], [NSTWUIBUILDDATE])
@wuiNavBarTop([NAME_IP], [DATE_TIME], [UP_TIME], [LOAD_AVG], [NOFRAMES_URL], [XML])
@wuiNstScriptButton(SCRIPT_NAME, [TEXT], [TITLE])
@wuiNstScriptLink(SCRIPT_NAME, [TEXT])
@wuiNstScriptRef(SCRIPT_NAME, [TEXT])
@wuiResultCount(COUNT, TYPE, ATTR)
@wuiXButton(XAPP, LABEL, [RETURN], [TITLE], [SYNCKEY], [RETURN_FROM], [RETURN_LABEL], [ATTRS])
@wuiSourceFile(REL_FILE_PATH, [DISP])
@wuiXslProcessButton(XML, XSL, [LABEL], [MIME_TYPE], [TITLE], [FORMATTRS], [XSLTPROC_PARAMS], [BUTTONATTRS])
@wuiXslIframeButton(XML, XSL, [LABEL], [MIME_TYPE], [TITLE], [XSLTPROC_PARAMS], [BUTTONATTRS], [PAGE_TITLE])
@embedYouTube(ID, [WIDTH], [HEIGHT])
@nstFileMgr(PATH, [SHOW])
@nstFileMgrButton(PATH, [SHOW], [ATTRS])
@nstShellRunCommandPlaceholder(ID)
@nstShellRunCommand(CMD, [FILENAMEPREFIX], [ID], [FCPARAMS], [COPARAMS], [PROGRESSTEXT])
@nstShellRunCommandFit(CMD, [FILENAMEPREFIX], [ID], [FCPARAMS], [COPARAMS], [PROGRESSTEXT])
@nstShellRunCommandMulti(JSCMDARRAY, [FILENAMEPREFIX], [ID], [FCPARAMS], [COPARAMS])
@nstShellRunCommandMultiFit(JSCMDARRAY, [FILENAMEPREFIX], [ID], [FCPARAMS], [COPARAMS], [PROGRESSTEXT])
@systemdTable(SERVICES)
@systemdTablePageReload(SERVICES, HREF)
@ipToolsWidget(IPv4ADDRESS, [ATTRS])
@hostNameToolsWidget(HOSTNAME, [ATTRS])
@ipHostNameTW(IPv46ADDRESSORHOSTNAME, [ID], [ATTRS])
@macToolsWidget(MACADDRESS, [ATTRS])
@rfcDataTracker(RFC)

@acronym(ID, [EXPANDED], [ATTRS], [SHOW])

Reference to a acronym.

The following parameters are recognized:

ID

The acronym ID (often the acronym itself) to use.

[EXPANDED]

The expanded version of the acronym (what it stands for).

[ATTRS]

Allows one pass optional attributes to the <acronymn> entity.

[SHOW]

The value to show for the acronym (only needed if ID won't work).

This macro is used to reference a macro defined in: "include/data/acronyms-db.xml". It is typically used in by macros prefixed by "acro" (like @acroCPU()). It is intended to form acronyms which are used throughout the NST documentation. NOTE: One should NOT use this macro directly (update the acronym database which then uses this macro).

Example of using the macro:

@acronym("NST","Network Security Toolkit")

Assuming the com.ccg.macros.at.All class is within your CLASSPATH and the config/html.at macros file has been generated (Hint: run make atmacros in the wui directory), a developer should be able to run the above example by copy/pasting from below:

[root@probe root]# java com.ccg.macros.at.All <<EOF
@include("config/html.at",,"d")

@acronym("NST","Network Security Toolkit")

EOF

This macro is defined as:

<a @htmlAttr("class","acronymLink")
  @htmlAttr("target","_blank")@ifEqual("@param(2)",,"
  @htmlAttr("onmouseover","NstAcro.ttActivate(this, event, '@param(0)', @ifEqual("@param(2)",,"null","'@param(2)'"));")")><acronym @htmlAttr("class","acronymLink")>@fnb("@param(3)","@param(0)")</acronym></a>