home *** CD-ROM | disk | FTP | other *** search
/ Dynamic HTML in Action / Dynamicke-HTML-v-akci-covermount.bin / XML / PARSER / XMLINST.EXE / viewer / long.xml < prev    next >
Encoding:
Extensible Markup Language  |  1998-05-29  |  34.3 KB  |  713 lines
  1. <?xml version="1.0" ?>
  2. <!DOCTYPE doc 
  3. [ 
  4. <!ELEMENT doc (titlegrp, prolog, chp*)>
  5. <!ATTLIST doc docid ID #REQUIRED>
  6.  
  7. <!ELEMENT titlegrp (title+)>
  8. <!ELEMENT title (#PCDATA)>
  9.  
  10. <!ELEMENT prolog (standard,pubby,version,trade,notice)>
  11. <!ELEMENT standard (p*)>
  12. <!ELEMENT pubby (p*)>
  13. <!ELEMENT version (p*)>
  14. <!ELEMENT trade (p*)>
  15. <!ELEMENT notice (p*)>
  16. <!ELEMENT p (#PCDATA | scp | b)*>
  17. <!ELEMENT b (#PCDATA)>
  18. <!ELEMENT scp (#PCDATA )>
  19.  
  20. <!NOTATION GIF SYSTEM "\\iso-gif-89">
  21. <!ENTITY aboutgif SYSTEM "about.gif" NDATA GIF>
  22. <!ENTITY aboutweb '<xref LINKEND="about.web">About the web manager</xref>'>
  23. <!ENTITY after SYSTEM "after.gif" NDATA GIF>
  24. <!ENTITY anchor '<xref LINKEND="ab.anchors">About anchors</xref>'>
  25. <!ENTITY annot-cr '<xref LINKEND="cre.anbs">Creating annotations and bookmarks</xref>'
  26. >
  27. <!ENTITY annotbut SYSTEM "annotbut.gif" NDATA GIF>
  28. <!ENTITY annots '<xref LINKEND="use.pwebs">Using personal webs</xref>'>
  29. <!ENTITY attrib SYSTEM "attrib.gif" NDATA GIF>
  30. <!ENTITY backtrck SYSTEM "backtrck.gif" NDATA GIF>
  31. <!ENTITY beglink SYSTEM "beglink.gif" NDATA GIF>
  32. <!ENTITY bigstyle SYSTEM "bigstyle.gif" NDATA GIF>
  33. <!ENTITY cond-tbl SYSTEM "cond.tbl">
  34. <!ENTITY conlink SYSTEM "conlink.gif" NDATA GIF>
  35. <!ENTITY cont '<xref LINKEND="cont.propop">Content property options</xref>'>
  36. <!ENTITY control '<xref LINKEND="cont.styshtsel">Controlling style sheet selection</xref>'
  37. >
  38. <!ENTITY copysel SYSTEM "copysel.gif" NDATA GIF>
  39. <!ENTITY custom '<xref LINKEND="cust.webi">Customizing web icons</xref>'>
  40. <!ENTITY remove '<xref LINKEND="del.webit">Removing web items</xref>'>
  41. <!ENTITY density SYSTEM "density.gif" NDATA GIF>
  42. <!ENTITY edit-men '<xref LINKEND="edit.men">Using the Edit menu items</xref>'>
  43. <!ENTITY enturl "http://www.sgmlopen.org/sgml/docs/general/entity.htm">
  44. <!ENTITY fileprep '<xref LINKEND="prep.sgmlfls">Preparing your SGML</xref>'>
  45. <!ENTITY follow SYSTEM "follow.gif" NDATA GIF>
  46. <!ENTITY forward SYSTEM "forward.gif" NDATA GIF>
  47. <!ENTITY graphics '<xref LINKEND="disp.gra">Displaying graphics</xref>'>
  48. <!ENTITY hotspot SYSTEM "hotspot.gif" NDATA GIF>
  49. <!ENTITY icons SYSTEM "icons.gif" NDATA GIF>
  50. <!ENTITY id-wout '<xref LINKEND="fls.wopubind">For files without public identifiers</xref>'
  51. >
  52. <!ENTITY ilinkfol '<xref LINKEND="foll.links">Following links</xref>'>
  53. <!ENTITY kbd-tbl SYSTEM "kbd.tbl" >
  54. <!--<!ENTITY main SYSTEM "main.gif" NDATA GIF>-->
  55. <!ENTITY mntpwebs '<xref LINKEND="mount.pwebs">Mounting and dismounting personal webs</xref>'
  56. >
  57. <!ENTITY nav-cr '<xref LINKEND="creed.navs">Creating and editing navigators</xref>'>
  58. <!ENTITY nav-ed '<xref LINKEND="ed.navs">Creating and editing navigators</xref>'>
  59. <!ENTITY nav-tbl SYSTEM "nav.tbl" >
  60. <!ENTITY navedit SYSTEM "navedit.gif" NDATA GIF>
  61. <!ENTITY navig '<xref LINKEND="use.navs">Using navigators</xref>'>
  62. <!ENTITY note '<xref LINKEND="use.note">Using Notations</xref>'>
  63. <!ENTITY note.gif SYSTEM "note.gif" NDATA GIF>
  64. <!ENTITY occdens '<xref LINKEND="use.occdens">Using the occurrence density display</xref>'
  65. >
  66. <!ENTITY open '<xref LINKEND="open.doc">Opening a document</xref>'>
  67. <!ENTITY openfile SYSTEM "openfile.gif" NDATA GIF>
  68. <!ENTITY openurl SYSTEM "openurl.gif" NDATA GIF>
  69. <!ENTITY p "Panorama PRO">
  70. <!ENTITY platform "Windows">
  71. <!ENTITY print '<xref LINKEND="prntg">Printing</xref>'>
  72. <!ENTITY print2 SYSTEM "print.gif" NDATA GIF>
  73. <!ENTITY printdoc SYSTEM "printdoc.gif" NDATA GIF>
  74. <!ENTITY prntport '<xref LINKEND="prntg.por">Printing portions of a document</xref>'>
  75. <!ENTITY propset '<xref LINKEND="op.propset">Options for property settings</xref>'>
  76. <!ENTITY pub '<xref LINKEND="pub.proc">The publishing process</xref>'>
  77. <!ENTITY pub-tbl SYSTEM "pub.tbl" >
  78. <!ENTITY qual '<xref LINKEND="qual.style">Qualifying styles</xref>'>
  79. <!ENTITY query '<xref LINKEND="query.langsyn">Query language syntax</xref>'>
  80. <!ENTITY search '<xref LINKEND="search.doc">Searching a document</xref>'>
  81. <!ENTITY search2 SYSTEM "search.gif" NDATA GIF>
  82. <!ENTITY selec '<xref LINKEND="select.style">Selecting a style sheet</xref>'>
  83. <!ENTITY setup '<xref LINKEND="set.asfls">Setting up auxiliary files</xref>'>
  84. <!ENTITY sgmlconf '<xref LINKEND="sgml.conf">SGML conformance</xref>'>
  85. <!ENTITY showtag SYSTEM "showtag.gif" NDATA GIF>
  86. <!ENTITY sp "Panorama">
  87. <!ENTITY specalt '<xref LINKEND="spec.altstysht.navs">Specifying an alternative style sheet for navigator</xref>'
  88. >
  89. <!ENTITY srchbwd SYSTEM "srchbwd.gif" NDATA GIF>
  90. <!ENTITY srchfwd SYSTEM "srchfwd.gif" NDATA GIF>
  91. <!ENTITY srchres '<xref LINKEND="use.srchres">Using the results of a search</xref>'>
  92. <!ENTITY srchsyn '<xref LINKEND="search.syn">Search string syntax</xref>'>
  93. <!ENTITY start '<xref LINKEND="get.start">Getting started</xref>'>
  94. <!ENTITY style '<xref LINKEND="creed.styshts">Creating and editing style sheets</xref>'
  95. >
  96. <!ENTITY style2 SYSTEM "style.gif" NDATA GIF>
  97. <!ENTITY tbsearch SYSTEM "tbsearch.gif" NDATA GIF>
  98. <!ENTITY tree '<xref LINKEND="use.sgmltree">Using the SGML Tree</xref>'>
  99. <!ENTITY tree2 SYSTEM "tree.gif" NDATA GIF>
  100. <!ENTITY viewsgml  '<xref LINKEND="view.sgml">Viewing the SGML</xref>'>
  101. <!ENTITY web "web">
  102. <!ENTITY web-cr '<xref LINKEND="cre.pwebs">Creating personal webs</xref>'>
  103. <!ENTITY web-ed '<xref LINKEND="ed.webit">Editing web items</xref>'>
  104. <!ENTITY webman SYSTEM "webman.gif" NDATA GIF>
  105. <!ENTITY xyz "">
  106. <!ENTITY zoom SYSTEM "zoom.gif" NDATA GIF>
  107. <!ENTITY copy "⌐ 1997 Microsoft Corporation. All rights reserved.">
  108. <!ENTITY ndash "--">
  109. <!ENTITY trade "<sup>TM</sup>">
  110. ]>
  111. <!--Copyright 1995 SoftQuad Inc.--><!--@(#)panoman.sgm.free    1.1 95/06/22-->
  112. <doc docid="PANORAMA"><titlegrp>
  113. <title>&sp; Guide</title>
  114. </titlegrp>
  115. <prolog>
  116. <standard><p><b>Standard Identification</b></p><p>SoftQuad
  117. &sp; is an <scp>SGML</scp>
  118. System Conforming to International Standard
  119. <scp>ISO 8879</scp> & Standard Generalized Markup Language.</p></standard><pubby><p><b>Published by</b></p><p>SoftQuad Inc.</p><p><scp>56</scp> Aberfoyle
  120. Crescent</p><p>Toronto, Canada <scp>M8X 2W4</scp></p><p>Telephone:
  121. <scp>(416) 239-4801</scp></p><p>Fax:
  122. <scp>(416) 239-7105</scp></p><p>General enquiries: panorama@sq.com</p><p><scp>WWW</scp>:
  123. <url>http://www.sq.com/</url></p></pubby>
  124. <version>
  125. <p><b>Document version</b></p><p>SoftQuad
  126. Panorama for Microsoft
  127. Windows</p><p>First Edition
  128. (June <scp>1995</scp>)</p><p><scp>ISBN 1-896172-20-2</scp></p><p>SoftQuad
  129. Inc. makes no warranty of
  130. any kind with respect to the completeness or accuracy of this
  131. book. SoftQuad may make improvements and/or changes to the
  132. product(s) and/or programs described in this book at any time
  133. and without notice.</p></version>
  134. <trade>
  135. <p><b>Copyrights and Trademarks</b></p><p>© <scp>1995</scp> SoftQuad Inc. All rights reserved.</p><p>©
  136. <scp>1995</scp> Synex Information <scp>AB</scp>.
  137. All rights reserved.</p><p>No
  138. part of this book may be reproduced, stored in a
  139. retrieval system, or transmitted in any form or by any
  140. means –
  141. electronic, mechanical, recording, orotherwise –
  142. without the prior written consent of the publisher,
  143. excepting brief quotes used in connection with reviews
  144. written specifically for inclusion in a magazine or
  145. newspaper.</p><p>SoftQuad
  146. &sp; and
  147. SoftQuad Author/Editor are trademarks of SoftQuad Inc.</p><p>Microsoft
  148. Windows™ is a trademark of Microsoft Corporation.</p></trade>
  149. <notice>
  150. <p><b>Notice</b></p><p>Agencies of the United States Government please note:</p><p><scp>RESTRICTED RIGHTS LEGEND</scp>: Use, duplication,
  151. or disclosure by
  152. the Government is subject to restrictions as set forth in
  153. subparagraph
  154. (c)(<scp>1</scp>)(ii) of the Rights in Technical
  155. Data and Computer Software clause at
  156. <scp>DFARS</scp> <scp>52.227-7013</scp> and in similar
  157. clauses in the <scp>FAR</scp> and <scp>NASA</scp> <scp>FAR</scp>
  158. Supplement.</p>
  159. </notice></prolog>
  160.  
  161. <chp id="c-get"><ct id="get.start">Getting started</ct>
  162. <idx entry="getting started"/>
  163. <p>When &sp; opens a document it also (in most cases) opens other auxiliary
  164. files.<l1>
  165. <li><p>It opens files that determine how the parts of the document are
  166. displayed (for example, titles are
  167. <scp>14</scp> point Arial, text is <scp>12</scp> point Times Roman): these are
  168. called
  169. <e1>style sheets</e1>. How to use style sheets is explained in &selec;.
  170. </p></li>
  171. <idx entry="introduction" parent="navigator"/>
  172. <li><p>It opens files that provide selective outlines of the document, such as
  173. a table of contents: these are called
  174. <e1>navigators</e1>. Navigators are displayed to the left of the document, in
  175. the navigator window.
  176. How to use navigators is explained in &navig;.
  177. </p></li></l1></p>
  178. <sec id="s-user"><st>About the &sp;
  179.  user interface</st>
  180. <idx entry="user interface"/><!--<FIG FILENAME="main"></FIG>-->
  181. <p>The &sp; user interface consists of the following items.</p>
  182. <randlist><li><p>A <e1>main menu</e1> and, below it, a
  183. <e1>toolbar</e1> containing icons for commonly used commands. (You can turn off
  184. the display of the toolbar with the
  185. <menu>Options</menu> menu.)</p></li>
  186. <idx entry="status bar, location of"/>
  187. <li><p>A <e1>status bar</e1> that echoes application activities and displays
  188. the name of the
  189. <scp>SGML</scp> file opened. (You can turn off the display of the status bar
  190. with the
  191. <menu>Options</menu> menu.)</p></li>
  192. <li><p>A <e1>pop-up menu</e1> that you invoke with the
  193.  
  194.  the contents of the menu depend on the location of the
  195. cursor.</p></li>
  196. <idx entry="window" parent="navigator"/>
  197. <li><p>A <e1>navigator window</e1> that shows a selective outline of the open
  198. document.</p></li>
  199. <idx entry="document window"/>
  200. <li><p>A <e1>document window</e1> that displays the contents of the open
  201. document, using the specifications recorded in a style sheet.</p></li></randlist>
  202. <ss1 id="s1-adjust"><st>Adjusting
  203. windows</st></ss1>
  204. <idx entry="adjusting windows"/>
  205. <idx entry="windows, adjusting"/>
  206. <idx entry="None" parent="Navigator menu"/>
  207. <p>Drag the bar dividing these windows to adjust their size relative to each
  208. other. To hide the navigator and show just the document window, choose
  209. <menuitem>None</menuitem> from the<menu> Navigator</menu> menu.</p>
  210. <ss1 id="s1-opt"><st>Options menu</st>
  211. <idx entry="options stored in" parent="panorama.ini"/>
  212. <idx entry="where choices are stored" parent="options menu"/>
  213. <p>The <menu>Options</menu> menu groups a number of settings that control the
  214. display, such as whether to show the toolbar and status bar. You toggle these
  215. settings on and off.</p>
  216. <p>The options are automatically saved between sessions, and are stored in the
  217. settings file
  218. <file>panorama.ini</file> in the main Windows directory (usually <file>c:\windows</file>).</p></ss1></sec>
  219. <sec id="s-web"><st>Selecting a web browser</st>
  220. <idx entry="web browser" parent="selecting"/>
  221. <idx entry="web browser, selecting"/>
  222. <idx entry="Mosaic" parent="Options menu"/>
  223. <idx entry="Mosaic"/>
  224. <p>Choose your web browser from the
  225. <menuitem>Mosaic</menuitem> item on the <menu>
  226. Options</menu> menu. If you do not have access to a web browser, choose
  227. <menuitem>
  228. None</menuitem>. If you choose
  229. <menuitem>None</menuitem>, you are only able to view local files.</p></sec>
  230. <sec id="s-open"><st id="open.doc">Opening a document</st>
  231. <p>Whether you are opening a <scp>URL</scp> from within &sp; or through your web browser, &sp; does not simply open the
  232. <scp>SGML</scp>: it formats it for display.</p>
  233. <p>This means it must open additional files so it can apply style sheets (which
  234. control how the document looks) and navigators (which control how you navigate
  235. through the document).
  236. </p>
  237. <p>When a document is opened, files are accessed to accomplish the following
  238. tasks:<seqlist>
  239. <li><p>Locate the <scp>DTD</scp>.</p></li>
  240. <li><p>Identify verbatim elements (that is, elements to be displayed
  241. line-for-line, preserving white space from the original file).</p></li>
  242. <li><p>Use the <scp>DTD</scp>.</p></li>
  243. <li><p>Find the style sheets to be used for this <scp>DTD</scp>.</p></li>
  244. <li><p>Find the navigators to be used for this <scp>DTD</scp>.</p></li></seqlist></p>
  245. </sec>
  246.  
  247. <sec id="s-flick"><st>Preventing
  248. flicker</st>
  249. <idx entry="preventing flicker"/>
  250. <idx entry="flicker, preventing"/>
  251. <idx entry="Prevent Flicker" parent="Options menu"/>
  252. <p>The <menuitem>Prevent Flicker</menuitem> option from the <menu>Options</menu>
  253. menu provides an alternative to drawing directly onto the screen, which may
  254. create a noticable flicker on slower systems. Check this option to have the
  255. screen contents first created in an off-screen buffer (in
  256. <scp>RAM</scp>), then copied onto the window. This requires more application
  257. memory but seems faster than the alternative method.</p></sec></chp>
  258. <chp id="c-use"><ct>Using document
  259. access features</ct>
  260. <p>While browsing documents with &sp; , you can
  261. choose to scroll to a specific part of a document using the navigator, or search
  262. for text in or out of a specific context.</p>
  263. <sec id="s-usenav"><st id="use.navs">Using navigators</st>
  264. <idx entry="using" parent="navigator"/>
  265. <idx entry="navigator" parent="using"/>
  266. <p>A navigator lists parts of a document, possibly in a hierarchical view. For
  267. example, a navigator could display a table of contents, showing chapters, their
  268. individual sections, and the headings within those sections. The words in the
  269. navigator are extracted from the text. Other possible navigators are a list of
  270. figures or a display of all the illustrations in a document.</p>
  271. <idx entry="displaying sub-entries" parent="navigator"/>
  272. <p>To scroll to a specific part of the document, simply click on the entry in
  273. the navigator window and the document window scrolls to that location. Click the
  274. icon preceding the entry to reveal or hide entries nested beneath it. An
  275. <e1>arrow</e1> points to your current location.</p>
  276. <idx entry="selecting" parent="navigator"/>
  277. <idx entry="list of navigators" parent="Navigator menu"/>
  278. <p>The navigators available for the document you are browsing are listed in the
  279. <menu>Navigator</menu> menu. The current navigator has a checkmark. Select the
  280. navigator you want to use.</p>
  281. </sec>
  282. <sec id="s-search"><st id="search.doc">Searching a document</st>
  283. <idx entry="searching" parent="document"/>
  284. <idx entry="document" parent="searching"/>
  285. <p>&sp; offers two types of searches:<randlist>
  286. <li><p>Searches for all occurrences of a string in the document (<e1>full
  287. text searches</e1>).<idx entry="fulltext search"/></p></li>
  288. <li><p>Searches for all occurrences of a string within all occurrences of a
  289. particular element (<e1>context searches</e1>).<idx entry="context searches"/></p></li></randlist>Both
  290. are invoked in the same way.</p>
  291. <ss1 id="s1-start"><st>Starting a search</st>
  292. <idx entry="Search" parent="Edit menu"/>
  293. <idx entry="Search"/>
  294. <p><cmd><li><p>From the <menu>Edit</menu> menu, choose <menu>Search</menu>
  295. or click <fig filename="tbsearch" position="INLINE"></fig>.</p></li></cmd></p>
  296.  
  297. <p>The <systext>Search</systext> dialog appears.</p>
  298. <fig filename="search2"></fig><!--case sensitive in search -->
  299. <hotspot id="ID11.SPOT" graphic="search2" rx="154" ry="919" rw="534" rh="273"/><!--arrow ?down in Search -->
  300. <hotspot id="ID10.SPOT" graphic="search2" rx="1803" ry="609" rw="116" rh="322"/>
  301. <cmd><li><p>Type your search string. (See &srchsyn;.)</p></li></cmd>
  302. <p>or</p>
  303. <cmd><li><p>Click the <xref linkend="ID10.SPOT">arrow</xref> to display the last eight search strings in this
  304. session and select one.</p></li></cmd>
  305. <p>and</p>
  306. <cmd><li><p>If desired, select <systext linkend="ID11.SPOT">Case Sensitive</systext>.</p></li></cmd></ss1>
  307. <ss1 id="s1-string"><st id="search.syn">Search string syntax</st>
  308. <idx entry="search string, syntax"/>
  309. <idx entry="string syntax for" parent="searching"/>
  310. <idx entry="of search strings" parent="syntax"/>
  311. <p>The syntax you use for string searches depends on the type of search you
  312. want to perform.</p>
  313. <ss2 id="s2-syn"><st>Syntax for full text
  314. searches</st>
  315. <idx entry="fulltext" parent="searching"/>
  316. <idx entry="fulltext search"/>
  317. <idx entry="keywords for searching"/>
  318. <idx entry="keywords for" parent="searching"/>
  319. <p>For full text searches, simply type the characters for which you want to
  320. search, choose whether or not the search should be case sensitive, and click
  321. <button>OK</button>. The only exception is if you are searching for text that
  322. is also a keyword for context searches: `in', `or', `cont', or `and'. You need
  323. to surround these characters with quotation marks
  324. so &sp; does
  325. not interpret them as keywords.</p>
  326. <p>For information on using the result of the search, see &srchres;.</p></ss2>
  327. <ss2 id="s2-syn2"><st>Syntax for context
  328. searches</st>
  329. <idx entry="syntax for" parent="context searches"/>
  330. <idx entry="query language for context searches"/>
  331. <idx entry="query language for" parent="context searches"/>
  332. <p>Context searches help you narrow your search criteria. For example, you
  333. might want to search for a word only if it appears in a bibliography, not when
  334. mentioned in the body of the document. To perform a context search, you need to
  335. know the names of the
  336. <scp>SGML</scp> elements. (For help in determining names, use the <menuitem>Show
  337. Tags</menuitem> option from the
  338. <menu>Options</menu> menu, or the <scp>SGML</scp> Tree, as described in
  339. &viewsgml;.)</p>
  340. <p>To restrict searches to a specific element, type the characters, followed by
  341. the keyword `in', followed by the element name, enclosed by angle brackets. For
  342. example: <systext>ignition in <ST></systext> searches for all occurrences of
  343. the word `ignition' within the element called
  344. <markup>ST</markup>.</p>
  345. <idx entry="examples of" parent="context searches"/>
  346. <p>The formal syntax is shown in &query;. Here are some examples of the kind of
  347. searches this language allows.<randlist>
  348. <li><p><systext><title> in (<chapter> or <section>)</systext> finds
  349. all titles within chapters or sections.</p></li>
  350. <li><p><systext>John Doe in <footnote></systext> finds the string `John
  351. Doe' in footnotes.</p></li>
  352. <li><p><systext><p> cont <footnote></systext> finds all
  353. <markup>P</markup> elements that contain one or more
  354. <markup>footnote</markup> elements.</p></li>
  355. <li><p><systext>John Doe in <person type=programmer></systext> finds the
  356. string `John Doe' in
  357. <markup>person</markup> elements where the attribute
  358. <markup>type</markup> has the value `programmer'.</p></li>
  359. <li><p><systext>John Doe in <person type=programmer compiler=borland></systext>
  360. finds the string `John Doe' only in person elements where the
  361. <markup>type</markup> attribute is `programmer' and the
  362. <markup>compiler</markup> attribute is `borland'.</p></li>
  363. <li><p><systext>(<P> cont physical) and (<P> cont education)</systext>
  364. finds all <markup>
  365. P</markup> elements containing both the words `physical' and `education'.</p></li></randlist></p></ss2></ss1>
  366. <ss1 id="s1-result"><st id="use.srchres">Using the results of a search</st>
  367. <idx entry="results of" parent="searching"/>
  368. <idx entry="results of search"/>
  369. <p>Each item found that matches the specifications is called a <e1>hit</e1>.
  370. No matter what kind of search you do, if hits are made:<l1>
  371. <li><p>The search dialog disappears.</p></li>
  372. <li><p>The document window moves the line containing the first hit (relative
  373. to your current location) to the top of the window.</p></li>
  374. <li><p>All occurrences of the specified string are highlighted in the
  375. document.</p></li>
  376. <li><p>The right corner of the status bar, if showing, displays the number of
  377. hits.</p></li>
  378. <li><p>If more than one hit is found, and if the correct <menu>Options</menu>
  379. menu item is checked, an
  380. <e1>occurrence density display</e1> appears to the left of the scroll bar. (See
  381. the next section for details.)</p></li>
  382. <li><p>If more than one hit is found, the previously dimmed toolbar icons and
  383. menu items in the
  384. <menu>Edit</menu> menu are now available. (See &edit-men; for details.)</p></li></l1></p>
  385. <!--<FIG FILENAME="after"></FIG>-->
  386. <ss2 id="s2-occ"><st id="use.occdens">Using the occurrence density display</st>
  387. <idx entry="occurrence density display"/>
  388. <p>The density display bar gives an overview of the search hits in the
  389. document. It looks like a scroll bar and is shown at the right of the document
  390. window. Its horizontal lines show the search hits.</p>
  391. <p>The density display bar represents the whole document. The portion of the
  392. document that is visible in the document window is represented by a darker <xref linkend="ID12.SPOT">grey
  393. shadow</xref> on the density display bar; the hits that are currently visible in the
  394. document window are shown as white lines.</p>
  395. <fig filename="density"></fig><!-- grey in density fig -->
  396. <hotspot id="ID12.SPOT" graphic="density" rx="422" ry="446" rw="1175" rh="241"/>
  397. <p>When the cursor is above the density display bar, it changes to a magnifying
  398. glass, indicating that you can `zoom' in on the portion of interest.</p>
  399. <p>To scroll the document window to the location of one of the hits:<cmd>
  400. <li><p>Click on the horizontal line representing that hit in the density
  401. display bar.</p></li></cmd>If the hit is already visible, the document window
  402. does not scroll.</p>
  403. <p>The size of the shadow that represents the visible portion of the document
  404. varies according to how much of the document's
  405. <scp>ASCII</scp> content is visible. If the document window contains dense
  406. text, the shadow will be comparatively long. If it contains many large figures,
  407. the shadow will be very short.</p></ss2>
  408. <ss2 id="s2-edit"><st id="edit.men">Using the Edit menu items</st>
  409. <idx entry="First" parent="Edit menu"/>
  410. <idx entry="First"/>
  411. <idx entry="Previous" parent="Edit menu"/>
  412. <idx entry="Previous"/>
  413. <idx entry="Next" parent="Edit menu"/>
  414. <idx entry="Next"/>
  415. <idx entry="Last" parent="Edit menu"/>
  416. <idx entry="Last"/>
  417. <p>The following commands in the
  418. <menu>Edit</menu> menu let you move through your hits:</p>
  419. <l3><li><p><menuitem>First</menuitem>: Scrolls the window to the first hit
  420. in the document.</p></li>
  421. <li><p><menuitem>Previous</menuitem>: Scrolls the window to the previous
  422. undisplayed hit in the document.</p></li>
  423. <li><p><menuitem>Next</menuitem>: Scrolls the window to the next undisplayed
  424. hit in the document.</p></li>
  425. <li><p><menuitem>Last</menuitem>: Scrolls the window to the last hit in the
  426. document.</p></li></l3></ss2></ss1></sec></chp>
  427. <chp id="c-view"><ct id="view.sgml">Viewing the SGML</ct>
  428. <p>&sp; lets you reveal the tags used in the
  429. <scp>
  430. SGML</scp> file. You can also look at the underlying
  431. <scp>SGML</scp> structure of a document, using it to move through the document.
  432. If you are new to
  433. <scp>SGML</scp>, you may find these features particularly useful.</p>
  434. <sec id="s-tree"><st id="use.sgmltree">Using the SGML Tree</st>
  435. <idx entry="using" parent="SGML Tree"/>
  436. <idx entry="tree navigator" xref="SGML Tree"/>
  437. <idx entry="SGML Tree" parent="Navigator menu"/>
  438. <p>One of the options available from the
  439. <menu>Navigator</menu> menu is <menuitem>
  440. SGML Tree</menuitem>. This replaces the current navigator with a tree showing
  441. the structure of the document. This tree can be quite large, so you may want to
  442. increase the size of the navigator window (by dragging the separator bar) to
  443. accommodate it. You can use scroll bars to scroll through the tree or hold the left mouse
  444. button down and drag the tree image in the window.</p>
  445. <p>Just as with a regular navigator, you can click on any element bar to scroll
  446. the document window to its location. The element's content is highlighted in the
  447. document window.</p>
  448. <fig filename="tree2"></fig><!-- double box in tree-->
  449. <hotspot id="ID13.SPOT" graphic="tree2" rx="410" ry="595" rw="443" rh="309"/>
  450. <idx entry="attribute values, viewing"/>
  451. <idx entry="viewing, attributes"/>
  452. <p>A <xref linkend="ID13.SPOT">double box</xref> around an element indicates that this occurrence of the element
  453. has attribute values. To see the attribute values:
  454. <cmd>
  455. <li><p>Click the element box with the right mouse button and choose <menuitem>Attributes</menuitem>
  456. from the pop-up menu.</p></li></cmd>The
  457. <systext>Attributes</systext> dialog shows the attributes of this element
  458. instance: both values (on the left) and how the element's attributes are
  459. declared in the
  460. <scp>DTD</scp> (on the right). If the value is displayed as
  461. <menuitem><IMPLIED></menuitem>, the attribute has not been assigned a
  462. value.</p><fig filename="attrib"></fig><idx entry="Attributes" parent="pop-up menu"/>
  463. <idx entry="Attributes"/>
  464. <p>To display or hide sub-elements:</p>
  465. <cmd><li><p>Click the left part of an element's box to reveal or hide
  466. elements nested beneath it.</p></li></cmd>
  467. <p>or</p>
  468. <cmd><li><p>Click the top-most element to collapse the tree and show only the
  469. highest level element.</p></li></cmd>
  470. <p><idx entry="finding a location in" parent="SGML Tree"/>
  471. <idx entry="finding a location in SGML tree"/>
  472. <idx entry="Locate in SGML Tree"/>
  473. <idx entry="Locate in SGML Tree" parent="pop-up menu"/>While in the document window, you can use the
  474. <scp>SGML</scp> tree to find where selected content appears in the document's
  475. structure. Click the right mouse button on the content and choose
  476. <menuitem>Locate in SGML Tree</menuitem> from the pop-up menu. If the <scp>SGML</scp>
  477. tree is not currently displayed, it appears, highlighting the box containing
  478. that content.</p></sec>
  479. <sec id="s-tags"><st>Showing tags</st>
  480. <idx entry="showing SGML tags"/>
  481. <idx entry="showing" parent="tags"/>
  482. <idx entry="copying to clipboard" parent="tags"/>
  483. <idx entry="Show Tags" parent="Options menu"/>
  484. <idx entry="Show Tags"/>
  485. <idx entry="SGML tags" parent="displaying"/>
  486. <p>To show the tag structure of the document:</p>
  487. <cmd><li><p>Choose <menuitem>Show Tags</menuitem> from the <menu>Options</menu> menu.</p></li></cmd>
  488. <p>The tags are shown as markup icons. When
  489. <menuitem>Show Tags</menuitem> is enabled, the markup tags are retained when
  490. you copy a selection into the clipboard.</p>
  491. <fig filename="showtag"></fig></sec></chp>
  492.  
  493. <chp id="c-style"><ct id="select.style">Selecting a style sheet</ct>
  494. <idx entry="selecting" parent="style sheet"/>
  495. <idx entry="style sheet" parent="selecting"/>
  496. <p>The style sheets available for the document you are browsing are listed in
  497. the
  498. <menu>Styles</menu> menu. The current style sheet is indicated with a
  499. checkmark.</p>
  500. </chp>
  501. <chp id="c-graph"><ct id="disp.gra">Displaying graphics</ct>
  502. <idx entry="displaying" parent="graphics"/>
  503. <idx entry="graphics" parent="displaying"/>
  504. <idx entry="Tear Off"/>
  505. <idx entry="Tear Off" parent="pop-up menu"/>
  506. <p>Graphics can be presented either <e1>inline</e1> (intermixed with the
  507. document's contents) or represented by an icon. The choice of presentation is
  508. set in the document's style sheet.</p>
  509. <p>When a graphic is represented by an icon, you click the icon to display the
  510. graphic in a separate window. You can use this window to zoom in on portions of
  511. the graphic. To display an inline graphic in such a window:
  512. <cmd>
  513. <li><p>Click the right mouse button on the graphic and choose
  514. <menuitem>Tear Off</menuitem> from the pop-up menu.</p></li></cmd> The graphic
  515. appears in a Zoom window.
  516. <fig filename="zoom"></fig></p>
  517.  
  518. <idx entry="Overview" parent="Zoom menu"/>
  519. <idx entry="Overview"/>
  520. <p>To toggle the miniature view on and off:<cmd>
  521. <li><p>Choose <menuitem>Overview</menuitem> from the
  522. <menu>Zoom</menu> menu.
  523. </p></li></cmd></p>
  524. <p>To zoom in on the picture:
  525. <idx entry="Supress Zoom"/>
  526. <idx entry="Supress Zoom" parent="Zoom menu"/><cmd>
  527. <li><p>Be sure <menuitem>Suppress Zoom</menuitem> is not selected in the
  528. <menu>Zoom</menu> menu.
  529. </p></li>
  530. <li><p>Click on the picture.</p></li></cmd></p>
  531. <idx entry="Reset" parent="Zoom menu"/>
  532. <idx entry="Reset"/>
  533. <p>Each time you click, the picture's image increases. To return to the
  534. original size:
  535. <cmd>
  536. <li><p>Choose <menuitem>Reset</menuitem> from the
  537. <menu>Zoom</menu> menu.</p></li></cmd></p>
  538. <p>To zoom in on a particular part of the picture:
  539. <idx entry="Centre Zoom" parent="Zoom menu"/><idx entry="Centre Zoom"/><cmd>
  540. <li><p>Choose <menuitem>Centre Zoom</menuitem> in the
  541. <menu>Zoom</menu> menu.</p></li>
  542. <li><p>Be sure <menuitem>Suppress Zoom</menuitem> is not selected.</p></li></cmd>
  543. </p>
  544. <p>Now every time you click on the picture the image increases, centered around
  545. the point where you clicked. To return to the original size:<cmd>
  546. <li><p>Choose <menuitem>Reset</menuitem> from the
  547. <menu>Zoom</menu> menu.</p></li></cmd>
  548. </p>
  549. <idx entry="Autoshrink" parent="Options menu"/>
  550. <idx entry="Autoshrink"/>
  551. <idx entry="results of narrow window" parent="graphics"/>
  552. <p>When the document window is too narrow to display a particular inline
  553. graphic, the results depend on whether or not the
  554. <menuitem>Autoshrink</menuitem> item in the
  555. <menu>Options</menu> menu is selected. When it is selected, graphics are
  556. resized. When it is unselected, scroll bars appear, to allow scrolling through
  557. the graphic.</p>
  558. <p>If you are concerned with the appearance of your screen updates, select
  559. <menuitem>Use Bitmap</menuitem> from the <menu>Zoom</menu> window. This causes
  560. the graphic to be rendered from an off-screen bitmap, giving a smoother, almost
  561. flicker-free, display. Using this option takes some additional
  562. <scp>RAM</scp>.
  563. </p>
  564.  
  565. <sec id="s-webfile"><st>Hot Spots</st>
  566. <idx entry="hotspot"/>
  567. <p>&sp; supports the use of hot spots in graphics. This format is a proprietary
  568. <scp>SGML</scp>-based format, which uses the concept of architectural forms. A
  569. hot spot locator is defined
  570. as:<eg><!ELEMENT HOTSPOT       EMPTY>
  571. <!ATTLIST    HOTSPOT
  572.        SYNEX-AF   NAME      HOTSPOT
  573.        ID         ID        #IMPLIED
  574.        GRAPHIC    ENTITY    #REQUIRED
  575.        RX         NUMBER   "0"      -- left endpoint --
  576.        RY         NUMBER   "0"      -- top endpoint --
  577.        RW         NUMBER   "2048"   -- maximum height --
  578.        RH         NUMBER   "2048"   -- maximum width --
  579.        ZOOM       NUMBER   "0"      -- 0=default
  580.         1=100%
  581.         2=200%
  582.         3=400%
  583.         4=800% --></eg></p>
  584. <p>The purpose of the attribute <markup>SYNEX-AF</markup> is to emphasize that
  585. this is a proprietary format. The attribute name
  586. <markup>hotspot</markup> specifies an architectural form that the parser
  587. understands. As a result, you can add hot spots in any document: their use is
  588. not limited to personal webs. The corresponding element can be named freely, and
  589. you may add other attributes.</p>
  590. <p>The hot spot addressing is based on a logical grid on the graphic that
  591. ranges from 0 to
  592. <scp>2048</scp> on both the x- and y-axis. This means that the graphic can be
  593. resized freely as long as the scale is uniform, since the addressing is relative
  594. to the logical grid.</p>
  595. <p>The <markup>ZOOM</markup> attribute specifies the amount by which the
  596. graphic should be zoomed when following a link into it. If this attribute is set
  597. to 0, the document window will try to locate the graphic in the open document,
  598. otherwise the hot spot is always displayed in a separate zoom window, scaled
  599. <scp>100</scp>, <scp>200</scp>, <scp>400</scp>, or
  600. <scp>800</scp> percent, depending on the value of the attribute.</p>
  601. </sec>
  602. </chp>
  603. <chp id="c-query"><ct id="query.langsyn">Query language syntax</ct>
  604. <eg>QueryExpression       ::=  QueryTerm (AND|OR) QueryExpression
  605. QueryTerm             ::=  QueryFactor (IN|CONT) QueryExpression
  606. QueryFactor           ::=  TextSpecification|TagSpecification|(QueryExpression)
  607. TextSpecification     ::=  (char+|literal)+
  608. TagSpecification      ::=  <tagname>
  609. char                  ::=  any characters except the keywords
  610.     AND OR IN CONT or the characters " and '
  611. literal               ::=  any characters delimited by ' or "
  612. tagname               ::=  a name string, i.e. a generic identifier
  613.     of the form [A-Za-z0-9]+</eg></chp>
  614. <chp id="c-conf"><ct id="sgml.conf">SGML conformance</ct>
  615. <idx entry="SGML conformance"/>
  616. <p>&sp; is an
  617. <scp>SGML</scp> system conforming to International Standard
  618. <scp>ISO 8879</scp> - Standard Generalized Markup Language.</p>
  619. <sec id="s-sysdec"><st>System declaration</st>
  620. <p>&sp; ignores an
  621. <scp>SGML</scp> declaration and will not act on its contents.
  622. &sp;
  623. conforms to the following system declaration (see
  624. clause
  625. <scp>15.6</scp> of <scp>ISO 8879</scp>):</p>
  626. <eg><!SYSTEM "ISO 8879:1986"
  627.         CHARSET
  628.         BASESET "ISO 646:1983//CHARSET International Reference
  629.         Version (IRV)//ESC 2/5 4/0"
  630.         DESCSET
  631.             0       9       UNUSED
  632.             9       2       9
  633.             11      2       UNUSED
  634.             13      1       13
  635.             14     18       UNUSED
  636.             32     95       32
  637.             127     1       UNUSED
  638.         BASESET "ISO Registration Number 8859//CHARSET
  639.         Right Part of Latin Alphabet Nr.1//ESC 2/13 4/1"
  640.         DESCSET
  641.             128     127     128
  642.     CAPACITY PUBLIC
  643.         "ISO 8879:1986//CAPACITY Reference//EN"
  644.     FEATURES
  645.         MINIMIZE
  646.             DATATAG     NO
  647.             OMITTAG     NO
  648.             RANK        NO
  649.             SHORTTAG    YES
  650.         LINK
  651.             SIMPLE      NO
  652.             IMPLICIT    NO
  653.             EXPLICIT    NO
  654.         OTHER
  655.             CONCUR      NO
  656.             SUBDOC      NO
  657.             FORMAL      NO
  658.         SCOPE DOCUMENT
  659.     SYNTAX PUBLIC
  660.         "ISO 8879:1986//SYNTAX Core//EN"
  661.     VALIDATE
  662.         GENERAL     NO
  663.         MODEL       NO
  664.         EXCLUDE     NO
  665.         CAPACITY    NO
  666.         NONSGML     NO
  667.         SGML        NO
  668.         FORMAL      NO
  669.         SDIF
  670.         PACK        NO></eg>
  671. <p>The core concrete syntax is the same as the reference concrete syntax except
  672. that
  673. <scp>NONE</scp> is specified for the <scp>SHORTREF</scp> parameter. The parser
  674. also supports marked sections,
  675. <scp>#CONREF</scp> attributes, full entity support including
  676. <scp>#DEFAULT</scp> entity, and the parsing of the local declaration subset.</p>
  677. <p>&sp; extends the core syntax in the following
  678. manner:
  679. <randlist>
  680. <li><p>The length of a parameter literal or attribute value literal (<scp>LITLEN</scp>)
  681. is set to
  682. <scp>2048</scp>.</p></li>
  683. <li><p>The length of a name, name token, etc. (<scp>NAMELEN</scp>) is set to
  684. <scp>2048</scp>.</p></li>
  685. <li><p>The length of a processing instruction (<scp>PILEN</scp>) is set to
  686. <scp>
  687.  2048</scp>.</p></li>
  688. <li><p>The length of a start-tag (<scp>TAGLEN</scp>) is set to <scp>2048</scp>.</p></li>
  689. <li><p>The nesting level of open elements (<scp>TAGLVL</scp>) is set to <scp>48</scp>.</p></li>
  690. <li><p>The number of attribute names and name tokens in an element's attribute
  691. definitions (<scp>ATTCNT</scp>) is set to <scp>100</scp>.</p></li>
  692. </randlist></p>
  693. <p>There are a number of limits set by the core syntax which are ignored, since
  694. &sp; will use available <scp>RAM</scp> as needed.
  695. These are:
  696. <randlist>
  697. <li><p>The number of tokens in a group (<scp>GRPCNT</scp>).</p></li>
  698. <li><p>The grand total of tokens at all levels of a model group (<scp>GRPGTCNT</scp>).</p></li>
  699. <li><p>The nesting level of model groups (<scp>GRPLVL</scp>).</p></li>
  700. <li><p>The nesting level of entities (<scp>ENTLVL</scp>).</p></li>
  701. </randlist>
  702. </p>
  703. <p>The namecase is <scp>NO</scp> for general identifiers and <scp>YES</scp>
  704. for entities (therefore only entity names are case-sensitive).</p></sec>
  705. <sec id="s-fea"><st>Feature
  706. support</st>
  707. <p><scp>SHORTTAG</scp> minimization is supported.</p></sec>
  708. <sec id="s-valid"><st>Validation
  709. services</st>
  710. <p>As &sp;is
  711. <e1>not</e1> a validating parser, we recommend the use of valid, normalized
  712. <scp>SGML</scp> instances as source input.</p></sec></chp></doc>
  713.