Re: [docbook] DocBook Fink report

Just to make one thing clear: the Mac OS X binaries for libxml2 and libxslt are completely independent of Tcl.

Although some of my projects are concerned with Tcl (eg. TclXML), I also have some that are not (libxml2, XSLTSL).  There are also some applications available that hide the Tcl dependency (tkxmllint, tkxsltproc).

Cheers,

Steve Ball

 

 
---
 

 
Steve Ball            |   XSLT Standard Library   | Training & Seminars
 
Explain         |     Web Tcl Complete      |   XML XSL Schemas
 
http://www.explain.com.au/ |      TclXML TclDOM        | Tcl, Web Development
 
  +---------------------------+---------------------
 
Ph. +61 2 6242 4099   |   Mobile (0413) 594 462   | Fax +61 2 6242 4099
  

On 06/10/2005, at 11:45 PM, Brad Tombaugh wrote:

Rich, you've discovered that DocBook can have a bit of a steep learning curve...  Its worth working through, in my opinion, and you'll get there shortly.

There have never been too much Mac OS X specific material available...  The earliest item that I had found was a packaged installer from Project: Omega in France.  "Mezis has gathered several XML-related tools out there in order to build a comprehensive DocBook processing package, initially for the team at Project:Omega. The result of this work is the DocBook-X package" which you can find at:

http://www.projectomega.org/subcat.php?lg=en&php=products_docbook

They offer a tutorial as well, but I've not looked at it in some time, so I can't comment on how useful it may be for you.  As I recall it was a good overview of the document creation cycle, although it may be a bit out of date as well.

A more recent resource is Steve Ball's Tcl front-end for XSLT processing, found at:

http://www.explain.com.au/oss/libxml2xslt.html

Steve's site also offers Mac OS X binaries of libxml and libxslt, eliminating the need for Fink.

--------

Brad Tombaugh

mailto:

http://www.Tombaugh.org

On Oct 6, 2005, at 2:29 AM, Rich Morin wrote:

 

At 12:44 PM +0900 10/6/05, Michael Smith wrote:

 

Caveat: I would guess that page is probably not up to date. But

perhaps you can volunteer to update it after you're done getting

your kit set up. :-)

 

   psgml           - couldn't find it!!!

 

Assuming that I'm successful, and that we can finesse the little

"immmutable page" notice at the bottom of the page, I'd be quite

happy to do so.

 

Bad place to start.

The best place to start now is with Bob Stayton's "DocBook XSL:

The Complete Guide" -

  http://www.sagehill.net/docbookxsl/index.html

That is up to date and will tell you pretty much everything you

need to know.

... If you are starting fresh with DocBook, you should use the

XSL-based toolchain, following the steps in Bob's book.

 

Let me get this straight.  I should ignore a document that tells

me that I can process a docbook file into (say) HTML with a single

command.  Instead, I should fish my way through 20+ pages of dense

installation and configuration information in Bob's book, trying to

figure out which instructions might be applicable to the programs

that I (supposedly) just installed.  I begin to see the problem.

Well, there are some things I can determine:

  % which pdftex

  /sw/bin/pdftex

  % which xsltproc

  /sw/bin/xsltproc

I look into installing xmlto, but it requires a different getopt

than OSX has.  I try installing the suggested getopt, but it does

not build on OSX.  The problem becomes a bit clearer.

I then look into "Docbook XSL", trying to find a "Hello World",

such as the one in the "Crash Course".  No such luck; instead, I

find a long-winded chapter on "XML catalogs".  Moan.

The "Crash Course" may be out of date, but it HAS THE RIGHT IDEA.

A newby needs an easy way to get things set up, determine that the

needed commands are all present, and get some plausible results.

THEN, s/he can be told that there are better (though more complex)

ways to do things.

So, what I'd like is a short example file and some equally short

commands to turn it into HTML and PDF.  Can someone supply these,

so that I can put them into the wiki?

-r

-- 

email: ; phone: +1 650-873-7841

http://www.cfcl.com        - Canta Forda Computer Laboratory

http://www.cfcl.com/Meta   - The FreeBSD Browser, Meta Project, etc.
 

---------------------------------------------------------------------

To unsubscribe, e-mail: 

For additional commands, e-mail: