[docbook-apps] article / info / author / address - how do I make it appear?

2010-07-18 Thread Jochen+oasis-open
I searched Bob's book for that (paper and online),
but to no success.

I wrote a little document,
and it's necessary, that it shows my address.

Any pointer pls?

Kind regards,
J.

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



Re: [docbook-apps] article / info / author / address - how do I make it appear?

2010-07-18 Thread Jochen+oasis-open
 Denis Bradford writes:

 Hi Jochen

Hi, Denis,

you are my diligent tutor!
Thanks a lot for that!

 According to 'DocBook 5: The Definitive Guide'
 (http://www.docbook.org/tdg51/en/html/info.html), article/info is not
 designed to appear in output:

Well, if it comes to processing and output orientation,
I have never used to look at TDG4 resp TDG5 for the last 12 years or so,
but always at Bob Stayton's book.

Maybe that was a fault.

On the other hand:
How holy are Processing expectations in the TDG?
It wouldn't really be against the spirit of a DocBook article to show the 
author details,
if the user requested that on purpose,
or is this regarded as simply incorrect by the community and the gurus?

I mean for a general purpose document (be it of type article),
what sense does that restriction make?

I hope, I do not unnecessarily restart old discussions.
Maybe somebody points me at an ancient agreement on this matter.

 ==
 Description

 The info element contains meta-information about the element that
 contains it.

 Processing expectations

 Suppressed.
 ==

 So I think you need to use address in a different context if you want
 it displayed. The same DocBook design document /address.html) has this
 example:

 […]

Alright, I will definitely do this,
as long as I don't achieve it in the place, where I actually attempt to achieve 
it.

 - Denis

Jochen

 On 07/18/2010 07:58 AM, jochen+oasis-o...@hayek.name wrote:
 I searched Bob's book for that (paper and online),
 but to no success.
 
 I wrote a little document,
 and it's necessary, that it shows my address.
 
 Any pointer pls?
 
 Kind regards,
 J.

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] blogging using DocBook articles or so ...

2010-07-18 Thread Jochen+oasis-open
So far I have been blogging on a couple of blogger.com blogs of mine,
and I got quite used to the capabilities there,
I mean WYSIWYG is not that disgusting, even for an open-minded emacs guy as me,
but then …

… maybe there has already been an attempt to use DocBook for blogging?

I mean, *what* *is* a *blog* *really*???

A time-consecutive list of articles,
together with a commenting facility (but that's not most important, I think),
and automatically supplied RSS and/or atom feeds.

Would be exciting to use DocBook also for that.

Kind regars,
J.
--
As nice as you guys here are,
pls usually only reply to my post right on this mailing list.
I honestly do follow this list.
Of course, if you want to tell me, how silly I am,
then let's keep that private ;-)
but usually it's only my Bad Simple English, not my ideas.

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] Re: blogging using DocBook articles or so ...

2010-07-18 Thread Jochen+oasis-open
 Robert Lucente writes:

 We have to be very conscious of who is the intended audiance.
 Warning pontification: You can't be everything to everybody.

 Creating DocBook XML and then getting the processing chain to work to
 convert XML to HTML 
 and then screwing around to get something
 to look exactly the way you want it to 
 in order to create a blog seems like way overkill.

My standards a lower there.
Aesthetics are important but not prio 1.
And IMHO DocBook output *is* nice.

And you do know, that O'Reilly books (all/some/a few?!?) are written in DocBook 
nowadays, don't you?

Maybe bloggingsharing would get far more often done, if the means were easier.

My current experience is DocBook Website,
which glues separate documents together using a layout.xml,
which serves quite a few different purposes including customization.

I would even regard it as acceptable to maintain something like the source of 
the RSS/atom feeds,
which could be the corresponding thing to that layout.xml.

 If something is not long or if the aesthetics are very critical, 
 perhaps DocBook is not the tool ?

 I am not trying to start a flame war, 
 just trying to look at things from everybody's perspective.

Fair enough.
Thanks for your contribution.

I just wanted to ask around and maybe suggest and idea.
Sometimes it take a spark, you know, in order to start projects, tiny ones and 
big ones.


Just my $0.05.

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] Re: blogging using DocBook articles or so ...

2010-07-18 Thread Jochen+oasis-open
 Robert Lucente writes:

 And IMHO DocBook output *is* nice.

 Ooops. Did not mean to imply otherwise.

 O'Reilly books (all/some/a few?!?) are written in DocBook

 Yes, I am aware. Please note that O'Reilly focuses on the tech market.

That's O'Reilly, not necessarily you and me.

*** THIS IS NOT A FLAME, HONEST ***

What makes DocBook unsuited for others than the tech market?

Is is it the same with LaTex?

Because you can write math. formulas with it,
you can't write prose with it?

Alright… people writing prose might not want to get bothered with something as 
profane as XML tags resp. LaTeX markup?

I used to use troff Memorandum Macros,
and not just for the job.

Do you think the addressees bothered, whether my letters were written in that 
incredible markup language?

 Maybe blogging  sharing would get far more often done, 
 if the means were easier.

 Please name the one specific thing that you would like to be easier.

I hate to edit text outside the emacs universe.
I hate it to edit text in a web browser.
I hate it to not be able to use Control-S to save my text every couple of 
seconds, w/o even being really aware, that I have done it again.

Too much hatred, I know.
Again: this is not a flame.

I am just not a WYSIWYG guy.
Yes, occasionally I like using formatted e-mail in Google Mail,
yes, it is a serious temptation.
Yes, I am Google Buzzing a lot.
But there again: I use old-fashioned markup there, too.

I prefer focussing on content, and *marking* *up* my text, yes with some kind 
of eagerness for perfection.
Your mileage may vary, they say.

With your preferred editor – do you actually type the end tag or does your 
editor achieve that for you?
My editor does it for me, so I don't bother.
I think end tags do help.
But than I am also one of the guys out there (with Ada being my 5th programming 
language or so),
who loves end if, end case, and that sort of stuff,
and with perl and ruby and whatever I add it myself as a comment.

 glues separate documents together

 I am confused. If we are talking about a simple blogg, why are we talking
 about glueing documents together ?

To keep things simple,
one approach may be to regard every blog article a document of its own.
Alright?
But if the blog is sort of DocBook Blog,
then what keeps the articles together?

I assume you are familiar with blog subscription features, like adding the 
blog's RSS resp. atom feed to your preferred feed reader.

What creates the RSS resp. atom feed in the case of DocBook Blog?

Well in the case of DocBook Website there is a meta-document called 
layout.xml, which is not really DocBookish but (at least) XML with a defined 
DTD/schema.

Maybe there will be sort of layout.xml for DocBook Blog as well.

I am sorry, you must be bored by this, as I keep reusing my own words.

 Please note that I am a newbie 
 and trying to figure out where the various tool sets fit in. 
 So, if I am making silly comments or asking silly questions, 
 request your patience.

If I am not patient enough: pls forgive me!
And see: I am still here :-)

Maybe DocBook Blog is serious enough for a student's thesis an whatever level.
No idea.
Just suggesting…




Another approach may well be
to regard the entire blog as a book,
with the articles being sections of level 1.

But then: as the blog grows article by article the generation process for the 
whole will more and more degrade.
And I just thought, that's not a good idea.
And why start there, if we know that from the very beginning.


 Just my $0.05.

Sic.

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] Re: blogging using DocBook articles or so ...

2010-07-18 Thread Jochen+oasis-open
 Dave Pawson writes:

 On Sun, 18 Jul 2010 15:43:20 +0200
 Jochen Hayek wrote:

 So far I have been blogging on a couple of blogger.com blogs of
 mine, and I got quite used to the capabilities there,
 I mean WYSIWYG is not that disgusting, even for an open-minded emacs
 guy as me, but then …

 … maybe there has already been an attempt to use DocBook for blogging?

 I mean, *what* *is* a *blog* *really*???

 A time-consecutive list of articles,
 together with a commenting facility (but that's not most important, I
 think), and automatically supplied RSS and/or atom feeds.

 Not docbook, but I've been generating atom blog entries for some time now.
 Each entry a different file (by date, then date.1 etc)
 Bit of python to get the xml file list, 
 XSLT to generate html + toc
 XSLT to generate the full atom feed.
 It's worked for about 5 years for me.
 Validated using NVDL.

 Let me know if you're interested.

I am of course.

Just to make sure: there is no DocBook envolved at all?
I would love to see DocBook at the core.

And you regard the file format, that embraces the articles (DocBook?!?),
as nice enough?

I mean, I am sure, it must actually be nice enough, if it's Dave Pawson's work.

Whatever grammar you are using,
I guess we can derive RNC from that,
which will enable my happy authoring in emacs with nxml-mode.

If I create an article (for the time being I asssume a DocBook article in one 
HTML chunk),
how much extra work is it around that?
do I have to manually keep redundant information like the article title and its 
creation DateTime?

Can we get away from that sort of redundancy?


You are a bright guy, that deserves my admiration.
I am only asking silly questions and creating cheaky requests.


So I am looking forward to any news from you.

Kind regards,
J.
--
pls don't reply privately!
pls don't regard this Hun as rough!

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] Re: article / info / author / address - how do I make it appear?

2010-07-18 Thread Jochen+oasis-open
 Mauritz Jeanson writes:

|  -Original Message-
|  From: jochen+oasis-o...@hayek.name 
|  
|  I searched Bob's book for that (paper and online),
|  but to no success.
|  
|  I wrote a little document,
|  and it's necessary, that it shows my address.
|  
|  Any pointer pls?

 The stuff inside info is part of the titlepage, 
 which has its own customization system:

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

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

Example 13.6. Adding an element to a title page.

Would I have to copy that t:titlepage-content rule
and add author/ there?

And if the original rule gets improved during its lifetime,
how would I notice but by setting a watch-dog?

I had hoped, I would find a simple switch saying include author?.

 Mauritz

Jochen

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] Re: blogging using DocBook articles or so ...

2010-07-18 Thread Jochen+oasis-open
 Dave Pawson da...@dpawson.co.uk writes:

 On Sun, 18 Jul 2010 18:01:37 +0200
 jochen+oasis-o...@hayek.name wrote:

 Just to make sure: there is no DocBook envolved at all?
 I would love to see DocBook at the core.

 Not sure how it would help with Atom?
 Perhaps to create the inserted html?

I thought I could create the articles, i.e. the *content* using DocBook.

 And you regard the file format, that embraces the articles
 (DocBook?!?), as nice enough?

 The wrapper is atom, not docbook, which I publish directly.

ure. A standard. Fine. Isn't that OPML-related? Rings a bell somehow.

But usually (I thought at least) the wrapper (i.e. the feed) does not contain 
the entire articles,
but it only refers to the content.

But at least some feed providers restrict it to that, as far as I can say.

I would like it that way.

I don't like to slurp an entire newspaper into my iPhone and not via wifi,
and only read 2% of it.
Yes, it's a little more time consuming, to read the articles,
that you decide to go for from the feed TOC.
But I find that more reasonable.

But maybe I got something fundamentally wrong.

 I mean, I am sure, it must actually be nice enough, if it's Dave
 Pawson's work.

 Whatever grammar you are using,
 I guess we can derive RNC from that,
 which will enable my happy authoring in emacs with nxml-mode.

 I have some code which generates the 'wrapper'
 $new tag Longer title generates

 [...]

 Then I just type html into the div, as html.

But I could basically just wrap the URL for the article itself in fullblown 
HTML here, right?
I mean, some articles are not just 140 characters, right?!?

 I use emacs nxml-mode for authoring but nvdl for validation. 
 Then run a build script, using xslt.

Sounds great to me.

 
 If I create an article (for the time being I asssume a DocBook
 article in one HTML chunk), how much extra work is it around that?
 do I have to manually keep redundant information like the article
 title and its creation DateTime?

 As you can see, some info is required. 
 I use the date as the key 'hook'
 with tag and title coming from the command line. 

 
 Can we get away from that sort of redundancy?

 From the above, you can see that the html header from docbook is all
 redundant?

Not from the above,
but if I want to keep the article separate, then yes.

 
 
 I am only asking silly questions and creating cheaky requests.

 No, just strikes me as 'I have a hammer' 
 it all looks like  a nail? 

Well, I think we have different approaches,
but I think I can make use of your software for my approach.

 I don't really see how docbook can help with a blog distributed in atom?

Separate articles, each written in DocBook, atom being the wrapper pointing to 
articles living for themselves, one by one.

 regards 
 Dave Pawson
 XSLT XSL-FO FAQ.
 http://www.dpawson.co.uk

Kind regards,
Jochen hayek

http://Hayek.name/Jochen.html

P.S.
I am taking my knowledge from some O'Reilly Short Cuts, namely:

$ pdfinfo 9780596528221.pdf
[…]
Title:  Getting Acquainted with OPML
Author: Amy Bellinger
[…]

$ pdfinfo 9780596529383.pdf
[…]
Title:  How to Build an RSS 2.0 Feed
Author: Mark Woodman
[…]

But maybe that literature does not really fit here.

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] Re: blogging using DocBook articles or so ...

2010-07-18 Thread Jochen+oasis-open
 Dave Pawson writes:

 […]

 Not docbook, 
 but I've been generating atom blog entries for some time now.
 Each entry a different file (by date, then date.1 etc)
 Bit of python to get the xml file list, 
 XSLT to generate html + toc
 XSLT to generate the full atom feed.
 It's worked for about 5 years for me.
 Validated using NVDL.

Dave, all you out there including NDW,

How far is your approach away from Norman's:

 Norman Walsh writes his blog in (a customization of) DocBook:
 http://norman.walsh.name/
 
 Here is an old (obsolete?) article describing the machinery:
 http://norman.walsh.name/2003/05/14/how
 
 Mauritz

And if I have the choice,
what should I go for?


I mean after all these years, there must have been a few out there,
that stood before the same decision, right?

Maybe both of you even presented your approach in a conference… :-)



Kind regards,
Jochen

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] DocBook Website and SVG images for the banners

2010-07-16 Thread Jochen+oasis-open
Having recognized the power of SVG only recently

(maybe HTML5 is going to embrace all its relevant dedicated powers rather 
soonish anyway …),

I now wanted to make use of SVG for the banner images.

Well, first I simply replaced the PNG with an SVG here:

  config param=homebanner-tabularvalue=graphics/homebanner.png 
  altval=Home Banner/

But during all my difficult attempts
of making use of SVG generated by Adobe Illustrator
I couldn't quite clearly see, where all my trouble originated.

After I had sorted the Adobe Illustrator SVG trouble itself,
I had to learn from here

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

that my HTML would have to make use of the EMBED tag instead of the IMG tag.
Well my browsers being Firefox, Safari, and Chrome, that is not a problem, 
they all accept EMBED.

But how do I get my layout.xml to create the EMBED tag?

Looking through the xsl/ subdirectory of my Website installation,
I am getting the impression, SVG is not getting mentioned there.

Any suggestions?



Me being a perl+ruby hacker
I can very well imagine postprocessing the HTML
and replacing code like this

  img align=left border=0 src=graphics/banner.svg alt=Banner

with code like this

  embed align=left border=0 src=graphics/banner.svg alt=Banner 
type=image/svg+xml

That's part of my webscraper competence… ;-)


But me *not* being an XSL hacker, what choice do I have?

Asking an XSL hacker here for his Amazon wishlist? :-)




Kind regards,
J.

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] Re: DocBook Website and SVG images for the banners

2010-07-16 Thread Jochen+oasis-open
 Sina K Heshmati writes:

 Do you have a customization layer for website stylesheets?

http://www.sagehill.net/docbookxsl/WebsiteFormat.html#WebsiteCustomization

  Website stylesheet customization

But I haven't started any like that here,
I am not an XSL hero ;-(

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] some automatic feedback message from info AT gute-preise24.de

2010-07-15 Thread Jochen+oasis-open
I guess, that everybody subscribed on this list has always been receiving his 
automatics message like this for a while:

Wir bitten um Verständnis, …

(Dies ist eine automatisch generierte E-Mail.)

Well, I tried to contact that guy over the phone – to no success.

I googled him, and it looks as he may be in quite some trouble businesswise,
and I assume therefore he will not be responding to any kind of request or 
whatever my e-mail.

So either the mailing list admin removes him entirely or temporarily from the 
list,
or we have to take action and we create mail filtering rules or whatever.

My procmail rule looks like this:

:0
* ^Subject:.*\[docbook-apps\]
* ^Return-Path: i...@gute-preise24\.de$
/dev/null

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] Re: [docbook] website and keyword vs. keywords

2010-07-14 Thread Jochen+oasis-open
Have you agreed by now on whether to support

  meta name=description …

or not?

IMHO it's a must.

I assume adding description.../description also effect the DTD, and the RNC 
grammar and so forth.
Would you like to share that with us resp. me?

J.

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] Website: is there any additional *short* title for use in the TOC / left column?

2010-07-14 Thread Jochen+oasis-open
Hi, there!


During my rather successful (from my point of view) process of converting a 
couple of web-sites from plain DocBook generated HTML to DocBook Website 
(HTML)

I now ran into a problem with this site:

  http://Aleph-Soft.com/JHwis/

Maybe you want to have a quick look at it.

I know, I got the TITLEs there a little long:

  headtitleTITLE/title/head

… which doesn't really disturb me as headers within those many HTML files,
but it does hurt within the left column.

Is there a way of providing a short title for use within the TOC / left column?

J.

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] Re: Website: description.../description

2010-07-14 Thread Jochen+oasis-open
I know …, I should have replace the Subject already in the first place ;-(


 Have you agreed by now on whether to support
   meta name=description …

 or not?

 IMHO it's a must.

 I assume adding description.../description also effects the DTD, and the 
 RNC grammar and so forth.
 Would you like to share that with us resp. me?

 J.

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] Re: Website: is there any additional *short* title for use in the TOC / left column?

2010-07-14 Thread Jochen+oasis-open
 Rowland, Larry larry.rowl...@hp.com writes:

 Did you try providing a titleabbrev element with the alternate, shorter 
 title.  

Many thanks for the hint, Larry!

Tried it, but to no success.

Well, within toc-tabular.xsl titleabbrev is taken into account
(is that the right place?),
but I don't understand the XSL well enough.

Sad.

 That is normally what is used for providing a title that is shorter than the 
 full title.  
 I am not that familiar with the Website grammar, 
 but I know that is how it works in other contexts.
 Regards,
 Larry Rowland

J.

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] Re: Website: is there any additional *short* title for use in the TOC / left column?

2010-07-14 Thread Jochen+oasis-open
 Rowland, Larry writes:

Thanks a lot, Larry, for your assistance!

 I have not looked at the code, 
 but from the title it looks like this generates the Table of Contents for the 
 tabular presentation.  
 In the sample posted at:

   http://docbook.sourceforge.net/release/website/example/custom.html

 the full title is shown at the top of the page and the titleabbrev is
 used for the navigational ToC to the left of the content area (I 
 checked the source for the page).

That's exactly whery my web-site sample is flowing over

  http://Aleph-Soft.com/JHwis/

But supplying titleabbrev a shorter title does not make that shorter title 
appear within that navigational ToC.

J.

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



[docbook-apps] Re: Website: is there any additional *short* title for use in the TOC / left column?

2010-07-14 Thread Jochen+oasis-open
I uploaded my Website *.xml files to this place:

  http://Hayek.name/Jochen/tmp/JHwis.tar.bz2

Maybe somebody else recognizes immediately, what my mistake is.

But maybe also, there is right now no viable path around for that problem.

J.

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



Re: [docbook-apps] Tools for generating Docbook programlisting fragments?

2007-08-26 Thread Jochen+oasis-open
 TN == Tommy Nordgren writes:

TN Do anyone know of a library for generating DocBook
TN programlisting fragments from source code listings marked up
TN with special comments.

Well, they have been calling that kind of thing literate programming,
and at 
http://www.google.com/Top/Computers/Programming/Methodologies/Literate_Programming/?il=1
you can find a few interesting articles 
including one by Normal Walsh titled Literate Programming in XML
at http://nwalsh.com/docs/articles/xml2002/lp/paper.html .
You might have come across Norman in the context of DocBook,
and you will find, that his article is quite DocBook related.

TN The purpose is to generate the Docbook source and program
TN language source, from a common specification.
TN I've tested filtering a xml file containing a programlisting
TN DocBook element through a custom stylesheet, but so far I've
TN been unable to avoid getting extra whitespace, when doing it
TN this way.

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: [docbook-apps] book / info / abstract / footnote not generated into HTML

2007-07-26 Thread Jochen+oasis-open
 Michael(tm) Smith writes:

 [EMAIL PROTECTED], 2007-07-24 21:20 +0200:

 I do have a tiny DocBook book here,
 and my problem with it is,
 that the footnote does not appear in HTML generated by the 1.72.0 
stylesheets.

MS Can you please go ahead and submit a bug report?

Sure, that's the least I can do.

MS   http://docbook.sourceforge.net/tracker/submit/bug

Done.

Request ID: 1760907

https://sourceforge.net/tracker/index.php?func=detailaid=1760907group_id=21935atid=373747

MS Just to make sure this doesn't fall between the cracks.

Thanks for your support and esp. Dick Hamilton's!!!

MS   --Mike

Jochen

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



[docbook-apps] book / info / abstract / footnote not generated into HTML

2007-07-24 Thread Jochen+oasis-open
I do have a tiny DocBook book here,
and my problem with it is,
that the footnote does not appear in HTML generated by the 1.72.0 stylesheets.



I tried poking my installation in order to use 1.73.0 stylesheets,
that I actually downloaded and unwrapped,
but apparently I wasn't very successfull,
as the HTML output still says, it got generated by the 1.72.0 stylesheets.
But that's another problem ...



It's not really any problem at all for me, that the footnote does not appear,
I just thought, I should tell you here about that little irregularity.


I edited the text in nxml-mode, so RELAX NG does have it's hands on it
and does consider it valid according to my 
/usr/share/xml/docbook/schema/rng/5.0CR4/docbook.rnc .

Maybe it's still invalid DocBook syntax / semantics.

Maybe someone is interested in this kind of problem.

JH


?xml version=1.0?

!DOCTYPE book PUBLIC -//OASIS//DTD DocBook XML 5.0CR4//EN 
http://www.oasis-open.org/docbook/xml/5.0CR4/dtd/docbook.dtd;

book xmlns=http://docbook.org/ns/docbook; 
xmlns:xl=http://www.w3.org/1999/xlink;

  titleMy DocBook XML test document/title

  info
abstract
  para
paragraph of an abstractfootnoteparafootnote ref. abstract within 
info/para/footnote
  /para
/abstract
  /info

  chapter
titlea chapter title/title
paraa paragraph/para
  /chapter
/book

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



[docbook-apps] Stripping namespace from DocBook 5 document

2007-07-19 Thread Jochen+oasis-open
When I compile my DocBook file from within emacs's nxml mode:

-*- mode: compilation; default-directory: ~/public_html--Hayek.name/ -*-
Compilation started at Thu Jul 19 20:58:29

make -k html
env XML_CATALOG_FILES=/etc/xml/catalog \
xsltproc \
--output book.html \
_xsl/html--docbook.xsl \
book.xml
Stripping namespace from DocBook 5 document.
WARNING: cannot add @xml:base to node set root element.  Relative paths may 
not work.
Processing stripped document.

Compilation finished at Thu Jul 19 20:58:31

I'm getting a few strange messages:

Stripping namespace from DocBook 5 document.
WARNING: cannot add @xml:base to node set root element.  Relative paths may 
not work.
Processing stripped document.

This is how my document starts:

!DOCTYPE article PUBLIC -//OASIS//DTD DocBook XML 5.0CR4//EN 
http://www.oasis-open.org/docbook/xml/5.0CR4/dtd/docbook.dtd; 

article version=5.0 class=techreport 
xmlns=http://docbook.org/ns/docbook; xmlns:xl=http://www.w3.org/1999/xlink;

I am sure I did not get those messages, when I used DocBook 4.5,
only when I migrated to DocBook 5, I introduced that namespace stuff
and I started getting these messages.

Maybe I haven't gotten it entirely right ...


How serious shall I take those 3 messages?
And what impact do they really have?
Can I get rid of a few of them?

I mean, I only introduced that namespace stuff, so that nxml mode wouldn't 
mourn at me
and so that the document complies to what I found at

http://www.oasis-open.org/docbook/specs/docbook-5.0b6-spec-wd-01.html

which looks to me (according to http://www.oasis-open.org/docbook/specs/)
like the latest document on DocBook 5.

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: [docbook-apps] which emacs mode for V5.0? nXML or psgml

2007-07-18 Thread Jochen+oasis-open
 JA == Jason Addison writes:

JA [...]

JA If I C-c C-o I get ``XML is not in any name group for element
JA ARTICLE'', pointing to the : in xml:lang in the article tag.

JA [...]

Maybe there are already far more competent responses on their way,
but maybe you are quite curious to get a very quick response ...

psgml *can* cope with XML DTDs, but only as long as *namespaces* are *not*
being made use of, and within your xml:lang the xml: is, what psgml
cannot handle.

Actually this reads like I solved the namespace problem:

http://lists.xml.org/archives/xml-dev/199907/msg00243.html

The article is from *1999* !
So derive your own conclusions about the state of psgml!




I personally migrated (almost) entirely with my DocBook files to nXML
and in the meantime also to DocBook XML 5.0.

The funny thing about the XSL stylesheets is, that they seem to handle
4.x and also 5.x DocBook XML files,
it looks like they just care for features, not for version numbers.


Actually I miss psgml features like C-c C-o to get a buffer offering
all the attributes and the abilty to edit their values in there.

I also find it quite adventurous to use software (RELAX NG, nXML mode),
whose developer (that I have a lot of admiration for) disappeared quite
a while ago and that didn't find maintainers in the meantime. Alright,
alright, it seriously looks, as if there are no (big) problems with
RELAX NG and nXML mode waiting to get solved, but maybe I was just not
observant enough ... 

For the time being I will just enjoy (and I hope you also do) nXML mode,
it's support for DocBook, DocBook itself, the XSL stylesheets towards
HTML and towards .fo, and just all of that, as far as I understand it ... ;-)

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



[docbook-apps] unnumbered section titles

2007-07-05 Thread Jochen+oasis-open
I usually like my documents structures as recursive sections,
but in a specific one, I would actually prefer some sections not to carry a 
number,
as that makes it otherwise look confusing (- year numbers in the section title 
itself).


How would I achieve that?
How do I get rid of those section numbers?
Setting the attribute label to an empty string does not to the job,
as the parent section's number is still used as the initial string of the child 
section's number resp. label.


I have not found an appropriate attribute with 4.5,
and I have also not found a suitable PI on www.sagehill.net/docbookxsl/ .

But maybe I just didn't manage to search the right way ...

J.

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



[docbook-apps] Re: unnumbered section titles

2007-07-05 Thread Jochen+oasis-open
 BL == Brett Leber writes:

BL Have you tried the simplesect element?

Yes, I have.

BL http://www.docbook.org/tdg/en/html/simplesect.html

BL It can only occur as a leaf section though
BL (bottom-most section in a recursive section).

And that is sometimes a problem.

BL I would be interested in a solution 
BL for setting an arbitrary section as unnumbered too.

I was quite sure, I don't stand alone with that idea.

J.

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



[docbook-apps] Re: how to upgrade docbook-xml properly w.r.t. nxml-mode - /usr/share/emacs/site-lisp/nxml-mode/schema/*.rnc

2007-05-10 Thread Jochen+oasis-open
 JMT == jmt  [EMAIL PROTECTED] writes:

JMT Hi, list !

JMT I use emacs + nxml mode in Debian ; this package still uses the 
Docbook 
JMT schema from V4.2, so I replaced to the original schema by the schema 
for 
JMT V5.0RC3. 

My nxml-mode installation keeps emacs mode and specifically docbook related 
files (*.rnc - RELAG NG compact syntax) here:

/usr/share/emacs/site-lisp/nxml-mode/schema/

So you are telling us, you took files from 
/usr/share/xml/docbook/schema/rng/5.0CR3/
and made them available to emacs nxml-mode, are you?

JMT Works like a charm, 

Does that mean regarding to editing in nxml-mode or regarding to creating 
HTML or PDF?

Do you really make use of new features in nxml-mode,
i.e. features of 5.0, that were not already available in 4.2?

JMT except that introducing a xml:id for person unvalidates the
JMT document.

I guess every new feature will unvalidate the document,
as long as the new and right *.rnc files are not properly made available to 
nxml-mode.

And how that is carried out -- maybe there is somebody else to tell us how to 
do that,
I mean to give us a recipe of how to upgrade docbook-xml properly w.r.t. 
nxml-mode - /usr/share/emacs/site-lisp/nxml-mode/schema/*.rnc.

Actually I would like to see,
that the *.rnc files in /usr/share/emacs/site-lisp/nxml-mode/schema/ get removed
and nxml-mode gets set up to make use of the *.rnc files in 
/usr/share/xml/docbook/schema/rng/5.0CR3/ or whatever new or old version one 
wants to make use of.

Obviously your paths may vary,
mine are from a mixture of SUSE 10.1 through 10.3alpha...
and I actually assume, they are file system standard compliant, but who knows 
...

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]