From mboxrd@z Thu Jan 1 00:00:00 1970 From: godoy@conectiva.com.br To: Jochem Huhmann Cc: docbook-tools-discuss@sourceware.cygnus.com Subject: Re: images in Docbook with Red Hat 6.2 Date: Wed, 27 Dec 2000 06:36:00 -0000 Message-id: References: <38F65807.4905D5C@cybercable.tm.fr> <00af01bfa571$69317680$1403a8c0@cogent.ca> <38F66342.9FD5F778@cybercable.tm.fr> <38F6E77C.66C4280E@cybercable.tm.fr> <38F779E7.9C0CA04D@cybercable.tm.fr> <38F78E74.4F14B78D@cybercable.tm.fr> X-SW-Source: 2000/msg00173.html Jochem Huhmann writes: > The actual problem (as so often with this stuff) is to make it easy to > use from a documentation writers point of view. Actually we don't need > any tools, we do need jade and stylesheets and DTD's and a Makefile. > Period. > > Someone who just wants to write and convert docs needs simple, straight, > well-documented tools with a man-page. With some commandline options or > with a GUI and with simple configuration files, with reasonable defaults > in /etc and his own in $HOME to override this. We should try to keep > that in mind. Tell these people about entities and driver files and such > and they won't use that at all. We work this way: 1. Linux platform 2. DocBook and OpenJade or DocBook and other converter 3. All pictures are in TIFF format (better quality) 4. Emacs + PSGML as editor (choose whatever you want. This gave us the easiness we needed to have plus an automation on validation of the document --- and syntax highlighting) 5. NFS for stylesheet and some common scripts --- I'm changing this to be a package now... 6. ImageMagick package (because of the graphical conversion tools) 7. teTeX Our makefile is called by a script in a command line that looks like this: $ compiles document format [stylesheet -- optional] [converter -- optional] document is the SGML document, format is one of the supported output formats of Jade/OpenJade (mif, html, jadetex, ...) or a combination of them (PS, DVI, ASCII, ...). Stylesheet is an optional stylesheet to be used and converter is used to choose between Jade and OpenJade, being OpenJade the default. When I choose "PS" backend, the script runs something similar to for i in `ls directory/images/tiff/*.tiff` ; do convert directory/images/tiff/$i directory/images/eps/`basename $i .tiff`.eps done and then call the Makefile with the correct options (runs collateindex, runs openjade, runs jadetex 3 times, runs dvips and finally calls gv). Authors use the option to insert figures (as I've sent before on this list). We have no problems here (more than 20 people writing documents and books)... PS:. We are in the process of changing some steps described, but this works perfectly. Regards, -- Godoy. Departamento de Publicações Publishing Department Conectiva S.A.