Audio support?

Hi,

Love your plugin. Just wondering how difficult it would be to add support for audio? As in, could we turn a dokuwiki link to an MP3 or OGG file into something like: <audio src="audio/clip01.mp3"/>?

[turnermm]

Unfortunately I have no experience with audio files, podcasts etc. I would have supposed that the audio file would be linked to normally in the epub, but your ebook reader has to support it. Does the audio file requires a plugin? If so, then there might be some issues.

Thanks for the response! It's not so much a plugin issue as it is an html issue. When I export an epub, my images are correctly linked in the html as follows:

<img src="../Images/namespace_image.png" width="500" alt="../Images/namespace_image" class="mediacenter" />

This works great. However, the links to the audio files use an <a> tag in the html as follows, which ends up being broken:

<a href=''> :namespace:filename.ogg |</a>

What I'd love to see is for the links to audio files to use an <audio src> tag instead of <a>. Would that be possible to implement?

[turnermm]

Show me a sample page from your wiki with markup using an audio file

Sure thing. I'm working on a free digital textbook for some courses that I teach.

Here's a page: Chapter 4

The markup for the first audio link on that page is:

{{ :bridges_counterpoint:04-ex40.mp3 | :bridges_counterpoint:04-ex40.ogg |}}

Ideally, I'd like my students to be able to view the book using a computer, tablet, phone, or e-reader, provided their e-reader supports audio. Searching for e-reader/epub support for dokuwiki is how I found your wonderful plugin.

Thanks for your help!

[turnermm]

I saved one of your audio files and created a new branch as a test for audio files:
https://github.com/turnermm/epub/archive/audio.zip
You can install it using the manual tab of the Extension Manager.

It embeds the audio file and sets up the controls, but I'm afraid for me, it doesn't produce sound at least not on Calibre or Sigil.

Getting pretty close. When I export and download the epub, it includes the audio files, which is good! That didn't happen previously. When I open the epub in Apple iBooks, the controls for the player display, but - like you mentioned - it doesn't produce sound.

I think it might be a simple HTML path issue. In looking at the HTML for a sample page, I see this:

<img src="../Images/filename.png" ... >

(further down)

<audio class="mediacenter" controls="controls"> <source src=Audio/filename.mp3 ... >

Note the difference in the path for img src versus source src. If I change the path for the link to <source src="../Audio/filename.mp3 ... ", it works perfectly.

[turnermm]

I've made the change. Test it. Same distribution url: https://github.com/turnermm/epub/archive/audio.zip
Still doesn't work in Calbre, which may require more sophisticated coding and which I'm not familiar with.

Hey, thanks! What I can tell you is that the audio works fine when viewing the HTML. I'll test it in iBooks tomorrow, but I suspect it will work as well.

I'm not even worried about Calibre. Any student I have who is sophisticated enough to use Calibre will come up with their own solution. Really, I just want the textbook to function decently on tablets with e-reader audio support (iPads, Kindle Fire, whatever). Looks like this is going to do the trick!

[turnermm]

I'll look forward to the details, sol that I can report on the plugin page how things go.

[turnermm]

I've discovered that in Firefox, on both Mac and Windows 10, the epubreader add-on plays back the mp3 files.
I've also added a possible help feature: for each audio file, I create a footnote, as with any other media type, so that it is possible to go to the footnotes page and save the mp3 file to the desktop by right-clicking and choosing "save as".

And I can confirm that on Apple iBooks, the audio files play perfectly.

Screenshot

I don't have an iPad (or similar) to test, but I suspect that everything should work just fine. Thanks for all your work! This is a great addition to your plugin.

[turnermm]

Try the latest and see what you think of the footnote link. I could set it up as a choice, and it might be possible to set up a tag to introduce the footnote and it should be centred (probably), to be parallel with the play icon.

Hmmm. I can see how the footnotes could be useful in an eBook with only the occasional audio file. In my case, with lots of audio examples per chapter, it makes for a cluttered and distracting look.

If it's set up as an option to use the footnote links, I'm in favor. Otherwise, I prefer the "minimal" look of picture with corresponding audio file.

[turnermm]

I'm a step ahead of you on the option. But you should look at the current implementation of the footnote link. It's centered beneath the play controls and single-spaced. The option defaults to true, i.e. use the extra link.

[turnermm]

With latest update, the titles of the footnote text are taken from the markup: {{ mpeg_file|title }}

Shakespeare, Sonnets.zip