home *** CD-ROM | disk | FTP | other *** search
/ Dream 57 / Amiga_Dream_57.iso / Linux / Bureautique / sgml-tools.txt < prev    next >
Text File  |  1998-04-07  |  3KB  |  58 lines
  1. *** This is the README file for the sgml-tools package, version 1.0.something 
  2.  
  3. *** For more uptodate information, visit the sgml-tools homepage
  4.     at http://pobox.com/~cg/sgmltools
  5.  
  6. SGML-Tools is a text-formatting package based on SGML (Standard 
  7. Generalized Markup Language), which allows you to produce LaTeX,
  8. HTML, GNU info, LyX, RTF, and plain text (via groff) from a single source;
  9. due to the flexible nature of SGML many other target formats are possible.
  10.  
  11. This system is tailored for writing technical software documentation, 
  12. an example of which are the Linux HOWTO documents. However, there is nothing
  13. Linux-specific about this package; it can be used for many other types of
  14. documentation on many other systems. It should be useful for all kinds of 
  15. printed and online documentation.
  16.  
  17. The current release version of sgml-tools can be found at
  18.  ftp://sunsite.unc.edu/pub/Linux/utils/text/sgml-tools-1.0.x.tar.gz
  19.  
  20. Hacker versions (1.1.x where x > 0) can be found at the Website above and
  21. probably on some assorted FTP sites. Note that there are no guarantees about
  22. stability here.
  23.  
  24. You can join the sgml-tools mailing list by sending mail to
  25. majordomo@via.ecp.fr with 'subscribe sgml-tools' in the message
  26. body.  The list address is sgml-tools@via.ecp.fr.
  27.  
  28. The file doc/guide.sgml is SGML source for the User's Guide. As you 
  29. probably don't know how to format it yet, there is formatted plain text
  30. in doc/guide.txt. There's also guide.dvi and guide.ps, if you wish to
  31. print them instead. The first thing you should read is doc/guide.txt, 
  32. which explains how to install the software (namely, it tells you to
  33. read the file INSTALL), and how to start writing documents with it.
  34. The file doc/example.sgml is a simple example document which you
  35. can use as a tutorial. 
  36.  
  37. For real-life examples of uses of SGML-Tools, look at the Linux HOWTOs 
  38. on sunsite.unc.edu:/pub/Linux/docs/HOWTO/other-formats/sgml. These HOWTOs 
  39. are written in SGML and automatically translated into PostScript, DVI, and 
  40. ASCII using this system. You can also look at the URL
  41.   http://sunsite.unc.edu/LDP/HOWTO/
  42. which has HTML formats of many Linux HOWTOs, produced using SGML-Tools. 
  43.  
  44. SGML-Tools is based on James Clark's sgmls parser, and the QWERTZ
  45. DTD by Tom Gordon.  The package was originally created by Matt Welsh, 
  46. and maintained by Greg Hankins under the name Linuxdoc-SGML.  It was 
  47. renamed to SGML-Tools, because it's not really Linux specific anymore.
  48. The tools are currently maintained by Cees de Groot <cg@pobox.com>.
  49.  
  50. Please send me any questions or bug reports, as well as suggestions for 
  51. improvement. 
  52.  
  53. Share and enjoy,
  54. Matt Welsh
  55. Greg Hankins
  56. Cees de Groot
  57. (and other contributers, see CONTRIBUTORS)
  58.