)Content For Hypertext Only,

SDM2HTM - An SDML to HTML Converter

| [next] [previous][contents]
'

3 - Content For Hypertext Only




<COMMENT>(HTML=)




@To allow the inclusion of text in Hypertext-available documents Honly (i.e. to exclude it from the printed and Bookreader documents) the !following construct is provided: 

  <COMMENT>(HTML=  intervening HTML  )
LThe embedding of the HTML within the comment statement effectively hides it Mfrom processing by DOCUMENT. SDM2HTM will detect it however and outputs the HTML enclosed by the statement.

IThis statement does not appear within the printed or Bookreader document. 

KSelect this link to see how it was produced

    %

<COMMENT>(HTML/POPUP=)



NThis allows a separate section of document to be created that does not appear Oin the flow of current text, but contains a reference (HTML link) that must be /selected, in much the same way as the DOCUMENT <POPUP> Ntag used for online documents. It is implemented by creating a separate HTML file. E

  <COMMENT>(HTML/POPUP=descriptive text appearing in link)  intervening SDML   <COMMENT>(HTML/ENDPOPUP)
LThe embedding of the HTML within the comment statement effectively hides it Mfrom processing by DOCUMENT. SDM2HTM will detect it however and creates the popup HTML. 

6Select the following link for an online demonstration:

7An Online Demonstration

   

Suggestion



NWhen hypertext-only portions of a document contain links to other documents orKonline demonstrations, information documenting this should be placed in anyIprintable/Bookreader versions. This can be accomplished using constructssdescribed in 4 - Content For Printed/Bookreader Only. The essential details arepresented here. 

$For an online demonstration include:

  <COMMENT>(HTML/OFF)6  <P><BOX>(online hypertext demonstration)  <COMMENT>(HTML/ON)


For a reference include:

  <COMMENT>(HTML/OFF)2  <P><BOX>(online hypertext reference)  <COMMENT>(HTML/ON)


/For referenced hypertext documentation include:

  <COMMENT>(HTML/OFF)6  <P><BOX>(online hypertext documentation)  <COMMENT>(HTML/ON)


Etcetera.

Note:

;The <COMMENT>(HTML=...) construct is one of Jthe most likely to cause SDM2HTM buffers to overflow. Be very careful to 9terminate the <COMMENT> statement with a Oclosing parenthesis. If parentheses are included within the HTML they must be Dbalanced, as this is how the end-of-comment is detected. If Oa buffer overflow occurs check the above considerations and if this is not the Jproblem reduce the quantity of HTML within the construct or break it into multiple constructs.
 




| [next] [previous][contents]