DOCBOOK-APPS: DiffMk trouble for DocBook documents
Hi all, I know this isn't the DiffMk list ;), but my hope is that some of the people that use Norm Co. Stylesheets for DocBook also use Norm's DiffMk (JAVA) Tool for DocBook. I have a problem with it which I couldn't resolve until now: I want to do a text diff on some DocBook files. This works fine but there is one thing I don't like: My root element is doubled when there was a change in one of it's attributes, i.e. I get something like book revisionflag=added fpi=my_fpibook revisionflag=deleted [...] /book/book Now, this is nice and fine if I go and manually change this to one modified book/ element or just discard the change. But I want to automate the creation of diff'ed versions of my DocBook files and would like to have *valid* DocBook as output of DiffMk w/o the need of manual post-processing. How can I tell DiffMk to either ignore this change on the root element *or* to mark it as modified? I tried to better understand the configuration files, but I don't have a clue where to start. My DiffMk.properties file looks like the following: #DiffMk.properties config=diffmk.xml validating=no namespaceaware=yes verbose=5 diff=text words=yes ignorewhitespace=yes #end diffmk.xml is the one delivered w/ the tool. Does anyone have had the same experience? Any suggestions, help? I'd very much appreciate any hint on that! Thanks a lot, Johann Richard Johann Richard IC DSP Design Engineer Dspfactory SA Champs-Montants 12a 2074 Marin-Epagnier Switzerland Tel: +41 32 755 7400 Fax: +41 32 755 7401 e-mail: mailto:[EMAIL PROTECTED] http://www.dspfactory.com
DOCBOOK-APPS: Index in HTML appears without hyperlinks
Hi List, I'm working with DocBook XSL 1.60.1 on SuSE Linux 7.0 or alternatively on Win 2k using Xalan-J 2.4.1 for the transformation. All works fine so far, but now I run into problems when generating an index. Within the compiled HTML Help the index works fine (that means, you can access the topics by clicking on the indexterms), but in HTML (chunked or not) it appears completely without hyperlinks. My indexterms within the docments all look like this: indextermprimaryJava 1.3/primaryseeJRE/see/indexterm I've got no idea what I'm doing wrong and didn't find a hint in the docs, faqs and list archives. It would be very nice if somebody could help me. Gisbert Amm http://web.de/
Re: DOCBOOK-APPS: Index in HTML appears without hyperlinks
Gisbert Amm wrote: My indexterms within the docments all look like this: indextermprimaryJava 1.3/primaryseeJRE/see/indexterm But this is not real indexterm. It will just add see indexterm entry into index. You must also have first class indexterms without see element. Like indextermprimaryJRE/primary/indexterm or indextermprimaryJava 1.3/primary/indexterm Jirka -- - Jirka Kosek e-mail: [EMAIL PROTECTED] http://www.kosek.cz
DOCBOOK-APPS: Using inline.monoseq in FO
Hi, I use this customization in my stylesheets for inline monospace fonts: xsl:template match=database xsl:call-template name=inline.monoseq/ /xsl:template But there is a problem: inline.monoseq uses attribute set monospace.properties, but it has set font-size attribute to 0.9em. That's not problem for para, but it's great problem for title in chapters or sections, for example: chapter title Table database class=tabletest/database /title ... /chapter Should I fire it as a bug? Martin Perina [EMAIL PROTECTED]
DOCBOOK-APPS: Re: glossdivs
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 / [EMAIL PROTECTED] was heard to say: | I am using $glossary.collection to import an external glossary, but my | glossdiv titles do not show up either in XHTML or FO. Only the contained | glossentries appear, as if no glossdivs were defined. Is this behaviour | expected? From what I could figure out reading glossary.xsl, they should be | processed just as if they were actually in the document. Am I missing | something? If you want glossdivs in your automatic glossary, put one in your dummy glossary: glossary role=auto glossdivtitlefoo/title glossentryglosstermirrelevant/glossterm glossdefpara//glossdef /glossentry /glossdiv /glossary Be seeing you, norm - -- Norman Walsh [EMAIL PROTECTED] | Puritanism--The haunting fear that http://www.oasis-open.org/docbook/ | someone, somewhere may be Chair, DocBook Technical Committee | happy.--H.L. Mencken -BEGIN PGP SIGNATURE- Version: GnuPG v1.0.6 (GNU/Linux) Comment: Processed by Mailcrypt 3.5.7 http://mailcrypt.sourceforge.net/ iD8DBQE+Nd5qOyltUcwYWjsRAicfAJwNzeBrgoqB2XrnDdc8Ca9joXM2uQCgh9Md 573FTs/HBI3vOGnymG0VejI= =/Ang -END PGP SIGNATURE-
DOCBOOK-APPS: Re: links to automatic glossary entries are broken
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 / [EMAIL PROTECTED] was heard to say: | In the FO stylesheets (up to 1.60.1), glossterms occuring inline point to a | id of the form gl. but when the glossary is generated, the gl. is | missing in the expansion of the corresponding glossentries. At least, when | a $glossary.collection is used. I patched it in my customization layer, but | unless this behaviour is expected, it would nice be good to correct it in | some next release. Fixed. Be seeing you, norm - -- Norman Walsh [EMAIL PROTECTED] | The way to get things done is not http://www.oasis-open.org/docbook/ | to mind who gets the credit of Chair, DocBook Technical Committee | doing them.--Benjamin Jowett -BEGIN PGP SIGNATURE- Version: GnuPG v1.0.6 (GNU/Linux) Comment: Processed by Mailcrypt 3.5.7 http://mailcrypt.sourceforge.net/ iD8DBQE+Nd2JOyltUcwYWjsRAqOPAKCuna3zyTndT63G4DqMeq8kl1HhSgCgm4ik BRq+ZB6JK4qAkeWtPN2mJjM= =sKhp -END PGP SIGNATURE-
RE: DOCBOOK-APPS: Images not included in PDF
Hello Bob, Thanks a lot for your help. I generated my FO file in different directory so the relative paths to the images were wrong. I thought the FO file was a binary file with the images encapsulated inside. Best regards Jean-Marc -Message d'origine- De :Bob Stayton [mailto:[EMAIL PROTECTED]] Envoyé :dimanche 26 janvier 2003 03:05 À : Jean-Marc Fontaine Cc :[EMAIL PROTECTED] Objet : Re: DOCBOOK-APPS: Images not included in PDF On Fri, Jan 24, 2003 at 06:32:31PM +0100, Jean-Marc Fontaine wrote: Hello, I have a XML DocBook document, with images references : figure title/title mediaobject imageobject imagedata align=center fileref=images/ges_com/menu.png format=PNG / /imageobject /mediaobject /figure The path to the images is correct. When I generate the HTML file using Saxon, everything is ok but when I try to generate the PDF with Saxon and FOP the images are missing in the generated PDF. I tried the images.fo file from the FOP examples and the generated PDF file includes the images so I think my way to launch FOP is right. I believe I am doing something wrong whether while calling Saxon whether in my XML DocBook document. My Saxon command line for generating the FO is the following : java -cp saxon.jar;saxon-fop.jar;../DocBook-XSL/extensions/saxon651.jar;../Xerces/xercesImpl.jar -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl com.icl.saxon.StyleSheet -o ..\..\Sortie\FO\Documentation.fo ..\..\Documentation\Documentation.xml ..\..\DocBook-XSL\fo\docbook.xsl fop.extensions=1 My FOP command line for generating the PDF is the following : java -cp build\fop.jar;lib\batik.jar;lib\xalan-2.3.1.jar;..\Xerces\xercesImpl.jar;lib\xml-apis.jar;lib\avalon-framework-cvs-20020315.jar;lib\logkit-1.0.jar;lib\jimi-1.0.jar org.apache.fop.apps.Fop -fo ..\..\Sortie\FO\Documentation.fo -pdf ..\..\Sortie\PDF\Documentation.pdf Maybe I forgot some Saxon command line parameter ... Can someone help me please ? Can you peek in your fo file with a text editor to see if the reference to the graphic is in there with the right path? If so, then perhaps the problem is one of relative paths. It looks like you are passing to FOP a relative path to your fo file. Perhaps the relative path of the graphic doesn't add up. Do you get any error message about graphic file not found? -- Bob Stayton 400 Encinal Street Publications Architect Santa Cruz, CA 95060 Technical Publications voice: (831) 427-7796 The SCO Group fax: (831) 429-1887 email: [EMAIL PROTECTED]
DOCBOOK-APPS: XMLSPY and DocBook
Hi, I am considering using DocBook to create a Manual of Procedures. Ideally I'd like to do so in an environment that is easy for those who are unfamiliar with programming and mark up to understand. Currently I am trying to use XMLSPY. If someone has attempted this before I would very much appreciate input into the feasibility of this plan or if someone can suggest an information resource that would be great too. Thanks, Corey
Re: DOCBOOK-APPS: XMLSPY and DocBook
I've tried to let our authors use XMLSpy, but that didn't work out too great. It's ok for simple things, but for tables formulas documents bigger than let's say 3 chapters of 5 section's each, you're out of luck. Also I found the stylesheets to be not so great, and it was very slow with a document of a reasonable size (50 kb+). If you're willing to spend some money, you're imho better off with Epic (www.arbortext.com) (considering that XmlSpy isn't cheap either...) You can mail me if you have specific questions about XmlSpy DocBook, if you want. cheers, roel Corey Arnold wrote: Hi, I am considering using DocBook to create a Manual of Procedures. Ideally I'd like to do so in an environment that is easy for those who are unfamiliar with programming and mark up to understand. Currently I am trying to use XMLSPY. If someone has attempted this before I would very much appreciate input into the feasibility of this plan or if someone can suggest an information resource that would be great too. Thanks, Corey
Re: DOCBOOK-APPS: XMLSPY and DocBook
Hi Cory, Try XXE, it's a very powerful and free DocBook editor on JAVA base. Cheers, Tom At 14:49 27.01.03 -0600, Corey Arnold wrote: Hi, I am considering using DocBook to create a Manual of Procedures. Ideally I'd like to do so in an environment that is easy for those who are unfamiliar with programming and mark up to understand. Currently I am trying to use XMLSPY. If someone has attempted this before I would very much appreciate input into the feasibility of this plan or if someone can suggest an information resource that would be great too. Thanks, Corey
Re: DOCBOOK-APPS: XMLSPY and DocBook
Hi, is jEdit with XML/XSLT plugins suitable for DocBook authoring? I do all of text processing in vi myself, but just wondering for the sake of other users. David
DOCBOOK-APPS: Re: FOP: margin-left and margin-right = 0
Norman Walsh [EMAIL PROTECTED] : Are you setting $page.margin.inner or $page.margin.outer in your customization layer? I don't see anywhere in the stylesheets where 0 is used for a left or right margin. Looks like there can be either problem on my side and on stylesheets side. I have diged my customization again and found separated old entry: xsl:param name=title.margin.left0/xsl:param I have changed it to: xsl:param name=title.margin.left0cm/xsl:param and all mentioned warnings are no more generated. The problem is: when I added unit only for .left side why both sides as margin-left and margin-right were influenced ? Is everything fine in that matter ? ABX
Re: DOCBOOK-APPS: XMLSPY and DocBook
Corey Arnold ([EMAIL PROTECTED]) wrote: I am considering using DocBook to create a Manual of Procedures. Ideally I'd like to do so in an environment that is easy for those who are unfamiliar with programming and mark up to understand. Currently I am trying to use XMLSPY. If someone has attempted this before I would very much appreciate input into the feasibility of this plan or if someone can suggest an information resource that would be great too. And what about epcEdit (www.epcedit.com)? Very capable, multi-platform, non-Java (performance) and the new version will have some very nice goodies. My $0.02 Sincerely, Gour -- Gour [EMAIL PROTECTED] Registered Linux User #278493
Re: DOCBOOK-APPS: XMLSPY and DocBook
I've used jEdit with the plugins, and it's a decent editor. It can validate on keystroke, and suggests available tags, but I wouldn't recommend it for business authors (those not used to seeing markup). I prefer Arbortext Epic for major edits, but jEdit is great for quick edits. Best regards, --Scott David Tolpin wrote: Hi, is jEdit with XML/XSLT plugins suitable for DocBook authoring? I do all of text processing in vi myself, but just wondering for the sake of other users. David
Re: DOCBOOK-APPS: XMLSPY and DocBook
On Mon, Jan 27, 2003 at 02:49:07PM -0600, Corey Arnold wrote: I am considering using DocBook to create a Manual of Procedures. Ideally I'd like to do so in an environment that is easy for those who are unfamiliar with programming and mark up to understand. Currently I am trying to use XMLSPY. If someone has attempted this before I would very much appreciate input into the feasibility of this plan or if someone can suggest an information resource that would be great too. You might also take a look at the Morphon XML-Editor (www.morphon.com), it is cheaper than XML Spy and has a 30-day trial license and comes with a DocBook stylesheet and DTD. -- Bart.
RE: DOCBOOK-APPS: XMLSPY and DocBook
Corey, I've used most of the editors that people have mentioned, including XXE and Morphon. If you can afford them, stick to Epic or Xmetal. Either will serve you well; whereas, the others will lack features that you'll surely need. I currently use Xmetal, mostly because of nasty experiences with earlier versions of Epic. Bill Lawrence Matrix Solutions -Original Message- From: Corey Arnold [mailto:[EMAIL PROTECTED]] Sent: Monday, January 27, 2003 3:49 PM To: [EMAIL PROTECTED] Subject: DOCBOOK-APPS: XMLSPY and DocBook Hi, I am considering using DocBook to create a Manual of Procedures. Ideally I'd like to do so in an environment that is easy for those who are unfamiliar with programming and mark up to understand. Currently I am trying to use XMLSPY. If someone has attempted this before I would very much appreciate input into the feasibility of this plan or if someone can suggest an information resource that would be great too. Thanks, Corey
Re: DOCBOOK-APPS: XMLSPY and DocBook
Stefan Drees ([EMAIL PROTECTED]) wrote: ... did You actually try it? It's a tcl script using wish and the tksmgl-lib. So performance on my machine linux 2.4 256 MB Mem, PIII-450 was not really that visible, ok for a tcl/tk script. Yes, I'm using it here with Celeron 566 256 RAM. I loaded the DocBook: The Definitive Guide sources and after initial loading, performance was quite OK (the engine of epcEdit is also written in C++). I tested version 1.2.4 by the way, the new one as of today. There are three sample DocBook files as of v4.1.2 included, but there are only 2 views offered: Text and Layout. Here I have all the Views available. - If you enter Text-View, a tip-of-the-day window pops up and asks you to better only use text-view, in case layout-view does not really work (like no template for visualizing etc.) - Layout is a markup-dominated view like ___ __ | \ / | |title A Title between some funny Limiters title| | /\ | --| (In fixed spacing fonts you get the idea) This view is probably not what someone unfamiliar with programming and mark up wants to work in. Well, if you don't like markup, you can simply switch it off, but be assured that if someone wants to author structured (like DocBook) documents, he must have some idea of markup, tags .. Tools like xmlspy offer (in version 5+) on windows plattform so called authentic views on docbook instances that seems to be more adequate for the casual Manual of Procedures user. Multi-platform capability (Win, Linux, Mac OSX) is a definitve plus for me. If you want, you can completely customize stylesheet for every DTD tag to get the more authentic view and the upcoming V2 will have support for CSS stylesheets and Both have a tabular view in which especially tables are quite nice to edit. inline tables as well :-) Sincerely, Gour -- Gour [EMAIL PROTECTED] Registered Linux User #278493
Re: DOCBOOK-APPS: Re: Is it time to rely on CSS? -- Yes
Elliot Rusty Harold replies to Adam di Carlo's Even if Netscape 4 didn't support CSS1, why should we sacrifice the convenience of style formatting for 95% of the authors/users because of the bugginess of the 5% ? Anyhow, even if the 5% can't see the style, surely the document would still be legible to them. with: I'm not willing to throw away 5% of readers to satisfy some ideological notion of HTML purity. I will only move forward to new technologies when they are truly ubiquitous or provide features I need that are simply not available using the old techniques. CSS doesn't meet that criteria. It doesn't help me do anything I need to do with my DocBook books I can't do with plain HTML. I am most certainly willing to sacrifice that 5%. Okay, sacrifice is too strong a word, here. Let's say discomfit. We're talking about stylesheets, not content. True, the loss of highlighting and other stylistic signals often represents a loss of information, but that already happens to a sizable degree when we attempt to display tables and images on Netscape 4.X and earlier browsers. The loss is manageable, survivable, and--in my opinion--acceptable. If your clients complain about the look of the documents, explain that your documents are optimized for W3C-compliant browsers and, maybe, offer an alternate output (PDF, for instance). Compromising with downlevel technology provides a cozy disincentive to upgrading. The big problem I see with going to CSS is that it's just one more task, one more fiddly bit I have to tweak, one more requirement I have to get my writers to include in order to make their documents look good. Ah well, such is the world of modern technology: we move with the flow of traffic, or we let it run us over. So, despite my personal comfort level with the current state of DocBook-produced HTML documents, I believe DocBook should evolve to be producing HTML 4.1 documents with CSS2 stylesheets (separate stylesheets, not a stylesheet coded into the html document) for the broadest range and finest control of customization. CSS2 and HTML 4.1 are the standards that all browser developers should now be working toward. We should be working to reach and promote that same standard. Dennis Grace Information Developer IBM Linux Technology Center (512) 838-3937 T/L 678-3937 cell: (512)-296-7830 [EMAIL PROTECTED] There are only 10 kinds of people in the world: those who understand binary and those who don't.
DOCBOOK-APPS: Re: DiffMk trouble for DocBook documents
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 / Johann Richard [EMAIL PROTECTED] was heard to say: | I have a problem with it which I couldn't resolve until now: | | I want to do a text diff on some DocBook files. This works fine | but there is one thing I don't like: My root element is doubled | when there was a change in one of it's attributes, i.e. I get | something like | | book revisionflag=added fpi=my_fpibook revisionflag=deleted | [...] | /book/book That's odd. Can you send me (offlist) a sample that demonstrates this? | How can I tell DiffMk to either ignore this change on the root | element *or* to mark it as modified? I tried to better understand | the configuration files, but I don't have a clue where to start. I recently changed the rules for diff to ignore attributes. Be seeing you, norm - -- Norman Walsh [EMAIL PROTECTED] | If all mankind were to disappear, http://www.oasis-open.org/docbook/ | the world would regenerate back to Chair, DocBook Technical Committee | the rich state of equilibrium that | existed ten thousand years ago. If | insects were to vanish, the | environment would collapse into | chaos.--Edward O. Wilson -BEGIN PGP SIGNATURE- Version: GnuPG v1.0.6 (GNU/Linux) Comment: Processed by Mailcrypt 3.5.7 http://mailcrypt.sourceforge.net/ iD8DBQE+Np2EOyltUcwYWjsRAiNKAJ0QBPACxOpacqr75//qZOKvCMO1aACbB3aN 7SdUR8BN6l0NKUT9njlC7ko= =BLLH -END PGP SIGNATURE-
DOCBOOK-APPS: Re: Using inline.monoseq in FO
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 / Martin Perina [EMAIL PROTECTED] was heard to say: | But there is a problem: inline.monoseq uses | attribute set monospace.properties, but | it has set font-size attribute to 0.9em. That's | not problem for para, but it's great problem | for title in chapters or sections, for example: Why is it a great problem? The result should be 90% of the paragraph size in the first case and 90% of the title size in the second. Are you getting a different result, or do you not like that result? Be seeing you, norm - -- Norman Walsh [EMAIL PROTECTED] | Irrationally held truths may be http://www.oasis-open.org/docbook/ | more harmful than reasoned Chair, DocBook Technical Committee | errors.--T. H. Huxley -BEGIN PGP SIGNATURE- Version: GnuPG v1.0.6 (GNU/Linux) Comment: Processed by Mailcrypt 3.5.7 http://mailcrypt.sourceforge.net/ iD8DBQE+NpxkOyltUcwYWjsRAhdHAKCtTGiWJt3hWT9ibp/ZAYKYvhHXaQCfYAVc JwBuZOIrBSfGLELxIKtIals= =1Pf8 -END PGP SIGNATURE-
Re: DOCBOOK-APPS: XMLSPY and DocBook
(My previous post too fast and far too useless, sorry) On Tue, Jan 28, 2003 at 03:45:50PM +0100 - a wonderful day - Gour wrote: Corey Arnold ([EMAIL PROTECTED]) wrote: I am considering using DocBook to create a Manual of Procedures. Ideally I'd like to do so in an environment that is easy for those who are unfamiliar with programming and mark up to understand. Currently I am trying to use XMLSPY. If someone has attempted this before ... Editing the sample DocBook instances in xmlspy (a c++-driven parser/gui if i remember that correctly) makes my w2k governed 800 MHz AMD Duron with 256 MB Memory become very ssslllow. So I guess a 1000 pages Manual of Procedures with a lot of figures and indexes etc. might make the experience of pure content editing in the so called authentic view a bit unsatisfactory. And what about epcEdit (www.epcedit.com)? Hm, ok I tried out of curiosity ... Very capable, multi-platform, non-Java (performance) ... did You actually try it? It's a tcl script using wish and the tksmgl-lib. So performance on my machine linux 2.4 256 MB Mem, PIII-450 was not really that visible, ok for a tcl/tk script. and the new version will have some very nice goodies. I tested version 1.2.4 by the way, the new one as of today. There are three sample DocBook files as of v4.1.2 included, but there are only 2 views offered: Text and Layout. - If you enter Text-View, a tip-of-the-day window pops up and asks you to better only use text-view, in case layout-view does not really work (like no template for visualizing etc.) - Layout is a markup-dominated view like ___ __ | \ / | |title A Title between some funny Limiters title| | /\ | --| (In fixed spacing fonts you get the idea) This view is probably not what someone unfamiliar with programming and mark up wants to work in. Tools like xmlspy offer (in version 5+) on windows plattform so called authentic views on docbook instances that seems to be more adequate for the casual Manual of Procedures user. Both have a tabular view in which especially tables are quite nice to edit. HTH and All the best, s t e f a n. -- Stefan Drees, [EMAIL PROTECTED] Fingerprint = 516C C4EF 712A B26F 15C9 C7B7 5651 6964 D508 1B56
Re: DOCBOOK-APPS: XMLSPY and DocBook
On Tue, Jan 28, 2003 at 03:45:50PM +0100 - a wonderful day - Gour wrote: Corey Arnold ([EMAIL PROTECTED]) wrote: I am considering using DocBook to create a Manual of Procedures. Ideally I'd like to do so in an environment that is easy for those who are unfamiliar with programming and mark up to understand. Currently I am trying to use XMLSPY. If someone has attempted this before I would very much appreciate input into the feasibility of this plan or if someone can suggest an information resource that would be great too. And what about epcEdit (www.epcedit.com)? Very capable, multi-platform, non-Java (performance) and the new version will have some very nice goodies. My $0.02 Sincerely, Gour -- Gour [EMAIL PROTECTED] Registered Linux User #278493 -- All the best, s t e f a n. -- Stefan Drees, [EMAIL PROTECTED], www.sdrees.de, +49 (700) 73733 733. Fingerprint = 516C C4EF 712A B26F 15C9 C7B7 5651 6964 D508 1B56
RE: DOCBOOK-APPS: XMLSPY and DocBook
Also try oXygen (http://www.oxygenxml.com), this application is young, but has loads of potential. I have used it to create a number of manuals. -Original Message- From: Corey Arnold [mailto:[EMAIL PROTECTED]] Sent: Tuesday, January 28, 2003 7:49 AM To: [EMAIL PROTECTED] Subject: DOCBOOK-APPS: XMLSPY and DocBook Hi, I am considering using DocBook to create a Manual of Procedures. Ideally I'd like to do so in an environment that is easy for those who are unfamiliar with programming and mark up to understand. Currently I am trying to use XMLSPY. If someone has attempted this before I would very much appreciate input into the feasibility of this plan or if someone can suggest an information resource that would be great too. Thanks, Corey
DOCBOOK-APPS: link in pdf
I ahve something like the following but the likk doens't appear in the pdf (via fop) screen ulink url=http://jdbforms.sourceforge.net;citetitlehttp://jdbforms.sourceforge.net/citetitle/ulink If that's for html only, is there a way to get a link in a pdf there? TIA -- shawn [EMAIL PROTECTED]
