Re: [Scons-dev] Documentation in EPUB-format

2013-10-13 Thread William Deegan
Andrew, On Oct 13, 2013, at 11:50 AM, Andrew Featherstone andrew.featherst...@gmail.com wrote: On 10/10/2013 12:59 AM, William Deegan wrote: All, On Oct 9, 2013, at 3:38 PM, Andrew Featherstone andrew.featherst...@cantab.net wrote: On 10/09/2013 09:18 AM, Dirk Bächle wrote: Andrew,

Re: [Scons-dev] Documentation in EPUB-format

2013-10-13 Thread Dirk Bächle
Andrew, On 13.10.2013 20:50, Andrew Featherstone wrote: [...] Dirk: I've pushed what I've got so far to https://bitbucket.org/ajf58/scons_docbook/branch/epub . I've run a basic Docbook through it and generated an EPUB file that passes the validation test here http://validator.idpf.org/ . In

[Scons-dev] Documentation in EPUB-format

2013-10-08 Thread Andrew Featherstone
Hi Dirk, Yes my tool takes care of zipping up and formatting the container correctly. Unfortunately the SCons Zip builder method doesn't support source files with different compression types; perhaps that's a separate feature that could be added. For now I'm using the Python zipfile module

Re: [Scons-dev] Documentation in EPUB-Format?

2013-10-06 Thread Dirk Bächle
On 06.10.2013 01:24, Bill Deegan wrote: Dirk, How big are the ePub files? vs pdf.. For the full UserGuide, I currently have: PDF = 2394kB vs. EPUB = 219kB , but you have to take into account that the additional graphics for the style and the titlepage eat up a lot of space for the PDF.

Re: [Scons-dev] Documentation in EPUB-format

2013-10-06 Thread Dirk Bächle
Andrew, On 06.10.2013 21:07, Dirk Bächle wrote: [...] The DocBook Tool is not (yet) part of the core sources. By keeping compatibility to older SCons and Python versions, we don't force people to upgrade if they want to use the Tool. So this still makes sense, I think. sorry I have to

Re: [Scons-dev] Documentation in EPUB-Format?

2013-10-06 Thread Gary Oberbrunner
I wouldn't use the epub format personally, I almost always use the searchable HTML. But anything that allows for wider adoption is fine with me, especially if it's not much work. On Fri, Oct 4, 2013 at 8:56 AM, Dirk Bächle tshor...@gmx.de wrote: Hi devs, since we're now using DocBook as

Re: [Scons-dev] Documentation in EPUB-Format?

2013-10-05 Thread Dirk Bächle
Hi Rob, On 05.10.2013 01:42, Managan, Rob wrote: I like the idea since I like ebooks. However, I will be honest and say that for code development I would not be too likely to use it since on my desktop machines I don't have a great epub viewers. it's more like for users starting with SCons

Re: [Scons-dev] Documentation in EPUB-Format?

2013-10-05 Thread Bill Deegan
Dirk, How big are the ePub files? vs pdf.. -Bill On Sat, Oct 5, 2013 at 1:50 AM, Dirk Bächle tshor...@gmx.de wrote: Hi Rob, On 05.10.2013 01:42, Managan, Rob wrote: I like the idea since I like ebooks. However, I will be honest and say that for code development I would not be too

[Scons-dev] Documentation in EPUB-Format?

2013-10-04 Thread Dirk Bächle
Hi devs, since we're now using DocBook as source format for all our documentation, it would technically be relatively easy to publish things like the MAN page or the UserGuide in EPUB format as well. The latest versions of pandoc ( 1.12.x) offer a DocBook reader and do a, more or less, good

Re: [Scons-dev] Documentation in EPUB-Format?

2013-10-04 Thread Managan, Rob
I like the idea since I like ebooks. However, I will be honest and say that for code development I would not be too likely to use it since on my desktop machines I don't have a great epub viewers. So I guess I would say that if there was no extra effort or file space required go ahead and add it