OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: RE: [docbook-apps] A little XML-to-XML handholding?


Maybe this page will help:
http://sagehill.net/docbookxsl/Db5Tools.html

________________________________________
From: Fredrik Unger [fred@tree.se]
Sent: Thursday, August 01, 2013 5:59 AM
To: Bob Stayton
Cc: Richard Hamilton; Michael Crawford; docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] A little XML-to-XML handholding?

Hi,

Just a question, I am not in the know when it comes to this.

http://www.docbook.org/tdg/en/html/ulink.html is for Docbook 4.X ?
and the replacement would be
http://www.docbook.org/tdg5/en/html/link.html
for Docbook 5.X?
I did not find an ulink for Docbook 5.X..
Or is uri rather the tag to use ?

I did not find any processing details for html with regards to ulink in
the Debian sid styleheets.
/usr/share/xml/docbook/stylesheet/docbook-xsl-ns/html/docbook.xsl
($Id: docbook.xsl 9605 2012-09-18 10:48:54Z tom_schr $)

The PDF has details for the xlink:href in the footnote processing.

Maybe I am looking to far ahead with version 5.x.

The http://docpond.tree.se/ is very basic but I will try to improve it.
The below stylesheets are really what I wanted to emphasize,
and the ease of adding new small test snippets.

For footnote for link.
Would this be the way to do it ? or am I overlooking something ?
(especially for html)

https://source.tree.se/git/docpond.git/blob/HEAD:/link/footnote.html.xsl
https://source.tree.se/git/docpond.git/blob/HEAD:/link/footnote.pdf.xsl

I am just trying to help.

Thank you,

Fredrik Unger


On 07/31/2013 11:29 PM, Bob Stayton wrote:
> Hi,
>> Regarding the killer feature, if you use the right option (I don't
>> remember off-hand, but it's in Bob Stayton's book
>> (http://sagehill.net)), you can get exactly what you want for links in
>> the hard copy.
>
> Dick is referring to the stylesheet feature that can generate a footnote
> for a <ulnk> element in DocBook.  So if you convert the HTML <a href>
> elements to <ulink>, then this feature will produce footnotes when
> processed:
>
> http://www.sagehill.net/docbookxsl/Ulinks.html
>
> Bob Stayton
> Sagehill Enterprises
> bobs@sagehill.net
>
> --------------------------------------------------
> From: "Richard Hamilton" <hamilton@xmlpress.net>
> Sent: Monday, July 29, 2013 11:25 AM
> To: "Michael Crawford" <lists@warplife.com>
> Cc: <docbook-apps@lists.oasis-open.org>
> Subject: Re: [docbook-apps] A little XML-to-XML handholding?
>
>> Hi Mike,
>>
>> I have had very good luck with Herold (http://www.michael-a-fuchs.de).
>>
>> I'm usually not fortunate enough to have strict xhtml, so we do some
>> pre-processing (usually on well-behaved, but idiosyncratic, html),
>> tidy it up into xhtml, then run Herold.
>>
>> You may find that you need to do some light pre- or post-processing,
>> but for us it has never been more than a short XSL stylesheet to do
>> things like remove empty paragraphs from the initial XHTML or change
>> the root element in the resulting DocBook (the latter can probably be
>> handled by Herold using Groovy scripts, but I've learning all the
>> scripting languages I need for the time being, so I stick with XSL or
>> Perl-:).
>>
>> When we build a book, like you're doing, rather than concatenate
>> pieces, we keep each file separate, then create a "book" file that
>> uses xinclude to pull in the chapters. That simplifies the scripting
>> and makes it easier to move parts around in the book.
>>
>> Regarding the killer feature, if you use the right option (I don't
>> remember off-hand, but it's in Bob Stayton's book
>> (http://sagehill.net)), you can get exactly what you want for links in
>> the hard copy.
>>
>> Best Regards,
>> Dick Hamilton
>> -------
>> XML Press
>> XML for Technical Communicators
>> http://xmlpress.net
>> hamilton@xmlpress.net
>>
>>
>>
>> On Jul 27, 2013, at 6:18 PM, Michael Crawford wrote:
>>
>>> Greetings, Earthlings,
>>>
>>> I have some articles and essays that are all marked up with valid
>>> XHTML 1.0 Strict with CSS, that I would like to publish as bound,
>>> dead-tree books, possibly also eBooks.
>>>
>>> It seems to me that the best way to do that would be to convert each
>>> collection of essays into a single DocBook XML document.  Can you
>>> give me some tips on how to get started?  I'm happy to Read The Fine
>>> Manual, but there are so many.
>>>
>>> One such volume, when printed both-sides on US Letter paper, is ~250
>>> pages.  The essays range from two to fifty pages.
>>>
>>> What I _think_ I need to do is to use some manner of XML-to-XML
>>> transformation, to strip everything from the beginning of each
>>> document, up to and including the opening <body>, then from the
>>> closing </body>, to the end of each document....
>>>
>>> ... then concatenate them all together, with each present XHTML
>>> document being a single chapter in the resulting DocBook document...
>>>
>>> ... then replace HTML-style tags and attributes with DocBook-style:
>>> <p> to <Para>, for example...
>>>
>>> ... what would be for me, A Killer Feature, would be to convert each
>>> HTML <a href="..."> hyperlink into a DocBook footnote.  So where I
>>> have this:
>>>
>>> ===========
>>> a long-forgotten <a href="http://www.kuro5hin.org/";>cesspool</a> in a
>>> far-off corner of the World-Wide Web...
>>> ===========
>>> would look something like this in hardcopy form:
>>>
>>> a long-forgotten cesspool[1] in a far-off corner of the World-Wide
>>> Web...
>>> ----
>>> 1. http://www.kuro5hin.org/
>>>
>>> =========
>>>
>>> I'd also like to design my own custom stylesheets.  I'll ask about
>>> that later though.  I have a copy of "Android Programming: The Big
>>> Nerd Ranch Guide" by Bill Phillips and Brian Hardy.  In the
>>> Acknowledgements, the authors credit Chris Loper of
>>> http://www.intelligentenglish.com/ for his DocBook toolchain.
>>>
>>> That volume is exquisite.  I'd like to design my own volume, not to
>>> look the same, but to look as good, with my own personal style.
>>>
>>> Thanks for any advice you can give me.
>>>
>>> Mike Crawford
>>> lists@warplife.com
>>> http://www.warplife.com/
>>>
>>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
>> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>>
>>
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>


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





[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]