NAME
Meta::Tool::Sgmltools - run sgmltools for you.
COPYRIGHT
Copyright (C) 2001 Mark Veltzer; All rights reserved.
LICENSE
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
DETAILS
MANIFEST: Sgmltools.pm PROJECT: meta
SYNOPSIS
package foo; use Meta::Tool::Sgmltools qw(); my($object)=Meta::Tool::Sgmltools-new();> my($result)=$object-method();>
DESCRIPTION
This module is here to ease the job of running sgmltools for you if you wish to use them (I think it's better to use the Jade.pm module which runs jade or openjade directly).
Sgmltools is quite problematic: 1. Sgmltools has a --jade-opt option but you CANT specify several options this way - you have to join everything into one thing.
EXPORTS
check($$) c2texx($) c2dvix($) c2psxx($) c2txtx($) c2html($) c2rtfx($) c2mifx($) c2info($) c2pdfx($) c2late($) c2lyxx($) tool($$$$)
FUNCTION DOCUMENTATION
- check($$)
-
Run a check on the SGML document using the sgmlcheck utility.
- c2texx($)
-
This routine will convert sgml DocBook files to Tex.
- c2dvix($)
-
This routine will convert sgml DocBook files to Dvi.
- c2psxx($)
-
This routine will convert sgml DocBook files to Postscript.
- c2txtx($)
-
This routine will convert sgml DocBook files to Text.
- c2html($)
-
This routine will convert sgml DocBook files to HTML.
- c2rtfx($)
-
This routine will convert sgml DocBook files to Rtf (Rich Text Format).
- c2mifx($)
-
This routine will convert sgml DocBook files to Mif (Microsoft Interchange Format). Currently this does not do the actual convertion because sgml tool do not support this so it just put an emblem.
- c2info($)
-
This routine will convert sgml DocBook files to GNU info format. These is no info backend to sgmltools at the moment (3.0) that I am aware of. This means that this routine is broken. Do not use it.
- c2pdfx($)
-
This routine will convert sgml DocBook files to Pdf (Portable Documentation Format). This way of prducing pdfs seems to be broken (I have not been able to see the resulting pdf using xpdf). In any case - this backend IS supported by sgmltools altough you cannot see this in the documentation.
- c2late($)
-
This method will convert SGML DocBook files to Latex.
- c2lyxx($)
-
This method will convert SGML DocBook files to Lyx.
- tool($$$$)
-
This is the actual wrapper code. We pass directory search paths to jade via the option in sgmltools to pass options to jade...:) The problem is that sgmltools does not allow the option to specify the output file and so we do all the work using a temporary file and then move the result.
BUGS
None.
AUTHOR
Mark Veltzer <mark2776@yahoo.com>
HISTORY
start of revision info end of revision info
SEE ALSO
Nothing.
TODO
-how can I stop jade from looking in /usr/lib/sgml and finding junk there ?
-remmember to restore SGML_CATALOG_FILES after invocation.
-do the actual code for c2info,c2pdfx
-try to use symlinks instead of the copies here (it will be faster).
-add a -o option to sgmltools so I wont need to bypass them here.