home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1993 #1 / NN_1993_1.iso / spool / comp / sys / sgi / apps / 48 < prev    next >
Encoding:
Internet Message Format  |  1993-01-09  |  3.0 KB

  1. Path: sparky!uunet!cs.utexas.edu!usc!rutgers!sgigate!odin!sgihub!zola!zuni!bawooner.esd.sgi.com!var
  2. From: var@bawooner.esd.sgi.com (Victor Riley)
  3. Newsgroups: comp.sys.sgi.apps
  4. Subject: Re: Insight....adding your own documents
  5. Keywords: InSight SGML online documentation
  6. Message-ID: <ul4ckqk@zuni.esd.sgi.com>
  7. Date: 9 Jan 93 05:03:37 GMT
  8. References: <1993Jan4.200343.20281@texhrc.uucp>
  9. Sender: news@zuni.esd.sgi.com (Net News)
  10. Organization: Silicon Graphics, Inc.
  11. Lines: 53
  12.  
  13. In article <1993Jan4.200343.20281@texhrc.uucp>, mjz@mjzsgi.Texaco.COM
  14. (Michael Zeitlin) writes:
  15. |> 
  16. |>    Insight is quite nice....i just assume use it for our own
  17. |>    "stuff"
  18.  
  19. Thanks for the compliment.  Our first release of InSight is meant as
  20. a base level of functionality that we can build on for future versions.
  21. With the InSight Viewer bundled with all machines we now have a base
  22. for putting more documents online.  In the future we will add more 
  23. functionality to the viewer and tools for helping users get documents
  24. into InSight.
  25.  
  26. The InSight Viewer is based on a 3rd party toolkit from Electronic Book
  27. Technologies, Inc. for displaying the books.  The format of the books 
  28. InSight reads is an SGML file compiled using EBT's SGML compiler.  SGML
  29. stands for Standard Generalized Markup Language and is a language for
  30. tagging the structure of a document based on a DTD (Document Type 
  31. Definition).
  32.  
  33. Adding books to the current version of InSight is not a trivial task.
  34. Your "stuff" must be converted to SGML then compiled using EBT's tools.
  35. We currently translate our books from Frame to SGML using a translator
  36. from another 3rd party vendor named Avalanche.  Our process is 
  37. semi-automated but specific to the SGI environment.  We have a group in 
  38. CSD that is translating files from ascii to SGML for the Support bookshelf
  39. but the files are semi-structured already.  We do not yet have a general 
  40. purpose tool for incorporating arbitrary ascii text files into InSight.
  41.  
  42. The translation of a book from whatever format you author it in into 
  43. SGML can either be done by yourself, or a service bureau.  Passage 
  44. Systems, Inc. was formed partially for this purpose.  There also exist 
  45. other companies that build translation filters from various formats to 
  46. SGML.
  47.  
  48. We do hope that 3rd parties, OEM's, and ISV's will decide to put their 
  49. documentation for their products online in InSight.  There are many 
  50. advantages besides having a common means of accessing all the information,
  51. the ability to query across all books, and the ability to link from one 
  52. book to another.  Another key feature is that 3rd parties can write their 
  53. book once for InSight and then take that same compiled book with EBT's
  54. DynaText browser and deliver the same book on other platforms.  EBT's 
  55. DynaText browser runs on a wide variety of platforms including Sun, DEC,
  56. HP, and Windows.
  57.  
  58. I realize that this isn't an answer to the question of "How do I get my
  59. documents online in InSight?" But before I write a lengthier reply I'd
  60. like
  61. to find out what kind of information you really want or need.
  62.  
  63.     Victor Riley
  64.     InSight Engineer
  65.     var@sgi.com
  66.