docbook: Thread: Help inserting

Hi all,

Has anyone been able to successfully include an audio clip in a docbook
file?  I've been beating myself in the head senseless trying to make
this work, using the docbook xsl 1.64.1 stylesheets, but it's a no go.

Your help would be appreciated, and if you need to know more
information, please let me know.

Thanks much,
Tab

-- 
Tabatha Marshall
Web: www.merlinmonroe.com
Linux Documentation Project Review Coordinator (http://www.tldp.org)
Linux Counter Area Manager US:wa (http://counter.li.org)

On Sun, Dec 21, 2003 at 06:06:12PM -0800, Tabatha Marshall wrote:
> Hi all,
> 
> Has anyone been able to successfully include an audio clip in a docbook
> file?  I've been beating myself in the head senseless trying to make
> this work, using the docbook xsl 1.64.1 stylesheets, but it's a no go.
> 
> Your help would be appreciated, and if you need to know more
> information, please let me know.

The stylesheets have pretty primative
support for audio.  Currently an audiodata element
just generates:

<embed src="filename"></embed>

where "filename" is the audio file referenced 
in the audiodata element.  Do you get this in
your output?  If you do, then that's pretty much
all the stylesheets can do.

I'm curious as to what else is needed on the
HTML side to make audio work.

-- 

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: ####@####.####

> I'm curious as to what else is needed on the
> HTML side to make audio work.

Depending on the audio file format, different Markup Tags might be needed.

A CSS (cascading style sheet) could be used to translate
<embed src="filename"></embed>
to something which a browser could play, based on the format of the file.

I dont think there is anything in the docbook xslt to make that kind of
transformation.

In Peace,
Saqib Ali
-------------
http://validate.sf.net <---- HTML/XHTML/DocBook Validator

On Mon, 2003-12-22 at 09:07, Bob Stayton wrote:
> On Sun, Dec 21, 2003 at 06:06:12PM -0800, Tabatha Marshall wrote:
> > Has anyone been able to successfully include an audio clip in a docbook
> > file?  I've been beating myself in the head senseless trying to make
> > this work, using the docbook xsl 1.64.1 stylesheets, but it's a no go.

> The stylesheets have pretty primative
> support for audio.  Currently an audiodata element
> just generates:
> 
> <embed src="filename"></embed>
> 
> where "filename" is the audio file referenced 
> in the audiodata element.  Do you get this in
> your output?  If you do, then that's pretty much
> all the stylesheets can do.

No, unfortunately I didn't even get that much.  I set it up using the
example given in the DocBook guide, so it was wrapped with mediaobject,
which I assume is correct.

> I'm curious as to what else is needed on the
> HTML side to make audio work.

Yes, matter of fact it is the html conversion I want to see it in...glad
you knew what I was looking for.  

Don't audio types have to be defined somewhere?  After all, all the
video and image file types are.  Incidentally, I'd like to find out if
video will come out too (haven't tested myself, only audio so far).

I figured that trying to embed audio wouldn't be the most desirable
thing in an html conversion.  I assume that the audio will play until
the browser window is closed, because there would be no way to shut it
off.

Tab

-- 
Tabatha Marshall
Web: www.merlinmonroe.com
Linux Documentation Project Review Coordinator (http://www.tldp.org)
Linux Counter Area Manager US:wa (http://counter.li.org)

On Mon, 2003-12-22 at 10:12, Saqib Ali wrote:
> > I'm curious as to what else is needed on the
> > HTML side to make audio work.
> 
> Depending on the audio file format, different Markup Tags might be needed.
> 
> A CSS (cascading style sheet) could be used to translate
> <embed src="filename"></embed>
> to something which a browser could play, based on the format of the file.
> 
> I dont think there is anything in the docbook xslt to make that kind of
> transformation.

I had hoped that since it was included in the DocBook guide that it
would be a working feature, but, sadly....

If you happen to stumble on a solution, please let me know! As I
mentioned to Bob, I'd be also interested to know if embedding video
really works, as I haven't tried it myself.  If no one else does, I'll
probably give it a shot just to see.  

Again, my main concern is not being able to shut off the noise until the
browser window is closed.  I think this would be enough of a deterrent
from using it, but still want to see for myself, if it's possible!  (I
have someone asking me about it all for their own work, but I'm a
curious cat myself.)

Thanks,
Tab

-- 
Tabatha Marshall
Web: www.merlinmonroe.com
Linux Documentation Project Review Coordinator (http://www.tldp.org)
Linux Counter Area Manager US:wa (http://counter.li.org)

On Mon, Dec 22, 2003 at 12:34:36PM -0800, Tabatha Marshall wrote:
> On Mon, 2003-12-22 at 09:07, Bob Stayton wrote:
> > On Sun, Dec 21, 2003 at 06:06:12PM -0800, Tabatha Marshall wrote:
> > > Has anyone been able to successfully include an audio clip in a docbook
> > > file?  I've been beating myself in the head senseless trying to make
> > > this work, using the docbook xsl 1.64.1 stylesheets, but it's a no go.
> 
> > The stylesheets have pretty primative
> > support for audio.  Currently an audiodata element
> > just generates:
> > 
> > <embed src="filename"></embed>
> > 
> > where "filename" is the audio file referenced 
> > in the audiodata element.  Do you get this in
> > your output?  If you do, then that's pretty much
> > all the stylesheets can do.
> 
> No, unfortunately I didn't even get that much.  I set it up using the
> example given in the DocBook guide, so it was wrapped with mediaobject,
> which I assume is correct.

Really? When I have this in my file:

    <mediaobject>
        <audioobject>
            <audiodata fileref="foo.swf"/>
        </audioobject>
    </mediaobject>

and process it with the 1.62.4 html stylesheet, my
HTML output contains:

  <div class="mediaobject"><embed src="foo.swf"></embed></div>

You should at least get that much.

> > I'm curious as to what else is needed on the
> > HTML side to make audio work.
> 
> Yes, matter of fact it is the html conversion I want to see it in...glad
> you knew what I was looking for.  
> 
> Don't audio types have to be defined somewhere?  After all, all the
> video and image file types are.  Incidentally, I'd like to find out if
> video will come out too (haven't tested myself, only audio so far).
> 
> I figured that trying to embed audio wouldn't be the most desirable
> thing in an html conversion.  I assume that the audio will play until
> the browser window is closed, because there would be no way to shut it
> off.

I don't know much about audio in HTML. But I assume
that an audio file, like other embedded applicactions,
would need a helper application to play it, based on its
MIME type?  The helper application would run in a separate
window and would provide controls.  I notice that the
<embed> element can take a 'type'attribute that identifies
the MIME type of the thing.  Maybe that's where the
connection is made.  

-- 

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: ####@####.####