[docbook] Recommendation on V4.5 DTD vs. V5.0 RELAX NG

2007-09-17 Thread Joachim Ziegler
you for any advice. Regards, Joachim Ziegler - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]

Re: [docbook] Recommendation on V4.5 DTD vs. V5.0 RELAX NG

2007-09-17 Thread Joachim Ziegler
Thank you for your advice! Nic Gibson wrote: Hi Joachim, I can't give an absolute recommendation but I've successfully migrated to a DocBook 5.0 toolchain (vim instead of I do not mean migrating my old content form 4.x to 5.0. I mean starting a brandnew project, and I wonder whether I should

Re: DOCBOOK-APPS: FOP: No ImageReader when using PDF as vector format

2003-03-17 Thread Joachim Ziegler
Shawn wrote: Hi, I had the same problem and ended up adding image support for FOP. The Jimi image library, which is by default used for processing images in PNG and other formats, was removed from the distribution for licensing reasons. So...: Either a) obtain Jimi from

DOCBOOK-APPS: FOP: No ImageReader when using PDF as vector format

2003-03-11 Thread Joachim Ziegler
Hello, Bob Stayton writes in Using the XSLT Sheets that FOP can handle PDF as a vector format: Table 16.6. FO processor supported graphics formats FO Processor Bitmap formats Vector formats FOP PNG JPEG SVG PDF But I get the following error from FOP 0.20.5rc2 [ERROR] Error while creating area :

Re: DOCBOOK: No attribute value 'PDF' in imagedata

2003-03-07 Thread Joachim Ziegler
Bob Stayton wrote: In the meanwhile, you can extend the list in notation.class using local.notation.class to allow PDF by adding this to your DOCTYPE in each file: !DOCTYPE book PUBLIC ... ... [ !ENTITY % local.notation.class | PDF ] That should enable validation. It seems that xmllint can't

Re: DOCBOOK: No attribute value 'PDF' in imagedata

2003-03-07 Thread Joachim Ziegler
Daniel Veillard wrote: Strange ... I don't know DocBook DTD, before saying it's a libxml2 bug I would like a full example. But please check first with a recent version 2.4.12 is really old (current is 2.5.4). http://xmlsoft.org/bugs.html Sorry, but this is hard to do for me. I would have to

Re: DOCBOOK: No attribute value 'PDF' in imagedata

2003-03-07 Thread Joachim Ziegler
Daniel Veillard wrote: it as a notation. Try to add !NOTATION PIC SYSTEM PIC in the internal subset of the document, and see if this validates, I bet it's the problem :-) OK, I got now !ENTITY % local.notation.class | PDF !NOTATION PDF SYSTEM PDF and it works! Thank

DOCBOOK: No attribute value 'PDF' in imagedata

2003-03-06 Thread Joachim Ziegler
Hello, I've just tried the following from Bob Staytons 2using the XSLT Stylesheets: Example 16.1. Multiple graphics in a mediaobject mediaobject id=MousePicture imageobject role=html imagedata format=PNG fileref=mouse.png/ /imageobject imageobject role=fo imagedata

Re: DOCBOOK-APPS: No simplelist in PDF-output / Pictures out twice

2003-02-27 Thread Joachim Ziegler
Bob Stayton wrote: Are you using any customizations that might affect the simplelist? Any customizations of its ancestors? No. All I do is xsl:import href=/KM/usr/ziegler/DocBook/docbook-xsl-1.59.2/fo/docbook.xsl/ xsl:param name=section.autolabel select=1/ xsl:param

Re: DOCBOOK-APPS: Use of titleabbrev in list of figurea and tables

2003-02-21 Thread Joachim Ziegler
Bob Stayton wrote: I'm just wondering why titleabbrevs are not used in the list of figures/tables. You could file a Request for Enhancement (RFE) at DocBook's SourceForge site. Speaking for myself, I wouldn't want to see this as the default behavior, but it could be an option. Hmm,

Re: DOCBOOK-APPS: Strange problem: no footnotes generated

2003-02-20 Thread Joachim Ziegler
Nicolas Nieswandt wrote: Joachim Ziegler wrote: No no, my file is valid! :-( Are you really sure? ;-) I discoverd no problems with the stylesheets concerning footnotes. So some more information would be nice, in order to guide you to the solution. You can have a look at the missing

DOCBOOK-APPS: Use of titleabbrev in list of figurea and tables

2003-02-20 Thread Joachim Ziegler
Hello, I'm just wondering why titleabbrevs are not used in the list of figures/tables. I have some tables and figures with a quite long description (given in title/title) and a short description (given in titleabbrev../titelabbrev). Now in the running text, when I have an xref to such a

Re: DOCBOOK-APPS: Strange problem: no footnotes generated

2003-02-19 Thread Joachim Ziegler
Nicolas Nieswandt wrote: What does your markup look like ? If you are using footnotecontent/footnote No no, my file is valid! :-( try footnoteparacontent/para/footnote footnotesimparacontent/simpara/footnote I know. Thank you anyway. Joachim

Re: DOCBOOK-APPS: Breaking a document into smaller pieces

2003-02-18 Thread Joachim Ziegler
Daniel Veillard wrote: And that's normal. You must provide the encoding information if it can't be guessed as UTF8 or UTF16. Your file is not well formed XML as is. Daniel ok, I do now: xmllint -valid --encode ISO-8859-1 --noout LEDATutorium.xml Compilation finished at Tue Feb 18 11:49:51

DOCBOOK-APPS: Strange problem: no footnotes generated

2003-02-18 Thread Joachim Ziegler
Hello, I just came across a strange problem: From a certain point on in the middle of my document, in the middle of a sect2, no footnotes are generated any more by the XSLT stylesheets (1.59.2 with HTML output). To be more precise: the link to the footnote and the corresponding number is

DOCBOOK: Markup for operators in a programming language

2003-02-17 Thread Joachim Ziegler
How do I markup an operator like ++? Is something like The operator function++/function increments its operand. ok? (Every operator can be seen as a function.) Greetings, Joachim

Re: DOCBOOK-APPS: Breaking a document into smaller pieces

2003-02-17 Thread Joachim Ziegler
Rune Enggaard Lausen wrote: At the end of each subdocument, you put a comment similar to !-- Local Variables: mode: xml sgml-parent-document: (master-file.xml) End: -- Substitute the name of your file containing the DOCTYPE for master-file.xml. The next time you load the

Re: DOCBOOK-APPS: Breaking a document into smaller pieces

2003-02-14 Thread Joachim Ziegler
Rune Enggaard Lausen wrote: I'm using Emacs with psgml. Using method a) does not allow me to associate any DTD to my chunk, so psgml is worthless, right? Wrong :-) At the end of each subdocument, you put a comment similar to !-- Local Variables: mode: xml sgml-parent-document:

Re: DOCBOOK-APPS: Breaking a document into smaller pieces

2003-02-14 Thread Joachim Ziegler
Bob Stayton wrote: You need to use olinks in a modular document only if you want to be able to validate each module. If you don't use olink, then when you try to validate a module by itself, any xref or link pointing to another module will be reported as missing the ID. But if you only care

DOCBOOK-APPS: Breaking a document into smaller pieces

2003-02-13 Thread Joachim Ziegler
Hello, I have a document that is getting larger and larger. Can someone please tell what's the state of the art concerning breaking a document into smaller physical chunks? a) using entities as described in The Definite Guide: !ENTITY chap1 SYSTEM chap1.sgm !ENTITY chap2 SYSTEM chap2.sgm ]

Re: DOCBOOK: Am I using DocBook appropriately?

2003-02-03 Thread Joachim Ziegler
Tobias Reif wrote: I think numbered sections (like sect1) aren't as common now as they once were, with nested sections being used more, but that's just an impression I have. I don't know how accurate it is. I see; I could simply use section elements and none of sect[1-5]. That's news to

DOCBOOK: Highlights vs. Abstract

2003-01-31 Thread Joachim Ziegler
I'm just wondering what the difference is and when I should use which tag. Can somebody explain to me or give a good example? Greetings, Joachim

DOCBOOK-APPS: Including only a part of an external source code

2003-01-24 Thread Joachim Ziegler
Hello, I'm planning to use DocBook to write a tutorial for the LEDA library (Library of Efficient Data Types and Algorithms). In this tutorial I will present many quite long code examples. i.e. source files of about 100 lines. I've just learned how I can include an external code file with

Re: DOCBOOK-APPS: Including only a part of an external source code

2003-01-24 Thread Joachim Ziegler
[EMAIL PROTECTED] wrote: When I was working on a book last year, writing using DocBook, I wound up splitting the files into fragments, and having a Makefile manage Thank you. That's a good idea. In my case, it would suffice to only specify the line numbers from (between) which source code

Re: DOCBOOK: Inserting external code into docbook

2002-10-24 Thread Joachim Ziegler
Am Mittwoch, 23. Oktober 2002 18:26 schrieb Bob Stayton: Looking back in the archives, it seems that this is how you do it with 4.1.2: programlisting inlinemediaobject imageobject imagedata fileref=myfunc.c format=linespecific/ /imageobject /inlinemediaobject

DOCBOOK: Markup for keywords in programs

2002-10-23 Thread Joachim Ziegler
What is the correct markup for a keyword like 'while' or 'for' in a programming language? Is it tokenwhile/token ? Greetings, Joachim

DOCBOOK: Inserting external code into docbook

2002-10-23 Thread Joachim Ziegler
According to question 26 in the DocBook Markup FAQ, I tried the following: -- (Bob Stayton says) You can use following construct to include external code. You only need the inlinemediaobject wrapper if you are using 4.1.2. programlistinginlinemediaobject

Re: DOCBOOK: Re: Markup for exercises

2002-10-12 Thread Joachim Ziegler
Am Samstag, 12. Oktober 2002 12:13 schrieb [EMAIL PROTECTED]: exercise exerciseinfo...as in sectioninfo.../exerciseinfo setup...information on what is needed to setup the exercise, student data etc.../setup scenario.../scenario task

Re: DOCBOOK: Re: Markup for exercises

2002-10-11 Thread Joachim Ziegler
Am Freitag, 11. Oktober 2002 17:25 schrieb Stephan Wiesner: exercises with the same solution. I then developed a style sheet to create documents with the exercises displayed in the text flow and the solutions at the end (both linked), or not at all, depending on the purpose. This is exactly

Re: DOCBOOK: Re: Markup for exercises

2002-10-11 Thread Joachim Ziegler
Am Freitag, 11. Oktober 2002 18:25 schrieb [EMAIL PROTECTED]: Perhaps these might be useful? (or something similar)... exercise exerciseinfo...as in sectioninfo.../exerciseinfo setup...information on what is needed to setup the exercise, student data etc.../setup

Re: DOCBOOK: Markup for exercises

2002-10-10 Thread Joachim Ziegler
Am Donnerstag, 10. Oktober 2002 00:23 schrieb Steve Ball: What do you mean by exercises? I mean something like exercise level=graduate paraProof that the traveling salesman problem is NP-complete./para /exercise When I talk about exercises I mean practical exercises, as in an examination

DOCBOOK: Re: Markup for exercises

2002-10-10 Thread Joachim Ziegler
Am Donnerstag, 10. Oktober 2002 14:46 schrieb Norman Walsh: In computer hardware and software documentation? Maybe. Maybe not. Exercises seem more like a teaching tool, an extension for tutorial documentation, perhaps. Still, the question has come up before. I wonder what else fits in that

Re: DOCBOOK: Re: Markup for exercises

2002-10-10 Thread Joachim Ziegler
Am Donnerstag, 10. Oktober 2002 18:50 schrieb Dave Pawson: If DocBook is not the right DTD for writing a book about programming (including exercises), what else in the XML world is? Should I stick with Latex? grin/ Sounds like a bribe/blackmail Joachim? I'd suggest stick with latex

DOCBOOK: Markup for definitions

2002-10-09 Thread Joachim Ziegler
Suppose I write a sentence like A *process* is a programm in execution. The word process should be emphasized in both the HTML and the PDF version. Later, whenever I speak of processes, I want to have a link to the definition above (in the HTML version). Moreover, the word process should

DOCBOOK: Markup for exercises

2002-10-09 Thread Joachim Ziegler
Hello, I'm just wondering why there is no special markup for exercises in DocBook, when there's something as specialized as a DestructorSynopsis which you can only use when you write about an OO language that has support for destructors. I know, I can simulate exercise with para

Re: DOCBOOK-APPS: FO customization doc available

2002-10-09 Thread Joachim Ziegler
Am Mittwoch, 9. Oktober 2002 10:26 schrieb Bob Stayton: You can browse it all at: http://www.sagehill.net/xml/docbookxsl/index.html is there a downloadable version? greetings, j.

Re: DOCBOOK-APPS: FO customization doc available

2002-10-09 Thread Joachim Ziegler
Am Mittwoch, 9. Oktober 2002 18:50 schrieb Bob Stayton: Making FO is the easy part. 8^) Getting good PDF with the free FO processors is the hard part. i'd be glad to get at least *some* PDF out of it. :-) i didn't manage to install PassiveTex yet (under linux). it was too complicated for

DOCBOOK-APPS: DSSSL or XSL? Which tools?

2002-09-26 Thread Joachim Ziegler
hello, (maybe this has been asked here a 1000 times, but i can't find it in the FAQ) i've finally produced my first DocBook document. now i want to transform it into nice looking pdf. the output must be of high qualitiy because someday it will go into print. what's more worth learning: DSSSL

Re: DOCBOOK-APPS: Goal and Conclusion Tags

2002-09-22 Thread Joachim Ziegler
Am Sonntag, 22. September 2002 11:33 schrieb Jirka Kosek: You can use role attribute for distinguish normal section from goal, e.g. section role=goal ... /section This allows you to process your document selectively and doesn't enforce you to modify DocBook and stylesheets.