publishing manual in formats other than PDF

Share what you’d like to see added to Ableton Live.
Post Reply
pmuellr
Posts: 11
Joined: Sat Dec 11, 2004 7:09 am

publishing manual in formats other than PDF

Post by pmuellr » Wed Jan 12, 2011 7:37 pm

I noticed an earlier post about publishing the Live manual for reading on Kindle or other e-reader devices. For some reason, can't find that topic anymore, though searching for "kindle" will find the hit for it.

Anyhoo, I'd also like to see the manual in a format other than just PDF as well. Preferrably ePUB, which can easily be converted into other formats, like .mobi for Kindle.

I've "converted" the existing Live .pdf manual to my Kindle by cropping it with a PDF editor, to remove the annotations on the side - not perfect, but it's a lot more readable than with the annotations on the side. If there's any interest, and if Ableton doesn't mind, I'd be happy to post the cropped PDF somewhere ...

I'd also be happy to work with someone from Ableton on an ePUB version of the doc

I'm seriously thinking of taking advantage of the Live for Max offer ending this week, and it appears it's doc (ie, in patches/docs/tutorials) would be very amenable to format-shifting. Wondering what C74 would think of alternate formats of their docs? I will admit that having the docs "open" in this format is really another factor drawing me towards the product.

Piplodocus
Posts: 825
Joined: Sun Dec 30, 2007 9:48 pm
Location: Southampton, UK

Re: publishing manual in formats other than PDF

Post by Piplodocus » Thu Jan 13, 2011 5:02 pm

I noticed opening the web based pdf in safari on my ipod (and I guess it works on iPad) offers to open the pdf in iBooks. I now have the manual stored on my ipod touch and I can take it off/put it on with itunes! Still not much good for Kindles though I guess.
Live relevant things: Suite 12, MacBook M1 Max, RME UFX II (kext drivers), Push 1

pmuellr
Posts: 11
Joined: Sat Dec 11, 2004 7:09 am

Re: publishing manual in formats other than PDF

Post by pmuellr » Thu Jan 13, 2011 5:15 pm

PDFs on the Kindle suffer a number of problems. Getting it to "basically display properly" while not having to zoom is the only thing I can "fix", which I did by cropping the PDF. There's very limited-to-none search/indexing/linking possible, which means you can really only read the manual serially. Pain.

The basic document structure of the existing Live manual would lend itself to HTML rendering pretty well, I think. Just don't happen to have that HTML. :-(

I looked a bit more a the Max doco last night - it's largely in XML, in their own set of XML dialects, which they provide XSLT transforms for to convert to HTML dynamically. Didn't realize people actually did that (I stopped years ago - XSLT support is pretty crappy cross-browser). But, should make it easy to generate stand-alone HTML for it, which I can then convert to .mobi format with Calibre, or something.
pmuellr

splitloop
Posts: 3
Joined: Thu Mar 20, 2008 12:34 pm

Re: publishing manual in formats other than PDF

Post by splitloop » Fri Aug 19, 2011 4:37 pm

pmuellr wrote:PDFs on the Kindle suffer a number of problems. Getting it to "basically display properly" while not having to zoom is the only thing I can "fix", which I did by cropping the PDF. There's very limited-to-none search/indexing/linking possible, which means you can really only read the manual serially. Pain.

The basic document structure of the existing Live manual would lend itself to HTML rendering pretty well, I think. Just don't happen to have that HTML. :-(

I looked a bit more a the Max doco last night - it's largely in XML, in their own set of XML dialects, which they provide XSLT transforms for to convert to HTML dynamically. Didn't realize people actually did that (I stopped years ago - XSLT support is pretty crappy cross-browser). But, should make it easy to generate stand-alone HTML for it, which I can then convert to .mobi format with Calibre, or something.
Hey - you manage to get anything sorted for this? Would love the Live manual in ePub?

Cheers,
Phil.

pmuellr
Posts: 11
Joined: Sat Dec 11, 2004 7:09 am

Re: publishing manual in formats other than PDF

Post by pmuellr » Fri Aug 19, 2011 5:02 pm

splitloop wrote:Hey - you manage to get anything sorted for this? Would love the Live manual in ePub?
No, don't think I'd give an .epub conversion a try without the manual in some kind of convertable format (word might be ok, for instance). PDF isn't really convertable. If you were really desperate, there are some tools to extract text from PDFs, but then you'd lose the pictures. Sidebar annotations likely wouldn't work right either. Calibre (open source ebook converter) may be able to do this kind of conversion.

At this point, I do a most of my e-reading (PDFs and EPUBs) on my iPad with iBook. The existing Live 8 Manual looks pretty good there - pages are readable by my elderly eyes, links work, auto-generated TOC is too low-level but ok, etc. The only thing that really needs improvement for the PDF is to use color screen shots instead of the black and white.

As an aside, not sure why the images ARE black and white. It's unlikely someone's going to print this 550 page manual, or that even if they did, that having color images would screw them up. The manual would likely be bigger, but ... who cares.

Please, Ableton, do a "Wizard of Oz" for us, and take us from a black&white world to a color one, for the next manual!
pmuellr

ShenShenDrax
Posts: 15
Joined: Fri Dec 01, 2006 11:04 pm
Location: Brisbane

Re: publishing manual in formats other than PDF

Post by ShenShenDrax » Fri Nov 11, 2011 12:21 pm

+1 for epub

William
Posts: 424
Joined: Thu Nov 18, 2004 8:04 pm
Location: Atlanta, GA

Re: publishing manual in formats other than PDF

Post by William » Tue Dec 27, 2011 3:31 am

I just got a Kindle for Christmas and was excited to download my manuals to it...until I tried it lol. Pdfs are no good. We definitely need an epub version.
Soundcloud: http://soundcloud.com/rimby

i7-3770K 3.5GHz
16GB RAM
256GB SSD, 1TB 7200HD

Windows 8

Live 9

Rickard
Posts: 8
Joined: Mon Nov 10, 2014 7:58 pm

Re: publishing manual in formats other than PDF

Post by Rickard » Wed Nov 26, 2014 9:52 pm

I have converted the pdf manual for Ableton 9 to epub and mobi (for kindle).

- A few diagrams was not possible to convert
- A few images is missing numbered arrows
- Page jumps does not work
- short keys chapter is missing, was to garbled
- Some double consonants was eaten by goblins. (No, really they are gone 8O )

https://www.dropbox.com/sh/6sn4hj1y2dsf ... MWUVa?dl=0

I converted with calibre, but had to adjust all images by hand as they were not in their correct place.

Rickard
Posts: 8
Joined: Mon Nov 10, 2014 7:58 pm

Re: publishing manual in formats other than PDF

Post by Rickard » Thu Nov 27, 2014 10:36 pm

Got tired of my old conversion and had to fix it. Created a ruby script that scrapes the manual from Abletons site change all urls to relative urls on images and links and download all images. Then it's easy to convert other formats with calibre. Just drag in the index.html file to calibre.

This fixes all issues I had previously!

There is only one remaining issue.

- Images in the mobi file has a slight left margine for some unknown reason.

The script can be cloned from here:

https://github.com/lindroth/ableton_manual

The mobi(kindle) and epub files can be downloaded from here:

https://www.dropbox.com/sh/6sn4hj1y2dsf ... MWUVa?dl=0
Last edited by Rickard on Fri Nov 28, 2014 12:21 am, edited 2 times in total.

pmuellr
Posts: 11
Joined: Sat Dec 11, 2004 7:09 am

Re: publishing manual in formats other than PDF

Post by pmuellr » Fri Nov 28, 2014 12:11 am

Rickard wrote:Got tired of my old conversion and had to if it. Created a ruby script that scrapes the manual from Abletons site change all urls to relative urls on images and links and download all images.
Wow, nice! Thanks!
pmuellr

ogofen
Posts: 1
Joined: Mon Apr 04, 2016 10:25 pm

Re: publishing manual in formats other than PDF

Post by ogofen » Mon Apr 04, 2016 10:31 pm

Yo, Thanks for sharing

saopor
Posts: 1
Joined: Wed Oct 18, 2017 3:27 pm

Re: publishing manual in formats other than PDF

Post by saopor » Wed Oct 18, 2017 3:31 pm

Hey Ableton team, if you're listening, you should put this port on Amazon for free Kindle download.

A) It's a great way to market your product.
B) It makes your users super happy, which is also a great way to market your product
C) It's a great way to make your users happy
D) The only cost should be bug/virus testing it, or alternatively, paying a subcontractor to convert your PDF to mobi. The user already created a script to do it!

Fuck the police!

:twisted: :lol: :mrgreen: :roll: :idea: :idea: :roll: :mrgreen: :lol: :twisted:

jx3
Posts: 38
Joined: Thu Aug 10, 2017 12:21 pm

Re: publishing manual in formats other than PDF

Post by jx3 » Sat Jan 27, 2018 3:06 pm

Rickard wrote:Got tired of my old conversion and had to fix it. Created a ruby script that scrapes the manual from Abletons site change all urls to relative urls on images and links and download all images. Then it's easy to convert other formats with calibre. Just drag in the index.html file to calibre.

This fixes all issues I had previously!

There is only one remaining issue.

- Images in the mobi file has a slight left margine for some unknown reason.

The script can be cloned from here:

https://github.com/lindroth/ableton_manual

The mobi(kindle) and epub files can be downloaded from here:

https://www.dropbox.com/sh/6sn4hj1y2dsf ... MWUVa?dl=0
Wow, thank you so much. I've been struggling to read the manual in .pdf format on my Kindle Fire for the last month. From what I've seen so far, the .mobi format is perfect on the Kindle Fire. The Ableton manual is now a very enjoyable read thanks to your hard work. Thank you, my man!

mrtagomi
Posts: 1
Joined: Sat Nov 04, 2017 10:20 am

Re: publishing manual in formats other than PDF

Post by mrtagomi » Sat Feb 03, 2018 9:11 pm

The document properties of the Live manual show it was made with Adobe InDesign. InDesign has an epub export function which works great, if the document is created properly. I really wonder why there are still no official epub/mobi manuals for any DAW (not only Ableton Live).

fenderblender77
Posts: 2
Joined: Fri Mar 10, 2017 3:18 am

Re: publishing manual in formats other than PDF

Post by fenderblender77 » Wed Mar 28, 2018 6:28 am

Any chance this could be updated for 10? Could use that mobi!

Post Reply