Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
JW(1)									 JW(1)

       jw,  docbook2dvi,  docbook2html,	 docbook2man, docbook2pdf, docbook2ps,
       docbook2rtf, docbook2tex, docbook2texi, docbook2txt  -  (Jade  Wrapper)
       converts	SGML files to other formats

       jw [ -f frontend	| --frontend frontend ]
	   [ -b	backend	| --backend backend ]
	   [ -c	file | --cat file ]
	   [ -n	| --nostd ]
	   [ -d	file|default|none | --dsl file|default|none ]
	   [ -l	file | --dcl file ]
	   [ -s	path | --sgmlbase path ]
	   [ -p	program	| --parser program ]
	   [ -o	directory | --output directory ]
	   [ -V	variable[=value] ]
	   [ -u	| --nochunks ] [ -i section | --include	section	]
	   [ -w	type|list | --warning type|list	]
	   [ -e	type|list | --error type|list ]
	   [ -h	| --help ] [ -v	| --version ]

       docbook2dvi SGML-file

       docbook2html SGML-file

       docbook2man SGML-file

       docbook2pdf SGML-file

       docbook2ps SGML-file

       docbook2rtf SGML-file

       docbook2tex SGML-file

       docbook2texi SGML-file

       docbook2txt SGML-file

       The  jw	shell  script  allows to convert a DocBook file	(or some other
       SGML-based format) to other formats (including HTML, RTF, PS  and  PDF)
       with  an	easy-to-understand syntax. It hides most of Jade's or OpenJade
       complexity and adds comfortable features.

       Other scripts like docbook2html,	docbook2rtf or docbook2ps provide dif-
       ferent ways of calling jw that might be easier to remember.

       For the moment, jw does not handle XML, but only	SGML.

       This  utility  assumes that several other components are	installed. The
       list includes:

       o the ISO character entities for	SGML

       o James Clark's DSSSL engine, jade, or an equivalent parser like	 Open-

       o the DocBook DTD from the OASIS	consortium

       o Norman	 Walsh's  DocBook  modular  style sheets (or some other	set of
	 DSSSL style sheets)

       o Sebastian Rahtz's jadetex set of TeX macros for  jade	(for  backends
	 intended to "printing"	formats	like PDF, RTF or PostScript)

       o A perl	interpreter (for backends that use perl)

       o SGMLSpm from CPAN (for	backends that use sgmls)

       o Lynx HTML browser (for	the txt	backend)

       The jw script is	basically called like this:

       jw mydoc.sgml

       where mydoc.sgml	is a SGML file.

       The  command  line above	uses default options: it converts from DocBook
       (the default frontend) to HTML (the default backend), does not put  the
       result  in  a  subdirectory  (unless  specified	otherwise in the style
       sheets),	etc.

       In this example,	the "mydoc" file name as well as the ".sgml" extension
       can  be	replaced by anything else. Current extensions for SGML DocBook
       files include ".sgml", ".sgm", ".docbook",  and	".db".	The  processed
       file mydoc.sgml can be in any other directory than the current one.

       Here  we	have chosen to generate	HTML output. In	fact we	can use	any of
       the backends stored in the backends/ subdirectory of the	 DocBook-utils
       distribution  directory (usually	/usr/share/sgml/docbook/utils-0.6.14).
       Similarly, you can use any frontend defined in the frontends/ subdirec-
       tory to convert from another input format.

       This  sample command creates one	or many	HTML files with	arbitrary file
       names in	the current directory. This default behavior  can  be  changed
       through command line options and/or customization style sheets.

       The following options apply to the conversion script:

	  -f frontend |	--frontend frontend
	      Allows  to  specify  another frontend than default docbook.  The
	      list of currently	available frontends is:

		     Converts docbook with Norman Walsh's style	 sheets.  This
		     frontend  searches	in the subdirectories of the base SGML
		     directory for a file named	html/docbook.dsl or print/doc-
		     book.dsl  (depending  on  the  backend's  type:  html  or

	  -b backend | --backend backend
	      Allows to	specify	another	backend	than default HTML. The list of
	      currently	available backends is:

	      dvi    Converts  to  DVI	(DeVice	 Independant files) by calling
		     Jade or OpenJade.

	      html   Converts to HTML (HyperText Markup	Language)  by  calling
		     Jade or OpenJade.

	      man    Converts a	refentry to a Unix manual page by calling doc-
		     book2man. Does not	work with other	 SGML  document	 types
		     than DocBook.

	      pdf    Converts  to  PDF	(Portable  Document Format) by calling
		     Jade or OpenJade.

	      ps     Converts to PostScript by calling Jade or OpenJade.

	      rtf    Converts to RTF (Rich Text	Format)	 by  calling  Jade  or
		     OpenJade. The resulting file can then be inported into MS
		     Word or one of its	Linux replacement programs.

	      tex    Converts to TeX by	calling	Jade or	OpenJade.

	      texi   Converts to GNU TeXinfo pages  by	calling	 docbook2texi.
		     Does  not	work  with other SGML document types than Doc-

	      txt    Converts to a bare	text file by calling Jade or OpenJade,
		     then Lynx.

	  -c file | --cat file
	      Allows  to  use  an extra	SGML Open Catalog that will list other
	      files like customization style sheets, adaptations to  the  Doc-
	      Book  Document Type Definition, special character	entities, etc.
	      This catalog is added to the list	of catalogs determined by  the
	      script (see option --nostd below)

	  -n | --nostd
	      Do  not use the standard SGML Open Catalogs. Normally, the stan-
	      dard catalogs list is determined like this:

	      o	if the centralized catalog exists, then	use it.	 The  central-
		ized catalog is	a list of all catalogs that might be necessary
		that usually resides in	/etc/sgml. Its name is provided	by the
		frontend,   for	  example   the	  docbook   frontend   returns

	      o	Otherwise, take	all the	files named catalog from the subdirec-
		tories of the SGML base	directory (usually /usr/share/sgml).
       This  option is useful in conjunction with the --cat option to use only
       the catalogs that are specified on the command line.

	  -d file|default|none | --dsl file|default|none
	      Allows to	use a customized style sheet instead  of  the  default

	      A	 "target" starting with	a hash mark "#"	can be appended	to the
	      file name. As a result, only the corresponding part of the style
	      sheet  is	executed (the "style specification" whose "identifica-
	      tor" is equal to the target's name). A common use	of this	mecha-
	      nism  is	to  define "#html" and "#print"	targets	to trigger the
	      corresponding part  of a replacement style sheet which is	common
	      for both HTML and	printout conversion.

	      By  replacing  the  file	name with "default", the default style
	      sheet provided with the frontend is used.	For example, the  doc-
	      book    frontend	  returns    ./docbook.dsl#html	  (or	./doc-
	      book.dsl#print) in the SGML base directory.

	      By replacing the file name with  "none",	no  replacement	 style
	      sheet is used, not even the default style	sheet. The style sheet
	      which is used is also determined by the frontend.	 For  example,
	      the docbook frontend returns Norman Walsh's html/docbook.dsl (or
	      print/docbook.dsl) found somewhere below the  SGML  base	direc-

	      If no --dsl option is specified, then "--dsl default" is used.

	  -l file | --dcl file
	      Allows  to  use a	customized SGML	declaration instead of the de-
	      fault one. The file name of the default SGML declaration is  not
	      set  for	SGML files, and	is set to xml.dcl in the SGML base di-
	      rectory for XML files.

	  -s path | --sgmlbase path
	      Allows to	use another location for the SGML base directory. This
	      is  the directory	below which all	SGML DTDs, style sheets, enti-
	      ties, etc	are installed. The default value is /usr/share/sgml.

	  -p program | --parser	program
	      Specify the parser to use	(Jade or OpenJade) if several are  in-
	      stalled. If this option is not specified,	the script first tries
	      to use Jade, then	it tries OpenJade.

	  -o directory | --output directory
	      Set output directory where  all  the  resulting  files  will  be
	      stored. If the style sheets define a subdirectory	where to store
	      the resulting files too, the subdirectory	defined	by  the	 style
	      sheets will be placed below the subdirectory defined by this op-

	  -V variable=[value]
	      Set a variable (to a value, if one is specified).

	  -u | --nochunks
	      Output only one big file.	This option is useful only when	gener-
	      ating  HTML, because the output can be split into	several	files.
	      This option overrides the	setting	that may be done in the	 style

	  -i section | --include section
	      Declare  a  SGML marked section as "include". A SGML marked sec-
	      tion is a	kind of	conditional part of a document.	If it  is  de-
	      clared  "ignore",	 it will be left ignored, otherwise it will be
	      processed. An example of such a marked section would be:

		   <DOCTYPE mydoc [
		     <!ENTITY %	confidential "ignore">
		     <![ %confidential [ Some confidential text... ]]>

	  -w type|list | --warning type|list
	      Enables or disables the display  of  given  types	 of  warnings.
	      Several  -w options might	be entered on the command line.	 Warn-
	      ing types	that start with	"no-" disable the corresponding	 warn-
	      ings, the	other types enable them.

	      If  the warning type is replaced with "list", then a list	of al-
	      lowed warning types is displayed.

	  -e type|list | --error type|list
	      Disables given types of errors.  Several -e options might	be en-
	      tered on the command line.  All error types start	with "no-".

	      If  the  error  type is replaced with "list", then a list	of al-
	      lowed error types	is displayed.

	  -h | --help
	      Print a short help message and exit

	  -v | --version
	      Print the	version	identifier and exit

	      Centralized SGML open catalog. This file name might vary if  an-
	      other frontend than docbook is used.

	      The various backends

	      The various frontends

	      The various helper scripts like docbook2man or docbook2texi

       Eric Bischoff (jw shell script and a few	backends), Jochem Huhmann (the
       man and texi backends)

SEE ALSO,,   install-catalog(8),
       nsgmls(1),  docbook-utils  homepage <URL:

			       11 February 2004				 JW(1)


Want to link to this manual page? Use this URL:

home | help