home *** CD-ROM | disk | FTP | other *** search
/ XML Bible (2nd Edition) / XML_Bible_Second_Edition_Hungry_Minds_2001.iso / mac / ReadMeFirst < prev   
Text File  |  2001-04-30  |  6KB  |  146 lines
  1.  
  2. What's on the CD-ROM
  3.  
  4. The CD that comes with this book should be readable on a Mac, Solaris, Linux, and 
  5. Windows 95/98/Me/NT/2000. Just put the CD in the drive, and mount it using whatever 
  6. method you normally use to load a CD on your platform, probably filemanager in Solaris, 
  7. and just stick it in the drive if you're using a Mac, Linux or Windows. There's no fancy 
  8. installer. You can browse the directories as you would a hard drive.
  9.  
  10. All CD-ROM files are read-only. Therefore, if you open a file from the CD-ROM and 
  11. make any changes to it, you'll need to save it to your hard drive. If you copy a file from 
  12. the CD-ROM to your hard drive on Windows, the file retains its read-only attribute. To 
  13. change this attribute after copying a file, right-click the file name or icon and select 
  14. Properties from the shortcut menu. In the Properties dialog box, click the General tab and 
  15. remove the checkmark from the Read-only checkbox.
  16.  
  17. The CD is divided into seven main directories:
  18.  
  19. *    Browsers
  20. *    Parsers
  21. *    Specifications
  22. *    Examples
  23. *    Source Code
  24. *    Utilities
  25. *    PDFs
  26.  
  27. Browsers
  28.  
  29. This directory contains a number of Web browsers that support XML to a greater or 
  30. lesser extent including:
  31.  
  32. *    Microsoft Internet Explorer 5.5 for Windows
  33. *    Microsoft Internet Explorer 5.0 for MacOS
  34. *    Mozilla 0.8 (various platforms)
  35.  
  36.  
  37. Parsers
  38.  
  39. This directory contains a variety of open source XML parsers including:
  40.  
  41. *    The Xerces Java XML parser
  42. *    The Xerces-C XML parser for C++
  43. *    The Xerces-Perl XML parser for Perl
  44. *    The expat parser for C++
  45.  
  46. Most of the examples in this book that have used a specific parser have used Xerces Java, 
  47. in particular, the sax.SAXCount program, To install it, just copy the xerces.jar and 
  48. xercesSamples.jar archives to your jre\lib\ext directory. You'll need the Java Runtime 
  49. Environment (JRE) 1.2 or later, which you can download from http://java.sun.com/. If 
  50. you've installed the Java Development Kit (JDK) instead of the JRE on Windows, you 
  51. may have two ext directories, one somewhere like C:\jdk1.3\jre\lib\ext and the other 
  52. somewhere like C:\Program Files\Javasoft\jre\1.3\lib\ext. You need to copy the jar 
  53. archive into both ext directories. Putting one copy in one directory and an alias into the 
  54. other directory does not work. You must place complete, actual copies into each ext 
  55. directory.
  56.  
  57. Specifications
  58.  
  59. This directory contains the XML Specifications from the World Wide Web Consortium 
  60. (W3C) including:
  61.  
  62. *    XML 1.0, second edition
  63. *    Namespaces in XML
  64. *    CSS Level 1
  65. *    CSS Level 2
  66. *    XSLT 1.0
  67. *    XPath 1.0
  68. *    HTML 4.0
  69. *    XHTML 1.0
  70. *    MathML 2.0
  71. *    The Resource Description Framework
  72. *    SMIL
  73.  
  74. These are all included in HTML format, and most are available in XML as well. Some 
  75. are also provided in additional formats such as PDF or plain text. Many technologies 
  76. discussed in this book are not yet finalized (for example, XLinks). You can find the 
  77. current draft specifications for these on the World Wide Web Consortium (W3C) Web 
  78. site at http://www.w3.org/TR/.
  79.  
  80. Examples
  81.  
  82. This directory contains several examples of large XML files and large collections of 
  83. XML documents. Some (but not all) of these are based on smaller examples printed in the 
  84. book. For instance, you'll find complete statistics for the 1998 Major League Baseball 
  85. season including all players and teams. Examples include:
  86.  
  87. *    The 1998 Major League Baseball season
  88. *    The complete works of Shakespeare (courtesy of Jon Bosak)
  89. *    The Old Testament (courtesy of Jon Bosak)
  90. *    The New Testament (courtesy of Jon Bosak)
  91. *    The Koran (courtesy of Jon Bosak)
  92. *    The Book of Mormon (courtesy of Jon Bosak)
  93. *    The periodic table of the elements
  94.  
  95. Source Code
  96.  
  97. All complete numbered code listings from this book are on the CD-ROM in a directory 
  98. called source. They are organized by chapter. Very simple HTML indexes are provided 
  99. for the examples in each chapter. However, because most of the examples are raw XML 
  100. files and because most don't have style sheets, some Web browsers won't display them 
  101. very well. Internet Explorer 5.x probably does the best job with most of these files. 
  102. Otherwise, you're probably better off just opening the directories in Windows Explorer, 
  103. the Finder or the equivalent on your platform of choice, and reading the files with a text 
  104. editor.
  105. Most of the files are named according to the listing number in the book (for example, 
  106. 6-1.xml, 27-1.cdf). However, in a few cases in which a specific name is used in the book, 
  107. such as family.dtd or family.xml, then that name is also used on the CD. The files on the 
  108. CD appear exactly as they do in the book's listings.
  109.  
  110. Utilities
  111.  
  112. The utilities directory contains assorted programs that will be useful for processing XML 
  113. documents of one type or another. These include:
  114.  
  115. *    Dave Raggett's HTML Tidy, compiled for a variety of platforms. Tidy can clean 
  116.     up most HTML files so that they become well-formed XML. Tidy can correct 
  117.     many common problems and warn you about the ones you need to fix yourself. 
  118.     
  119. The latest version can be found at http://www.w3.org/People/Raggett/tidy.
  120.  
  121. *    The Xalan-J XSLT Processor from the XML Apache Project 
  122. *    Michael Kay's SAXON XSLT Processor 
  123. *    James Clark's XT XSLT Processor
  124. *    The Batik SVG Viewer from the XML Apache Project 
  125. *    FOP, a print formatter driven by XSL formatting objects from the XML Apache 
  126.     Project.
  127.     
  128. PDF
  129.  
  130. The pdf directory contains Acrobat PDF files for this entire book. To read them, you'll 
  131. need the free Acrobat Reader software included on the CD-ROM. Feel free to put them 
  132. on your local hard disk for easy access. I don't really care if you loan the CD-ROM to 
  133. some cash-strapped undergrad who finds it cheaper to tie up a school printer for a few 
  134. hours printing all 1200+ pages rather than spend $49.99 for a printed copy. (If you're 
  135. using your own printer, toner, and paper, it's much cheaper to buy the book.) However, I 
  136. would very much appreciate it if you do not place these files on Web, FTP, Gnutella, 
  137. Publius, or any other servers. This includes intranet servers, password-protected sites, and 
  138. other things that aren't meant for the public at large. Most local sites and intranets are far 
  139. more exposed to the broader Internet than most people think. Today's search engines are 
  140. very good at locating content that is supposed to be hidden. Putting mirror copies of these 
  141. files around the Web makes it extremely difficult to keep all the files up to date and to 
  142. make sure that search engines find the right copies.
  143.  
  144.  
  145.  
  146.