Documentation to ePUB or app

blindmime
@blindmime
8 years ago
772 posts
Have you thought of making it possible to output from the Documentation module to ePub format or as an app?

Also, it would be great to have an Audio document type added.
updated by @blindmime: 11/17/16 06:07:50PM
michael
@michael
8 years ago
7,746 posts
Yup, thought about it, but haven't implemented it, it would be nice to be able to output to pdf and print the lot.

"Also, it would be great to have an Audio document type added. "
Where?
blindmime
@blindmime
8 years ago
772 posts
"Also, it would be great to have an Audio document type added. "
Where?[/quote]

In the Documentation Module
blindmime
@blindmime
8 years ago
772 posts
I've been sort of exploring the use of the Documentation module as a collaborative writing tool for Family histories and other kinds of digital books or rich media publications. Thinking a controlled export of the dataset could even produce an app in something like the Baker Framework, if I understand it correctly. So a group of people could put media into galleries, video, audio, stories and use the Document module to outline, organize and then produce a publication, discussing it in a forum, assigning tasks in the tracker.

That's what's prompting the question.
SteveX
SteveX
@ultrajam
8 years ago
2,584 posts
Take a look at the documentation module code, I really like it. I'm one of it's biggest fans :)

I use a module based on jrDocs to make sectional pages, and the pages are organised into microsites (at work we call them "workbooks", here's one example: http://academicskills.uwe.ac.uk/general/workbooks/writing-for-university). These workbooks are collaboratively written by librarians to deliver teaching to university students. Librarians seem to love Jamroom, which is pretty cool!

Within jrDocs you can write a section pretty easily, just a couple of functions and a template. Try adding in an audio section, or get a developer to do that if you need. It isn't a big job if you know your way around a Jamroom module. You'll have to merge in your customisations when you update jrDocs but there aren't many updates as it's as stable as it's useful :)

Of course the easiest route to getting audio into jrDocs is to allow audio embeds in the editor section. Give that a try first if an audio player in your docs is what you need, no worries when you update jrDocs.


--
¯\_(ツ)_/¯ Education, learning resources, TEL, AR/VR/MR, CC licensed content, panoramas, interactive narrative, sectional modules (like jrDocs), lunch at Uni of Bristol. Get in touch if you share my current interests or can suggest better :)

updated by @ultrajam: 06/21/16 01:24:19PM
michael
@michael
8 years ago
7,746 posts
wow, that looks nice! Great job Steve :)

I'll add the suggestion of audio type doc block to the tracker. Thanks blindmime. :)
michael
@michael
8 years ago
7,746 posts
right now there is a 'Downloadable File' file type for the jrDocs module. If the purpose of the file attached to the doc is to download it, that will be enough i should imagine.

However if the purpose of the doc section is to play the audio file, then in order for it to be playable on all devices it needs to run through the same audio conversion system that the jrAudio file runs it through.

I wouldn't want to replicate that system in another module, so making the doc section in that module seams the most appropriate. But that then brings up the question: "If the jrAudio module exists, and can be embeded via the jrEmbed module into any text area, then whats the purpose of the audio section?"

Is it the jrEmbed interface that you're wanting maybe for the 'text' sections? Because they can embed an audio file right now with:
[jrEmbed module="jrAudio" id="1"]

Help me understand. Thanks.
blindmime
@blindmime
8 years ago
772 posts
Yeah, I think that will be fine. I'm seeing this though.
screenshot_58.png
screenshot_58.png  •  28KB

gary.moncrieff
gary.moncrieff
@garymoncrieff
8 years ago
865 posts
blindmime:
Yeah, I think that will be fine. I'm seeing this though.

Just checked and I see this too.
SteveX
SteveX
@ultrajam
8 years ago
2,584 posts
Have you checked "Enable Editor" in your jrDocs config?


--
¯\_(ツ)_/¯ Education, learning resources, TEL, AR/VR/MR, CC licensed content, panoramas, interactive narrative, sectional modules (like jrDocs), lunch at Uni of Bristol. Get in touch if you share my current interests or can suggest better :)
michael
@michael
8 years ago
7,746 posts
also check
ACP -> MODULES -> SYSTEM CORE -> QUOTA CONFIG -> (the docs profile quota) -> ACTIVE TEXT FORMATTERS -> Convert Embed Tags
gary.moncrieff
gary.moncrieff
@garymoncrieff
8 years ago
865 posts
I have since solved this on mine, I must have had done something stupid as it was affecting embeds on the whole site, still not sure what it was mind.
blindmime
@blindmime
8 years ago
772 posts
michael:
also check
ACP -> MODULES -> SYSTEM CORE -> QUOTA CONFIG -> (the docs profile quota) -> ACTIVE TEXT FORMATTERS -> Convert Embed Tags

That's what it was.
michael
@michael
8 years ago
7,746 posts
looking at your docs again Steve, I'm even more impressed, the word puzzle built in and the polls. wow.
SteveX
SteveX
@ultrajam
8 years ago
2,584 posts
Thanks Michael, that's nice to hear :)


--
¯\_(ツ)_/¯ Education, learning resources, TEL, AR/VR/MR, CC licensed content, panoramas, interactive narrative, sectional modules (like jrDocs), lunch at Uni of Bristol. Get in touch if you share my current interests or can suggest better :)

Tags