[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

RE: sgmltools Questions



On Fri, 7 Jul 2000, Gregory Leblanc wrote:

>  If
> you're using Debian, I think something like apt-get sgml-doc will work.

     apt-get install <packagename>

will trog off to wherever you have indicated in your /etc/sources.list
file [stable; unstable; frozen; etc]; find the requisite package (plus
any dependencies); then install it all.

Relevant packages currently available:


***********************************************************************

* task-sgml  -  SGML and XML authoring and editing
-
A metapackage containing dependencies for a complete SGML and XML
support environment, geared towards document engineers.

***********************************************************************

* sgml-base  -  utilities to maintain the SGML catalog file
-
This package includes the install-sgmlcatalog utility, which is used by
all other SGML packages to install, update, and remove entries from the
SGML catalog.

************************************************************************

* sgml-data  -  common SGML DTDs and entities
-
This package includes Document Type Definitions for HTML Levels 0, 1, 2,
3, 3.2, and 4.0, as well as their strict versions; DTDs for Mozilla
(2.0) and for Internet Explorer (2.0 and 3.0); and some other somewhat
"standard" DTDs.
Also included are ISO standard entities, HTML standard entities, and
other generally useful sets of entities.
-
Access to these data files is facilitated by the inclusion of an SGML
catalog file which defines a default SGML declaration and a default DTD
for documents whose DOCTYPE is 'html'; and which links system
identifiers to public identifiers for other SGML DTDs and entity sets.

************************************************************************

* debiandoc-sgml  -  DebianDoc SGML DTD and formatting tools
-
This is an SGML-based documentation formatting package used for the
Debian manuals.  It reads markup files and produces DVI (via LaTeX),
HTML, Info (via Texinfo), LaTeX, PostScript (via DVI), Texinfo, and
plain text (with overstrikes a la troff as well as without) files.
-
The LaTeX based output needs the libpaperg, tetex-bin and tetex-extra
packages.  The Texinfo based output needs the texinfo package.

***********************************************************************

* debiandoc-sgml-doc  -  documentation for DebianDoc-SGML
-
This package contains the documentation for DebianDoc-SGML in HTML, PDF
and plain ASCII format.

***********************************************************************

* perlsgml  -  tools to build and analyse SGML document type definitions 
(DTDs).
-
dtd2html generates a suite of linked HTML documents listing the
components and features of each element in an SGML Document Type
Definition (DTD).
-
dtddiff shows differences between two DTDs.
-
dtdtree shows the hierarchy tree (in ASCII) of SGML elements in a DTD.
-
dtdview is an interactive program for studying an SGML DTD.
-
stripsgml strips SGML markup from a file, and also attempts to translate
entity references to standard ASCII characters.

************************************************************************

* docbook  -  SGML DTD for software documentation
-
The DocBook DTD was developed specifically for computer software
documentation -- that is, user manuals and programming references. It
has emerged as a standard DTD in the software industry.
-
This package include the 2.4.1, 3.0, and 3.1 versions of the DocBook
DTD.

************************************************************************

* docbook-doc  -  documentation for the DocBook DTD.
-
The DocBook DTD was developed specifically for computer software
documentation -- that is, user manuals and programming references.
-
This set of documentation includes the following titles:
 - Overview of the DocBook DTD
 - User's Guide for the DocBook DTD
 - Guide to the DocBook DTD
 - Reference for the DocBook DTD
 - Customizer's Guide for the DocBook DTD

************************************************************************

* docbook-stylesheets  -  modular DocBook stylesheets, for print and
HTML
-
This package contains two DocBook DSSSL stylesheets, one for print and
one for HTML.  The print stylesheet can be used, in conjunction with the
RTF and the TeX back-ends that Jade provides, to produce output suitable
for printing. The HTML stylesheet can be used to convert DocBook
documents into HTML.
-
The stylesheets are modular in the sense that you can extend and, to
some extent, customize them.
-
Author:   Norman Walsh <ndw@nwalsh.com> Homepage:
http://nwalsh.com/docbook/dsssl/

************************************************************************

* docbook-stylesheets-doc  -  modular DocBook stylesheets documentation
-
This package contains documentation for the Modular DocBook stylesheets,
as found in the 'docbook' package.
-
Author:   Norman Walsh <ndw@nwalsh.com> Homepage:
http://nwalsh.com/docbook/dsssl/

************************************************************************

* docbook-to-man  -  converter from DocBook SGML into roff -man macros.
-
The docbook-to-man tool is a batch converter that transforms UNIX-style
manpages from the DocBook SGML DTD into nroff/troff -man macros.  This
is not the original version by Fred Dalrymple, but one with the ANS
modifications by David Bolen.

************************************************************************

* docbook-xml - XML DTD for DocBook, also known as DocBk XML
-
An XML representation of the DocBook 3.x DTD, which is sometimes
referred to as DocBk XML.
-
This package also includes the "Simplified" DocBk XML DTD, which is a
small subset of the DocBk XML DTD.
-
Additional, an XML versions of the standard ISO entity sets is also
distributed with this package, which may be of interest to anyone using
XML.

************************************************************************

* docbook2man  -  Perl SGMLS spec file to convert DocBook SGML docs into
troff
-
docbook2man-spec is a sgmlspl spec file that produces man pages (using
the -man macros) from DocBook RefEntry markup.
-
The program reads ESIS produced by nsgmls (or other SGML parsers) from
standard input. Markup not found in RefEntry is discarded.

************************************************************************

* docbook2texi  -  Perl SGMLS spec file to convert DocBook SGML docs
into Texinfo
-
docbook2texi-spec is a sgmlspl spec file that produces GNU Texinfo
documents from DocBook documents.
-
The  program  reads ESIS produced by nsgmls (or other SGML parsers) from
standard input.  Currently the document element must be Book, otherwise
the results are undefined.

************************************************************************

* psgml  -  an emacs major mode for editing SGML documents.

PSGML is a major mode for editing SGML documents.  It contains a simple
SGML parser and can work with any DTD. (The most popular nowadays are
the various HTML DTDs. This package turns your emacs into one of the 
most powerful SGML/HTML editors around, and will be ultimately flexible
as well, since you can upgrade your editor by just installing new DTDs).
Functions provided include:
 - menus and commands for inserting only *contextually valid* tags;
 - identification of structural errors;
 - editing of attribute values in a separate window with information
about types and defaults;   and
 - structure based editing.
-
Since psgml parses the DTD to allow you to edit SGML documents, you DO
need to have the DTDs installed in order to use psgml. Since psgml
installs itself as an HTML mode in Emacs, it depends on sgml-data. Some
other packages which also provide SGML DTDs are suggested, like
debiandoc-sgml and linuxdoc-sgml.
-
SGML, a language for encoding the structure of a document, is an ISO
standard: ISO 8879:1986 "Information processing - Text and office
systems - Standard Generalized Markup Language (SGML)".
-
This is a standard package for XEmacs.

***********************************************************************

* sgml-tools  -  SGML converters for the LinuxDoc DTD _only_.
-
The Linux Documentation Project advises using this set of SGML parsers
to generate HOWTOs and books. LaTeX, ASCII, HTML, PostScript and roff
can all be generated from one SGML source file.
-
HTML can be generated without any other Debian text processing package,
but for any other formats [DTDs] the appropriate packages will have to
be installed.
-
This sgml-tools package has been designed and implemented for the
*Linuxdoc DTD ONLY*
      [ -- and should therefore be sensibly renamed -- msw]
-
Since upstream developers have now completely moved away to the
development of sgmltools-2
      [ -- which again should be sensibly renamed -- msw]
this set of tools will not be enhanced to handle documents marked
up with other DTDs.
-
If you wish to convert debiandoc DTD documents, please install and use
the debiandoc-sgml package.  If you wish to convert DocBook DTD
documents, please install and use jade or the sgmltools-2 package.

***********************************************************************

* sgmltools-2  -  second generation SGML text formatting system based on 
the DocBook DTD
-
A text-formatting package based on SGML (Standard Generalized Markup
Language), which allows you to produce TeX/DVI/PS/PDF, HTML, RTF, and
plain ASCII (currently via Lynx) from a single source.  Due to the
flexible nature of SGML, many other target formats are possible.
-
This system is tailored towards writing technical software
documentation -- an example of which are the Linux HOWTO
documents.  However, there is nothing Linux-specific about this
package; it can be used for many other types of
documentation on many other systems. It should be useful for all kinds
of printed and online documentation.
-
The package was formerly called Linuxdoc-SGML because it originates from
the Linux Documentation Project (LDP).  The name has been changed to
SGMLtools to make it clearer that there is no Linux-specific stuff
included in this package.
   [ -- thus totally ignoring the fact that the package is
        nevertheless *DTD* specific !!!  Ye gods!  msw]

************************************************************************

* libsgmls-perl  -  Perl modules to process SGML parser output
-
This is a set of Perl5 routines for processing the output from the sgmls
and nsgmls SGML parsers.  To make sensible use of this package you will
need to install a suitable SGML parser as well.

************************************************************************

* sgmlspl  -  SGMLS-based (example) Perl script to process SGML parser
output
-
This is an example of a Perl script to post-process SGML parser output
using the SGMLS Perl modules.  To make sensible use of this package you
will need to install a suitable SGML parser as well.

************************************************************************

sgmls-doc  -  HTML documentation for libsgmls-perl and sgmlspl
-
This package contains the documentation in HTML format of the packages
libsgmls-perl and sgmlspl.

************************************************************************



************************************************************************

* debiandoc-sgml-doc-pt-br  -  documentation for DebianDoc-SGML in
Brazilian Portuguese
-
This package contains the documentation for DebianDoc-SGML in Brazilian
Portuguese in HTML, PDF and plain ASCII format.

************************************************************************

yasgml  -  Yet Another SGML mode

Yasgml automates the typesetting and previewing of SGML, and enables
completing the input of SGML mark-up tags such as 
`<verb>'..`</verb>'.
It is intended to be used with the LinuxDoc DTD and sgml-tools (v1).
Default is for Japanese text editing. Its keybinding is based on
that of YaTeX.

************************************************************************

zh-sgmltools  -  a wrapper for SGMLtools to process Chinese
-
This is a wrapper for SGMLtools (version 1) that lets you convert
Chinese SGML files (either Big5 or GB) into HTML, plain text, LaTeX, and
so on.  This package is used to process CLDP (Chinese Linux
Documentation Project) documents.
-
If you want to output plain text files, you need to have the lynx
package installed.

************************************************************************



************************************************************************

task-sgml-dev - SGML and XML development environment
-
A metapackage containing dependencies for a complete SGML and XML
support environment, geared towards developers.

************************************************************************


I've also got  sgmlnorm  installed; but blessed if I can remember where
I got it from.  Non-free, perhaps?

Anyway; that should be enough to keep you going over the summer :)

msw
-- 
Martin Wheeler         -         StarTEXT - Glastonbury - BA6 9PH - England
[1] mwheeler@startext.co.uk                      http://www.startext.co.uk/


--  
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org