From owner-freebsd-doc Thu Dec 10 12:32:57 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id MAA11952 for freebsd-doc-outgoing; Thu, 10 Dec 1998 12:32:57 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id MAA11940 for ; Thu, 10 Dec 1998 12:32:51 -0800 (PST) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.8.8/8.8.8) id UAA10827; Thu, 10 Dec 1998 20:30:34 GMT (envelope-from nik) Message-ID: <19981210203033.34618@nothing-going-on.org> Date: Thu, 10 Dec 1998 20:30:33 +0000 From: Nik Clayton To: doc@FreeBSD.ORG Subject: HEADS UP: Testers required Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.89.1i Organization: Nik at home, where there's nothing going on Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Folks, I've just committed (or am in the process of committing) the latest round of changes to the DocBook handbook, and would be grateful if a few other people could do some testing. There are two things I'd like tested at the moment. First is the generation of HTML, RTF, and plain text formats. Second is the generation of PostScript and PDF formats. To start with; * Install ports/textproc/docproj * Download (use CVSup or similar) and checkout the latest version of doc/en/handbook. This is the DocBook version of the Handbook. To test the HTML generation There are a few things not in the docproj port that are required from the ports system. * www/tidy * www/lynx They'll be added soon. In addition, you need to cut-n-paste the following into doc/en/handbook/conv.pl #!/usr/local/bin/perl -pi s/“/\`\`/g; s/”/''/g; s/—/---/g; s/–/--/g; s/…/.../g; s/$/\$/g; (Yeah, I know this isn't seamless, I'll be tidying it up on Friday or Sunday night). Then convert the Handbook % cd doc/en/handbook % make Should leave you with a bunch of .html files. Load index.html into your browser and play around. % make FORMATS=html-chunk should make one big HTML file instead, probably ~1MB in size. % make FORMATS=ascii should make one big .txt file, and 1 big HTML file (the .txt file is generated from the HTML file). This depends on Lynx being installed. % make FORMATS=rtf should make one big .rtf file which you can load into your favourite RTF viewer (Word, Star Office, whatever). Any problems, please let me know. To test PostScript and PDF generation Install the ports/print/jadetex port. THIS WILL INSTALL teTeX-beta if you haven't already got it. This is a ~ 30MB download, so you might not want to test this. If so, I understand. PS and PDF generation take a while. If you have installed this port, you should be able to do % make FORMATS=ps to generate a large handbook.ps file and % make FORMATS=pdf to make a PDF file. Use Ghostview to view them (or Ghostview for the PS and Adobe Acroread for the PDF -- Ghostview will read both formats though). This will generate some errors from Jade about undefined variables with 'jpja' in their names. You can safely ignore these for the time being. It will also create from LaTeX errors on some of the TeX passes. Again, you can ignore these. If you are able to successfully generate these formats with these tools, I'd very much like to know about it. Thanks, N -- C.R.F. Consulting -- we're run to make me richer. . . To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message